Starting a parallel session on an ISC TCP/IP link from CICS

From IBM® CICS® Transaction Server for z/OS®, you start an ISC TCP/IP parallel session with IMS by issuing the CICS command SET IPCONN(ipconnnm) ACQUIRE.

Prerequisites: Before you can start an ISC TCP/IP session with IMS from CICS:
  • The connection must be defined in IMS, IMS Connect, and CICS as described in Setting up an ISC TCP/IP connection with CICS.
  • In IMS, the ISC terminal must be defined to use TCP/IP. If the terminal is not defined in IMS to use TCP/IP, IMS rejects the request to start the session.

To start an ISC TCP/IP session from CICS, you need the 1-to-4 character IPCONN name from the IPCONN resource that defines the ISC connection in CICS. This value is the same as the USER value that identifies the parallel session in IMS.

If you migrated LUTYPE 6.1 links from ISC VTAM® to ISC TCP/IP, the IPCONN name is likely the same as the name of the CONNECTION resource that defined the ISC VTAM link.

You can issue the SET IPCONN ACQUIRE command through several different CICS interfaces, including:
  • The CICS Explorer®
  • The CICS system programming interface (SPI)
  • The CICS master terminal transaction CEMT
  • The CICS command-level interpreter (CECI) transaction

Procedure

For example, to start an ISC parallel session with IMS from CICS by using CEMT, issue the following command:
Read syntax diagramSkip visual syntax diagramCEMT SET IPCONN( ipconnnm) ACQUIRED

When a session starts successfully, IMS issues message DFS2064I to the master terminal and IMS and CICS perform a capability exchange to validate the session and server attributes.

To check that the session was started, issue the INQUIRE IPCONN(ipconnnm) command by using any of the CICS command interfaces.

After the session starts, CICS application programs can use the CICS START and RETRIEVE commands to process IMS nonresponse mode and nonconversational transactions, message switches, and the IMS /DISPLAY, /RDISPLAY, and /SIGN operator commands.