This document describes how to set up the External Call Interface (ECI) within CICS. It covers the following topics:
Important:
If the terms and concepts in this document are unfamiliar to you, please work with the appropriate CICS system programmer.
Only authorized personnel should make changes to mainframe computer systems.
The DFH$SOT group contains three TCP/IP services. For our
purposes, the pertinent service is ECI. The ECI service has, defined in it, the
TCP/IP port number through which the CICS region listens to the ECI. By
default, IBM predefines the TCP/IP port number as
"1435". If this port is already reserved for another
CICS region, you may have to define a different port number in the ECI service.
For more information, see your IBM documentation.
You must specify SOCKETCLOSE(NO) on the
TCPIPSERVICE. If you need to specify a timeout
for a task initiated using ECI over TCP/IP, specify an RTIMOUT
value on the mirror transaction. Note that the standard mirror,
CPMI, is defined with profile DFHCICSA, which
specifies RTIMOUT(NO). This means that long running mirrors will
wait indefinitely for data, unless you specify a different
RTIMOUT for the mirror transaction.
To define an ECI service without security
Use CEDA ALTER to supply the ECI TCPIPService with a unique TCP/IP port number.
Use CEDA ALTER to set the ECI ATTACHSEC to "LOCAL"
To define an ECI service with security
Copy the ECI TCPIPService to an ECIS TCPIPSERVICE.
Use CEDA ALTER to supply the ECIS TCPIPSERVICE with a unique TCP/IP port number.
Use CEDA ALTER to set the ECIS ATTACHSEC to "VERIFY".
A successful installation should pass the following verification tests:
CEMT INQUIRE TCPIPSERVICE(*) should now display your services with status OPE. A status of CLO might indicate an already used (not unique) TCP/IP port
number.
CEMT I TCPIPSERVICE(ECI) to verify TCPIPSERVICE in CICS.
CEMT I TRA(CIEP) to verify transaction CIEP in CICS.
CEMT I PROGRAM(DFHIEP) to verify program DFHIEP in CICS.
CEMT I TRAN(CPMI) to verify transaction CPMI in CICS.
CEMT I PROGRAM(DFHMIRS) to verify program DFHMIRS in CICS.
CEMT I TD(CIEO) to verify program TQ queue CIEO.
Verify that the groups DFHISC DFHDCTG and DFHIPECI are added to the active autoinstall.
Tip:
You can check the mentioned programs and transactions and TD queues by using CEMT INQUIRE TCPIPSERVICE(*).
This table describes the handling of errors in the CICS ECI connection or the RPC Server for CICS ECI.
| Problem | Handling |
|---|---|
| A CICS program sends abend code in response. | The CICS session is closed and the next call opens a different session. |
The TCP/IP connection is lost with a SocketTimeoutException.
|
The CICS session is closed and the next call opens a different session. |
The TCP/IP connection is lost with an EOFException.
|
|