Dynamic system symbols
New symbol | Old symbol |
---|---|
&YYMMDD | &DATE |
&LYYMMDD | &LDATE |
&HHMMSS | &TIME |
&LHHMMSS | <IME |
To maintain compatibility, the original system symbols (Compatibility-only dynamic system symbols) are still supported by the DUMPDS command. However, IBM® suggests that you change to use the new system symbols (Dynamic system symbols) because the substitution texts for the old system symbols might cause buffer overflows.
- For system symbols within a parmlib member, when the parmlib member is processed.
- For system symbols within JCL, when the JCL undergoes conversion.
- When an application program is running.
- Dynamic system symbols
- Compatibility-only dynamic system symbols. Note that IBM recommends against using these system symbols.
System symbol | Description |
---|---|
&DAY | The day of the month, based on Coordinated Universal Time (UTC). Shown in two decimal digits, 01-31. Use &LDAY for local time. |
&DS | The dump section number for multiple data sets in a transaction dump (TDUMP). Shown in three decimal digits, 000-999. &DS is resolved when used by IEATDUMP. |
&HHMMSS | The time. Equivalent to &HR.&MIN.&SEC.. Use &LHHMMSS for local time. |
&HR | The hour of the day, based on UTC. Shown in two decimal digits, 00-23. Use &LHR for local time. |
&JDAY | The Julian day of the year, based on UTC. Shown in three decimal digits, 001-366. Use &LJDAY for local time. |
&JOBNAME | The name of the job. Shown in 1-8 characters. In the special case when the job
name is *MASTER*, &JOBNAME resolves to #MASTER# to avoid the error of using the asterisk as part
of a data set name. Under z/OS®, it is valid to define a user ID that is all numeric. Under z/OS UNIX, this all-numeric user ID might be propagated as a job name in the case of a fork() or non-local spawn(); this can lead to allocation failures when &JOBNAME is used in substitution for a data set name. If you specify the &JOBNAME dynamic system symbol in a START command for a started task, the resolved substitution text for &JOBNAME is the name of the job assigned to the address space that calls the symbolic substitution service, not the address space of the started task. |
&LDATE | The local date, based on Coordinated Universal Time (UTC). Equivalent to &YR2.&MON.&DAY.. |
&LDAY | The day of the month, based on local time. Shown in two decimal digits, 01-31. |
&LHHMMSS | The local time. Equivalent to &HR.&MIN.&SEC. |
&LHR | The hour of the day, based on local time. Shown in two decimal digits, 00-23. |
&LJDAY | The Julian day of the year, based on local time. Shown in three decimal digits, 001-366. |
&LMIN | The minute of the hour, based on local time. Shown in two decimal digits, 00-59. |
&LMON | The month, based on local time. Shown in two decimal digits, 01-12. |
&LSEC | The second of the minute, based on local time. Shown in two decimal digits, 00-59. |
<IME | The local time that the dump was requested, Equivalent to &HR.&MIN.&SEC.. |
&LWDAY | The day of the week, based on local time. Shown in three characters: SUN, MON, TUE, WED, THU, FRI or SAT. |
&LYR2 | The year, based on local time. Shown in two decimal digits, 00-99. |
&LYR4 | The year, based on local time. Shown in four decimal digits, 0000-9999. |
&MIN | The minute of the hour, based on UTC. Shown in two decimal digits, 00-59. Use &LMIN for local time. |
&MON | The month, based on UTC. Shown in two decimal digits, 01-12. Use &LMON for local time. |
&SEC | The second of the minute, based on UTC. Shown in two decimal digits, 00-59. Use &LSEC for local time. |
&SEQ | A sequence number for uniqueness. It is required for names of automatically allocated dump data sets. Shown in five decimal digits, 00000-99999. &SEQ is resolved only when used with DUMPDS. |
&WDAY | The day of the week, based on UTC. Shown in three characters: SUN, MON, TUE, WED, THU, FRI or SAT. Use &LWDAY for local time. |
&YR2 | The year, based on UTC. Shown in two decimal digits, 00-99. Use &LYR2 for local time. |
&YR4 | The year, based on UTC. Shown in four decimal digits, 0000-9999. Use &LYR4 for local time. |
&YYMMDD | The date, based on UTC. Equivalent to &YR2.&MON.&DAY.. Use &LYYMMDD for local time. |
System symbol | Description |
---|---|
&DATE | The date, based on Coordinated Universal Time (UTC). Equivalent to &YR2.&MON.&DAY.. Use &LDATE for local date. |
&TIME | The time that the dump was requested, Equivalent to &HR.&MIN.&SEC.. Use <IME for local time. |