Checklist for installing and customizing Z Abend Investigator

In order to verify the installation of Z Abend Investigator, and to start using Z Abend Investigator at your site, you must perform the following tasks. Unless otherwise indicated, all tasks are mandatory.

Notes:
  • Copy all members of data set HFZ.SHFZSAM1 to another data set before proceeding, and make all changes to the copies only.
  • You can use the HFZCHKI utility to check the state of the Z Abend Investigator installation or to query service information. See Step 3: Verify the service level (optional).
  1. Make Z Abend Investigator modules available via LINKLIST and LPA

    For details, see Making Z Abend Investigator modules available.

  2. Allocate a history file

    Although multiple history files might eventually be used at your site, a single history file is sufficient to verify the installation of Z Abend Investigator.

    There are no restrictions on the name of the history file, but the default name searched for by Z Abend Investigator is HFZ.HIST. If a different name is used, then the HFZCNFxx parmlib member is used to provide the name through the DataSets option. You review the HFZCNFxx parmlib member, and the options it might contain, later in the installation process.

    A suggested size of the initial history file is 100 cylinders.

    General information about history files is provided in Setting up history files, along with considerations for choosing PDS or PDSE formats, and instructions for using the sample job provided for the data set allocation.

  3. Create the HFZCNFxx parmlib member

    For details, see Setting and changing default options for the site.

    Ensure that a 
    DataSets(HFZHIST(dsn))
    option is included if you allocated a history file with a name other than HFZ.HIST in step 2.

    Likewise, if Z Abend Investigator was installed using a high-level qualifier other than HFZ, use the DataSets option to provide the names of all required Z Abend Investigator data sets.

  4. Define and initialize the message and abend code explanation repository

    For details, see Setting up the message and abend code explanation repository.

  5. Install the MVS™ change options/suppress dump exit HFZXDCAP

    For details, see Installing the MVS change options/suppress dump exit HFZXDCAP.

    Information about the characteristics of this exit are provided in Exits for invoking Z Abend Investigator.

    At the completion of this step, Z Abend Investigator is effectively enabled at your site, and might start analyzing abends and creating entries in your history file.

  6. Enable the Language Environment® abnormal termination exits HFZXCEE and HFZXCE64

    For details, see Installing the Language Environment abnormal termination exits HFZXCEE and HFZXCE64.

    For information to help you determine the applicability of this exit at your site, see Exits for invoking Z Abend Investigator and Language Environment options required for invocation of Z Abend Investigator.

  7. Install the SVC dump registration exit HFZXTSEL

    For details, see Installing the MVS post-dump exit HFZXTSEL.

  8. Customize the CICS® environment

    This step is only applicable if you are using CICS®.

    For details, see Customizing the CICS environment.

  9. Customize the DB2® environment

    This step is only applicable if you are using DB2®.

    For details, see Customizing the DB2 environment.

    Create the DB2® table index discussed in Improving Z Abend Investigator DB2 performance; otherwise, severe Z Abend Investigator performance degradation might result when accessing DB2® catalog information.

  10. Customize the IMS™ environment

    This step is only applicable if you are using IMS™.

    For details, see Customizing the IMS environment.

  11. Customize the Java™ environment

    This step is only applicable if you are using Java.

    For details, see Customizing the Java environment.

  12. Customize for ISPF

    For details, see Modifying your ISPF environment.

  13. Start the Z Abend Investigator HFZS subsystem

    For details, see Using the Z Abend Investigator HFZS subsystem.

  14. Review and optionally change the default extended minidump (XDUMP) data set name pattern using an HFZOPTLM configuration-options module.

    For details, see Changing the default extended minidump (XDUMP) data set name pattern (XDUMPDSN).

Optional installation steps

  1. Add BPX security server program control profile for Z Abend Investigator programs

    This step is only required if program control has been activated for your installation.

    For details, see Defining program control access to Z Abend Investigator programs.

  2. Install USERMOD HFZSPLI or HFZSPLIA to enable implicit Z Abend Investigator invocation from PL/I V2R3 applications

    For details, see Enabling implicit Z Abend Investigator invocation from PL/I V2R3 applications (++HFZSPLI/++HFZSPLIA).

  3. Change the default recovery fault recording IEATDUMP data set name pattern using an HFZOPTLM configuration-options module

    For details, see Changing the default recovery fault recording IEATDUMP data set name (RFRDSN).

  4. Define XFACILIT resource classes to manage recovery fault recording data sets.

    For details, see Managing recovery fault recording data set access.

  5. Change the default extended minidump (XDUMP) data set name pattern using an HFZOPTLM configuration-options module

    For details, see Changing the default extended minidump (XDUMP) data set name pattern (XDUMPDSN).

  6. Customize for Japanese language support

    This step is only required if the Japanese feature of Z Abend Investigator is installed.

    For details, see Customizing the Z Abend Investigator Japanese feature.

  7. Grant history file administrator authorization for change of settings via ISPF interface

    For details, see Restricting change of history file settings.

  8. Set SLIP traps to capture documentation for selected Z Abend Investigator error messages

    For details, see Setting Z Abend Investigator SLIP traps.

Additional customization can optionally be performed using user exits, as described in Customizing Z Abend Investigator by using user exits. However, no user exits are required for Z Abend Investigator to run.

Installation verification

  1. Perform assembler IVP

    For details, see Verifying the use of Z Abend Investigator with assembler.

  2. Perform COBOL IVP

    Only perform this step if COBOL is installed at your site.

    For details, see Verifying the use of Z Abend Investigator with COBOL.

  3. Perform PL/I IVP

    Only perform this step if PL/I is installed at your site.

    For details, see Verifying the use of Z Abend Investigator with PL/I.

  4. Perform HFZXCEE Language Environment® exit IVP

    For details, see Verifying the HFZXCEE Language Environment exit enablement.

  5. Perform CICS® IVP

    Only perform this step if CICS® is installed at your site.

    For details, see Verifying Z Abend Investigator customization under CICS.

  6. Perform DB2® IVP

    Only perform this step if DB2® is installed at your site.

    Both a C and a COBOL IVP is provided. For details, see Verifying the use of Z Abend Investigator with DB2.

  7. Perform ISPF IVP

    For details, see Verifying the use of Z Abend Investigator through ISPF.

  8. Verify Z Abend Investigator license status

    Inspect the SLCHK001 file in the output of the running job to verify that Z Abend Investigator is licensed to run.