INSERT CPOC
Insert an occurrence to current plan.
ACTION=INSERT,RESOURCE=CPOC,ADID=application_description,
IA=input_arrival_datetime,
DEADLINE=deadline_date_datetime,
PRIORITY=priority,
ERRCODE=error_code,
DESC=descriptive_text,
GROUP=authority_group_name,
OWNER=owner,
ODESC=descriptive_text_of_owner,
GROUPDEF=application_groupid,
JCLVTAB= JCL_variable_table_id;
- application_description
- Character (char(16)) can be generic (%*)
- application_groupid
- Character (char 16))
- authority_group_name
- Character (char(8)) can be generic (%*)
- deadline_date_datetime
- Date and time (YYMMDDHHMM)
- descriptive_text
- Character (char(24))
- descriptive_text_of_owner
- Character (char(24))
- error_code
- Character (char(4))
- input_arrival_datetime
- Date and time (YYMMDDHHMM)
- jcl_variable_table_id
- Character (char(16)) can be generic (%*)
- owner
- Character (char(16)) can be generic (%*)
- priority
- One integer (integer(4))
Note:
- If LTP=Y was specified in the options card and the IA date specified or defaulted is higher than the CP end date, the occurrence will be inserted in the LTP. In this case the operands DESC, GROUP, OWNER, and ODESC, if specified, will be ignored.
- The following facts must be carefully considered when GROUPDEF
is specified:
- Each of the applications belonging to the group is inserted separately, in alphabetical order (if CPDEPR=N is specified or defaulted in the options card) or in the order required to correctly resolve the dependencies (if CPDEPR=Y is specified in the options card). If any errors occur, BCIT ends and this results in only a partial insertion of the applications belonging to GROUPDEF.
- If there are more than one version of a given application in the AD, you must check that the specified or defaulted IA falls within one of the corresponding validity periods; otherwise, the BCIT job will terminate with RC=8.
- If CPDEPR was set to Y:
- It is not allowed to specify for an operation an external dependency on itself or on another operation of the same application.
- Cross dependencies are not supported. That is, if APPL1 contains an external dependency on an operation of APPL2 and APPL2 contains an external dependency on an operation of APPL1, this will be detected and the BCIT job will terminate with RC=8 (in this case, the INSERT will not be performed).
- It is your responsibility to ensure that the CP does not contain occurrences of the applications belonging to GROUPDEF: if they exist, the dependencies will be resolved in a different way from expected.
- It is not allowed to update the applications belonging to GROUPDEF at the same time as the batch job execution: the outcome of such concurrent update is unpredictable.