General Information for DUE OUT

The DUE OUT parameters are used to specify the date and time by which the job must finish executing.

When specified in a SMART Table Entity, the DUE OUT parameters are used to specify the date and time by which all the jobs contained in the SMART Table must finish executing.

When two jobs with the same priority are available for submission, Control-M submits the job with the earlier DUE OUT date and time first.

When a DUE OUT date and time is specified, the Control-M monitor can calculate a DUE IN date and time for the job.

The DUE IN date and time are the recommended date and time by which the job must be submitted in order to finish executing by the DUE OUT date and time.

If the DUEINCHK parameter in the CTMPARM member in the IOA PARM library has been set to No, the job is always submitted, no matter what values are present in the DUE IN date and time.

If the DUEINCHK parameter in the CTMPARM member in the IOA PARM library has been set to Yes, job submission depends on the DUE IN date and time:

• If the DUE IN date of a job has passed, the job is never submitted.
• If the DUE IN date is not present, and the DUE IN time has passed, the job must wait until the next day to be submitted.

To calculate the DUE IN time, the Control-M monitor subtracts the anticipated elapse time of the job from the DUE OUT time. The anticipated elapse time is the average of the execution times of the job recorded in the Control-M Statistics file.

If DUE OUT date is present, the DUE IN date is calculated as follows:

• The DUE IN date is equal to the DUE OUT date.
• If, when you move forward on the physical clock from the New Day Processing time, you arrive at the DUE OUT TIME before you arrive at the DUE IN time, it means that New Day processing falls between the DUE IN TIME and the DUE OUT TIME. In this case, one day is subtracted from the DUE IN DATE.

If DUE OUT TIME is not specified, the default DUE OUT TIME is the last minute of the working day.

Automatic adjustment of DUE OUT date and time can be requested from the Job Dependency Network screen.

For more information, see Automatic Job Flow Adjustment, and Job Dependency Network Screen. For an explanation of how DUE OUT affects job submission in the QUIESCE command, see the description of setting a planned shutdown time in the INCONTROL for z/OS Administrator Guide.

Please note that when specifying a DUE OUT date, the correct MAXWAIT parameter value must be specified. For details, see MAXWAIT: Basic Scheduling Parameter.