Interface API and Configuration

Host Access Manager leverages a common interface and configuration to access different types of host system. When a backend host system changes, the application API is not required to change.

▪ Connector
The Connector integrates the definitions of the underlying connect service and the connection factory and pool. Connector creates the connection factory.

HostConnector hostConnector = Service.readObject("hostMQConnector");
HostConnectionFactory connectionFactory = hostConnector.createHostConnectionFactory();

Note the refService="mqConnService" configuration sets the link between the host connector and the legacy UDTT MQ service:

▪ Connection Factory
The Connection Factory creates the connections. One connection factory instance refers to only one connection pool instance.

HostConnection cxn = connectionFactory.getConnection();

▪ Connection
Connection represents a connection session with host. The Connection factory creates a new connection or obtains an existing connection from the pool by case. Connection creates the interaction.

HostInteraction ixn = cxn.createInteraction();

▪ Interaction and InteractionSpec
Interaction represents an interactive action after establishing a connection session with the host. InteractionSpec specifies the Interaction property like verb, timeout, and function name.

HostInteractionSpec ixnSpec = new HostInteractionSpec();
ixnSpec.setInteractionVerb(ixnSpec.SYNC_SEND_RECEIVE);
ixnSpec.setExecutionTimeout(6000);
HostData outgoingData=new UDTTHostData();
outgoingData.setData("TX019#54323487523#599.00");
HostData returnData=new UDTTHostData();
ixn.execute(ixnSpec, outgoingData, returnData);

Users can self-define verbs while extending a new connector, but in general, the following build-in verb definitions are supported: SYNC_SEND, SYNC_SEND_RECEIVE, SYNC_RECEIVE.

▪ HostData
HostData represents the data to be transferred between UDTT and the host. It is a java object. In the pre-build MQ and SNA host access manager implementation, it is plain string text.