Locating the waiting CSECT

If Db2 or z/OS® are not operational, you can try locating the waiting CSECT.

Procedure

To locate the waiting CSECT:

  1. Determine whether an SVRB (supervisor request block) is beneath the lowest PRB (program request block) of a task.
    • If not, check its PSW to see whether it points into DSNVSR.

      If this PSW points into DSNVSR, use save area sets to determine the CSECT and offset from which suspend was called. Refer to If Db2 and/or z/OS are not operational and follow the procedure that is given for waits.

    • If so, look in the field that is labeled W–L–I–C in the PRB; the last byte in this field indicates the SVC ran. The PSW points to the instruction that follows the SVC.

      If the interrupt code is X'2F', the SVC was a STIMER. Db2 uses STIMER loops in several places to wait for the occurrence of an event. The PSW in the PRB is in the CSECT in which the STIMER loop is occurring.

  2. Find the CSECT and load module names by using one of the following methods.
    • Using the module entry point list (MEPL) enables positive verification of an entry point, which is helpful in determining the offset of an instruction within a CSECT. (The MEPL can also be obtained by specifying IFCID 186 in the IFCID() parameter of the -START TRACE command.) Refer to Printing and analyzing dumps for detailed information about MEPLs.
      There are three MEPLs:
      • Batch Utilities MEPL

        A batch utilities MEPL is found in all SVC dumps that are issued by Db2 involving batch utility abends. This list contains the CSECTs for the batch load module, DSNUTILB. Use the batch utilities MEPL only when message DSNU0171 is issued or when the dump title lists DSNUTILB as the failing load module.

      • Early Code MEPL

        If the component ID in a dump title is XYR01, an early code MEPL is included in the summary dump for load module DSN3EP. The eyecatcher is EEP MEPL—LIKE FOR DSN3EP. Use this MEPL when the failure occurred in a CSECT of load module DSN3EP; its format is the same as the other MEPLs. Locate the failing CSECT by following the procedure that is described under Finding the name of the failing CSECT in the MEPL. The ASID of load module DSN3EP is always 0000.

      • Standard MEPL

        The standard MEPL is included in all dumps of the Db2 address spaces. If the dump is initiated by component 5740XYR00, that MEPL is included in the summary section of the dump. The standard MEPL contains entries for all load modules and CSECTs in the Db2 address spaces. It can be recognized by the MEPL eyecatcher or by several pages of EBCDIC CSECT or load module names on the interpreted area of the dump at the right. Use the standard MEPL when the criteria for using the other two MEPLs do not apply.

        Refer to The module entry point list (MEPL) and The batch utilities MEPL for detailed information about how to find the CSECT and load module in the MEPL.

    • Using the PSW
      1. Locate the instruction to which the PSW points and back up to the EBCDIC eyecatcher for the CSECT. This contains the function modification identifier (FMID), which indicates the fix level.
      2. Verify that you are in the correct address space. Look at the XSB just under the PRB from which the PSW was obtained. The PASID field indicates the ASID of the current primary address space, from which instructions are being fetched.
  3. Add WAIT xxxxxx to the keyword string, replacing xxxxxx with the CSECT name. If the CSECT name is unavailable or if a search with this name is unsuccessful, replace it with the load module identifier. For more information, turn to Load module modifier keyword. To conduct a search, turn to Searching the IBM Support site for known problems and solutions.
      5740XYR00 R111 WAIT DSNXCR2
       (free format)
      PIDS/5740XYR00 LVLS/111 RIDS/DSNXCR2 WAIT
       (structured format)