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

&SYSSTEP System Variable Symbol Notes: 1. The value of the type attribute of &SYSSEQF (T'&SYSSEQF) is U, unless &SYSSEQF is assigned a null character string, in which case the value of the type attribute is O. 2. The value of the count attribute of &SYSSEQF (K'&SYSSEQF) is equal to the number of characters assigned as a value to &SYSSEQF. If &SYSSEQF is assigned a null character string, the value of the count attribute is 0. 3. Throughout the use of a macro definition, the value of &SYSSEQF is considered a constant. &SYSSTEP System Variable Symbol Use &SYSSTEP to obtain the stepname of the job step used to assemble your source module. &SYSSTEP has a global scope. On CMS and VSE the value of &SYSSTEP is always (NOSTEP). Notes: 1. The value of the type attribute of &SYSSTEP (T'&SYSSTEP) is always U. 2. The value of the count attribute (K'&SYSSTEP) is the number of characters assigned. &SYSSTMT System Variable Symbol Use &SYSSTMT to obtain the next statement number that is assigned to a statement by the assembler. &SYSSTMT has a global scope. The value assigned to &SYSSTMT is an 8-character string, padded on the left with leading zero (X'F0') characters. The following example shows the value assigned to &SYSSTMT. It assumes that the DC statement is in open code, and is the 23rd statement in the source module. 23 DC C'&SYSSTMT' + DC C'24' Notes: 1. The value of the type attribute of &SYSSTMT (T'&SYSSTMT) is always N. 2. The value of the count attribute of &SYSSTMT (K'&SYSSTMT) is always 8. &SYSSTYP System Variable Symbol Use &SYSSTYP in a macro definition to generate the type of the current control section. The current control section is the control section in which the macro instruction that calls the definition appears. The local-scope system variable symbol &SYSSTYP is assigned a read-only value each time a macro definition is called. The value assigned is the symbol that represents the type of the current control section in effect when the macro is called. A control section that has been initiated or continued by substitution does not affect the value of &SYSSTYP for the expansion of the current macro. However, it does affect &SYSSTYP for a subsequent macro call. Nested macros cause the assembler to assign a value to 292 HLASM V1R5 Language Reference

&SYSTEM_ID System Variable Symbol &SYSSTYP that depends on the control section in force inside the calling macro when the inner macro is called. The control section whose type is assigned to &SYSSTYP can be defined by a program sectioning statement. This can be a START, CSECT, RSECT, DSECT, or COM statement, or, for the first control section, any instruction described in “First Section” on page 54. Depending upon the instruction used to initiate the current control section, the value assigned to &SYSSTYP is either CSECT, RSECT, DSECT, or COM. If the current control section is an executable control section initiated by other than a CSECT or RSECT instruction, the value assigned to &SYSSTYP is CSECT. If a control section has not been initiated, &SYSSTYP is assigned a null character string. Notes: 1. The value of the type attribute of &SYSSTYP (T'&SYSSTYP) is U, unless &SYSSTYP is assigned a null character string, in which case the value of the type attribute is O. 2. The value of the count attribute of &SYSSTYP (K'&SYSSTYP) is equal to the number of characters assigned as a value to &SYSSTYP. If &SYSSTYP is assigned a null character string, the value of the count attribute is 0. 3. Throughout the use of a macro definition, the value of &SYSSTYP is considered a constant. &SYSTEM_ID System Variable Symbol Use &SYSTEM_ID to obtain the name and release of the operating system under which your source module is being assembled. &SYSTEM_ID has a global scope. For example, on MVS, &SYSTEM_ID might contain one of the following: z/OS 1.4. z/OS 1.5. ... etc. on CMS, &SYSTEM_ID might contain one of the following: CMS 18 CMS 19 ... etc. on VSE, &SYSTEM_ID might contain one of the following: VSE/AF 6.6. ... etc. Notes: 1. The value of the type attribute of &SYSTEM_ID (T'&SYSTEM_ID) is always U. 2. The value of the count attribute (K'&SYSTEM_ID) is the number of characters assigned. Chapter 7. How to Specify Macro Definitions 293

&SYSSTEP System Variable Symbol<br />

Notes:<br />

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

&SYSSEQF is assigned a null character string, in which case the value of the<br />

type attribute is O.<br />

2. The value of the count attribute of &SYSSEQF (K'&SYSSEQF) is equal to the<br />

number of characters assigned as a value to &SYSSEQF. If &SYSSEQF is<br />

assigned a null character string, the value of the count attribute is 0.<br />

3. Throughout the use of a macro definition, the value of &SYSSEQF is<br />

considered a constant.<br />

&SYSSTEP System Variable Symbol<br />

Use &SYSSTEP to obtain the stepname of the job step used to assemble your<br />

source module. &SYSSTEP has a global scope.<br />

On CMS and VSE the value of &SYSSTEP is always (NOSTEP).<br />

Notes:<br />

1. The value of the type attribute of &SYSSTEP (T'&SYSSTEP) is always U.<br />

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

assigned.<br />

&SYSSTMT System Variable Symbol<br />

Use &SYSSTMT to obtain the next statement number that is assigned to a<br />

statement by the assembler. &SYSSTMT has a global scope.<br />

The value assigned to &SYSSTMT is an 8-character string, padded on the left with<br />

leading zero (X'F0') characters. The following example shows the value assigned<br />

to &SYSSTMT. It assumes that the DC statement is in open code, and is the 23rd<br />

statement in the source module.<br />

23 DC C'&SYSSTMT'<br />

+ DC C'24'<br />

Notes:<br />

1. The value of the type attribute of &SYSSTMT (T'&SYSSTMT) is always N.<br />

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

&SYSSTYP System Variable Symbol<br />

Use &SYSSTYP in a macro definition to generate the type of the current control<br />

section. The current control section is the control section in which the macro<br />

instruction that calls the definition appears.<br />

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

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

The value assigned is the symbol that represents the type of the current control<br />

section in effect when the macro is called. A control section that has been initiated<br />

or continued by substitution does not affect the value of &SYSSTYP for the<br />

expansion of the current macro. However, it does affect &SYSSTYP for a<br />

subsequent macro call. Nested macros cause the assembler to assign a value to<br />

292 <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!