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 SVC dumps that duplicate previous SVC dumps for
more information about DAE and dump suppression.