IBM MQ links [Collection]

IBM MQ links [Collection]

The IBM MQ link connects the messaging engine as a queue manager to IBM MQ, providing a bridge between the bus and an IBM MQ network.

To view this page in the console, click one of the following paths:

Service integration -> Buses -> bus_name -> [Topology] Foreign bus connections -> foreign_bus_name -> [Related Items] IBM MQ links
Service integration -> Buses -> bus_name -> [Topology] Messaging engines -> engine_name -> [Additional properties] IBM MQ links

To browse or change the properties of a listed item, select its name in the list.

To act on one or more of the listed items, select the check boxes next to the names of the items to act on, then use the buttons provided.

To change which entries are listed, or to change the level of detail displayed for those entries, use the Filter settings.

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.

Name

The name of the IBM MQ link, used for administrative purposes.

Description

An optional description for the IBM MQ link, for administrative purposes.

Local messaging engine

The local messaging engine that this IBM MQ link is hosted on.

Virtual queue manager name

The virtual queue manager name by which the local bus is to be known to an IBM MQ network. It is generally recommended that we 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, ensure that the length of the local bus name does not exceed 48 characters.

Status

The runtime status of the IBM MQ link.

Status can take the following values:

Status Meaning
Run The IBM MQ link is running.
Stopped The IBM MQ link is stopped.

Current outbound messages

The current total number of messages queued on the sender channel transmitter and link transmitters for this IBM MQ link.

Messages sent

The total number of messages sent, since the start of the messaging engine, on the sender channel transmitter to the foreign bus.

Messages received

The total number of messages received, since the start of the messaging engine, on the link receiver connections for this IBM MQ link.

Buttons

Button Description
New Create a new administrative object of this type.
Delete Delete the selected items.
Start Start selected items.
This button does not work if the selected IBM MQ link is running on an application server on which IBM MQ has been disabled. See Disable IBM MQ functionality in WAS.

Stop Stop a selected IBM MQ link. We must first have selected the link to be stopped.
We can choose the mode of stop action and the required state when the link has been stopped:

Stop mode:

Force

Stop the link immediately. We should only use this mode if a quiesce action does not work.

Quiesce

Stop the link in a controlled manner.

Target state:

Inactive

Stop the link and set its state to Inactive. If an application tries to use the link, the link is started again.

Stopped

Stop the link and set its state to Stopped. The link can only be started again by administrator action.

This button does not work if the selected IBM MQ link is running on an application server on which IBM MQ has been disabled. See Disable IBM MQ functionality in WAS.

Status	Meaning
Run	The IBM MQ link is running.
Stopped	The IBM MQ link is stopped.

Button	Description
New	Create a new administrative object of this type.
Delete	Delete the selected items.
Start	Start selected items. This button does not work if the selected IBM MQ link is running on an application server on which IBM MQ has been disabled. See Disable IBM MQ functionality in WAS.
Stop	Stop a selected IBM MQ link. We must first have selected the link to be stopped. We can choose the mode of stop action and the required state when the link has been stopped: Stop mode: Force Stop the link immediately. We should only use this mode if a quiesce action does not work. Quiesce Stop the link in a controlled manner. Target state: Inactive Stop the link and set its state to Inactive. If an application tries to use the link, the link is started again. Stopped Stop the link and set its state to Stopped. The link can only be started again by administrator action. This button does not work if the selected IBM MQ link is running on an application server on which IBM MQ has been disabled. See Disable IBM MQ functionality in WAS.