Making ECI calls from C programs

You can make ECI V2 calls to a CICS server from a C Client application in remote mode.

Use the CTG_ECI_PARMS parameter block structure to communicate with a CICS® server. The parameter block fields are used for input and output. To communicate with the CICS server using the Gateway daemon use the CTG_ECI_Execute function. The Remote Client interface requires Version 2 of the ECI Parameter block. Set the ECI parameter block to nulls before setting the input parameter fields. For guidance on how to use the ECI to manage logical units See Managing logical units of work.

The following table shows the field names in C data structures that correspond to the ECI terms described in I/O parameters on ECI calls.

Table 1. ECI terms and corresponding fields in C in remote mode
ECI term C structure.field
Abend code CTG_ECI_PARMS.eci_abend_Code
Start of change Channel End of change Start of change CTG_ECI_PARMS.channel. See Introduction to channels and containers. End of change
COMMAREA CTG_ECI_PARMS.eci_commarea
ECI timeout CTG_ECI_PARMS.eci_timeout. See Timeout of the ECI request.
LUW control CTG_ECI_PARMS.eci_extend_mode. See Program link calls.
LUW identifier CTG_ECI_PARMS.eci_luw_token. See Managing logical units of work.
Start of change Message qualifier End of change Start of change CTG_ECI_PARMS.eci_message_qualifier. See Retrieving replies from asynchronous ECI requests. End of change
Password or password phrase CTG_ECI_PARMS.eci_password_ptr. See Security in the ECI.
Program name CTG_ECI_PARMS.eci_program_name
Server name CTG_ECI_PARMS.eci_system_name
TPNName CTG_ECI_PARMS.eci_tpn. See ECI and CICS transaction IDs.
TranName CTG_ECI_PARMS.eci_transid. See ECI and CICS transaction IDs.
User ID CTG_ECI_PARMS.eci_userid_ptr. See Security in the ECI.

Concept Concept

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//progdezos/ecicalls_remotemode.html