HLASM Language Reference
HLASM Language Reference HLASM Language Reference
EXITCTL Instruction sequence_symbol is a sequence symbol. exit_type identifies the type of exit to which this EXITCTL instruction applies. Exit_type must have one of the following values: SOURCE Sets the exit-control parameters for the user-supplied exit module specified in the INEXIT suboption of the EXIT assembler option. LIBRARY Sets the exit-control parameters for the user-supplied exit module specified in the LIBEXIT suboption of the EXIT assembler option. LISTING Sets the exit-control parameters for the user-supplied exit module specified in the PRTEXIT suboption of the EXIT assembler option. PUNCH Sets the exit-control parameters for the user-supplied exit module specified in the OBJEXIT suboption of the EXIT assembler option when it is called to process the object module records generated when the DECK assembler option is specified. OBJECT (MVS and CMS) Sets the exit-control parameters for the user-supplied exit module specified in the OBJEXIT suboption of the EXIT assembler option when it is called to process the object module records generated when the OBJECT or GOFF assembler option is specified. ADATA Sets the exit-control parameters for the user-supplied exit module specified in the ADEXIT suboption of the EXIT assembler option. TERM Sets the exit-control parameters for the user-supplied exit module specified in the TRMEXIT suboption of the EXIT assembler option. control_value is the value to which the corresponding exit-control parameter should be set. For each exit type, the assembler maintains four exit-control parameters known as EXITCTL_1, EXITCTL_2, EXITCTL_3, and EXITCTL_4. Therefore, up to four values may be specified. Which exit-control parameter is set is determined by the position of the value in the operand of the instruction. You must code a comma in the operand for each omitted value. If specified, control_value must be either: A decimal self-defining term with a value in the range −2 31 to +2 31 −1. An expression in the form ±n, where is the current value of the corresponding exit-control parameter to which n, a decimal self-defining term, is added or from which n is subtracted. The value of the result of adding n to or subtracting n from the current exit-control parameter value must be in the range −2 31 to +2 31 −1. If control_value is omitted, the corresponding exit-control parameter retains its current value. The following example shows how to set the exit-control parameters EXITCTL_1 and EXITCTL_3 for the LISTING exit without affecting the contents of the other exit-control parameters: EXITCTL LISTING,256,,+128 See the HLASM Programmer's Guide for information about how EXITCTL values are passed to each type of exit. The assembler initializes all exit-control parameters to binary zeros. 188 HLASM V1R5 Language Reference
EXTRN Instruction EXTRN Instruction The EXTRN instruction identifies symbols referred to in a source module but defined in another source module. These symbols are external symbols. ┌─,───────────────┐ ►►──┬─────────────────┬──EXTRN─── ▼ ─external_symbol─┴────────────────►◄ └─sequence_symbol─┘ sequence_symbol is a sequence symbol. external_symbol is a relocatable symbol that: Is a valid symbol Is not used as the name entry of a source statement in the source module in which it is defined Up to 65535 individual control sections, external symbols, and external dummy sections can be defined in a source module. However, the practical maximum number depends on the amount of table storage available during link-editing. The assembler lists each external symbol identified in a source module in the external symbol dictionary, along with entries for entry symbols, common control sections, parts, and external control sections. External symbols have a length attribute of 1. See also “WXTRN Instruction” on page 229. ICTL Instruction The ICTL instruction changes the begin, end, and continue columns that establish the coding format of the assembler language source statements. ►►──ICTL──begin──┬─────────────────────┬───────────────────────────►◄ └─,end─┬───────────┬──┘ └─,continue─┘ begin specifies the begin column of the source statement. It must be a decimal self-defining term within the range of 1 to 40, inclusive. end specifies the end column of the source statement. When end is specified it must be a decimal self-defining term within the range of 41 to 80, inclusive. It must be not less than begin +5, and must be greater than continue. If end is not specified, it is assumed to be 71. continue specifies the continue column of the source statement. When specified, continue must be a decimal self-defining term within the range of 2 to 40, and it Chapter 5. Assembler Instruction Statements 189
- 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 206 and 207: EQU Instruction 5. The length attri
- 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
- Page 256 and 257: Part 3. Macro Language &SYSDATC Sys
EXITCTL Instruction<br />
sequence_symbol<br />
is a sequence symbol.<br />
exit_type<br />
identifies the type of exit to which this EXITCTL instruction applies. Exit_type<br />
must have one of the following values:<br />
SOURCE Sets the exit-control parameters for the user-supplied exit module<br />
specified in the INEXIT suboption of the EXIT assembler option.<br />
LIBRARY Sets the exit-control parameters for the user-supplied exit module<br />
specified in the LIBEXIT suboption of the EXIT assembler option.<br />
LISTING Sets the exit-control parameters for the user-supplied exit module<br />
specified in the PRTEXIT suboption of the EXIT assembler option.<br />
PUNCH Sets the exit-control parameters for the user-supplied exit module<br />
specified in the OBJEXIT suboption of the EXIT assembler option<br />
when it is called to process the object module records generated<br />
when the DECK assembler option is specified.<br />
OBJECT (MVS and CMS)<br />
Sets the exit-control parameters for the user-supplied exit module<br />
specified in the OBJEXIT suboption of the EXIT assembler option<br />
when it is called to process the object module records generated<br />
when the OBJECT or GOFF assembler option is specified.<br />
ADATA Sets the exit-control parameters for the user-supplied exit module<br />
specified in the ADEXIT suboption of the EXIT assembler option.<br />
TERM Sets the exit-control parameters for the user-supplied exit module<br />
specified in the TRMEXIT suboption of the EXIT assembler option.<br />
control_value<br />
is the value to which the corresponding exit-control parameter should be set.<br />
For each exit type, the assembler maintains four exit-control parameters known<br />
as EXITCTL_1, EXITCTL_2, EXITCTL_3, and EXITCTL_4. Therefore, up to<br />
four values may be specified. Which exit-control parameter is set is determined<br />
by the position of the value in the operand of the instruction. You must code a<br />
comma in the operand for each omitted value. If specified, control_value must<br />
be either:<br />
A decimal self-defining term with a value in the range −2 31 to +2 31 −1.<br />
An expression in the form ±n, where is the current value of the<br />
corresponding exit-control parameter to which n, a decimal self-defining<br />
term, is added or from which n is subtracted. The value of the result of<br />
adding n to or subtracting n from the current exit-control parameter value<br />
must be in the range −2 31 to +2 31 −1.<br />
If control_value is omitted, the corresponding exit-control parameter retains its<br />
current value.<br />
The following example shows how to set the exit-control parameters EXITCTL_1<br />
and EXITCTL_3 for the LISTING exit without affecting the contents of the other<br />
exit-control parameters:<br />
EXITCTL LISTING,256,,+128<br />
See the <strong>HLASM</strong> Programmer's Guide for information about how EXITCTL values<br />
are passed to each type of exit.<br />
The assembler initializes all exit-control parameters to binary zeros.<br />
188 <strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>