Migrating the listener regions

  1. Quiesce a listener region and bring it down.
  2. Upgrade this single listener region to CICS® Transaction Server for z/OS®, Version 3 Release 1, following the standard migration procedures described in CICS Transaction Server for z/OS Migration from CICS TS Version version_number, where version_number is the version number of your back-level CICS release.
    Important:
    1. If you upgrade a CSD from CICS TS 2.2 to CICS TS for z/OS, Version 3.1 level, if it is shared by any CICS TS 2.2 regions other than that being upgraded, include the DFHCOMPA resource group (supplied with CICS TS for z/OS, Version 3.1) in the startup group list of these regions. DFHCOMPA is a compatibility group that provides a definition of DFJIIRP, the default request processor program, that can be used by a CICS TS 2.2 region when sharing a CICS TS for z/OS, Version 3.1 CSD.

      This step is necessary because, in CICS TS for z/OS, Version 3.1, the JVM profile used by DFJIIRP is DFHJVMCD. In CICS TS 2.2, it is DFHJVMPR.

    2. At this stage, don't enable any new, CICS TS for z/OS, Version 3.1-specific, options on resource definitions, because they won't be understood by the back-level AORs. Use of these new features must wait until the whole logical server—both listener regions and AORs—has been upgraded.

    For definitive information about setting up a listener region in CICS TS for z/OS, Version 3.1, refer to Configuring CICS for IIOP.

  3. Bring the listener back up. This region is now at the newer version of CICS but may continue to participate as part of the back-level logical server.
  4. Repeat steps 1 through 3 for all of the listener regions in the logical server.