&SYSPUNCH_VOLUME System Variable Symbol

Use &SYSPUNCH_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. &SYSPUNCH_VOLUME is only assigned a value when you specify the DECK assembler option.

The local-scope system variable symbol &SYSPUNCH_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 object records are being written to a Shared File System CMS file, &SYSPUNCH_VOLUME is assigned the value ** SFS.

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

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