The system diagnostic work area (SDWA)

Each SVC dump that is requested by a Db2 functional recovery routine usually contains an SDWA with information about the status of the subsystem at the time of the error. Typically, the SDWA is a starting point for diagnosis.

Finding the SDWA

Use the SUMDUMP Dump Index to locate the SDWA. For more information about the contents of the SDWA:

Using the SDWA during the secondary error recovery processing

The z/OS® SDUMP macro uses the SDWA at time of invocation to gather the storage areas around the registers (SDWAGRSV) and PSW (SDWAEC1) at the time of error to include in the dump data set. If secondary errors occur during Db2 dump processing, the SDWA used during SDUMP processing would therefore reflect the registers and PSW of the secondary error; the original SDWA error information would be lost.

To avoid losing the original error information and to retain as much secondary error information as possible, Db2 saves selected fields from both the original and secondary SDWA in the DMPW data area. Before you start SDUMP, Db2 dump services then uses fields from the original SDWA to overlay the corresponding fields (restored) in the secondary SDWA.

The following list describes in greater detail the services that are performed when errors occur during dump processing.

  • These fields from both the original and secondary SDWA are saved in the DMPW data area:
    Figure 1. DMPW data area
    FIELD         LENGTH     FUNCTION
    Eyecatcher      4        'OERR' and 'SERR'
    SDWAFLGS        4        SDWA flags (saved only)
    SDWAABCC        4        Completion code (restored)
    SDWAGRSV       64        Registers at error (restored)
    SDWAEC1         8        Ext/CTL PSW (restored)
    SDWAAAEC1       8        EC mode data (restored)
    SDWACOMU        8        SDWA communication (restored)
  • The DMPW fields from the SDWA reflecting the original error 'OERR' are used to overlay the same fields in the secondary SDWA 'SERR'. The summary storage areas that are provided by SDUMP around the registers and PSW at the time of the error now reflect the original error.
  • Both the original and secondary SDWA error fields are kept in the DMPW for later examination during problem analysis.
  • This error message is inserted into the header portion of the DMPW to show that a secondary error occurred.