Installing CICS support for Language Environment

To enable Language Environment® support to be installed correctly by CICS®, specify storage requirements and ensure that you have the required modules and resource definitions.

1. Specify enough storage for the extended read-only dynamic storage area (ERDSA) to run CICS and Language Environment together. They require a minimum of 3,500 KB. To this minimum, add an amount of storage sufficient for your own requirements.
2. Ensure the CICS-Language Environment interface module, CEECCICS, and the Language Environment modules CEEPIPI and CEECTCB are installed in an APF-authorized library defined in the STEPLIB concatenation in the CICS startup JCL. You can do this by including the Language Environment SCEERUN library in an APF-authorized library in the STEPLIB concatenation of your CICS startup job, for example, in the CICSTS55.CICS.SDFHAUTH library, or in an APF-authorized library in the MVS LNKLSTnn concatenation.
3. Ensure that the CEE group is removed from any CICS startup group list named in the GRPLIST system initialization parameter. If CEE group definitions have been converted to bundle definitions or CICSPlex® SM BAS definitions, these should also be removed. This is because with the CICS system autoinstall function, CICS dynamically installs Language Environment definitions when required, rather than installing a large number of definitions during startup.
   Note: Language Environment requires some definitions to be preloaded, such as the event handlers for Language Environment, which are named CEEEVnnn. So, during CICS initialization, Language Environment attempts to load all its 18 event handlers. As a result, all the 18 Language Environment event handler definitions are automatically installed; but later in initialization, before PLT phase 2, CICS discards, where possible, event handlers that are not required in a CICS environment.

   The following event handlers are retained because they are required in a CICS environment:

   • CEEEV003 for C and C++
   • CEEEV004 and CEEEV005 for COBOL
   • CEEEV006 for Debug Tool
   • CEEEV010 and CEEEV011 for PL/I

   In addition, two unwanted handlers, CEEEV007 for Fortran and CEEEV012 for OE sockets, will remain because Language Environment has successfully loaded the two event handler programs.

4. Define the Language Environment transient data destinations, CESE and CESO (DD names CEEMSG and CEEOUT).
   The CICS-supplied resource definition group DFHDCTG, in the CSD, contains entries for CESE and CESO.

   For information about the attributes required for Language Environment transient data destinations, see the z/OS Language Environment Programming Guide.

5. Define the Language Environment runtime libraries on the CICS STEPLIB and DFHRPL DD statements:
   1. Add the following libraries to STEPLIB or to a library in the MVS LNKLSTnn concatenation:
      • SCEERUN, which contains CEECCICS and CEECTCB
      • SCEERUN2, which contains support that is required for the IBM® Java™ Virtual Machine (JVM) and also support for other programming languages

      Both the libraries, SCEERUN and SCEERUN2, must be APF-authorized.

   2. Add the SCEECICS, SCEERUN2, and SCEERUN libraries to DFHRPL.

   For example:

   //*               CICS APF-authorized libraries
   //STEPLIB  DD DSN=hlq.CICS.SDFHAUTH,DISP=SHR
   //         DD DSN=hlq.LE.SCEERUN2,DISP=SHR
   //         DD DSN=hlq.LE.SCEERUN,DISP=SHR
   //*               CICS load libraries
   //DFHRPL   DD DSN=hlq.CICS.SDFHLOAD,DISP=SHR
   //         DD DSN=hlq.LE.SCEECICS,DISP=SHR
   //         DD DSN=hlq.LE.SCEERUN2,DISP=SHR
   //         DD DSN=hlq.LE.SCEERUN,DISP=SHR

   Use only these Language Environment runtime libraries for all your high-level language application programs.