HLASM Language Reference

ORG Instruction
►►──┬────────┬──ORG─────────────────────────────────────────────────►
└─symbol─┘
►──┬────────────────────────────────────────────────┬──────────────►◄
| └─expression──┬────────────────────────────────┬─┘
| └─,──┬─boundary──┬───────────┬─┬─┘
| │ └─,──offset─┘
│
| └─,──offset───────────────┘
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
If symbol denotes an ordinary symbol, the ordinary symbol is defined with the
value that the location counter had before the ORG statement is processed.
expression
is a relocatable expression, the value of which is used to set the location
counter. If expression is omitted, the location counter is set to the next
available location for the current control section.
| boundary
| is an absolute expression that must be a power of 2 with a range from 8
| (doubleword) to 4096 (page). If boundary exceeds the SECTALGN value,
| message ASMA500E is issued.
| offset
| Any absolute expression
| If boundary or offset are provided, then the resultant location counter is calculated
| by rounding the expression up to the next higher boundary and then adding the
| offset value.
In general, symbols used in expression need not have been previously defined.
However, the relocatable component of expression (that is, the unpaired relocatable
term) must have been previously defined in the same control section in which the
ORG statement appears, or be equated to a previously defined value.
A length attribute reference to the name of a ORG instruction is always invalid.
Message ASMS042E is issued, and a default value of 1 is assigned.
An ORG statement cannot be used to specify a location below the beginning of the
control section in which it appears. For example, the following statement is not
correct if it appears less than 500 bytes from the beginning of the current control
section.
ORG
–5
This is because the expression specified is negative, and sets the location counter
to a value larger than the assembler can process. The location counter wraps
around (the location counter is discussed in detail in “Location Counter” on
page 36).
Chapter 5. Assembler Instruction Statements 201