HLASM Language Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


ACTR instruction

HLASM Language Reference
SC26-4940-06

The ACTR instruction sets a conditional assembly branch counter either within a macro definition or in open code. The ACTR instruction can appear anywhere in open code or within a macro definition.

Each time the assembler processes a successful AIF or AGO branching instruction in a macro definition or in open code, the branch counter for that part of the program is decremented by one. When the number of conditional assembly branches reaches the value assigned to the branch counter by the ACTR instruction, the assembler exits from the macro definition or stops processing statements in open code.

By using the ACTR instruction, you avoid excessive looping during conditional assembly processing.
Read syntax diagramSkip visual syntax diagram
>>-+-----------------+--ACTR--arithmetic_expression------------><
   '-sequence_symbol-'                                

sequence_symbol
Is a sequence symbol.
arithmetic_expression
Is an arithmetic expression used to set or reset a conditional assembly branch counter.

A conditional assembly branch counter has a local scope; its value is decremented by AGO and successful AIF instructions, and reassigned only by ACTR instructions that appear within the same scope. Thus, the nesting of macros has no effect on the setting of branch counters in other scopes. The assembler assigns a branch counter for open code and for each macro definition. In the absence of an ACTR instruction, a default value of 4096 is assigned.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014