IBM MQ link [Settings]
The WebSphere® MQ link connects the messaging engine as a queue manager to IBM MQ, providing a bridge between the bus and a IBM MQ network.
To view this page in the console, click the following path:
For more information about choosing settings, see the Intercommunication section of the IBM MQ information center.
If WebSphere MQ functionality has been disabled at any scope, an informational message indicating that WebSphere MQ has been disabled is displayed. In a single server environment this informational message is only displayed when the server is restarted after WebSphere MQ functionality has been disabled. In a network deployment environment the informational message is displayed immediately. For more information see Disabling WebSphere MQ functionality in WebSphere Application Server.
Configuration tab
The Configuration tab shows configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.
General Properties
Name
The name of the IBM MQ link, used for administrative purposes.
Information | Value |
---|---|
Required | Yes |
Data type | String |
UUID
The universal unique identifier assigned by the system to this IBM MQ link for administrative purposes.
Information | Value |
---|---|
Required | No |
Data type | String |
Description
An optional description for the IBM MQ link, for administrative purposes.
Dynamic updates to this property are effective immediately.
Information | Value |
---|---|
Required | No |
Data type | Text area |
Foreign bus connection name
The foreign bus to which this link connects.
Information | Value |
---|---|
Required | Yes |
Data type | drop-down list |
Local messaging engine
The local messaging engine that this IBM MQ link is hosted on.
Information | Value |
---|---|
Required | Yes |
Data type | drop-down list |
Virtual queue manager name
The virtual queue manager name by which the local bus is to be known to a IBM MQ network. It is generally recommended that you set the virtual queue manager name to match the name of the local bus. As IBM MQ queue manager names can be no longer than 48 characters, you must ensure that the length of the local bus name does not exceed 48 characters.
- It must contain between 1 and 48 characters.
- It must conform to the IBM MQ queue naming rules (see the Rules for naming IBM MQ objects topic in the IBM MQ information center).
Information | Value |
---|---|
Required | Yes |
Data type | String |
Batch size
The maximum number of messages that can be sent through a channel before taking a checkpoint.
For information about choosing the batch size, see the description of the Batch size (BATCHSZ) property in the Intercommunication section of the IBM MQ information center.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information | Value |
---|---|
Required | No |
Data type | Integer |
Range | 1 through 9999 |
Maximum message size
The maximum message length, in bytes, that can be transmitted on any channel for the IBM MQ link. This is compared with the value for the corresponding partner IBM MQ channel and the actual maximum used is the lower of the two values.
For more information about choosing a value for the maximum message size, see the description of the Maximum message length (MAXMSGL) property in the Intercommunication section of the IBM MQ information center.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information | Value |
---|---|
Required | No |
Data type | Integer |
Range | 0 through 104857600 |
Heartbeat interval
The negotiated time, in seconds, between heartbeat flows passed from the IBM MQ link sender channel to the IBM MQ receiver channel when there are no messages on the transmission point being served by the IBM MQ link sender channel.
Heartbeats give the receiving channel the opportunity to quiesce the channel connection.
For more information about choosing a value for this property, see the Intercommunication section of the IBM MQ information center.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information | Value |
---|---|
Required | No |
Data type | Integer |
Range | 0 through 999999 |
Sequence wrap
The value at which message sequence numbers wrap to start again at 1.
For more information about choosing a value for this property, see the description of the Sequence Numberwrap (SEQWRAP) property in the Intercommunication section of the IBM MQ information center.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information | Value |
---|---|
Required | No |
Data type | Long |
Range | 100 through 999999999 |
Adoptable
Whether or not a running instance of a IBM MQ link receiver channel (associated with this MQ link) should be adopted or not. In the event of a communications failure, it is possible for a running instance of a IBM MQ link receiver channel to be left waiting for messages. When communication is re-established, and the partner IBM MQ sender channel next attempts to establish a session with the IBM MQ link receiver channel, the request will fail as there is already a running instance of the IBM MQ link receiver channel that believes it is in session with the partner IBM MQ sender channel. You can overcome this problem by selecting this option, which causes the already running instance of the IBM MQ link receiver channel to be stopped and a new instance to be started.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information | Value |
---|---|
Required | No |
Data type | Boolean |
Exception destination
The destination for an inbound message when the IBM MQ link cannot deliver the message to its target bus destination, or to the exception destination that is configured for that target destination, or when the target destination does not exist.
- Select None to specify that the IBM MQ link does not use an exception destination. Undeliverable messages are not rerouted to an exception destination and can block the processing of other messages waiting for delivery through that link to the same bus. This option can be used to preserve message ordering.
- Select System to use the default exception destination. Messages that cannot be delivered to the bus destination are rerouted to the system default exception destination for the messaging engine that this link is assigned to: _SYSTEM.Exception.Destinationmessaging_engine_name.
- Select Specify and enter an exception destination to use the exception destination specified here. If the IBM MQ link cannot use this exception destination, it uses the system exception destination.
Information | Value |
---|---|
Required | No |
Data type | Custom |
Default | System |
Initial state
Whether the IBM MQ link is started or stopped when the hosting messaging engine is first started. Until it is started, the IBM MQ link is unavailable.
Dynamic updates to this property are effective when the messaging engine restarts. Use the Runtime tab to check the current state.
Information | Value |
---|---|
Required | No |
Data type | drop-down list |
Range |
|
Nonpersistent message speed
The class of service for nonpersistent messages on channels of this IBM MQ link.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information | Value |
---|---|
Required | No |
Data type | drop-down list |
Range |
|
Additional Properties
- Publish/subscribe broker profiles
- Profiles used to define the topic mappings and transactionality for publishing and receiving (by subscription) topics across the publish/subscribe bridge between WebSphere Application Server and a IBM MQ network.
- Receiver channel
- The receiver channel that receives messages from the gateway queue manager. The receiver channel communicates with a IBM MQ sender channel on the gateway queue manager, and converts MQ format messages to service integration bus messages.
- Sender channel
- The sender channel that sends messages to the gateway queue manager. The sender channel communicates with a IBM MQ receiver channel on the gateway queue manager, and converts service integration bus messages to MQ format messages.
- Sender channel transmitters
- The sender channel transmitters for the queueing of messages across the IBM MQ link.
Runtime tab
The Runtime tab shows runtime properties for this object. These properties directly affect the current runtime environment, but are not preserved when that environment is stopped. To preserve runtime property values, change the equivalent property values on the Configuration tab. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.
General Properties
Status
The runtime status of the IBM MQ link.
Information | Value |
---|---|
Required | No |
Data type | drop-down list |
Range |
|
Additional Properties
- Sender channel transmitters
- The sender channel transmitters for the queueing of messages across the IBM MQ link.