HLASM Language Reference
HLASM Language Reference HLASM Language Reference
DXD Instruction ASEMBLY2 CSECT USING ,15 USING INAREA,3 CLI INCODE,C'A' BE ATYPE MVC OUTPUTA,DATA_B MVC OUTPUTB,DATA_A B FINISH ATYPE DS H MVC OUTPUTA,DATA_A MVC OUTPUTB,DATA_B FINISH BR 14 DATA_A DC CL8'ADATA' DATA_B DC CL8'BDATA' INAREA DSECT INCODE DS CL1 OUTPUTA DS CL8 OUTPUTB DS CL8 END Figure 54. Sample Code Using the DSECT Instruction (Assembly-2) DXD Instruction The DXD instruction identifies and defines an external dummy section. ►►──symbol──DXD──┬────────────────────┬──type──┬────────────────┬───► └─duplication_factor─┘ └─type_extension─┘ ►──┬──────────┬──┬───────────────────┬─────────────────────────────►◄ └─modifier─┘ │ ┌ ───────────────┐ │ └── ▼ ─nominal_value─┴─┘ symbol is an external symbol which is one of the following: An ordinary symbol A variable symbol that has been assigned a character string with a value that is valid for an ordinary symbol duplication_factor is the duplication factor subfield equivalent to the duplication factor subfield of the DS instruction. type is the type subfield equivalent to the type subfield of the DS instruction. type_extension is the type extension subfield equivalent to the type extension subfield of the DS instruction. modifiers is the modifiers subfield equivalent to the modifiers subfield of the DS instruction. 180 HLASM V1R5 Language Reference
EJECT Instruction nominal_value is the nominal-value subfield equivalent to the nominal-value subfield of the DS instruction. The nominal value is optional. If specified, it is not generated. The DXD instruction can be used anywhere in a source module, after the ICTL instruction. In order to reference the storage defined by the external dummy section, the ordinary symbol denoted by symbol must appear in the operand of a Q-type constant. This symbol represents the address of the first byte of the external dummy section defined, and has a length attribute value of 1. The subfields in the operand field (duplication factor, type, type extension, modifier, and nominal value) are specified in the same way as in a DS instruction. The assembler computes the amount of storage and the alignment required for an external dummy section from the area specified in the operand field. For more information about how to specify the subfields, see “DS Instruction” on page 174. For example: A DXD CL2 2 bytes, byte alignment B DXD 3F,XL4 2 bytes, fullword alignment C DXD LQ 16 bytes, quadword alignment The linker uses the information provided by the assembler to compute the total length of storage required for all external dummy sections specified in a program. Notes: 1. The DSECT instruction also defines an external dummy section, but only if the symbol in the name field appears in a Q-type offset constant in the same source module. Otherwise, a DSECT instruction defines a dummy section. 2. If two or more external dummy sections for different source modules have the same name, the linker uses the most restrictive alignment, and the largest section to compute the total length. EJECT Instruction The EJECT instruction stops the printing of the assembler listing on the current page, and continues the printing on the next page. ►►──┬─────────────────┬──EJECT─────────────────────────────────────►◄ └─sequence_symbol─┘ sequence_symbol is a sequence symbol. The EJECT instruction causes the next line of the assembler listing to be printed at the top of a new page. If the line before the EJECT statement appears at the bottom of a page, the EJECT statement has no effect. An EJECT instruction immediately following another EJECT instruction is ignored. A TITLE instruction immediately following an EJECT instruction causes the title to Chapter 5. Assembler Instruction Statements 181
- Page 150 and 151: DC Instruction Figure 33 (Page 2 of
- Page 152 and 153: DC Instruction With EBCDIC spaces
- Page 154 and 155: DC Instruction Further information
- 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 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 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
EJECT Instruction<br />
nominal_value<br />
is the nominal-value subfield equivalent to the nominal-value subfield of the DS<br />
instruction. The nominal value is optional. If specified, it is not generated.<br />
The DXD instruction can be used anywhere in a source module, after the ICTL<br />
instruction.<br />
In order to reference the storage defined by the external dummy section, the<br />
ordinary symbol denoted by symbol must appear in the operand of a Q-type<br />
constant. This symbol represents the address of the first byte of the external<br />
dummy section defined, and has a length attribute value of 1.<br />
The subfields in the operand field (duplication factor, type, type extension, modifier,<br />
and nominal value) are specified in the same way as in a DS instruction. The<br />
assembler computes the amount of storage and the alignment required for an<br />
external dummy section from the area specified in the operand field. For more<br />
information about how to specify the subfields, see “DS Instruction” on page 174.<br />
For example:<br />
A DXD CL2 2 bytes, byte alignment<br />
B DXD 3F,XL4 2 bytes, fullword alignment<br />
C DXD LQ 16 bytes, quadword alignment<br />
The linker uses the information provided by the assembler to compute the total<br />
length of storage required for all external dummy sections specified in a program.<br />
Notes:<br />
1. The DSECT instruction also defines an external dummy section, but only if the<br />
symbol in the name field appears in a Q-type offset constant in the same<br />
source module. Otherwise, a DSECT instruction defines a dummy section.<br />
2. If two or more external dummy sections for different source modules have the<br />
same name, the linker uses the most restrictive alignment, and the largest<br />
section to compute the total length.<br />
EJECT Instruction<br />
The EJECT instruction stops the printing of the assembler listing on the current<br />
page, and continues the printing on the next page.<br />
►►──┬─────────────────┬──EJECT─────────────────────────────────────►◄<br />
└─sequence_symbol─┘<br />
sequence_symbol<br />
is a sequence symbol.<br />
The EJECT instruction causes the next line of the assembler listing to be printed at<br />
the top of a new page. If the line before the EJECT statement appears at the<br />
bottom of a page, the EJECT statement has no effect.<br />
An EJECT instruction immediately following another EJECT instruction is ignored.<br />
A TITLE instruction immediately following an EJECT instruction causes the title to<br />
Chapter 5. Assembler Instruction Statements 181