One of the objectives of providing recovery is to obtain as much
information as possible to help you determine what went wrong. The
SDWA has certain areas where the recovery routine can save such information.
Your recovery routine can update the SDWA with serviceability information
in three different ways:
- By issuing the SETRP macro with the RECPARM parameter. Use the RECPARM parameter to supply the load module name,
the active CSECT name, and the recovery routine CSECT name. See Using the SETRP macro to update the SDWA for more information about using SETRP.
- By issuing the VRADATA macro to update the SDWA variable recording area. See the VRADATA macro in z/OS MVS Programming: Assembler Services Reference IAR-XCT for more information.
- By directly manipulating other fields in the SDWA. Important
fields to fill
in are SDWACID, SDWASC, SDWAMLVL, and SDWARRL. See Important fields in the SDWA for
a description of each of these fields.
Part of saving serviceability data includes providing information
for dump analysis and elimination (DAE). DAE depends on information
that users provide in recovery routines to construct symptom strings
needed to describe software failures. DAE uses these symptom strings
to analyze dumps and suppress duplicate dumps as requested. You should
provide information for DAE prior to requesting a dump of storage.
See Suppressing dumps that duplicate previous dumps for more information about DAE and dump
suppression.