Client connection resource

The client connection definition holds the detailed information required to make a connection to an MQ queue manager. The connection properties are shown in the following table:
Table 1. Client connection service properties
Property Explanation
Adapter class Class to be used as the gateway adapter
CCSID* The integer MQ CCSID value to be used
Class Bridge client connection service class
Max connection idle time The maximum time a connection is allowed to be idle before being terminated
MQ password* Password for use by the Java™ client
MQ port* IP port number used to create connections to the MQ queue manager via the Java client classes. If not specified then the MQ queue manager is assumed to be on the same machine as the bridge and the Java bindings are used
MQ receive exit class* Used to match the receive exit used at the other end of the client channel; the exit has an associated string to allow data to be passed to the exit code
MQ security exit class* Used to match the security exit used at the other end of the client channel; the exit has an associated string to allow data to be passed to the exit code
MQ send exit class* Used to match the send exit used at the other end of the client channel; the exit has an associated string to allow data to be passed to the exit code
MQ user ID* user ID for use by the Java client
Client connection service name Name of the server connection channel on the MQ machine
Name of owning queue manager proxy The name of the owning queue manager proxy
Startup rule class Rule class used when the bridge client connection service is started
Sync queue name The name of the MQ queue that is used by the bridge for synchronization purposes
Sync queue purger rules class The rules class to be used when a message is found on the synchronous queue
Run state Status: running or stopped
Name of owning Bridge The name of the bridge that owns this client connection
MQ XmitQ Listener Children List of all the listeners that use this client connection

The adapter class is used to send messages from MQe to MQ and the sync queue is used to keep track of the status of this process. Its contents are used in recovery situations to guarantee assured messaging; after a normal shutdown the queue is empty. It can be shared across multiple client connections and across multiple bridge definitions provided that the receive, send and security exits are the same. This queue can also be used to store state about messages moving from MQ to MQe , depending upon the listener properties in use. The sync queue purger rules class is used when a message is found on the sync queue, indicating a failure of MQe to confirm a message.

The maximum connection idle time is used to control the pool of Java client connections maintained by the bridge client connection service to its MQ system. When an MQ connection becomes idle, through lack of use, a timer is started and the idle connection is discarded if the timer expires before the connection is reused. Creation of MQ connections is an expensive operation and this process ensures that they are efficiently reused without consuming excessive resources. A value of zero indicates that a connection pool should not be used.

More detail of each property can be found in the Java Programming Reference, in the administration class com.ibm.mqe.mqbridge.MQeClientConnectionAdminMsg.

Each client connection object supports the full range of create,inquire, inquire-all, update, start, stop, delete operations. Examples of these operations can be found in the Java class examples.mqbridge.administration.programming.AdminHelperMQClientConnection.


Terms of use | WebSphere software

(c) Copyright IBM Corporation 2004, 2005. All rights reserved.