Installing CICS modules in the LPA

You can install modules into the MVS™ link pack area by using SMP/E.

In the context of the LPA, install means to move or copy a module into a suitable LPA library by using SMP/E, or by using a copying method that re-blocks the copied modules when the target data set has a smaller block size than the data set you copy from. For example, you can use the COPYMOD function of the IEBCOPY program.

Do not relink-edit the modules to put them into the LPA library. CICS® modules are supplied with the necessary attributes such that MVS loads them automatically above the 16 MB line into the ELPA.

The following steps summarize the procedure to install modules in the CICS LPA library, and to ensure that SMP/E can continue to service them. Further information explains these steps in more detail.
  1. Select those modules that you want to use from the MVS link pack area and specify them in the SMP/E USERMOD to be used to install the modules in the MVS link pack area.

    For a list of CICS-supplied modules eligible for the MVS link pack area, see the CICS-supplied sample DFH$UMOD.

    To install modules in the MVS link pack area, use one of the following methods:
    • Use an SMP/E USERMOD that contains ++MOVE statements for only the modules to be installed in the MVS link pack area.

      CICS supplies an SMP/E USERMOD called DFHUMOD in member DFH$UMOD in the hlq.SDFHSAMP library. This USERMOD contains ++MOVE statements for all CICS modules, in the hlq.SDFHAUTH and hlq.SDFHLOAD libraries, that are eligible for the MVS link pack area. The USERMOD also indicates whether each module is LPA- or ELPA-eligible. You can choose which of the modules to install in the LPA by creating your own version of the USERMOD. Include modules in the working set of the installation.

    • Use your own version of a USERMOD. Your version can include ++MOVE statements from both CICS-supplied USERMODs.

      If you intend changing a CICS-supplied USERMOD, to choose modules to install in the MVS link pack area, take a copy of the USERMOD and update the copy only. If you have copied the hlq.SDFHSAMP library, for instance, when changing user-replaceable programs, you already have copies of the CICS-supplied USERMODs. If the original hlq.SDFHSAMP library is serviced, and the USERMOD is modified, you can reflect the changes in your version.

  2. Choose which read-only modules to install in the MVS link pack area and edit your copy of the SMP/E USERMOD.
    1. Comment out the ++MOVE statements for the modules that you do not want to install in the LPA.
    2. Move the remaining ++MOVE statements for the modules that you do want to install in the LPA one column to the left, so that the ++MOVE statements start in column one of the USERMOD module.
    3. Add ++MOVE statements for your user application program modules that you want to install in the LPA, with the ++MOVE statements starting in column one of the DFH$UMOD module.
  3. Receive the USERMOD into the CICS global zone. SMP/E moves those load modules you have specified from the named CICS target library (hlq.SDFHLOAD or hlq.SDFHAUTH) into the CICS LPA library.

    To receive and apply the CICS-supplied sample USERMODs in DFH$UMOD, you can use the associated job DFHLPUMD, which is tailored to your CICS environment and stored in the hlq.XDFHINST library when you run the DFHISTAR job.

  4. Apply the USERMOD to the LPA zone. When you apply the USERMOD, you also update the corresponding LMOD entries in the target zone SMPCSI.
  5. To enable CICS to use the modules that you have installed in the MVS link pack area, re-IPL your MVS with CLPA specified.

    Also, specify that CICS uses modules from the LPA>. You can also control which modules are used from the MVS link pack area in several ways. See Controlling the use of modules from the MVS link pack area for more information.