Specifying input arrival dates and times

About this task

In the scheduler, the input arrival time forms part of the key that uniquely identifies each occurrence of the application in the long-term plan and in the current plan; it is not the time that the scheduler attempts to start the occurrence, unless you specify the first operation as time-dependent. The input arrival time of the occurrence is the default input arrival time for operations making up that occurrence. Some of the OCL instructions use the input arrival date and time to uniquely identify the occurrences in the scheduler plans. The keywords that specify the input arrival date and time are:

Table 1. Input Arrival Date and Time Keywords
Keyword Abbreviation Purpose
IADATE IAD Specifies the input arrival date, in YYMMDD format.
IATIME IAT Specifies the input arrival time, in HHMM format.
IA   Specifies the input arrival date and time, in YYMMDDHHMM format.

These keywords are optional. You can specify either or both the keywords IADATE and IATIME, but if you do you cannot then specify the IA keyword. OCL does not check for duplicate keywords in the OCL statements. If a keyword is specified more than once, the values from the last occurrence will be used.

The initialization parameters that affect the calculation of the input arrival date and time if you omit either specification are:
DEFIAT
Specified in the EQQYRPRM member; it determines the default occurrence input arrival time (for example, 1800).
A blank value is allowed. If DEFIAT is set to blank and an IA time is not specified, the following rules apply:
  • All the existing occurrences matching the other specified parameters are searched for, by applying the mechanism set by the SORT parameter (MIN or MAX).
  • If the action is an add occurrence, the blank value is replaced by the current time.
SORT
Specified in the EQQYRPRM member or in the INIT instruction. It is used only if IADATE, IATIME, and IA keywords are not specified in the OCL instruction, or if IADATE is set and IATIME is not. In this latter case, after the MAX or MIN criterion is applied, the IA date is used to filter the matching occurrences.
The SORT parameter determines whether OCL is to consider the earliest or the latest date and time of the occurrence in the current plan. For example: 
COMPL APPL(TEST01)
The following occurrences of the application TEST01 are in the current plan: 
Input arrival date: 211201 time: 18.00
Input arrival date: 211201 time: 20.00
Input arrival date: 211203 time: 18.00
If SORT is MAX, OCL selects the occurrence with input arrival 21/12/03 18.00. If SORT is MIN, OCL selects the occurrence with input arrival 21/12/01 18.00.

How OCL Uses the IADATE, IATIME, and IA Keywords describes how OCL uses the IADATE, IATIME, and IA keywords:

Table 2. How OCL Uses the IADATE, IATIME, and IA Keywords
Keywords Input arrival date and time calculated by OCL Comment
IAD(971203) 9712031800 Uses the default IA time, as specified in the DEFIAT parameter (for example, 1800). If DEFIAT is not set:
  • It uses the current time (for example, 1015) if the action is an occurrence add.
  • Time is left blank and all the occurrences matching the IA date are searched for, by applying the mechanism set by the SORT parameter.
IAD(971203) IAT(2030) 9712032030  
IAD(=) 9712041800 Uses the current date and the default IA time (for example, 1800), if it is specified in the DEFIAT parameter. If DEFIAT is not set:
  • It uses the current time (for example, 1015) if the action is an occurrence add.
  • Time is left blank and all the occurrences matching the IA date are searched for, by applying the mechanism set by the SORT parameter.
IAD(=) IAT(=) 9712041015 Uses the current date and time
IAD(971203) IAT=() 9712031015 Uses the specified date and current time.
IAT(=) 9712041015 Uses the current date and specified time.
IAT(2030) 9712042030 Uses the current date.
IA(9712032030) 971232030  
IA(=) 9712031015 Uses the current date and time.
Note: If no keyword is specified, OCL selects the earliest or the latest occurrence of the application in the scheduler plans, according to the SORT parameter specified in the EQQYRPRM member or in the INIT instruction.

If the IA date is set and the IA time is not, after the SORT parameter is applied the IA date is used to filter the matching occurrences.

The keywords listed in How OCL Uses the IADATE, IATIME, and IA Keywords can be specified in the following OCL instructions:
ADD ADDCOND ADDOP ADDPRED ADDRES
ADDSIMP CHGEXTNME CHGJOB CHKAPPL COMPL
DEL DELCOND DELPRED DELRES DELSIMP
FORCE HOLD KILLJOB KILLREC MODCOND
MODOP NOP RELEASE RELOP RELSUCC
UNNOP
You can use the SUBSYS() keyword to specify the scheduler subsystem name in any of the following:
  • The EQQYRPRM member
  • The INIT instruction
  • The EQQYPARM DD card if it is specified in the OCL procedure
OCL uses the following order to override the scheduler subsystem name:
  1. SUBSYS() specified in the data set referenced by the EQQYPARM DD card
  2. SUBSYS() specified in an OCL instruction (for example, OPSTAT)
  3. SUBSYS() specified in the INIT instruction
  4. SUBSYS() specified in the OCL PARMLIB

The SUBSYS() keyword specified in the EQQYPARM overrides all the scheduler subsystem name specifications.

If duplicate keywords are specified in the OCL instructions, OCL takes the rightmost specification. For example: 
CHKAPPL  APPL(TEST01) IAD(=) APPL(TEST05) STATUS(E)

In this example, OCL checks for occurrences of application TEST05.