HLASM Language Reference

LOCTR Instruction
A CSECT , See note 1
LR 12,15
USING A,12
.
B LOCTR , See note 2
.
C LOCTR ,
.
B LOCTR , See note 3
.
A LOCTR , See note 4
.
DUM DSECT , See note 1
C LOCTR , See note 5
.
END
LOCTRs are ordered by their definition order. So in the previous example, the
ordering is A, B and C. When there are statements in LOCTR groups, the code is
generated using currently active USINGs and then moved to the final location.
Notes:
1. The first location counter of a section, class or part is defined by the name of
the START, CSECT, DSECT, RSECT, CATTR or COM instruction defining the
section.
2. The LOCTR instruction defines a location counter.
3. The LOCTR continues a previously defined location counter. A location
counter remains in use until it is interrupted by a LOCTR, CSECT, DSECT, or
COM instruction.
4. A LOCTR instruction with the same name as a control section continues the
first location counter of that section. However, an unnamed LOCTR cannot be
used to continue an unnamed (private code) control section.
5. A LOCTR instruction with the same name as a LOCTR instruction in a previous
control section causes that control section to be continued using the location
counter specified, even though the LOCTR instruction may follow the definition
(or resumption) of a different section.
6. To continue a location counter in an unnamed section, a named location
counter must first be specified for the section by a LOCTR in the unnamed
section.
A control section cannot have the same name as a previous LOCTR instruction. A
LOCTR instruction placed before the first control section definition initiates an
unnamed control section before the LOCTR instruction is processed.
The length attribute of a LOCTR name is 1.
LOCTR instructions do not force alignment; code assembled under a location
counter other than the first location counter of a control section is assembled
starting at the next available byte after the previous segment.
| A LOCTR name may be referenced as an ordinary symbol. If the LOCTR name
| does not match a section name, its value is the location counter value assigned to
| its first appearance, and it may have arbitrary alignment and other attributes. If the
192 HLASM V1R5 Language Reference