Making Z Abend Investigator modules available

To make Z Abend Investigator modules available, the following steps must be performed following the SMP/E installation of Z Abend Investigator.

  1. Authorize HFZ.SHFZAUTH and add to the LINKLIST

    Z Abend Investigator modules that require APF-authorization are placed in target library, HFZ.SHFZAUTH. You must APF-authorize HFZ.SHFZAUTH by adding it to the IEAAPFxx or PROGxx member (if available on your system) in SYS1.PARMLIB. HFZ.SHFZAUTH must also reside in the LINKLIST. Add HFZ.SHFZAUTH to your concatenated LINKLIST by using the LNKLSTxx or PROGxx member in your SYS1.PARMLIB.

    Note:
    MVS requires that data sets in LINKLIST either be in the master catalog or specified with the volume serial number where the data set resides.

    The load modules HFZDA, HFZPDDIR, and HFZUTIL in HFZ.SHFZAUTH do not execute correctly unless they are loaded from an APF-authorized library.

  2. Add HFZ.SHFZALPA to the LPALIST

    Z Abend Investigator modules that must be loaded into the LPA reside in the target library, HFZ.SHFZALPA. Add HFZ.SHFZALPA to your concatenated LPALIST via the LPALSTxx member in your SYS1.PARMLIB.

    Note:
    MVS requires that data sets in LPALIST are either in the master catalog or specified with the volume serial number where the data set resides.
    The LPALSTxx change must be implemented by performing an IPL with CLPA (step 4), or by doing the following if an IPL cannot be scheduled:
    1. Issue the operator command:
      SETPROG LPA,ADD,MOD=(HFZCSVCR, HFZCSRBL),DSN=HFZ.SHFZALPA
      Note:
      Ensure ECSA size is sufficient to accommodate the additional storage required by the SETPROG LPA,ADD command.
    2. Submit a batch job containing the following EXEC JCL statement to dynamically install the Z Abend Investigator SVC 109 ESR code on your system.
      // EXEC PGM=HFZCZSVC,PARM=’SVCNUM=xxx

      The xxx variable specifies the SVC table entry index number to use if entry 53 is unavailable. It can be any value from 200 to 255.

      If no PARM value is specified, HFZCZSVC will dynamically locate a free ESR code.

      If the HFZ.SHFZALPA modules are not added to LPA via an IPL with CLPA (step 4) or the above dynamic update using SETPROG and HFZCZSVC, then errors are expected, including abend S16D.
  3. Add Z Abend Investigator and HFZLANGX to LPA

    This is an optional but recommended step to provide additional storage in the abending region for Z Abend Investigator real-time analysis.

    For more information see, Storage recommendations.

  4. Perform IPL with CLPA

    If any of the previous steps were not successfully implemented dynamically, then it is necessary to IPL your system with CLPA.