Making Z Abend Investigator modules available

The following steps must be performed to make Z Abend Investigator modules available.

  1. Authorizing HFZ.SHFZAUTH and adding to the LINKLIST

    Z Abend Investigator modules that can reside in a PDS and 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. Adding 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 then be implemented by performing an IPL with CLPA.
  3. Adding HFZ.SHFZLPA1 to the LPALIST (optional)

    Z Abend Investigator modules that can optionally be loaded into the LPA reside in the target library, HFZ.SHFZLPA1. 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 HFZ.SHFZLPA1 to your concatenated LPALIST through the LPALSTxx member in your SYS1.PARMLIB. All modules in HFZ.SHFZLPA1 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 HFZ.SHFZLPA1 data set is added to LPALIST, take care when applying maintenance to Z Abend Investigator. For details, see Maintaining Z Abend Investigator.
  4. Performing IPL with CLPA or running HFZCZSVC

    It is necessary to IPL your system again, with CLPA, as the Z Abend Investigator installation has added SVC modules to LPA in data set HFZ.SHFZALPA. Failure to do this IPL results in abend S16D being issued when Z Abend Investigator performs analysis.

    For the initial installation and whenever module HFZCSVCR in HFZ.SHFZALPA is updated, you can do the following if an IPL cannot be scheduled:

    1. Issue the operator command:
      SETPROG LPA,ADD,MOD=(HFZCSVCR),DSN=HFZ.SHFZALPA
    2. Submit a batch job containing the following EXEC JCL statement to dynamically install the Z Abend Investigator SVC 109 ESR code to your system.
      // EXEC PGM=HFZCZSVC,PARM=’SVCNUM=xxx

      The xxx variable can be any value from 200 to 255. If you do not specify a PARM, HFZCZSVC locates a free ESR code dynamically.

    The message The Z Abend Investigator SVC 109 code xxx has been set identifies which ESR code is available. Use the returned ESR code as the xxx value to relink HFZCSVCR into SHFZALPA, as shown in the following JCL:
    //LNKCSVCR EXEC PGM=HEWL,REGION=2M,                             
    //         PARM='MAP,RENT'                                      
    //SYSUT1   DD  UNIT=VIO,SPACE=(32000,(30,30))                   
    //SYSPRINT DD  SYSOUT=*                                         
    //SYSLMOD  DD  DISP=SHR,DSN=SHFZALPA                     
    //SYSLIN   DD  *                                                
      INCLUDE SYSLMOD(HFZCSVCR)                                     
     ALIAS              IGX00xxx 
     ENTRY              HFZCSVCR                                    
     ORDER              HFZCSVCR                                    
     NAME               HFZCSVCR(R)
    After the alias is defined, you can perform an IPL without running HFCZSVC.