Loading module DFHHPSVC

Before you can use HPO, ensure that the HPO SVC module is included in the MVS™ nucleus by one of the following methods:

  1. Copy the DFHHPSVC module into SYS1.NUCLEUS, renaming it to IGC215 or the appropriate name if you are not using the default, and specify it on an INCLUDE statement in the NUCLSTxx member of the SYS1.PARMLIB library. (You must also specify the name of the NUCLSTxx member on the NUCLST statement of the LOADxx member of the SYS1.PARMLIB library.) The NUCLSTxx method provides you with greater flexibility in customizing the MVS nucleus than the NMLDEF method described in the method 2.

    For further information about coding a NUCLSTxx member, and about a comparison with using the NMLDEF macro, see the z/OS MVS Initialization and Tuning Guide.

  2. Copy the DFHHPSVC module into SYS1.NUCLEUS and specify it in a nucleus module list (NML) for CICS®, created using the NMLDEF macro shown in the sample job in Figure 5. This NML selects the CICS members in SYS1.NUCLEUS that are to be loaded into the MVS nucleus, and eliminates the need for the MVS nucleus to be re-link-edited for the DFHHPSVC module (or any other module needed in the MVS nucleus).

    For information about coding an NMLDEF macro, see the z/OS MVS Programming: Authorized Assembler Services Reference Vol 3 manual.

    Figure 5. Sample job stream to load the CICS Type 6 SVC into the MVS nucleus
    //LOADSVC   JOB 'accounting info',MSGCLASS=A,CLASS=A
    //NMLDEF    EXEC ASMHCL
    //C.SYSIN    DD *
    IEANCnnn NMLDEF NUCL=DFHHPSVC
    //L.SYSLMOD DD DSN=SYS1.NUCLEUS,UNIT=3380,DISP=OLD
    //L.SYSIN DD *
      NAME IEANCnnn
    /*
    //

    where nnn is the number of the CICS NML, in the range 001 through 256. Choose the value of nnn to be unique within your MVS nucleus.

     

Removing existing DFHHPSVC modules from the MVS nucleus

You can remove a link-edited version of the DFHHPSVC module (for an earlier release of CICS) from the MVS nucleus by running a link-edit job to replace the existing version of the nucleus with one that does not contain the module to be removed.

Notes:
  1. If the existing nucleus-resident DFHHPSVC module is known to SMP/E, use the SMP/E UCLIN statement to remove the module entry.
  2. You must link-edit the nucleus module, IEANUC0x, with the scatter (SCTR) attribute. If you do not do this, MVS enters a non-restartable wait state at system initialization.
  3. If you have a version of the DFHHPSVC module from an earlier release of CICS already installed in your MVS nucleus, you do not need to replace it with the latest version. Versions of the DFHHPSVC module from earlier releases of CICS are compatible with the current release.
[[ Contents Previous Page | Next Page Index ]]