&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:
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:
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:
IBMAPC.IBMAPCA.JOB06734.D0000103.?
PUNCH
- 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.