Saving serviceability data
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.