By install, we mean 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 are copying from (for example, use the COPYMOD function of the IEBCOPY program). A procedure for installing modules into the MVS link pack area by using SMP/E is in this topic.
You should not relink-edit the modules in order to get them into the LPA library. CICS® modules as supplied have the necessary attributes that cause MVS™ to load them automatically above the line (into the ELPA).
To install modules in the CICS LPA library, and to ensure that SMP/E can continue to service them, complete the following steps:
You can use the CICS-supplied USERMOD, LPAMODS, or create and use your own version.
If you use your own version of a USERMOD, this can include ++MOVE statements from both CICS-supplied USERMODs.
These steps are in the following topics.
You should install in the MVS link pack area only those modules that you want to use from the MVS link pack area. Appendix. CICS modules eligible for the MVS link pack area lists the CICS-supplied modules eligible for the MVS link pack area, and gives descriptions and other information to help you select those CICS modules that you want to use from the MVS link pack area.
To install modules in the MVS link pack area, you should 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 MVS link pack area by creating your own version of the USERMOD. Your selection isgenerally include modules in the working set of the installation.
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, then you already have copies of the CICS-supplied USERMODs. If the original hlq.SDFHSAMP library is serviced, and the USERMOD is modified, you may like to reflect the changes in your version.
To choose which read-only modules to install in the MVS link pack area, edit your copy of the SMP/E USERMOD to:
Receive the USERMOD into the CICS global zone and apply it to the LPA target zone. This causes SMP/E to move those load modules you have specified from the named CICS target library (hlq.SDFHLOAD or hlq.SDFHAUTH) into the CICS LPA library. Applying the USERMOD also updates the corresponding LMOD entries within the target zone SMPCSI.
Do not accept the USERMOD into the distribution zone, and for the time being, do not apply it to any other target zone.
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.
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 to CICS that it is to use modules from the MVS link pack area. You can also control which modules are used from the MVS link pack area in several ways. This is in the topic Controlling the use of modules from the MVS link pack area.