Finding the name of the failing load module in a MEPL

The name of a failing load module can be found in a MEPL.

Procedure

To find the name of the failing load module in a MEPL:

  1. Locate the MEPL in the dump.
  2. Locate the appropriate PSW and use the address in its second fullword as an index into the list.
    Use the PSW and ASID listed in the PRINT DUMP ABSTRACT INFORMATION section, which is located just before the system diagnostic work area (SDWA). Refer to the data listed under INFORMATION AT TIME OF ERROR.
  3. Review the beginning and ending addresses for each load module; the beginning address is the third word, and the ending address is the fourth word of each entry.
  4. If the address in the PSW falls between the beginning and ending addresses of a particular load module, that can be the failing load module.

    In the following example, assume that the address in the PSW at failure is 005A144A. Looking in the MEPL, you find that load module DSNVGEPL begins at 005A0A20 and ends at 005AB000. Because 005A144A falls between 005A0A20 and 005AB000, the name of the load module that contains the failing CSECT is DSNVGEPL.

    Figure 1. Finding the name of the failing load module in a MEPL
    09A0  00145830 C4E2D5E5 C4D9D940 F0F661F0 F/ 000 *.DSNVDRR.
    09C0  C4E2D5E5 C7C5D7D3 005A0A20 005AB000/ 00000 *.DSNVGEPL
    09E0  005A0A20 C4E2D5E5 C1E2C9D4 F0F661F/0080000 *.DSNVASIM
    0A00  005A1268 C4E2D5E5 E3D9E3C8 F0F66/ 00080000 *.DSNVTRTH
    0A20  005A1748 C4E2D5E5 C5E4E2F1 F0F/40 00080000 *.DSNVEUS1
  5. Verify that the suspected load module was involved in the failure.

    Review the ASID field in the MEPL. This field is the first halfword immediately following the ending address of the load module.

    The load module is the one that was involved in the failure if one of these conditions is true:

    • ASID field = 0000
    • ASID field = xxxx, where xxxx is the ASID identified in the dump as primary and is the ASID of system services or database services.
    For example, if the primary address space identifier (the identifier that follows the eye-catcher PASID in the beginning of the dump) is 0012, the ASID field of the MEPL for the load module that is involved in the failure must either be 0000 or 0012.
  6. If the suspected load module was not involved in the failure, continue searching the MEPL until a load module is found that contains the address in the PSW and whose ASID is equal to 0000 or to the ASID of the dump.

    If the failure is not a loop, the name of the failing load module should begin with DSN. If it begins with anything else, the problem might be in another product. Use the z/OS® diagnostic techniques publication for help in diagnosing the failure.

  7. If the search is unsuccessful, the name of the load module that is involved cannot be determined from the MEPL.

Example

Figure 2. Sample MEPL (module entry point list)
MEPL (00014) ADDR=7F71A000 ASID=0010 VVV=00  FROM: SCOM (0006) OFFSET
  0000  00BA0000 D4C5D7D3 00850594 0000B2A0   00000000 00000000 00000
  0020  C4E2D5E8 C1E2C3D7 81D008C8 81D04000   00100004 00000000 00000
  0040  81D00950 C4E2D5E8 C1E2E3D7 F0F361F1   F061F8F6 F1F84BF1 F3404
  0060  81D010A8 C4E2D5E8 C1E2E3D9 F0F361F1   F061F8F6 F1F84BF1 F4404
  0080  81D00950 C4E2D5E8 C5C3E3C5 F0F361F1   F061F8F6 F1F84BF2 F0404
  00A0  81D02AE0 C4E2D5E8 C1E2C3D7 F0F261F1   F061F8F7 F1F64BF0 F5404
  00C0  C4E2D5E8 C1C7C3E2 81CB7340 81CBA000   00000001 00000000 00000
  00E0  81CB9638 C4E2D5E8 C1C7C3E2 F0F361F1   F061F8F6 F2F24BF4 F6404
  0100  C4E2D5E8 C1D3D3C9 81CB7340 81CB9000   00000003 00000000 00000
  0120  81CB73C8 C4E2D5E8 C5C1E3C5 F0F161F1   F961F8F7 F1F14BF4 F2404
  0140  81CB73C8 C4E2D5E8 C5C1E3F2 F0F361F1   F061F8F6 F1F84BF1 F7404
  0160  81CB8500 C4E2D5E8 C1D3D3C9 F0F161F1   F961F8F7 F1F84BF3 F7404
⋮