Considerations when sharing the CSD (CMAS)

Before the CSD can be shared by multiple releases of CICS®, the CSD must be upgraded by installing the CICSPlex® SM resource definitions for the current CICS release. For information about doing so, see Considerations when upgrading the CSD release (CMAS).

If you are running a CMAS under a previous release of CICS that is accessing resource definitions in a CSD that has been upgraded to the current CICS release, you must update the CMAS group list. Because the CMAS group list definitions are secured against updates, you must create a copy of the CMAS group list and update the copy.

For example, to run DFHCSDUP to create a copy of the CMAS group list and add the CICS compatibility groups (DFHCOMP4, DFHCOMP5, DFHCOMP6, DFHCOMP7, DFHCOMP8, DFHCOMP9, and DFHCOMPA) that are required for a CICS/ESA 4.1 CMAS to access resource definitions in a CICS Transaction Server for z/OS® Release 3.1 CMAS; use the following SYSIN control statements:

Figure 53. Sample JCL to update CMAS group list
//SYSIN DD *
 UPGRADE USING(EYU964G0)
 APPEND    LIST(EYU310L0)  TO(EYUE41L0)
 ADD     GROUP(DFHCOMPA) LIST(EYUE41L0)
 ADD     GROUP(DFHCOMP9) LIST(EYUE41L0)
 ADD     GROUP(DFHCOMP8) LIST(EYUE41L0)
 ADD     GROUP(DFHCOMP7) LIST(EYUE41L0)
 ADD     GROUP(DFHCOMP6) LIST(EYUE41L0)
 ADD     GROUP(DFHCOMP5) LIST(EYUE41L0)
 ADD     GROUP(DFHCOMP4) LIST(EYUE41L0)
/*

The control statements in Figure 53 perform the following functions:

UPGRADE USING(EYU964G0)
Replaces the previous CICS/ESA, CICS TS for OS/390 or CICS Transaction Server for z/OS release CMAS group definitions with CICS Transaction Server for z/OS Release 3.1 group definitions. The CICS Transaction Server for z/OS Release 3.1 group definitions can be used to run a CICS/ESA 4.1, CICS TS for OS/390 or a CICS Transaction Server for z/OS Version 2 CMAS.
APPEND LIST(EYU310L0) TO(EYUE41L0)
Creates the unprotected copy of list EYU310L0.
ADD GROUP(DFHCOMPA) LIST(EYUE41L0)
Adds CICS Transaction Server for z/OS Release 2.2 compatibility group DFHCOMPA to the list EYUE41L0.
ADD GROUP(DFHCOMP9) LIST(EYUE41L0)
Adds CICS TS for OS/390 Release 3 compatibility group DFHCOMP9 to the list EYUE41L0.
ADD GROUP(DFHCOMP8) LIST(EYUE41L0)
Adds CICS TS for OS/390 Release 3 compatibility group DFHCOMP8 to the list EYUE41L0.
ADD GROUP(DFHCOMP7) LIST(EYUE41L0)
Adds CICS TS for OS/390 Release 2 compatibility group DFHCOMP7 to the list EYUE41L0.
ADD GROUP(DFHCOMP6) LIST(EYUE41L0)
Adds CICS TS for OS/390 Release 1 compatibility group DFHCOMP6 to the list EYUE41L0.
ADD GROUP(DFHCOMP5) LIST(EYUE41L0)
Adds CICS/ESA 4.1 compatibility group DFHCOMP5 to the list EYUE41L0.

This JCL completes with a return code of 04 when group or list that is referenced by the UPGRADE statements is installed for the first time. This occurs because the processing of the UPGRADE statements attempts to delete list EYU310L0 and group EYU310G0 before these resources are defined.

After this job is completed successfully, you can start a CICS/ESA 4.1 CMAS by referencing group list EYUE41L0; you can start a CICS TS for OS/390 Release 3 CMAS by referencing group list EYU310L0.

To start a CICS Transaction Server for z/OS Release 2.3CMAS, you can define an additional group list in a CICS TS for OS/390 CSD. Such a group list will include CICS compatibility group DFHCOMP8.

To start a CICS/ESA 4.1 CMAS, you can define an additional group list in a CICS TS for OS/390 CSD. Such a group list will include CICS compatibility groups DFHCOMPA, DFHCOMP9, DFHCOMP8, DFHCOMP7, DFHCOMP6, and DFHCOMP5, in that order.

For more information about upgrading the CICS CSD with compatibility group definitions, see the "Sharing the CSD between different releases of CICS" topic in the CICS Transaction Server for z/OS Migration from CICS TS Version 2.3 Guide,

[[ Contents Previous Page | Next Page Index ]]