Scope

Conditions for jobs can be checked before job execution and after job execution. The condition which is checked before job execution is called In Condition and the condition which is checked after job execution is called Out Condition.

...

Conditions can be added to jobs depending upon whether the new Job Stream is to be created or the Job Stream already exists. 

Creating Job Streams and Conditions

Creating a 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 a condition should 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 window will be displayed. Enter the name of the Job Stream and hit the "submit" button.
• Now drag and drop the jobs for which you want to add an In Condition or Out Condition.
• The conditions for a job can also 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.

1. 
   
   

   • • The Conditions Editor opens for the job.
       
       

   
   
   

Adding a Condition to a Job in an existing Job Stream

• If the Job Stream already exists then you can drag & drop the job to which you want to add a condition.
  • Note: When dropping a job from the Job Stream the name of the Job Stream will be set by default to the name of Job Stream to which the job is added/dropped.
    
    

...

• • When the job is dropped the Conditions Editor pop-up window 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 displayed "No In Conditions found. Click Here To Add". Click on "Click Here To Add" to add an In Condition.

...

• Another Conditions Editor window 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 evaluates to true. The In Condition supports two commands:
  • startJob: This command starts the job according to the value of Command Param if the Expression evaluates to true. The default value of Command Param is now, which means the job will start as soon as the result of the Expression becomes true.
  • writeLog: This command writes the message provided with the Command Param to the task log of the job to which the In Condition is added. 

How to add an Out Condition to a job?

• Open the Conditions Editor and switch to the Out Conditions tab. There will be displayed "No Out Conditions found. Click Here To Add". Click on "Click Here To Add" to add an Out Condition.
• Another Conditions Editor window  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 checks a successful run of the job. Then select an Event List which is to be executed if the Expression evaluates to true. The Out Condition supports two event lists:
  • 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 job 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.

How to edit an existing In Condition or Out Condition with a Job Stream?

• To edit an existing In Condition or Out Condition from the graph using the Update Expression option from the action menu of the Condition of the job. For example: you want to update the Expression for an Out Condition of a job form returncode:0 to returncode:10 to indicate that 
• Then switch to the Job Streams graph, use the action menu of the Out Condition indicated by parallelogram after the job. Click on Update Expression. 
  • Note: An In Condition for a job is indicated by a left inclined parallelogram before the job. An Out Condition for a job is indicated by a right inclined parallelogram after the job.
• The Conditions Editor will open. Update the Expression and hit the "submit" button to apply your changes.

...