Installing Language Environment support

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:

  1. Load the Language Environment interface modules, CEECCICS, CEEPIPI, and CEECTCB, from STEPLIB.
  2. Successfully call the CEECCICS module to initialize the interface.

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.

Installing CICS support for Language Environment

To enable Language Environment support to be installed correctly by CICS:

Language Environment support for COBOL

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.

Start of changeSupport 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.End of change

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 support for C and C++

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 support for PL/I

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.

Start of changePL/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.End of change

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 support for CICS JVM programs

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. Start of changeThe SCEERUN and SCEERUN2 libraries also need to be added to DFHRPL.End of change

Related concepts
the  CICS Application Programming Guide
Related tasks
Adding CICS support for programming languages

Related tasks
Adding CICS support for programming languages
Installing Language Environment support
the  CICS Resource Definition Guide
the  CICS Application Programming Guide
the  CICS Application Programming Guide
the  CICS Application Programming Guide
the  CICS Application Programming Guide
[[ Contents Previous Page | Next Page Index ]]