Design overview

Communication between CICS® and Language Environment® is made by calling a special Language Environment interface module (CEECCICS) and passing to it a parameter list (addressed by register 1), which consists of an indication of the function to be performed and a set of address pointers to data values or areas.

Module CEECCICS is distributed in the Language Environment library, but must be copied to an authorized library defined in the STEPLIB concatenation of the CICS startup job stream.

All calls to Language Environment are made directly from the CICS language interface module DFHAPLI. This module is called by several components of CICS to perform specific functions. Table 1 lists those functions, and shows the name of the CICS module initiating each function call and the Language Environment call made by DFHAPLI to support the function. The format of each call parameter list is given in External interfaces.

Table 1. Language Environment interface calls
Function Module Language Environment call
Terminate Languages DFHSTP Partition Termination
Establish Language

DFHPGLK
DFHPGLU
DFHPGPG

Establish Ownership Type
Start Program

DFHPGLK
DFHPGLU

Thread Initialization
Run Unit Initialization
Run Unit Begin Invocation
Run Unit End Invocation
Run Unit Termination
Thread Termination

Goto DFHEIP Perform Goto
Find Program Attributes DFHEDFX Determine Working Storage
Initialize Languages DFHSIJ1 Partition Initialization
The logical relationship between the different calls is shown in Figure 1.
Figure 1. Language Environment interface components
Diagram showing the function calls from CICS to Language Environment and their logical relationship.
Note: The actual passing of control to CEECCICS is made from the CICS language interface program (DFHAPLI), which provides a single point of contact between CICS and Language Environment. Other modules call DFHAPLI to initiate the intended function.

All calls to DFHAPLI use either the DFHAPLIM macro (for calls from outside the CICS application domain), or the DFHLILIM macro (for calls made from within the application domain).



dfhs3c00831.html | Timestamp icon Last updated: Monday, 5 June 2017