Class Hierarchy All Classes All Fields and Methods

Class com.ibm.connector2.ims.ico.IMSConnection

java.lang.Object
   |
   +----com.ibm.connector2.ims.ico.IMSConnection

public class IMSConnection
extends Object

An IMSConnection instance is an application-level handle that is used by a component to access an underlying physical connection to IMS Connect. IMS Connect in turn uses the Cross System Coupling Facility (XCF) to access IMS OTMA. A physical connection, such as a TCP/IP socket or Local Option connection, is represented by an IMSManagedConnection instance. An application that uses the Common Client Interface (CCI) obtains an IMSConnection instance by invoking the getConnection() method of an IMSConnectionFactory instance.

The variant of the getConnection() method that is used depends on how the the application is configured. For example:

Constructor Index
Constructor Description
IMSConnection(ManagedConnection) Creates an IMSConnection instance as an application handle to an IMSManagedConnection instance representing a physical connection such as a TCP/IP socket or a Local Option connection.
Method Index
Method Description
void close() Releases an allocated connection handle.
javax.resource.cci.Interaction createInteraction() Creates an IMSInteraction instance to use to interact with IMS OTMA via IMS Connect.
javax.resource.cci.LocalTransaction getLocalTransaction() Returns a LocalTransaction instance that enables a component to demarcate resource manager local transactions (not supported).
javax.resource.cci.ConnectionMetaData getMetaData() Returns information about the IMS Connect and IMS instances connected by an IMSConnection instance.
javax.resource.cci.ResultSetInfo getResultSetInfo() Returns a ResultSetInfo object (not supported).

Constructors

IMSConnection

public IMSConnection(ManagedConnection aManagedConnection) 

Creates an IMSConnection instance as an application handle to an IMSManagedConnection instance representing a physical connection such as a TCP/IP socket or a Local Option connection.

Methods

close

public void close() throws ResourceException

Releases an allocated connection handle.

createInteraction

public javax.resource.cci.Interaction createInteraction() throws ResourceException

Creates an IMSInteraction instance to use to interact with IMS OTMA via IMS Connect. For example, an application that uses the Common Client Interface (CCI) can use an IMSInteraction instance to submit an IMS transaction using the associated IMSConnection instance.

getLocalTransaction

public javax.resource.cci.LocalTransaction getLocalTransaction() throws ResourceException

Returns a LocalTransaction instance that enables a component to demarcate resource manager local transactions (not supported).

Note: IMS Connector for Java currently does not have local transaction support.

getMetaData

public javax.resource.cci.ConnectionMetaData getMetaData() throws ResourceException

Returns information about the IMS Connect and IMS instances connected by an IMSConnection instance.

getResultSetInfo

public javax.resource.cci.ResultSetInfo getResultSetInfo() throws ResourceException

Returns a ResultSetInfo object (not supported).

Note: ResultSetInfo is not supported by IMS Connector for Java.

Class Hierarchy All Classes All Fields and Methods