ADD

The ADD instruction adds occurrences or a group of occurrences to the current plan or to the long-term plan. It modifies the current plan or long-term plan, depending on the date and time specified or defaulted to. If the date and time being used is after the end of the current plan, the modification will be made to the long-term plan instead of the current plan.

Keywords Used in the Add Instruction describes the keywords that can be used.

Table 1. Keywords Used in the Add Instruction
Keyword	Requirement	Multiple Values Allowed	Description	Abbreviation	Format
APPL()	Required¹	Yes	Name of the application to be added. APPL() and GROUP() are mutually exclusive.
DL()	Optional	No	Deadline date and time of the application occurrence or group.		YYMMDDHHMM
GDEPRES()	Optional	No	Group dependencies resolution option (Y or N). If not specified it defaults to "Y". To be used only when the versioning is present.
GROUP()	Required¹	No	The application group name to be added. GROUP() and APPL() are mutually exclusive.
IADATE()	Optional	No	Input arrival date of the application occurrence. If not specified, it defaults to the current date. IADATE() and IA() are mutually exclusive.	IAD	YYMMDD
IATIME()	Optional¹	No	Input arrival time of the application occurrence. It defaults to the current time or, if an occurrence of the application already exists in the current plan, to the first minute after the current time. IATIME() and IA() are mutually exclusive.	IAT	HHMM
IA()	Optional¹	No	Input arrival date and time of the application occurrence or group. It defaults to the current date and time. IA() cannot be used with IADATE() or IATIME().		YYMMDDHHMM
VARTAB()	Optional	No	The IBM Z Workload Scheduler variable table you want to associate with the group or application.
Note: ¹ Mutually exclusive with another keyword.

Examples:

ADD APPL(TEST01): Application TEST01 will be added to the current plan or to the long-term plan
ADD GROUP(GROUPTEST01): All the applications associated with the application group GROUPTEST01 will be added to the current plan or to the long-term plan
ADD APPL(TEST01) IA(=): Application TEST01 will be added to the current plan or to the long-term plan with input arrival date and time that corresponds to the current date and time
ADD APPL(TEST01) IAD(970708) IAT(0900): Application TEST01 will be added to the current plan or to the long-term plan with input arrival date 970708 and input arrival time 0900
ADD APPL(TEST01,TEST02,TEST03,TEST04,TEST05,TEST06): Applications TEST01, TEST02, TEST03, TEST04, TEST05, and TEST06 will be added to the current plan or to the long-term plan

Note: The following message is not to be considered an error by OCL:

EQQM018E OCCURRENCE ALREADY EXISTS - NOT ADDED

It is issued when OCL tries to add an occurrence that already exists in the current plan. In this case, OCL tries again to add the occurrence with an input arrival time incremented by 1 minute.

The ADD instruction returns one of the following return codes:

RESULT = 0: Occurrences added to the current plan or to the long-term plan.
RESULT = 4: Occurrences added to the long-term plan, but unable to resolve all external dependencies.
RESULT = 8: Invalid instruction or PIF problem. Refer to the error messages.