Making Fault Analyzer modules available

The following steps must be performed to make Fault Analyzer modules available.

Note: The data sets IPV.SIPVMODA and IPV.SIPVLPA1 are created as part of the installation of ADFz Common Components.
  1. Authorizing IDI.SIDIAUTH and adding to the LINKLIST

    Fault Analyzer modules that can reside in a PDS and require APF-authorization are placed in target library, IDI.SIDIAUTH. You must APF-authorize IDI.SIDIAUTH by adding it to the IEAAPFxx or PROGxx member (if available on your system) in SYS1.PARMLIB. IDI.SIDIAUTH must also reside in the LINKLIST. Add IDI.SIDIAUTH 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 IDIDA, IDIPDDIR, and IDIUTIL in IDI.SIDIAUTH do not execute correctly unless they are loaded from an APF-authorized library.

  2. Authorizing IDI.SIDIAUT2 and adding to the LINKLIST

    Fault Analyzer modules that must reside in a PDSE and require APF-authorization are placed in the target library, IDI.SIDIAUT2. You must APF-authorize IDI.SIDIAUT2 by adding it to the IEAAPFxx or PROGxx member (if available on your system) in SYS1.PARMLIB. IDI.SIDIAUT2 must also reside in the LINKLIST. Add IDI.SIDIAUT2 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.
  3. Adding IDI.SIDIMOD1 and IPV.SIPVMODA to the LINKLIST

    To enable Fault Analyzer to work correctly, you must add IDI.SIDIMOD1 to your concatenated LINKLIST. To do this, add this library to either your LNKLSTxx or PROGxx (if available on your system) member in SYS1.PARMLIB.

    Data set IPV.SIPVMODA must be added to LINKLIST for Fault Analyzer to provide source level support when using compiler listings or SYSADATA files.

    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.

    ADFz Common Components also provides a data set IPV.SIPVMOD1, which is not required by Fault Analyzer.

  4. Adding IDI.SIDIALPA to the LPALIST

    Fault Analyzer modules that must be loaded into the LPA reside in the target library, IDI.SIDIALPA. Add IDI.SIDIALPA 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 then be implemented by performing an IPL with CLPA.
  5. Adding IDI.SIDILPA1 and IPV.SIPVLPA1 to the LPALIST (optional)

    Fault Analyzer modules that can optionally be loaded into the LPA reside in the target library, IDI.SIDILPA1. Equivalent ADFz Common Components modules used by Fault Analyzer reside in library IPV.SIPVLPA1. Libraries that you add to your LPALIST require less space in the abending region being analyzed. To conserve the maximum amount of virtual storage, add IDI.SIDILPA1 and IPV.SIPVLPA1 to your concatenated LPALIST via the LPALSTxx member in your SYS1.PARMLIB. All modules in IDI.SIDILPA1 and IPV.SIPVLPA1 are 31-bit and therefore are automatically loaded into ELPA above the line.

    Note:
    1. 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 then be implemented by performing an IPL with CLPA.
    2. If the IDI.SIDILPA1 data set is added to LPALIST, take care when applying maintenance to Fault Analyzer. For details, see Maintaining Fault Analyzer.
  6. Performing IPL with CLPA or running IDICZSVC

    It is necessary to IPL your system again, with CLPA, as the Fault Analyzer installation has added SVC modules to LPA in data set IDI.SIDIALPA. Failure to do this IPL results in abend S16D being issued when Fault Analyzer performs analysis.

    For the initial installation and whenever module IDICSVCR in IDI.SIDIALPA is updated, you can do the following if an IPL cannot be scheduled:

    1. Issue the operator command:
      SETPROG LPA,ADD,MOD=(IDICSVCR),DSN=IDI.SIDIALPA
    2. Submit a batch job containing the following EXEC JCL statement to dynamically install the Fault Analyzer SVC 109 ESR code 53 to your system.
      // EXEC PGM=IDICZSVC