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.
- 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)
- 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

