This section describes CICS® support for Language Environment® and what to do to install that support. The use of Language Environment is essential in CICS Transaction Server for z/OS®, Version 3 Release 1.
Language Environment support is provided by run-time libraries that establish a common execution environment for application programs compiled by high-level languages. All programs compiled by a high-level language, whether by a Language Environment-conforming compiler or not, must be run under CICS-Language Environment support.
The CICS-Language Environment interface is initialized automatically when CICS can:
Language Environment initialization takes place during CICS startup, when CICS issues the message DFHAP1203I applid Language Environment is being initialized. The CEECCICS module is loaded, followed by a partition initialization call, before the start of second phase PLT processing. If Language Environment cannot successfully complete the initialization of all languages supported by CICS, or can only initialize some of them, it issues messages to the MVS™ console. If Language Environment initialization fails completely, it may be because the CEECCICS module could not be loaded, or something went wrong during the loading of a particular language routine.
To enable Language Environment support to be installed correctly by CICS:
The CEE group is added automatically to the CSD and to the grouplist DFHLIST during CICS installation, as part of the DFHCOMDS job
The definitions are also supplied as DEFINE statements in the CEECCSD and CEECCSDX members of the SCEESAMP library.
You can add the CEE group to any CICS startup group list named in the GRPLIST system initialization parameter.
For information about the attributes needed for Language Environment transient data destinations, see the IBM Language Environment for MVS & VM Programming Guide, SC26-4818.
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.
Language Environment is a prerequisite for application programs written in COBOL. For information about Language Environment, see the Language Environment for OS/390® Customization manual, SC28-1941.
Support for OS/VS COBOL programs is now withdrawn. These
programs, which had runtime support in CICS Transaction Server for z/OS Version 2, cannot run under CICS Transaction Server for z/OS
Version 3. OS/VS COBOL programs must be upgraded to Language Environment conforming COBOL, and recompiled against a level of COBOL compiler supported
by CICS. The CICS Application Programming Guide provides assistance with
converting OS/VS COBOL programs to Language Environment conforming COBOL.
To run COBOL application programs:
For your application programs, CICS can create and install program resource definitions automatically, or you can create them specifically in the CSD, and install them by using the GRPLIST system initialization parameter or CEDA INSTALL command. For more information about installing program resource definitions, see the CICS Resource Definition Guide.
For information about Language Environment support for programming languages, see the Program Directory for IBM Language Environment for MVS and VM.
Language Environment is a prerequisite for application programs compiled using IBM C/C++ for MVS or SAA AD/Cycle® C/370™ compilers. Language Environment incorporates the run-time libraries required for both these C language compilers. For information about Language Environment, see the Language Environment for OS/390 Customization manual, SC28-1941.
To run under CICS your C application programs:
For information about installing program resource definitions, see the CICS Resource Definition Guide.
CICS supports application programs written in C++ that:
If you use Version 3 Release 2, or late, of the C/C++ compiler to compile a C++ program, specify the CXX parameter when options are passed to the compiler, otherwise the C compiler is invoked. Do not specify CXX if a C program is to be compiled. See the IBM C/C++ for MVS/ESA Compiler and Run-Time Migration Guide Version 3 Release 2, SC33-2002, for further information.
For information about Language Environment support for programming languages, see the Program Directory for IBM Language Environment for MVS and VM.
Language Environment is a prerequisite for application programs compiled using IBM PL/I for MVS or SAA AD/Cycle PL/I compilers. Language Environment incorporates the run-time libraries required for both these PL/I compilers. For information about Language Environment, see the Language Environment for OS/390 Customization manual, SC28-1941.
PL/I support is also required if you use the Web services
support in CICS; in particular, it is required if you use the CICS-supplied SOAP
1.1 and SOAP 1.2 message handler programs.
To run CICS PL/I application programs :
For information about installing program resource definitions, see CICS Resource Definition Guide.
For information about Language Environment support for programming languages, see the Program Directory for IBM Language Environment for MVS and VM.
Language Environment is a prerequisite for CICS JVM programs.
However, unlike the other languages, JVM programs do not require the CICS-Language
Environment interface. JVM programs run with Language Environment support using MVS services (not CICS services). JVM programs
require the Language Environment support provided by the
SCEERUN and SCEERUN2 libraries only, which can either be defined in the CICS STEPLIB, or included in the MVS linklist. The
SCEERUN and SCEERUN2 libraries also need to be added to DFHRPL.