HLASM Language Reference

&SYSTERM_DSN System Variable Symbol
&SYSTERM_DSN System Variable Symbol
Use &SYSTERM_DSN in a macro definition to obtain the name of the data set to
which the assembler is writing the terminal records.
The local-scope system variable symbol &SYSTERM_DSN is assigned a read-only
value each time a macro definition is called.
When the assembler runs on the MVS operating systems, the value of the
character string assigned to &SYSTERM_DSN is always the value stored in the
JFCB for SYSTERM. If SYSTERM is allocated to DUMMY, or a NULLFILE, the
value in &SYSTERM_DSN is NULLFILE.
When the assembler runs on the CMS component of the VM operating systems,
the value of the character string assigned to &SYSTERM_DSN is determined as
follows:
Figure 76. Contents of &SYSTERM_DSN on CMS
SYSTERM Allocated To:
CMS file
Dummy file (no physical I/O)
Printer
Labeled tape file
Contents of &SYSTERM_DSN:
The 8-character filename, the
8-character filetype, and the
2-character filemode of the file, each
separated by a space
DUMMY
PRINTER
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
On VSE, the value of the character string assigned to &SYSTERM_DSN is always
SYSLOG.
Examples:
On MVS, &SYSTERM_DSN might be assigned a value such as:
IBMAPC.IBMAPCA.JOB6734.D14.?
On CMS, &SYSTERM_DSN might be assigned a value such as:
TERMINAL
Notes:
1. If the TERM user exit provides the terminal data set information then the value
in &SYSTERM_DSN is the value extracted from the Exit-Specific Information
block described in the HLASM Programmer's Guide.
2. The value of the type attribute of &SYSTERM_DSN (T'&SYSTERM_DSN) is
always U.
3. The value of the count attribute of &SYSTERM_DSN (K'&SYSTERM_DSN) is
equal to the number of characters assigned as a value to &SYSTERM_DSN.
294 HLASM V1R5 Language Reference