IBM MQ client link settings
An IBM MQ client link presents the messaging engine, and therefore the bus, as an IBM MQ queue manager to which IBM MQ clients can attach. This behavior enables WAS v5 JMS clients to use messaging resources on the bus.
Console path:
Service integration -> Buses -> bus_name -> [Topology] Messaging engines -> engine_name -> [Additional Properties] IBM MQ client links -> link_name.
If IBM MQ functionality has been disabled at any scope, an informational message indicating that IBM MQ has been disabled is displayed. In a single server environment this informational message is only displayed when the server is restarted after IBM MQ functionality has been disabled. In a network deployment environment the informational message is displayed immediately. See Disable IBM MQ functionality in WAS.
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.
General Properties
Status
The runtime status of the IBM MQ client link.
Information Value Required No Data type drop-down list Range
- Inactive
- The IBM MQ client link is ready and enabled to receive inbound connections from clients, but no client connections have yet been established.
- Stopped
- The IBM MQ client link is in a stopped state and cannot process any new requests for inbound connections from clients.
- Starting
- The IBM MQ client link has received an inbound connection from a client, and is in the process of starting this connection.
- Binding
- The IBM MQ client link is performing channel negotiation and is not yet ready to transfer messages.
- Run
- The IBM MQ client link has an active session with a client, and data can be flowing between the client and the IBM MQ client link.
- Stopping
- TheIBM MQ client link, or a connection with that link, is in the process of being stopped.
- Multiple
- The IBM MQ client link has established sessions with several clients, and the sessions can be in different states: Starting, Running, Stopping, or Stopped.
Additional Properties
- Client connections
- The client connections that exist on the IBM MQ client link.
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.
General Properties
Name
The name of the IBM MQ client link.
Information Value Required Yes Data type String
UUID
The universal unique identifier assigned by the system to this IBM MQ client link for administrative purposes.
Information Value Required No Data type String
Description
An optional description for the IBM MQ client link, for administrative purposes.
Information Value Required No Data type Text area
MQ channel name
The name of the channel for the IBM MQ client link, used to flow messages between IBM MQ clients and the bus.
The name of the IBM MQ server connection channel that this client link will use to represent itself to clients. It must exactly match the value specified by the client for a connection to be established. For v5 embedded messaging clients a value of "WAS.JMS.SVRCONN" must be specified. We should not define two MQ client links that share both channel name and queue manager name. However, it is possible to have client links with identical channel names if they specify different queue manager names.
.
Information Value Required Yes Data type String
Queue manager name
The name of the IBM MQ queue manager on which the IBM MQ sender channel, that is connected to this MQ link receiver channel connection instance, is running.
The IBM MQ client link for use by JMS applications on WAS v5.1 has the queue manager name WAS_nodeName_jmsserver. We should not use this name on any other IBM MQ client link that is assigned to a messaging engine on the same node.
Information Value Required Yes Data type String
Default queue manager
Whether or not this is the default queue manager for the IBM MQ clients.
If a client does not specify the name of the queue manager it is to connect to, it will be connected to an MQ client link with a matching channel name that has been marked as being the default, if one matching this criterion can be found.
Information Value Required No Data type Boolean
Maximum message size
The maximum message length, in bytes, that can be transmitted using the IBM MQ client link.
Information Value Required No Data type Long Range 0 through 104857600
Heartbeat interval
The time, in seconds, to wait before checking that a client requesting an operation is still active.
This heartbeat interval allows a sending channel to verify that the receiving channel is still active just before committing a batch of messages. If the receiving channel is not active, the batch can be backed out rather than becoming indoubt, as would otherwise be the case. By backing out the batch, the messages remain available for processing so they can, for example, be redirected to another channel.
If the sending channel has had a communication from the receiving channel within the batch heartbeat interval, the receiving channel is assumed to be still active, otherwise a "heartbeat" signal is sent to the receiving channel to check.
Information Value Required No Data type Integer Range 0 through 999999 A value of 0 (zero) indicates that the heartbeat mechanism is not used.
Initial state
Whether the IBM MQ client link is started or stopped when the associated messaging engine is first started. Until started, the IBM MQ client link is unavailable.
Information Value Required No Data type drop-down list Range
- Stopped
- When the associated messaging engine is started, the IBM MQ client link is in a stopped state and cannot process any new requests for inbound connections from clients.
- Started
- When the associated messaging engine is started, the IBM MQ client link is ready and enabled to receive inbound connections.
Additional Properties
- Advanced properties
- Advanced configurable properties, such as message reliability and broker queue names, for the IBM MQ client link.