&SYSPRINT_DSN System Variable Symbol

Use &SYSPRINT_DSN in a macro definition to obtain the name of the data set to which the assembler writes the assembler listing.

The local-scope system variable symbol &SYSPRINT_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 &SYSPRINT_DSN is always the value stored in the JFCB for SYSPRINT. If SYSPRINT is allocated to DUMMY, or a NULLFILE, the value in &SYSPRINT_DSN is NULLFILE.

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

Table 43. Contents of &SYSPRINT_DSN on CMS
SYSPRINT Allocated To: Contents of &SYSPRINT_DSN:
CMS file The 8-character filename, the 8-character filetype, and the 2-character filemode of the file, each separated by a space
Dummy file (no physical I/O) DUMMY
Printer PRINTER
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.
Terminal TERMINAL

When the assembler runs on z/VSE, the value of the character string assigned to &SYSPRINT_DSN is determined as follows:

Table 44. Contents of &SYSPRINT_DSN on z/VSE
SYSLST Assigned To: Contents of &SYSPRINT_DSN:
Disk file (not for dynamic partitions) The file-id
Printer SYSLST
Labeled tape file The file-id of the tape file
Unlabeled tape file SYSLST

Examples:

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

IBMAPC.IBMAPCA.JOB06734.D0000102.?

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

SAMPLE   LISTING  A1

Notes:
  1. If the LISTING user exit provides the listing data set information then the value in &SYSPRINT_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.
  2. The value of the type attribute of &SYSPRINT_DSN (T'&SYSPRINT_DSN) is always U.
  3. The value of the count attribute of &SYSPRINT_DSN (K'&SYSPRINT_DSN) is equal to the number of characters assigned as a value to &SYSPRINT_DSN.

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