Update the CSD based on the newest CEECCSD

Description

Each release, Language Environment® adds or deletes load modules in the CICS® system definition (CSD) file. Therefore, the CSD file must be updated every release, based on the sample CSD program definitions in members CEECCSD and CEECCSDX in the SCEESAMP data set. The CSD samples from the latest release of z/OS can be used for earlier releases of z/OS that can co-exist with the current release.

If your installation is running CICS Transaction Server for z/OS 4.2 or earlier, you must update the CSD file with the program definitions in member CEECCSD and member CEECCSDX. For later releases of CICS TS, you can skip this step if your installation uses the automatic update function that was provided in APARs PI60389 and PI73184.

Table 1 provides more details about this migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature: Language Environment.
When change was introduced: General migration action not tied to a specific release.
Applies to migration from: z/OS V2R2 and z/OS V2R1.
Timing: Before the first IPL of z/OS V2R3.
Is the migration action required? Yes, if you use:
  • CICS TS 4.2 or earlier
  • CICS TS 5.1, 5.2, or 5.3, and you do not allow program definitions to be updated automatically.
Target system hardware requirements: None.
Target system software requirements: For CICS TS 5.1, 5.2, and 5.3, the optional, but recommended, approach is not to add the Language Environment required program resource definitions to the CSD. Instead, allow the program resource definitions to be automatically updated by CICS through its system autoinstall functionality, which installs the program definitions when they are required.

For CICS TS 5.4 and later, use of the automatic update function is required.

Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: Failure to perform this migration action can result in several various program ABENDs, such as ABENDU4093 RC=3EC. Which ABEND you see depends on the programming language, and the level of the programming language, that you use.
Related IBM® Health Checker for z/OS® check: None.

Steps to take

If your installation is running CICS TS 4.2 or earlier, you must update the CSD file with the program definitions in member CEECCSD and member CEECCSDX. These members are contained in the data set hlq.SCEESAMP.

Note: The group that contains the Language Environment runtime routines must be in the group list that is used during CICS startup.

For CICS TS 5.1, 5.2, and 5.3, you can skip this step, if you allow CICS to install the program definitions automatically. This function was provided in APARs PI60389 and PI73184. Otherwise, you must update the CSD file manually.

For CICS TS 5.4 and later, use of the CICS automatic update function is required. This function ensures that the Language Environment definitions are installed with the same program attributes as was used previously.

Reference information

For more information, see the following references: