The conditions for the jobs can be checked before the job execution and after the job execution. The condition which is checked before the job execution is called In-Condition and the condition which is checked after the job execution is called Out-Condition.
- The condition which controls the execution of the job is referred to as In-Condition.
- And the condition which either Create Event or Delete Event according to the Event List is referred to as Out-Condition.
Conditions to the job can be added depending upon whether the new Job Stream is to be created or the Job Stream already exists.
- Creating a new Job Stream:
- Login to the JOC Cockpit, switch to the JOB STREAMS tab.
- From the left side tree view select the folder with the jobs to which condition is to be added.
- After clicking on folder there will be a message displayed No Job Streams found. Click Here to Add.
- Click on the link to add the Job Stream.
- A Create Job Stream pop up will be displayed. Enter the name of the Job Stream and click submit.
- Now drag and drop the jobs for which you want to add an In-Condition or Out-Condition.
- The conditions for a job can be added or deleted by the option Edit Conditions in the action menu of the job from the list view of the Job Streams tab.
- Note: The Edit Conditions tab can also be used to add a condition for existing Job Stream by adding the same name of Job Stream as that of existing Job Stream in the Conditions Editor.
- Note: The Edit Conditions tab can also be used to add a condition for existing Job Stream by adding the same name of Job Stream as that of existing Job Stream in the Conditions Editor.
- A Condition Editor opens for the job.
- A Condition Editor opens for the job.
- Adding a condition for a job in an Existing Job Stream:
- If a Job Stream is already created for a job/jobs in the same folder then you can drag and job for which you want to add a condition.
- Note: On dropping a job to the Job Stream the name of the Job Stream will be set by default to the name of Job Stream on which the job is added/dropped.
- Note: On dropping a job to the Job Stream the name of the Job Stream will be set by default to the name of Job Stream on which the job is added/dropped.
- If a Job Stream is already created for a job/jobs in the same folder then you can drag and job for which you want to add a condition.
- When the job is dropped a Conditions Editor pop-up opens.
How to add an In-Condition to a job?
Open the Conditions Editor, if there are no In-Conditions added then in the In-Conditions tab there will be written "No Inconditions found. Click Here To Add". Click on "Click Here To Add" to add an In-Condition.
Another Conditions Editor will open. Add the expression to be evaluated. You can use the Expression Editor to check what expressions are supported by Job Streams. Then select a Command which is to be executed if the expression becomes true. The In-Condition supports two commands:
- startJob: This command starts the job according to the value of Command Param if the expressions evaluate to true. The default value of Command Param now, which means the job will be started as soon as the result of the Expressions becomes true.
- writeLog: This command writes the message provided in the Command Param to the log.
How to add an Out-Condition to a job?
Open the Conditions Editor, switch to the Out-Conditions tab there will be written "No Outconditions found. Click Here To Add". Click on "Click Here To Add" to add an Out-Condition.
Another Conditions Editor will open. Add the expression to be evaluated. You can use the Expression Editor to check what expressions are supported by Job Streams. By default, the expression is set to "returncode:0" which means the success of the job. Then select a Command which is to be executed if the expression becomes true. The Out-Condition supports two commands:
- Create Event: The Create Event Event List is used to create an event if the expression for the Out-Condition evaluates to true. The default name of the Event to be created is the same as that of the jobs name.
- Delete Event: The Delete Event Event List is used to delete an existing event if the expression for the out-Condition evaluates to true.