HLASM Language Reference

HLASM Language Reference HLASM Language Reference

faculty.cs.niu.edu
from faculty.cs.niu.edu More from this publisher
22.02.2015 Views

&SYSPARM System Variable Symbol Notes: 1. The value of the type attribute of &SYSOPT_XOBJECT (T'&SYSOPT_XOBJECT) is always N. 2. The value of the count attribute (K'&SYSOPT_XOBJECT) is always 1. &SYSPARM System Variable Symbol The &SYSPARM system variable is assigned a read-only value from the assembler option SYSPARM. It is treated as a global-scope SETC symbol in a source module except that its value cannot be changed. (Refer to chapter 3 of the Programmer's Guide for information on assembler options.) Notes: 1. The largest value that &SYSPARM can hold is 1024 characters. However, if the PARM field of the EXEC statement is used to specify its value, the PARM field restrictions reduce its maximum possible length. 2. No values are substituted for variable symbols in the specified value, however, on MVS and VSE, you must use double ampersands to represent a single ampersand. 3. On MVS and VSE, you must use two single quotation marks to represent a single quotation mark, because the entire EXEC PARM field is enclosed in single quotation marks. 4. If the SYSPARM assembler option is not specified, &SYSPARM is assigned the default value that was specified when the assembler was installed on your system. If a default value for SYSPARM was not specified when the assembler was installed on your system, &SYSPARM is assigned a value of the null character string. 5. The value of the type attribute of &SYSPARM (T'&SYSPARM) is U, unless &SYSPARM is assigned a null value, in which case the value of the type attribute is O. 6. The value of the count attribute (K'&SYSPARM) is the number of characters assigned as a value to &SYSPARM. If &SYSPARM is assigned a null character string, the value of the count attribute is 0. 7. If the SYSPARM option is passed to the assembler via the ASMAOPT file (CMS and MVS) or Librarian member (VSE) and the option contains imbedded spaces, it must be enclosed in quotes. &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 MVS 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. 286 HLASM V1R5 Language Reference

&SYSPRINT_DSN System Variable Symbol 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: Figure 72. Contents of &SYSPRINT_DSN on CMS SYSPRINT Allocated To: CMS file Dummy file (no physical I/O) Printer Labeled tape file Contents of &SYSPRINT_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 When the assembler runs on VSE, the value of the character string assigned to &SYSPRINT_DSN is determined as follows: Figure 73. Contents of &SYSPRINT_DSN on 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 MVS, &SYSPRINT_DSN might be assigned a value such as: IBMAPC.IBMAPCA.JOB6734.D12.? 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 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. Chapter 7. How to Specify Macro Definitions 287

&SYSPARM System Variable Symbol<br />

Notes:<br />

1. The value of the type attribute of &SYSOPT_XOBJECT<br />

(T'&SYSOPT_XOBJECT) is always N.<br />

2. The value of the count attribute (K'&SYSOPT_XOBJECT) is always 1.<br />

&SYSPARM System Variable Symbol<br />

The &SYSPARM system variable is assigned a read-only value from the assembler<br />

option SYSPARM. It is treated as a global-scope SETC symbol in a source module<br />

except that its value cannot be changed. (Refer to chapter 3 of the Programmer's<br />

Guide for information on assembler options.)<br />

Notes:<br />

1. The largest value that &SYSPARM can hold is 1024 characters. However, if<br />

the PARM field of the EXEC statement is used to specify its value, the PARM<br />

field restrictions reduce its maximum possible length.<br />

2. No values are substituted for variable symbols in the specified value, however,<br />

on MVS and VSE, you must use double ampersands to represent a single<br />

ampersand.<br />

3. On MVS and VSE, you must use two single quotation marks to represent a<br />

single quotation mark, because the entire EXEC PARM field is enclosed in<br />

single quotation marks.<br />

4. If the SYSPARM assembler option is not specified, &SYSPARM is assigned the<br />

default value that was specified when the assembler was installed on your<br />

system.<br />

If a default value for SYSPARM was not specified when the assembler was<br />

installed on your system, &SYSPARM is assigned a value of the null character<br />

string.<br />

5. The value of the type attribute of &SYSPARM (T'&SYSPARM) is U, unless<br />

&SYSPARM is assigned a null value, in which case the value of the type<br />

attribute is O.<br />

6. The value of the count attribute (K'&SYSPARM) is the number of characters<br />

assigned as a value to &SYSPARM. If &SYSPARM is assigned a null character<br />

string, the value of the count attribute is 0.<br />

7. If the SYSPARM option is passed to the assembler via the ASMAOPT file<br />

(CMS and MVS) or Librarian member (VSE) and the option contains imbedded<br />

spaces, it must be enclosed in quotes.<br />

&SYSPRINT_DSN System Variable Symbol<br />

Use &SYSPRINT_DSN in a macro definition to obtain the name of the data set to<br />

which the assembler writes the assembler listing.<br />

The local-scope system variable symbol &SYSPRINT_DSN is assigned a read-only<br />

value each time a macro definition is called.<br />

When the assembler runs on the MVS operating systems, the value of the<br />

character string assigned to &SYSPRINT_DSN is always the value stored in the<br />

JFCB for SYSPRINT. If SYSPRINT is allocated to DUMMY, or a NULLFILE, the<br />

value in &SYSPRINT_DSN is NULLFILE.<br />

286 <strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!