General Information for OUT

If the job ends OK, the prerequisite conditions are added to or deleted from the IOA Conditions file according to the value set for opt.

Prerequisite conditions are usually used to establish job dependencies or to ensure manual intervention when required:

• To establish job dependency, define a prerequisite condition in an OUT or DO COND statement in the job that must run first, and in an IN statement in the job that must run afterwards.

  The job containing a prerequisite condition in an IN statement is not submitted unless that prerequisite condition has been added manually or by a job containing the OUT or DO COND statement.

  • An OUT statement is used to add the prerequisite condition if the job ends OK.
  • The DO COND statement is used to add the prerequisite condition if the step and code event criteria specified in the accompanying ON statement are satisfied.
• If the IN condition can only be satisfied by manual intervention, for example, if TAPE1-ARRIVED is set by the operator after an external tape has arrived on-site, performance of the required manual intervention before job submission can be ensured.

OUT and DO COND statements can also be used to delete prerequisite conditions. The OUT statement of the job can be used to delete a prerequisite condition after the job ends OK. A DO COND statement can be used to delete prerequisite conditions if the accompanying ON step and code criteria are satisfied.

These statements are generally used to delete prerequisite conditions either to prevent a particular job from running or when the condition is no longer needed by any other jobs in the Active Jobs file.

DO COND functions are performed after the functions of the OUT parameter:

• If a prerequisite condition is added by the OUT parameter and deleted by the DO COND parameter, the combined effect is the deletion of the prerequisite condition.
• If a prerequisite condition is deleted by the OUT parameter and added by the DO COND parameter, the combined effect is the addition of that prerequisite condition.

The following are examples of prerequisite conditions:

• IMS-ACTIVE
• JOB_PAYCALC_ENDED_OK
• TAPE1_LOADED

All prerequisite conditions are associated with a date reference that is used to distinguish between different runs of the same job with different scheduling dates. If, for example, a condition is being deleted, only the condition matching the specified date is deleted. The same condition from a different date is not deleted.

Prerequisite conditions created by the OUT parameter can trigger the execution of other jobs or processes.

Prerequisite conditions deleted by the OUT parameter can prevent the scheduling of jobs and processes that require those prerequisite conditions in their IN parameter.

For more information regarding prerequisite conditions, see IN: Runtime Scheduling Parameter, ON Statements: Post–Processing Parameter, and DO COND: Post–Processing Parameter, and see Prerequisite Conditions.