HLASM Language Reference
HLASM Language Reference HLASM Language Reference
START Instruction START Instruction The START instruction can be used to initiate the first or only control section of a source module, and optionally to set an initial location counter value. ►►──┬────────┬──START──┬────────────┬──────────────────────────────►◄ └─symbol─┘ └─expression─┘ symbol 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 A sequence symbol expression is an absolute expression, the value of which the assembler uses to set the location counter to an initial value for the source module. Any symbols referenced in expression must have been previously defined. The START instruction must be the first instruction of the first executable control section of a source module. It must not be preceded by any instruction that affects the location counter, and thereby causes the first control section to be initiated. Use the START instruction to initiate the first or only control section of a source module, because it: Determines exactly where the first control section is to begin, thus avoiding the accidental initiation of the first control section by some other instruction. Gives a symbolic name to the first control section, which can then be distinguished from the other control sections listed in the external symbol dictionary. Specifies the initial setting of the location counter for the first or only control section. If symbol denotes an ordinary symbol, the ordinary symbol identifies the first control section. It must be used in the name field of any CSECT instruction that indicates the continuation of the first control section. The ordinary symbol denoted by symbol represents the address of the first byte in the control section, and has a length attribute value of 1. If symbol is not specified, or if name is a sequence symbol, the START instruction initiates an unnamed control section. The assembler uses the value expression in the operand field, if specified, to set the location counter to an initial value for the source module. All control sections | are aligned on the boundary specified by the SECTALGN option. Therefore, if the | value specified in expression is not divisible by the SECTALGN value, the | assembler sets the initial value of the location counter to the next higher required boundary. If expression is omitted, the assembler sets the initial value to 0. 214 HLASM V1R5 Language Reference
TITLE Instruction The source statements that follow the START instruction are assembled into the first control section. If a CSECT instruction indicates the continuation of the first control section, the source statements that follow this CSECT instruction are also assembled into the first control section. Any instruction that defines a new or continued control section marks the end of the preceding control section. The END instruction marks the end of the control section in effect. TITLE Instruction The TITLE instruction: Provides headings for each page of the source and object section of the assembler listing. If the first statement in your source program is an ICTL instruction or a *PROCESS statement then the title is not printed on the first page of the Source and Object section, because each of these instructions must precede all other instructions. Identifies the assembly output records of your object modules. You can specify up to 8 identification characters that the assembler includes as a deck ID in all object records, beginning at byte 73. If the deck ID is less than 8 characters, the assembler puts sequence numbers in the remaining bytes up to byte 80. ►►──┬──────┬──TITLE──title_string──────────────────────────────────►◄ └─name─┘ name You can specify name only once in the source module. It is one of the following: A string of printable characters A variable symbol that has been assigned a string of printable characters A combination of the above A sequence symbol Except when the name is a sequence symbol, the assembler uses the first 8 characters you specify, and discards the remaining characters without warning. title_string is a string of 1 to 100 characters enclosed in single quotation marks If two or more TITLE instructions are together, the title provided by the last instruction is printed as the heading. Deck ID in Object Records When you specify the name, and it is not a sequence symbol, it has a special significance. The assembler uses the name value to generate the deck ID in object records. The deck ID is placed in the object records starting at byte 73. It is not generated for records produced by the PUNCH and REPRO instructions. The name value does not need to be on the first TITLE instruction. Chapter 5. Assembler Instruction Statements 215
- 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 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 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
- Page 258 and 259: Introduction to Macro Language Chap
- Page 260 and 261: Introduction to Macro Language The
- Page 262 and 263: Introduction to Macro Language Macr
- Page 264 and 265: MACRO and MEND Statements The assem
- Page 266 and 267: Prototype Statement Macros that are
- Page 268 and 269: Model Statements generated from tha
- Page 270 and 271: Model Statements ▌5▐ ▌6▐
- Page 272 and 273: Model Statements Notes: 1. You can
- Page 274 and 275: Positional Parameters Symbolic para
- Page 276 and 277: Processing Statements Processing St
- Page 278 and 279: AREAD Instruction Assign Local Time
- Page 280 and 281: COPY Instruction sequence_symbol is
- Page 282 and 283: System Variable Symbols System Vari
START Instruction<br />
START Instruction<br />
The START instruction can be used to initiate the first or only control section of a<br />
source module, and optionally to set an initial location counter value.<br />
►►──┬────────┬──START──┬────────────┬──────────────────────────────►◄<br />
└─symbol─┘<br />
└─expression─┘<br />
symbol<br />
is one of the following:<br />
An ordinary symbol<br />
A variable symbol that has been assigned a character string with a value<br />
that is valid for an ordinary symbol<br />
A sequence symbol<br />
expression<br />
is an absolute expression, the value of which the assembler uses to set the<br />
location counter to an initial value for the source module.<br />
Any symbols referenced in expression must have been previously defined.<br />
The START instruction must be the first instruction of the first executable control<br />
section of a source module. It must not be preceded by any instruction that affects<br />
the location counter, and thereby causes the first control section to be initiated.<br />
Use the START instruction to initiate the first or only control section of a source<br />
module, because it:<br />
Determines exactly where the first control section is to begin, thus avoiding the<br />
accidental initiation of the first control section by some other instruction.<br />
Gives a symbolic name to the first control section, which can then be<br />
distinguished from the other control sections listed in the external symbol<br />
dictionary.<br />
Specifies the initial setting of the location counter for the first or only control<br />
section.<br />
If symbol denotes an ordinary symbol, the ordinary symbol identifies the first control<br />
section. It must be used in the name field of any CSECT instruction that indicates<br />
the continuation of the first control section. The ordinary symbol denoted by<br />
symbol represents the address of the first byte in the control section, and has a<br />
length attribute value of 1.<br />
If symbol is not specified, or if name is a sequence symbol, the START instruction<br />
initiates an unnamed control section.<br />
The assembler uses the value expression in the operand field, if specified, to set<br />
the location counter to an initial value for the source module. All control sections<br />
| are aligned on the boundary specified by the SECTALGN option. Therefore, if the<br />
| value specified in expression is not divisible by the SECTALGN value, the<br />
| assembler sets the initial value of the location counter to the next higher required<br />
boundary. If expression is omitted, the assembler sets the initial value to 0.<br />
214 <strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>
Change language