Outstanding I/Os at the time of failure
Before the most recently activated ESTAE-type recovery routine receives control, the system can handle outstanding I/Os at the time of the failure. You request this through the macro that defines the routine (that is, through the PURGE parameter on ESTAE, ESTAEX, FESTAE, or ATTACHX). The system performs the requested I/O processing only for the first ESTAE-type recovery routine that gets control. Subsequent routines that get control receive an indication of the I/O processing previously done, but no additional processing is performed.
- If the recovery routine specified FRESDWA=YES and RETREGS=NO on the SETRP macro, or the system did not provide an SDWA, the system supplies the address of the purged I/O restore list in GPR 2 on entry to the retry routine.
- If the recovery routine specified FRESDWA=NO and RETREGS=NO on the SETRP macro, GPR 1 contains the address of the SDWA, and the address of the purged I/O restore list is in the SDWAFIOB field on entry to the retry routine.
- If the recovery routine specified FRESDWA=NO and RETREGS=YES on the SETRP macro, the recovery routine must pass the address of the SDWA to the retry routine (in the user parameter area, or in GPR 0). The address of the purged I/O restore list is in the SDWAFIOB field on entry to the retry routine.
- If the recovery routine specified FRESDWA=YES and RETREGS=YES on the SETRP macro, the retry routine cannot access the purged I/O restore list.
The following table provides a summary of how the retry routine can access quiesced restorable I/O operations:
Parameter on SETRP Macro | RETREGS=NO | RETREGS=YES |
---|---|---|
FRESDWA=YES | GPR 2 contains the address of the purged I/O restore list (see note below) | Retry routine cannot access the purged I/O restore list. |
FRESDWA=NO | GPR 1 contains the address of the SDWA; SDWAFIOB contains the address of the purged I/O restore list | The recovery routine must pass the address of the SDWA to the retry routine; SDWAFIOB contains the address of the purged I/O restore list. |
You can use the RESTORE macro to have the system restore all I/O requests on the list. For information about where the RESTORE macro is documented, see z/OS DFSMS Introduction for the version of DFP you have installed.