Making ECI calls from a Java client program

This section describes how to run a program on a CICS® server using ECI calls from a Java™ client application.

Use the com.ibm.ctg.client.ECIRequest base class and the JavaGateway flow method to pass details of an ECI request to CICS Transaction Gateway. The following table shows Java objects corresponding to the ECI terms described in I/O parameters on ECI calls.

Table 1. ECI terms and corresponding Java objects
ECI term	Java object.field or object.method()
Abend code	ECIRequest.Abend_Code
Channel	ECIRequest.setChannel(channel) See Introduction to channels and containers.
COMMAREA	ECIRequest.Commarea See ECI performance considerations when using COMMAREAs.
ECI timeout	ECIRequest.setECITimeout(short) See Timeout of the ECI request.
LUW control	ECIRequest.Extend_Mode See Program link calls.
LUW identifier	ECIRequest.Luw_Token See Managing logical units of work.
Message qualifier	ECIRequest.getMessageQualifier() and ECIRequest.setMessageQualifier() See Retrieving replies from asynchronous ECI requests.
Password or password phrase	ECIRequest.Password See Security in the ECI.
Program name	ECIRequest.Program
Server name	ECIRequest.Server
TPNName	ECIRequest.Call_Type = ECI_SYNC_TPN or ECI_ASYNC_TPN and ECIRequest.Transid See ECI and CICS transaction IDs.
TranName	ECIRequest.Call_Type = ECI_SYNC or ECI_ASYNC and ECIRequest.Transid See ECI and CICS transaction IDs.
User ID	ECIRequest.Userid See Security in the ECI.