VRA data modifier keyword
Use this keyword procedure if the type of failure was ABEND and you have access to a variable recording area (VRA), in the system diagnostic work area (SDWA) of an SVC dump or a SYS1.LOGREC entry.
About this task
Some information in the VRA is common to all Db2 subcomponents; however, a given subcomponent can add specialized information at failure. In the examples that are shown here, the abend reason code X'00E2000B' is listed as one of the reason codes for the storage manager subcomponent for which significant data is stored in the VRA.
Procedure
To use the VRA data modifier keyword:
- Determine whether the reason code received for the abend indicates that significant information is recorded in the VRA.
- If significant information is recorded, locate the VRA Diagnostic Information Report. See Figure 1 for an example. It usually appears in the beginning of the formatted dump. For more information about the VRA report and details on locating it, see The variable recording area (VRA).
- Scan the
KEYcolumn until the key that contains the significant data is found. - Determine the appropriate key name that is based on the
hexadecimal key value. For example, a key of 3D for reason code X'00E2000B' indicates the key name
VRACAN
. See SYS1.LOGREC. - Build a keyword similar to xxxxxx yyyyyy.
Replace xxxxxx with the VRA key name and yyyyyy with
the data that appears in the corresponding
VRA DATA FIELDScolumn. Add this information to the keyword string and search the database by using the CSECT name or the load module identifier (or both, if appropriate). Turn to Searching the IBM Support site for known problems and solutions.
Results
(free format):
5740XYR00 R111 ABEND04E RC00E2000B DSNSFBK
VRACAN DSNVASIM (with CSECT name)
5740XYR00 R111 ABEND04E RC00E2000B DSNSLD1
VRACAN DSNVASIM (with load module identifier)
5740XYR00 R111 ABEND04E RC00E2000B DSNSLD1
DSNSFBK VRACAN DSNVASIM
(with load module identifier and CSECT name)
(structured format):
PIDS/5740XYR00 LVLS/111 AB/S00E4
PRCS/00E2000B RIDS/DSNSFBK FLDS/VRACAN
RIDS/DSNVASIM (with CSECT name)
PIDS/5740XYR00 LVLS/111 AB/S00E4
PRCS/00E2000B RIDS/DSNSLD1#L FLDS/VRACAN
RIDS/DSNVASIM (with load module identifier)
PIDS/5740XYR00 LVLS/111 AB/S00E4
PRCS/00E2000B RIDS/DSNSLD1#L RIDS/DSNSFBK
FLDS/VRACAN RIDS/DSNVASIM
(with CSECT name and load module identifier)