Execution JCL › One-Step and Five-Step JCL

One-Step and Five-Step JCL

CA Culprit can execute in one step or five steps at z/OS, z/VSE, and z/VM installations; CA Culprit executes in five steps. When one-step CA Culprit JCL executes, all six processing phases are invoked by a single driver program. When five-step CA Culprit JCL executes, each processing phase executes as a separate step. (The compile and extract phases combine to form one job step.)

The major advantage of one-step CA Culprit is that it eliminates much of the JCL necessary for running the job, which in turn simplifies the system. The single driver program maintains control over all processing phases. The driver controls each of the six processing phases in turn and regains control after each phase except the compile phase.

Before proceeding with the next processing phase, the driver checks the previous phase for a completion code of zero (that is, a normal return). If the completion code is not zero, an error message is printed and the entire job is terminated without executing the remaining processing phases.

A return code for the entire job is set, depending on the reason for termination. The error message associated with job cancellation prints on a new page in the output listing under the heading CA Culprit CONTROLLER MESSAGES. This error message indicates the processing phase that caused job termination and the completion code set by this processing phase.

Note: For more information on error messages, see the CA Culprit for CA IDMS Messages and Codes Guide.

With five-step CA Culprit jobs run under z/OS, z/VM, users can control run terminations according to the severity levels of the errors encountered. The control is established through the RC= keyword expression on the PROFILE parameter (see Chapter 2, PROFILE Parameter) and in the execution JCL. At z/VSE installations, the RC= option causes cancellation of the entire job when the indicated error level is encountered.

Differences in Parameter Sort and Data Sort Phases

One-step and five-step CA Culprit jobs invoke the parameter sort and data sort phases differently, as follows:

• Under five-step CA Culprit, both phases are invoked by the JCL.
• Under one-step CA Culprit, both phases are internal to the CA Culprit program. Sort user-exit routines handle the input and output for the sort phases, making SORTIN and SORTOUT DD statements unnecessary. The input and output file for the parameter sort phase is the formatted parameter file, SYS005. The input and output file for the data sort phase is the extracted items and statistics file, SYS006.

  The user can change the name of the sort program invoked by one-step CA Culprit by assembling the system profile option program, CULPPROF, with the SORT= macro operand at installation time. The sort-control statements can also be changed easily, as needed.

  Parameters for CA Culprit's two sort phases are stored as follows:

  • At z/OS installations, parameters for the parameter sort reside in the SRCLIB member, SORT1; parameters for the data sort are generated from the template found in the CULLSRTC module.
  • At z/VSE installations, parameters for the parameter sort reside in the SORT1.SAMPS member in the IDMSBASE sublibrary; parameters for the data sort are generated from the template found in the CULLSRTO relocatable module.
  • At z/VM installations, parameters for the parameter sort reside in IDMSLIB MACLIB member SORT1; parameters for the data sort are generated from the template found in the CULLSRTC module.

Note: For more information, see the CA IDMS Installation Guide for your operating system.

Sort listings generated by one-step CA Culprit differ from those generated by five-step CA Culprit. Order of the sort listings is determined by the placement of the sort output DD statements relative to SYS004. The sort listings in one-step CA Culprit either precede or follow the Sequential Parameter and Input Parameter Listings but cannot appear between them. In five-step CA Culprit, the parameter sort listing appears after the Sequential Parameter Listing, and the data sort listing appears after the Input Parameter Listing.

In one-step CA Culprit, the numbers of records processed by each sort are listed under INSERT and DELETE headers; in five-step CA Culprit, the numbers are listed under IN and OUT.