Register contents on entry to a recovery routine

The register contents on entry to an ESTAE-type recovery routine are different depending on whether the system supplied and SDWA. The following tables describe the register contents on entry to the recovery routine for both situations.

Table 1. Register Contents—ESTAE-Type Recovery Routine With an SDWA
Register Contents
General Purpose Registers  
GPR 0 A code indicating the type of I/O processing performed:
0
Active I/O has been quiesced and is restorable.
4
Active I/O has been halted and is not restorable.
8
No I/O was active when the abend occurred.
16 (X'10')
No I/O processing was performed.
GPR 1 Address of the SDWA.
GPR 2 One of the following:
  • If you specified the PARM parameter on ESTAE or ESTAEX, the address of the user-supplied parameter area.
  • For ESTAI issued via ATTACHX, the address of the user-supplied parameter area. Note this is a 31-bit address for ESTAI issued in either AMODE31 or AMODE64.
  • If you issued FESTAE without the PARAM parameter, the address of the 24-byte parameter area in the SVRB (RBFEPARM).
  • If you issued ESTAE, ESTAEX, or ATTACHX without the PARAM parameter, zero.
  • For IEAARR issued in AMODE 31, the 31-bit address of the parameter area specified on the ARRPARAMPTR parameter of IEAARR.
  • For IEAARR issued in AMODE 64, the 64-bit address of the parameter area specified on the ARRPARAMPTR64 parameter of IEAARR.
GPRs 3 - 12 Do not contain any information for use by the routine.
GPR 13 Address of a 144-byte register save area.
GPR 14 Return address to the system.
GPR 15 Entry point address of the ESTAE-type recovery routine, except for ESTAEX issued in AMODE 64, in which case the low order bit will be on.
Access registers  
ARs 0 - 1 Zero
AR 2 One of the following:
  • If you issued the ESTAEX macro in AR ASC mode, an ALET that qualifies the address in GPR 2.
  • Otherwise, this register does not contain any information for use by the routine.
ARs 3 - 15 Zero.
Table 2. Register Contents—ESTAE-Type Recovery Routine Without an SDWA
Register Contents
General Purpose Registers  
GPR 0 12 (X'0C'). The system could not obtain an SDWA.
GPR 1 Completion code in bytes 1-3. The system completion code appears in the first 12 bits, and the user completion code appears in the second 12 bits.
GPR 2 One of the following:
  • If you specified the PARAM parameter on ESTAE, ESTAEX, or FESTAE, the address of the user-supplied parameter area.
  • For ESTAI issued via ATTACHX, the address of the user-supplied parameter area. Note this is a 31-bit address for ESTAI issued in either AMODE31 or AMODE64.
  • If you issued FESTAE without the PARM parameter, the address of the 24-byte parameter area in the SVRB (RBFEPARM).
  • If you issued ESTAE, ESTAEX, or ATTACHX without the PARAM parameter, zero.
  • For IEAARR issued in AMODE 31, the 31-bit address of the parameter area specified on the ARRPARAMPTR parameter of IEAARR.
  • For IEAARR issued in AMODE 64, the 64-bit address of the parameter area specified on the ARRPARAMPTR64 parameter of IEAARR.
GPRs 3 - 13 Do not contain any information for use by the routine.
Note: When the system does not provide an SDWA, GPR 13 does not contain the address of a 144-byte save area. In this case, your ESTAE-type recovery routine must save the address from GPR 14 and use it as the return address to the system.
GPR 14 Return address to the system.
GPR 15 Entry point address of the ESTAE-type recovery routine except for ESTAEX issued in AMODE 64 in which the low order bit is set on.
Access registers  
ARs 0 - 1 Zero
AR 2 One of the following:
  • If you issued the ESTAEX macro in AR ASC mode and not AMODE 64, an ALET that qualifies the address in GPR 2.
  • Otherwise, this register does not contain any information for use by the routine.
ARs 3 - 15 Zero.