IMS Connect support for the IMS TM Resource Adapter
To support Java™ application programs connecting to IMS TM, IMS Connect supports the IMS TM Resource Adapter.
The IMS TM Resource Adapter runs under WebSphere® Application Server in distributed environments and is used by Java applications, Java Platform, Enterprise Edition (Java EE) applications or web services to access IMS transactions that are running on host IMS systems. It is also used by IMS applications that run in IMS dependent regions to make asynchronous callout requests to external Java EE applications.
The IMS TM Resource Adapter connects to IMS Connect through the TCP/IP communications protocol.
When a Java application submits a transaction request to IMS through the IMS TM Resource Adapter, IMS Connect sends the transaction request to IMS Open Transaction Manager Access (OTMA) by using the z/OS® cross-system coupling facility, and the transaction runs in IMS. The response is returned to the Java application using the same path.
When an IMS application invokes an external enterprise JavaBeans (EJB) component or web service through a callout request, IMS Connect retrieves the callout request from a hold queue and passes it to the IMS TM Resource Adapter, which in turn passes the request to an EJB application in WebSphere Application Server that is set up to receive callout requests. The EJB starts a connection to IMS Connect via the IMS TM Resource Adapter. The IMS TM Resource Adapter polls IMS Connect to retrieve the callout requests from the hold queue. The EJB processes the request, and returns any response data to IMS by issuing a normal IMS transaction request.
IMS Connect identifies TCP/IP connections by a client ID that is submitted by the IMS TM Resource Adapter.
For connections on persistent TCP/IP sockets, IMS Connect can generate a client ID for the IMS TM Resource Adapter in any of the following cases:
- The IMS TM Resource Adapter requests that IMS Connect generate a unique client ID in the event that a client ID submitted by the IMS TM Resource Adapter is a duplicate of an existing IMS TM Resource Adapter client ID.
- The IMS TM Resource Adapter submits a blank client ID.