Defining links for use by the external CICS interface

This section describes how to define connections for use by non-CICS® programs that use the external CICS interface (EXCI) to link to CICS server programs. The definitions required are similar to those needed for MRO links between CICS systems. Each connection requires a CONNECTION and a SESSIONS definition.

Because EXCI connections are used for processing work from external sources, you must not define any SEND sessions.

EXCI connections can be defined as “specific” or “generic”. A specific EXCI connection is an MRO link on which all the RECEIVE sessions are dedicated to a single user (client program). A generic EXCI connection is an MRO link on which the RECEIVE sessions are shared by multiple users. Only one generic EXCI connection can be defined on each CICS region.

On definitions of both specific and generic connections, you must:
  • Specify PROTOCOL(EXCI).
  • Specify ACCESSMETHOD(IRC). The external CICS interface does not support the MRO cross-memory access method (XM). The cross-system coupling facility (XCF) is supported.
  • Let SENDCOUNT and SENDPFX default to blanks.

Example CONNECTION attributes for a specific EXCI connection

CONNECTION(EIP1)
The local name for the connection
NETNAME(CLAP1)
The name of the user program specified on the EXCI INITIALIZE_USER command.
ACCESSMETHOD(IRC)
PROTOCOL(EXCI)
CONNTYPE(Specific)
Pipes are dedicated to a single user
INSERVICE(YES)
ATTACHSEC(LOCAL)

Example SESSIONS attributes for a specific EXCI connection

SESSIONS(csdname)
A unique csd name
CONNECTION(EIP1)
The name of the associated CONNECTION resource
PROTOCOL(EXCI)
RECEIVEPFX(<)
RECEIVECOUNT(5)
5 receive sessions
SENDPFX
Do not specify
SENDCOUNT
Do not specify

Example CONNECTION attributes for a generic EXCI connection

CONNECTION(EIP2)
The local name for the connection
ACCESSMETHOD(IRC)
NETNAME()
Must be blank for generic connection
INSERVICE(YES)
PROTOCOL(EXCI)
CONNTYPE(Generic)
Pipes are shared by multiple users
ATTACHSEC(LOCAL)
Figure 1. Example SESSIONS attributes for a generic EXCI connection
SESSIONS(csdname)
A unique csd name
CONNECTION(EIP2)
The name of the associated CONNECTION resource
PROTOCOL(EXCI)
RECEIVEPFX(<)
RECEIVECOUNT(5)
5 receive sessions
SENDPFX
Do not specify
SENDCOUNT
Do not specify


dfht132.html | Timestamp icon Last updated: Sunday, 4 June 2017