Data set name skeleton substitution keywords


The following substitution keywords are valid in the data set name skeleton:

&JOBN

The job name from the JOB statement in the application program JCL.

&JOBNUM

The JES-assigned JOB identifier for the job. This keyword is valid only for data sets that AR/CTL creates.

&JOBSN

The job step name from the EXEC statement in the application program JCL.

&STEPN

The job step name (if available) or the procedure step name (if the job step name is not available).

&PROCSN

The procedure step name from the EXEC statement in the JCL procedure. If the execution does not use a JCL procedure or if the procedure step does not have a step name, AR/CTL substitutes blanks, and an invalid data set name results.

&PSB

The PSB name from the PSB value of the PARM parameter on the EXEC statement in the application program JCL.

&ASB

The ASB name from the ASB value of the PARM parameter on the EXEC statement in the application program JCL or from the program registration record.

&PROG

The program name from the PGM parameter on the EXEC statement in the job step JCL.

&ARCID

The ARCID associated with the job step.

&IMSID

The IMSID associated with the job step.

&DEPT

The value of the Department Name option from the merged processing options record for this execution. For information about setting the value of this option, see Department-name.

&SEQ

The value of the SEQ keyword within the job step for each job step. AR/CTL initially sets the value to 1. Then AR/CTL increments the value each time it uses the keyword to construct a data set name within the job step. AR/CTL does not maintain the value between successive job steps for the same job, reattaches or restarts of the same job, or different jobs. When AR/CTL constructs the data set qualifier using this keyword, it prefixes the seven-position numeric portion with the character S. This keyword is valid only for data sets that AR/CTL creates.

&DATE

The Julian date, in the format Dyyyyddd, where D is a constant, yyyy is the year, and ddd is the day of the year (1 to 366). This keyword is valid only for data sets that AR/CTL creates.

&TIME

The time of the execution, in the format Thhmmsst, where T is a constant, hh is the hour (00 to 23), mm is the minute (00 to 59), ss is the second (00 to 59), and t is the tenth of a second (0 to 9). This keyword is valid only for data sets that AR/CTL creates.

&USER

The value that is specified for the USER keyword on the JOB statement. If AR/CTL cannot locate a valid USER value on the JOB statement or by system default, it uses the job name for this keyword. &USER is not a good high-level qualifier for the checkpoint data set.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

APPLICATION RESTART CONTROL 4.1 (ARCHIVED)