GENJCL definitions

Reference for IMS HP Change Accumulation Utility GENJCL definitions.

GEN.GRPNAME=name
Names a change accumulation group for which a DBRC GENJCL.CA command is created. If you provide a GEN.GRPNAME statement, then you must provide at least one GEN.GENJCL statement. You can create as many GEN.GRPNAME statements as necessary to define all groups for processing. GENJCL.CA commands are created in the order in which GEN.GRPNAME statements are processed.
GEN.GENJCL=string
Represents a continued line of a DBRC GENJCL.CA command. The command must not contain the GRPNAME( ) parameter. If you provide a GEN.GENJCL statement, then you must provide at least one GEN.GRPNAME statement. You can create as many GEN.GENJCL statements as necessary to define all continuation lines for the GENJCL.CA command. The GENJCL.CA command is created in the order in which GEN.GENJCL statements are processed. The continuation indicator for each line is optional.
GEN.LIST=number
If the DBRC completion code (CC) >number, then the SYSPRINT DD output of the GENJCL.CA commands is listed in the HPCDBPRT data set, if allocated. IMS HP Change Accumulation Utility tests for this condition prior to GEN.WARN. The completion codes are:
  • 0 = list for all conditions
  • 4 = list for warnings or errors
  • 8 = list only when errors
GEN.RETRY=number
Specifies the number of times IMS HP Change Accumulation Utility will reprocess GENJCL for CAGRPs that cannot be accumulated because of the purge time validation error.

Range: 0 - 3

Default: 0

Valid only for the extended batch environment.

The following restrictions apply:

  • Only simple forms of GENJCL definitions in HPCSYSIN are accepted
  • VOLNUM is not supported
  • Single Address Space (SAS) is not supported
  • Point-in-time (PIT) is not supported
  • A new delete data set step is added if HPCADRI1 RC=4
GEN.STOP
Directs IMS HP Change Accumulation Utility to bypass processing of the converted CAJCL procedures. This is similar to running PGM=HPCABAT0 (the first step in the 2-step batch process).
GEN.WARN=action
Directs IMS HP Change Accumulation Utility to take action if the DBRC GENJCL.CA process competes without error, but with warnings.
Actions are the following:
  • STOP - End processing after messages are displayed.
  • IGNORE - Attempt to process the JCL that was returned. The warning condition might result in additional errors or abends depending on the conditions of the resulting JCL.
  • DEFER - Continue processing the JCL that was returned. Final return code will be RC=0 unless other errors are detected.

Default: STOP

Note: If no CA groups were returned by DBRC, or if error conditions have caused all groups to be bypassed, processing always ends with RC=4. GEN.WARN=IGNORE or DEFER has no effect when there are no CA groups to be processed. This command is secondary to the WARN=parm optionally provided in the EXEC parameters.
Condition codes
Termination condition codes for HPCADRIV and HPCAMAIN reflect the combined termination status of the main address space and all subordinate address spaces. The completion codes are:
  • CC=00 All selected groups scheduled and completed successfully.
  • CC=04 No requested groups have input logs for processing.
  • CC=04 At least one scheduled group completed with a warning.
  • CC=08 At least one scheduled group completed with an error.
  • CC=20 At least one selected group was not scheduled.
  • CC=20 At least one scheduled group ended abnormally.
  • CC=20 At least one scheduled group ended in an unknown condition.

CC=20 can result from an abend or from a condition that is not identifiable to the IMS HP Change Accumulation Utility main task. For example, a JCL error in the subordinate address space prevents any cross-memory communication and the condition is, therefore, unknown to the main address space.