CSECT keyword
To find the name of the failing CSECT, use the SVC dump title. If the dump title is not available, use the SYS1.LOGREC entry or the first page of an SVC dump.
Any CSECT name that is located following these procedures should begin with:
- DSN for Db2
- DXR for IRLM
- DSNC or DSN2 for CICS® attachment
- DSNM for IMS attachment
- DSN3, DSNA, DSNV, or DSNZ for the subsystem initialization component, or the primary Db2 component. Some DSNA CSECTs belong to the call attachment facility.
- If the CSECT prefix is DSN3, DSNA, DSNV, or DSNZ follow the steps
below.
- Use SMP to list the CSECT. Issue the command 'LIST CDS MOD(csect-name)'. Locate the FMID from this.
- If the FMID is HIZ2220, use the subsystem initialization component identifier (5740XYR01) in the keyword string. If the FMID is HDB2220, use the primary Db2 component identifier (5740XYR00). Consult the z/OS® diagnostic techniques publication to identify the failing product.
- If the prefix denotes an attachment facility, use its component identifier in the keyword string: 5740IX100 for CICS (old attachment facility), 565501800 for CICS (new attachment facility), and 5740IY100 for IMS.
If a CSECT name with a different prefix is found, the problem probably is not in Db2. Isolate the failing product using the z/OS diagnostic techniques publication.
Other ways of finding the CSECT name are explained elsewhere in this section. For example:
- If you received a Db2-generated message and if the type-of-failure keyword is MSGx, follow the procedures for MSGx keyword.
- If using SQL and access is available to an SQL Communication Area (SQLCA) for the problem, use the procedure for SQLCODE modifier keyword. You have access to the SQLCA if the application program displays it or if a dump was generated for this specific problem.
If the CSECT cannot be found, turn to Recovery routine modifier keyword.
Procedure using SVC dump title
To find the name of the failing CSECT using the SVC dump title:- Locate the second word following the label
LOC=. This is the CSECT name (a number follows it).- For an example, see SVC dump titles that are issued by Db2.
- If the dump title does not contain this label, follow either Procedure using a SYS1.LOGREC entry or Procedure using first page of an SVC dump.
- If the reason code found when following ABENDx keyword is X'00C90101',
X'00C90102', X'00C90105', or in the range of X'00C902xx',
locate the four-character reason code qualifier in the dump title.
See Figure 1.Build a keyword similar to xxxxxxxx VRACE yyyy or xxxxxxxx ERQUAL yyyy. Replace xxxxxxxx with the CSECT name and yyyy with the reason code qualifier. Add this to the keyword string. To find the load module name and any appropriate VRA data, see Modifier keyword.
(free format): 5740XYR00 R121 ABEND04E RC00C90105 DSNKDLEV VRACE0D01 5740XYR00 R121 ABEND04E RC00C90105 DSNKDLEV ERQUAL 0D01 (structured format): PIDS/5740XYR00 LVLS/121 PRCS/00C90105 RIDS/DSNKDLEV FLDS/VRACE VALU/H0D01 PIDS/5740XYR00 LVLS/121 PRCS/00C90105 RIDS/DSNKDLEV FLDS/ERQUAL VALU/H0D01 - If the reason code found when following ABENDx keyword begins with
X'00E7', locate the
PorMsign in the dump title and the three-digit decimal reason code qualifier that follows it. For an example, see Figure 3.Append the qualifier to SQLERRD. Add this and the CSECT name to the keyword string. To find the load module name and any appropriate VRA data, see Modifier keyword.(free format): 5740XYR00 R121 ABEND04E RC00E70005 DSNXAMCT SQLERRD101 (structured format): PIDS/5740XYR00 LVLS/121 AB/S004E PRCS/00E7005 RIDS/DSNXAMCT FLDS/SQLERRD101 - If the reason code found when following ABENDx keyword begins with
X'00E2', the name of the CSECT calling the failing Storage Manager
CSECT is included in the VRA. Search the database using the information
in the dump title. The search can be narrowed by including the CSECT
name, turn to VRA data modifier keyword.
(free format): 5740XYR00 R121 ABEND04E RC00E2000B DSNSFBK (structured format): PIDS/5740XYR00 LVLS/121 AB/S004E PRCS/00E2000B RIDS/DSNSFBK
Procedure using a SYS1.LOGREC entry
To find the name of the failing CSECT by using a SYS1.LOGREC entry:- Locate the SYS1.LOGREC entry related to the error. Compare the date, time, ERRORID string, and program name in the dump with those in the SYS1.LOGREC entry.
- Locate the CSECT name in the SYS1.LOGREC entry. It follows the
words
NAME OF CSECT INVOLVEDon the top left corner of the first page. For an example, turn to SYS1.LOGREC. - Add the CSECT name to the keyword string. The component identifier
must correspond to the CSECT prefix. To determine the load module
name and any appropriate VRA data, see Modifier keyword.
(free format): 5740XYR00 R121 ABEND0C4 DSNVATRM (structured format): PIDS/5740XYR00 LVLS/121 AB/S00C4 RIDS/DSNVATRM
Procedure using first page of an SVC dump
To find the name of the failing CSECT using the first page of an SVC dump:- Locate the SYMPTOM DATA column and note the name listed as the second item. This is the CSECT name, as the EXPLANATION column indicates. For an example, see Figure 1.
- Add the CSECT name to the keyword string and turn to Modifier keyword if you
want to narrow the search further.
(free format): 5740XYR00 R121 ABEND0C4 DSNVATRM (structured format): PIDS/5740XYR00 LVLS/121 AB/S00C4 RIDS/DSNCATRM