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:
  1. 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.
  2. 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.