Previous Topic: IMSNext Topic: Debugging Applications


Customize for ECI

A CA Gen CICS server is accessible by CA Gen clients using the CICS Client External Call Interface (ECI). CA Gen C and Java clients and those using Communications Bridge can use ECI communications. Depending on where and how the CA Gen clients are deployed, each client type may require CICS Universal Clients or CICS Transaction Gateway.

Note: For more information about CICS Universal Clients and CICS Transaction Gateway, see the CICS Transaction Gateway documentation.

A CA Gen server invoked through ECI is started by a Distributed Program Link (DPL) request. The DPL request uses the CICS supplied Mirror Program (DFHMIRS) to start the requested Gen server. By default, the transaction ID CPMI invokes the CICS Mirror Program. In some cases, it may be desirable to use a transaction ID other than CPMI for ECI requests.

For Java clients, the trancode associated with the target server application in Construction Packaging is the transaction ID used when the commcfg.properties file parameter ECIUseSyncTpn is set to Yes.

For clients using the Communications Bridge, the data pointed to by parameter pECITpn of the Communications Bridge exit ioeciclx.c is used.

For GUI and C proxy clients, the data pointed to by parameter pTpn of the Windows exit cieciclx.c is used.

When using a transaction ID other than CPMI, define the relevant transaction in CICS to point to the DFHMIRS program and use profile DFHCICSA. CA Gen applications using ECI and non-ECI cooperative flows cannot share this transaction definition.

The interface assumes that data translation (ASCII to EBCDIC) and code page conversion is required and automatically invokes the conversation table DFHCNV. CA Gen does translation and conversion, so this step is not necessary. However, a conversion table is still required. Code a DFHCNV table with TYPE=INITIAL and TYPE=FINAL macros only. Assemble, link, and make the table available to CICS.

Sample DFHCNV that CA Gen requires:

DFHCNV      TYPE=INITIAL
DFHCNV      TYPE=FINAL
END

To use this table for another application, ensure that no translation or conversion is done for CA Gen server applications. For more information on the DFHCNV table, see the CICS Family Communicating from CICS on S/390.