&SYSLIN_VOLUME System Variable Symbol

Use &SYSLIN_VOLUME in a macro definition to obtain the volume identifier of the object data set. The volume identifier is of the first volume containing the data set. &SYSLIN_VOLUME is only assigned a value when you specify the OBJECT, GOFF or XOBJECT assembler option.

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

If the assembler runs on the CMS component of the VM operating system, and the assembler listing is being written to a Shared File System CMS file, &SYSLIN_VOLUME is assigned the value ** SFS.

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

Notes:
  1. If the OBJECT user exit provides the data set information then the value in &SYSLIN_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 &SYSLIN_VOLUME (T'&SYSLIN_VOLUME) is U, unless &SYSLIN_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 &SYSLIN_VOLUME (K'&SYSLIN_VOLUME) is equal to the number of characters assigned as a value to &SYSLIN_VOLUME. If &SYSLIN_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.

[ Top of Page | Previous Page | Next Page | Contents | Index ]