HLASM Language Reference

AGO Instruction
The extended AIF instruction is exactly equivalent to n successive AIF statements.
The branch is taken to the first sequence symbol (scanning left to right) whose
corresponding logical expression is true. If none of the logical expressions is true,
no branch is taken.
Example:
Cont.
AIF ('&L'(&C,1) EQ '$').DOLR, X
('&L'(&C,1) EQ '#').POUND,
X
('&L'(&C,1) EQ '@').AT,
X
('&L'(&C,1) EQ '=').EQUAL,
X
('&L'(&C,1) EQ '(').LEFTPAR,
X
('&L'(&C,1) EQ '+').PLUS,
X
('&L'(&C,1) EQ '-').MINUS
This statement looks for the occurrence of a $, #, @, =, (, +, and -, in that order;
and causes control to branch to .DOLR, .POUND, .AT, .EQUAL, .LEFTPAR, .PLUS, and
.MINUS, respectively, if the string being examined contains any of these characters
at the position designated by &C.
Alternative Format for AIF Instruction
The alternative statement format is allowed for extended AIF instructions. This
format is illustrated in the above example.
AIFB—Synonym of the AIF Instruction
For compatibility with some earlier assemblers, High Level Assembler supports the
AIFB symbolic operation code as a synonym of the AIF instruction. However, you
should not use the AIFB instruction in new applications as support for it might be
removed in the future.
AGO Instruction
The AGO instruction branches unconditionally. You can thus alter the sequence in
which your assembler language statements are processed. This provides you with
final exits from conditional assembly loops.
►►──┬─────────────────┬──AGO──sequence_symbol──────────────────────►◄
└─sequence_symbol─┘
sequence_symbol
is a sequence symbol.
The statement named by the sequence symbol in the operand field is the next
statement processed by the assembler.
The statement identified by a sequence symbol referred to in the AGO instruction
can appear before or after the AGO instruction. However, the statement must
appear within the local scope of the sequence symbol. Thus, the statement
identified by the sequence symbol must appear:
In open code, if the corresponding AGO instruction appears in open code
In the same macro definition in which the corresponding AGO instruction
appears.
392 HLASM V1R5 Language Reference