&SYSPUNCH_DSN System Variable Symbol

Use &SYSPUNCH_DSN in a macro definition to obtain the name of the data set to which the assembler is writing the object records when assembler option DECK is specified.

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

When the assembler runs on the z/OS operating systems, the value of the character string assigned to &SYSPUNCH_DSN is always the value stored in the JFCB for SYSPUNCH. If SYSPUNCH is allocated to DUMMY, or a NULLFILE, the value in &SYSPUNCH_DSN is NULLFILE.

When the assembler runs on the CMS component of the VM operating systems, the value of the character string assigned to &SYSPUNCH_DSN is determined as follows:

Table 1. Contents of &SYSPUNCH_DSN on CMS
SYSPUNCH Allocated To:	Contents of &SYSPUNCH_DSN:
CMS file	The 8-character file name, the 8-character file type, and the 2-character file mode of the file, each separated by a space
Dummy file (no physical I/O)	`DUMMY`
Punch	`PUNCH`
Labeled tape file	The data set name of the tape file
Unlabeled tape file	`TAPn`, where n is a value from 0 to 9, or A to F.

On z/VSE, the value of the character string assigned to &SYSPUNCH_DSN is determined as follows:

Table 2. Contents of &SYSPUNCH_DSN on z/VSE
SYSPCH Assigned To:	Contents of &SYSPUNCH_DSN:
Disk file	The file-id
Punch	`SYSPCH`
Labeled tape file	The file ID of the tape file
Unlabeled tape file	`SYSPCH`

Examples:

On z/OS, &SYSPUNCH_DSN might be assigned a value such as:

IBMAPC.IBMAPCA.JOB06734.D0000103.?

On CMS, &SYSPUNCH_DSN might be assigned a value such as:

PUNCH

Notes:

If the PUNCH user exit provides the punch data set information then the value in &SYSPUNCH_DSN is the value extracted from the Exit-Specific Information block described in the section "Exit-Specific Information Block" in the HLASM Programmer's Guide.
The value of the type attribute of &SYSPUNCH_DSN (T'&SYSPUNCH_DSN) is always U.
The value of the count attribute of &SYSPUNCH_DSN (K'&SYSPUNCH_DSN) is equal to the number of characters assigned as a value to &SYSPUNCH_DSN.