Using CICSPlex SM modules in the MVS link pack area

The benefits of using the MVS™ link pack area (LPA) are:

Every CICSPlex® SM module installed in the LPA can be used only by the release of CICSPlex SM to which it relates.

CICSPlex SM supplies prebuilt SMP/E USERMODs as members in the CICSTS31.CPSM.SEYUSAMP library. Start of changeThe USERMOD is:End of change

Start of change  EYU$UM01 - Local MAS modulesEnd of change

These USERMODs contain ++MOVE statements for each module that is eligible for the extended link pack area (ELPA). A read-only module that may reside above 16MB is eligible for the ELPA.

CICSPlex SM allocates an empty library for your use, called SYS1.CICSTS31.CPSM.SEYULPA. You can use SYS1.CICSTS31.CPSM.SEYULPA as the LPA library or you can add the modules to another LPA library.

If you are going to use SYS1.CICSTS31.CPSM.SEYULPA, verify that you have already authorized this library (see Authorizing libraries), and that you have applied appropriate security (see the CICS RACF® Security Guide.) You can give the SYS1.CICSTS31.CPSM.SEYULPA library your own high-level index. If you do, you must specify the new index on the LINDEX parameter of the EYUISTAR job.

The following sections provide information about:

Space requirements

Start of change

You must allow enough space in the link pack area for the installation of the selected CICSPlex SM modules.

The total space needed depends on how the modules are packaged into the link pack area by the operating system and a local MAS requires approximately 2 034KB.

End of change

Installing CICSPlex SM modules into the LPA

The term install means move or copy a module into the SYS1.CICSTS31.CPSM.SEYULPA library, by using SMP/E, or by using a copying method that reblocks 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). The procedure for installing modules in the LPA by using SMP/E is described in this section.

You should not relink-edit the modules in order to get them into the SYS1.CICSTS31.CPSM.SEYULPA library. CICSPlex SM modules, as supplied, have the necessary attributes that cause MVS to load them automatically above 16MB (into the ELPA).

The MVS link pack area has both pageable and fixed areas. Although you can install CICSPlex SM modules into the fixed areas, for performance reasons you should use the pageable areas.

Modules to be loaded into the MVS pageable link pack area (PLPA) must have been link-edited with the RENT attribute. The library in which these modules reside must be named in an LPALSTxx member of the SYS1.PARMLIB library.

To install modules in the CICSPlex SM LPA library, and to ensure that SMP/E can continue to service them, complete the following steps for one or both of the CICSPlex SM-supplied USERMODs:

  1. Receive the USERMOD into the CICSPlex SM global zone, and apply it to the CICSPlex SM target zone.
  2. Define the SYS1.CICSTS31.CPSM.SEYULPA library to your MVS.
Note:
You must also verify that the CSD referenced by the MAS contains the appropriate CICSPlex SM groups for loading modules from the LPA. For information about updating the CSD, see Updating CSD files using DFHCSDUP (MVS MAS).

Receiving and applying the USERMOD

To receive and apply the CICSPlex SM-supplied Start of changeUSERMOD, in EYU$UM01End of change, you can use the sample job EYULPMOD, which is tailored to your CICSPlex SM environment and stored in the CICSTS31.CPSM.XEYUINST library when you run the EYUISTAR job. Member EYULPMOD must be edited to receive and apply the desired USERMODs. Ensure that the EYUISTAR settings match the corresponding DFHISTAR settings.

Receive the USERMOD into the CICSPlex SM global zone and apply it to the CICSPlex SM target zone. This causes SMP/E to move those load modules you have specified from the named CICSPlex SM target library (either CICSTS31.CPSM.SEYUAUTH or CICSTS31.CPSM.SEYULOAD) into the SYS1.CICSTS31.CPSM.SEYULPA library.

When the USERMOD is applied, the corresponding LMOD entries within the target zone SMP CSI are updated. Either or both USERMODs may be applied depending on your enterprise’s requirements.

Do not accept the USERMOD into the distribution zone, and, for the time being, do not apply it to any other target zone.

Defining the SYS1.CICSTS31.CPSM.SEYULPA library to your MVS

Add the full name of the SYS1.CICSTS31.CPSM.SEYULPA library to an LPALSTxx member of SYS1.PARMLIB. This ensures that the library contents are loaded into the PLPA at the next IPL of your system when CLPA is specified.

When you have defined the SYS1.CICSTS31.CPSM.SEYULPA library to MVS, you should re-IPL your MVS with CLPA specified to enable the modules in the SYS1.CICSTS31.CPSM.SEYULPA library to be used from the LPA.

To run DFCSDUP to add the CICSPlex SM resource definitions required for MAS execution, use the following SYSIN control statement:

//SYSIN DD *
 UPGRADE USING(EYU9XXGB)
/*

Applying maintenance to LPA modules

Use the SMP/E RESTORE function to back off the USERMOD before modules in the LPA are updated or copied. Afterwards, the USERMOD may be reapplied.

[[ Contents Previous Page | Next Page Index ]]