Parameters

AREA=

Specifies the address of the area in the dump to be obtained. If AREA=address is specified, then BASE= and REF= must be specified if this is the first expansion of ABNGET in this module.

BASE=

Specifies the base register to be used in performing the calculation of the address specified for AREA.

REF=

Specifies the label in the control block which the BASE register points to.

WREG=

Specifies a work register to be used during the address calculation. If not specified, it defaults to R1. The address calculation is done as follows:

LA&tab;WREG,AREA-REF
ALR&tab;WREG,BASE

where the values of WREG, AREA, REF, and BASE are symbolically substituted in the above instructions.

The values specified for BASE and REF are saved in global assembler variables. If on an invocation of ABNGET, BASE or REF is not specified, then it will default to its last specified value.

The values specified for BASE and WREG must be different.

Registers 0, 1, 14, and 15 are changed by the macro and should not be specified for BASE.

ERROR=

Specifies the address of a routine to which control returns when: (1) IPCS cannot retrieve the requested address from a dump; or (2) during JES3 abend formatting, the specified area was not obtained or the area does not have the JES3 storage protection key.

NORMAL=

This parameter specifies that after the macro processing routine executes, the issuing program can resume execution at an instruction other than the instruction that immediately follows the macro.