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

END Instruction change but no additional page eject is performed. (The TITLE instruction normally forces a page eject.) The EJECT instruction statement itself is not printed in the listing. END Instruction Use the END instruction to end the assembly of a program. You can also supply an address in the operand field to which control can be transferred after the program is loaded. The END instruction must always be the last statement in the source program. ►►──┬─────────────────┬──END──┬────────────┬──┬─────────────┬──────►◄ └─sequence_symbol─┘ └─expression─┘ └─,──language─┘ sequence_symbol is a sequence symbol. expression specifies the point to which control can be transferred when loading of the object program completes. If the GOFF option is in effect this parameter is ignored. This point is usually the address of the first executable instruction in the program, as shown in the following sequence: NAME CSECT AREA DS 5F BEGIN BALR 2, USING ,2 . . . END BEGIN If specified, expression may be generated by substitution into variable symbols. It must be a simply relocatable expression representing an address in the source module delimited by the END instruction, or If it contains an external symbol, the external symbol must be the only term in the expression, or the remaining terms in the expression must reduce to zero. It must not be a literal. language a marker for use by language translators that produce assembly code. The operand has three sub-operands. The values in this operand are copied into the END record in the object deck. The syntax of this operand is (char1,char4,char5) where all three sub-operands, and the commas and parentheses are required. char1 is a one to ten character code. It is intended to be a language translator identifier. char4 must be exactly four characters long. It is intended to be a version and release code. char5 must be exactly five characters long, and 182 HLASM V1R5 Language Reference

ENTRY Instruction should be a date in the format “YYDDD.” It is intended to be the compile date. For example: END ENTRYPT,(MYCOMPILER,11,273) Notes: 1. If the END instruction is omitted, one is generated by the assembler, and message ASMA14W END record missing is issued. 2. Refer to the note on page 341 about lookahead processing, and the effect it has on generated END statements. 3. If the END statement is not the last statement in the input stream, and the BATCH option (see HLASM Programmer's Guide) has been specified, the assembler will initiate assembly of a new source module when the current assembly is completed. ENTRY Instruction The ENTRY instruction identifies symbols defined in one source module so that they can be referred to in another source module. These symbols are entry symbols. ┌─,───────────┐ ►►──┬─────────────────┬──ENTRY─── ▼ ─entry_point─┴────────────────────►◄ └─sequence_symbol─┘ sequence_symbol is a sequence symbol. entry_point is a relocatable symbol that: Is a valid symbol Is defined in an executable control section Is not defined in a dummy control section, a common control section, or an external control section 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 to the program that links the object module. The assembler lists each entry symbol of a source module in an external symbol dictionary, along with entries for external symbols, common control sections, parts, and external control sections. A symbol used as the name entry of a START or CSECT instruction is also automatically considered an entry symbol, and does not have to be identified by an ENTRY instruction. The length attribute value of entry symbols is the same as the length attribute value of the symbol at its point of definition. Chapter 5. Assembler Instruction Statements 183

ENTRY Instruction<br />

should be a date in the format “YYDDD.” It is intended to be the compile date.<br />

For example:<br />

END ENTRYPT,(MYCOMPILER,11,273)<br />

Notes:<br />

1. If the END instruction is omitted, one is generated by the assembler, and<br />

message ASMA14W END record missing is issued.<br />

2. Refer to the note on page 341 about lookahead processing, and the effect it<br />

has on generated END statements.<br />

3. If the END statement is not the last statement in the input stream, and the<br />

BATCH option (see <strong>HLASM</strong> Programmer's Guide) has been specified, the<br />

assembler will initiate assembly of a new source module when the current<br />

assembly is completed.<br />

ENTRY Instruction<br />

The ENTRY instruction identifies symbols defined in one source module so that<br />

they can be referred to in another source module. These symbols are entry<br />

symbols.<br />

┌─,───────────┐<br />

►►──┬─────────────────┬──ENTRY─── ▼ ─entry_point─┴────────────────────►◄<br />

└─sequence_symbol─┘<br />

sequence_symbol<br />

is a sequence symbol.<br />

entry_point<br />

is a relocatable symbol that:<br />

Is a valid symbol<br />

Is defined in an executable control section<br />

Is not defined in a dummy control section, a common control section, or an<br />

external control section<br />

Up to 65535 individual control sections, external symbols, and external dummy<br />

sections can be defined in a source module. However, the practical maximum<br />

number depends on the amount of table storage available to the program that links<br />

the object module.<br />

The assembler lists each entry symbol of a source module in an external symbol<br />

dictionary, along with entries for external symbols, common control sections, parts,<br />

and external control sections.<br />

A symbol used as the name entry of a START or CSECT instruction is also<br />

automatically considered an entry symbol, and does not have to be identified by an<br />

ENTRY instruction.<br />

The length attribute value of entry symbols is the same as the length attribute value<br />

of the symbol at its point of definition.<br />

Chapter 5. Assembler Instruction Statements 183

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!