Making Z Abend Investigator modules available
The following steps must be performed to make Z Abend Investigator modules available.
- 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.
- 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. - 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:- 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.
- 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.
- 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:
- Issue the operator command:
SETPROG LPA,ADD,MOD=(HFZCSVCR),DSN=HFZ.SHFZALPA
- 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:
After the alias is defined, you can perform an IPL without running HFCZSVC.//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)
- Issue the operator command: