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.