+

Search Tips   |   Advanced Search

WebSphere MQ links [Collection]

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

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

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, use the buttons provided.

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

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 Disable WebSphere MQ functionality in WebSphere Application Server.

Name

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

Description

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

Local messaging engine

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

Virtual queue manager name

The virtual queue manager name by which the local bus is to be known to a WebSphere MQ network. It is generally recommended set the virtual queue manager name to match the name of the local bus. As WebSphere 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.

Status

The runtime status of the WebSphere MQ link.

Status can take the following values:

lists the status values of WebSphere MQ link. The second column contains
Status Meaning
Running The WebSphere MQ link is running.
Stopped The WebSphere MQ link is stopped.

Current outbound messages

The current total number of messages queued on the sender channel transmitter and link transmitters for this WebSphere 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 WebSphere 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 WebSphere MQ link is running on an application server on which WebSphere MQ has been disabled. For more information see Disable WebSphere MQ functionality in WebSphere Application Server.

Stop Stop a selected WebSphere 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. You 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 WebSphere MQ link is running on an application server on which WebSphere MQ has been disabled. For more information see Disable WebSphere MQ functionality in WebSphere Application Server.


Related concepts

  • Foreign buses


    Related tasks

  • Configure foreign bus connections

  • Configure exception destination processing for a link to a foreign bus

  • View the status of a WebSphere MQ link and its sender and receiver channels

  • Administer an existing WebSphere MQ link

  • Disable WebSphere MQ functionality in WebSphere Application Server


    Related information:

  • Administrative console buttons

  • Administrative console preference settings Reference topic