&SYSTERM_VOLUME System Variable Symbol

z/VSE®
The value of &SYSTERM_VOLUME is always null.

The value of the type attribute is U, and the value of the count attribute is 0.

z/VM® and z/OS®
You can use &SYSTERM_VOLUME in a macro definition to obtain the volume identifier of the first volume containing the data set to which the assembler is writing the terminal records.

The local-scope system variable symbol &SYSTERM_VOLUME is assigned a read-only value each time a macro definition is called.

If the assembler runs on the CMS component of the z/VM operating system, and the terminal records are being written to a Shared File System CMS file, &SYSTERM_VOLUME is assigned the value “** SFS”.

If the volume on which the data set resides is not labeled, &SYSTERM_VOLUME is assigned a null character string.

Notes:
  1. If the TERM user exit provides the terminal data set information then the value in &SYSTERM_VOLUME is the value extracted from the Exit-Specific Information block described in the section Exit-Specific Information Block in the HLASM Programmer's Guide.
  2. The value of the type attribute of &SYSTERM_VOLUME (T'&SYSTERM_VOLUME) is U, unless &SYSTERM_VOLUME is assigned a null character string, in which case the value of the type attribute is O.
  3. The value of the count attribute of &SYSTERM_VOLUME (K'&SYSTERM_VOLUME) is equal to the number of characters assigned as a value to &SYSTERM_VOLUME. If &SYSTERM_VOLUME is assigned a null character string, the value of the count attribute is 0. The maximum length of this system variable symbol is 6.