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. |