HLASM Language Reference
HLASM Language Reference HLASM Language Reference
EQU Instruction 5. The length attribute value described in cases 2, 3, and 4 above is the assembly-time value of the attribute. For more information about the length attribute value, see “Symbol Length Attribute Reference” on page 38. For example: X DS CL8 X has length attribute 8 Y EQU X,4 Y has length attribute 4 expression_3 represents a value that the assembler assigns as a type attribute value to the symbol in the name field. It is optional, but, if specified, it must be an absolute value in the range 0 to 255. All symbols appearing in expression_3 must have been previously defined, and all expressions in expression_3 must be evaluatable when the EQU statement is processed. If expression_3 is omitted, the assembler assigns a type attribute value of U to the symbol, which means the symbol in the name field has an undefined (or unknown or unassigned) type attribute. See the general discussion about data attributes on page 324, and “Type Attribute (T')” on page 328. For example: A DS D A has type attribute D B EQU A,,C'X' B has type attribute X | expression_4 | represents a value that the assembler assigns as a program type value to the | symbol in the name field. It is optional. It can be specified as a decimal, | character, hex or binary self-defining term and is stored as a 4-byte (32-bit) | number; all four bytes are printed in the program listings opposite the symbol. | The value is not used in any way by the assembler, and may be queried by | using the SYSATTRP built-in function. | All symbols appearing in expression_4 must have been previously defined, and | all expressions in expression_4 must be evaluatable when the EQU statement | is processed. | If expression_4 is omitted, the assembler assigns a null to the program type, | and querying the value using the SYSATTRP built-in function returns a null | value. | expression_5 | represents a character value from 1-4 bytes in length, that the assembler | assigns as an assembler type value to the symbol in the name field. It is | optional. It is stored as a 4-byte string; all four bytes are printed in the program | listings opposite the symbol. The value is used by the assembler when | type-checking has been activated, and may be queried by using the | SYSATTRA built-in function. | Valid values for this expression are: 186 HLASM V1R5 Language Reference
EXITCTL Instruction | AR Register - Access | CR Register - Control | CR32 Register - Control 32-bit | CR64 Register - Control 64-bit | FPR Register - Floating-Point | GR Register - General | GR32 Register - General 32-bit | GR64 Register - General 64-bit | If expression_5 is omitted, the assembler assigns a null value to the assembler | type, and querying the value using the SYSATTRA build-in function returns a | null value. The EQU instruction can be used anywhere in a source module after the ICTL instruction. Note, however, that the EQU instruction will initiate an unnamed control section (private code) if it is specified before the first control section. Using Conditional Assembly Values The following rules describe when you can use the value, length attribute value, or type attribute value of an equated symbol in conditional assembly statements: If you want to use the value of the symbol in conditional assembly statements, then: – The EQU statement that defines the symbol must be processed by the assembler before the conditional assembly statement that refers to the symbol. – The symbol in the name field of the EQU statement must be an ordinary symbol. – Expression_1 must be an absolute expression, and must contain only self-defining terms or previously defined symbols. If only expression_1 is specified, the assembler assigns a value of 1 to the length attribute, and a value of U to the type attribute of the symbol during conditional assembly. You can use these values in conditional assembly statements, although references to the length attribute may be flagged. If you specify expression_2 or expression_3 and you want to use the explicit attribute value during conditional assembly processing, then: – The symbol in the name field must be an ordinary symbol. – The expression must contain only self-defining terms. EXITCTL Instruction The EXITCTL instruction sets or modifies the contents of the four signed fullword exit-control parameters that the assembler maintains for each type of exit. ►►──┬─────────────────┬──EXITCTL────────────────────────────────────► └─sequence_symbol─┘ ┌ ────────────────────────┐ ►──exit_type── ▼ ─,──┬───────────────┬ ── (1) ─┴────────────────────────────►◄ └─control_value─┘ Note: 1 From one to four values to be supplied. Chapter 5. Assembler Instruction Statements 187
- Page 156 and 157: DC Instruction | Symbols used in su
- Page 158 and 159: DC Instruction The length attribute
- Page 160 and 161: DC Instruction Notes: 1. Don't conf
- Page 162 and 163: DC Instruction—Character Constant
- Page 164 and 165: DC Instruction—Character Constant
- Page 166 and 167: DC Instruction—Graphic Constant r
- Page 168 and 169: DC Instruction—Fixed-Point Consta
- Page 170 and 171: DC Instruction—Fixed-Point Consta
- Page 172 and 173: DC Instruction—Decimal Constants
- Page 174 and 175: DC Instruction—Address Constants
- Page 176 and 177: DC Instruction—Address Constants
- Page 178 and 179: DC Instruction—Offset Constant re
- Page 180 and 181: DC Instruction—Length Constant Le
- Page 182 and 183: DC Instruction—Hexadecimal Floati
- Page 184 and 185: DC Instruction—Hexadecimal Floati
- Page 186 and 187: DC Instruction—Hexadecimal Floati
- Page 188 and 189: DC Instruction—Binary Floating-Po
- Page 190 and 191: DC Instruction—Binary Floating-Po
- Page 192 and 193: DROP Instruction DROP Instruction T
- Page 194 and 195: DS Instruction USING DSECTA,14 ALBL
- Page 196 and 197: DS Instruction The size of a storag
- Page 198 and 199: DSECT Instruction DSECT Instruction
- Page 200 and 201: DXD Instruction ASEMBLY2 CSECT USIN
- Page 202 and 203: END Instruction change but no addit
- Page 204 and 205: EQU Instruction EQU Instruction The
- Page 208 and 209: EXITCTL Instruction sequence_symbol
- Page 210 and 211: ISEQ Instruction must be greater th
- Page 212 and 213: LOCTR Instruction A CSECT , See not
- Page 214 and 215: LTORG Instruction If symbol is an o
- Page 216 and 217: MNOTE Instruction When two literals
- Page 218 and 219: OPSYN Instruction ,ERROR, SEV 1 An
- Page 220 and 221: ORG Instruction AFTER is defined in
- Page 222 and 223: ORG Instruction If you specify mult
- Page 224 and 225: POP Instruction POP Instruction The
- Page 226 and 227: PRINT Instruction Note: If the next
- Page 228 and 229: Process Statement Process Statement
- Page 230 and 231: REPRO Instruction NOPRINT instructs
- Page 232 and 233: RSECT Instruction 4. AMODE or RMODE
- Page 234 and 235: START Instruction START Instruction
- Page 236 and 237: TITLE Instruction The name value is
- Page 238 and 239: USING Instruction Only the characte
- Page 240 and 241: USING Instruction Base Registers fo
- Page 242 and 243: USING Instruction If register 0 is
- Page 244 and 245: USING Instruction A variable symbo
- Page 246 and 247: USING Instruction In this MVC instr
- Page 248 and 249: USING Instruction Range of a Depend
- Page 250 and 251: XATTR Instruction external_symbol i
- Page 252 and 253: XATTR Instruction SCOPE ►►─
- Page 254 and 255: XATTR Instruction 234 HLASM V1R5 La
EXITCTL Instruction<br />
| AR Register - Access<br />
| CR Register - Control<br />
| CR32 Register - Control 32-bit<br />
| CR64 Register - Control 64-bit<br />
| FPR Register - Floating-Point<br />
| GR Register - General<br />
| GR32 Register - General 32-bit<br />
| GR64 Register - General 64-bit<br />
| If expression_5 is omitted, the assembler assigns a null value to the assembler<br />
| type, and querying the value using the SYSATTRA build-in function returns a<br />
| null value.<br />
The EQU instruction can be used anywhere in a source module after the ICTL<br />
instruction. Note, however, that the EQU instruction will initiate an unnamed control<br />
section (private code) if it is specified before the first control section.<br />
Using Conditional Assembly Values<br />
The following rules describe when you can use the value, length attribute value, or<br />
type attribute value of an equated symbol in conditional assembly statements:<br />
If you want to use the value of the symbol in conditional assembly statements,<br />
then:<br />
– The EQU statement that defines the symbol must be processed by the<br />
assembler before the conditional assembly statement that refers to the<br />
symbol.<br />
– The symbol in the name field of the EQU statement must be an ordinary<br />
symbol.<br />
– Expression_1 must be an absolute expression, and must contain only<br />
self-defining terms or previously defined symbols.<br />
If only expression_1 is specified, the assembler assigns a value of 1 to the<br />
length attribute, and a value of U to the type attribute of the symbol during<br />
conditional assembly. You can use these values in conditional assembly<br />
statements, although references to the length attribute may be flagged.<br />
If you specify expression_2 or expression_3 and you want to use the explicit<br />
attribute value during conditional assembly processing, then:<br />
– The symbol in the name field must be an ordinary symbol.<br />
– The expression must contain only self-defining terms.<br />
EXITCTL Instruction<br />
The EXITCTL instruction sets or modifies the contents of the four signed fullword<br />
exit-control parameters that the assembler maintains for each type of exit.<br />
►►──┬─────────────────┬──EXITCTL────────────────────────────────────►<br />
└─sequence_symbol─┘<br />
┌<br />
────────────────────────┐<br />
►──exit_type── ▼ ─,──┬───────────────┬ ──<br />
(1) ─┴────────────────────────────►◄<br />
└─control_value─┘<br />
Note:<br />
1<br />
From one to four values to be supplied.<br />
Chapter 5. Assembler Instruction Statements 187