Modifying a WebSphere MQ link

How and when to modify the properties of a WebSphere® MQ link.

Before you begin

Decide which method to use to configure these resources. You can modify a WebSphere MQ link by using the administrative console as described in this task, or you can modify a WebSphere MQ link by using the wsadmin tool.

You have to know the name of the bus, and the messaging engine on the bus that contains the WebSphere MQ link you want to modify.

About this task

A WebSphere MQ link provides a server to server channel connection between a service integration bus and a WebSphere MQ queue manager or queue-sharing group, which acts as the gateway to the WebSphere MQ network. At any time after you create a new WebSphere MQ link, you can modify its properties.

When you use the foreign bus connection wizard to connect a bus and a WebSphere MQ queue manager or queue-sharing group (known as the "gateway queue manager") to use point-to-point messaging or publish-subscribe messaging, one or more WebSphere MQ links are created and configured as part of the task. However the wizard does not ask you to set all possible properties of a WebSphere MQ link, and some of the link properties are not set or are set to default values. You can fine tune these properties by modifying the link.

When you create a new WebSphere MQ link, you can also choose not to create sender or receiver channels. These channels can be added later by modifying the link.

When you use the foreign bus connection wizard to create a WebSphere MQ link for point-to-point messaging, you can later modify the link for publish-subscribe messaging by adding a publish/subscribe broker profile to the link.

Procedure

  1. In the navigation pane, click, Service integration -> Buses -> bus_name -> [Topology] Messaging engines -> engine_name -> [Additional properties] WebSphere MQ links -> link_name.
  2. Modify the properties of the link.

    For information about all the properties that you can modify, see WebSphere MQ link [Settings].

    When you create a new WebSphere MQ link, the following properties are set to default values:

    Description
    An optional description for the WebSphere MQ link, for administrative purposes.
    Adoptable
    Whether or not a running instance of a WebSphere 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 WebSphere MQ link receiver channel to be left waiting for messages. When communication is re-established, and the partner WebSphere MQ sender channel next attempts to establish a session with the WebSphere MQ link receiver channel, the request will fail as there is already a running instance of the WebSphere MQ link receiver channel that believes it is in session with the partner WebSphere MQ sender channel. You can overcome this problem by selecting this option, which causes the already running instance of the WebSphere MQ link receiver channel to be stopped and a new instance to be started. By default, this option is not selected.
    Exception destination
    The destination for an inbound message when the WebSphere 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. By default, undeliverable messages are sent to the system default exception destination for the messaging engine that this link is assigned to. However, it can aid problem-solving if you separate these exceptions out from other system messages by configuring a specific exception destination for this link.
    Initial state
    Whether the WebSphere MQ link is started or stopped when the hosting messaging engine is first started. Until started, the WebSphere MQ link is unavailable. By default, the value is "Started".
    Nonpersistent message speed
    The class of service for nonpersistent messages on channels of this WebSphere MQ link. By default, the value is "Fast".
  3. Configure the additional properties. You can configure any of the following additional properties of this WebSphere MQ link:
  4. Configure the related items. You can configure any of the following related items of this WebSphere MQ link:
  5. Save your changes to the master configuration.
  6. If you have enabled dynamic configuration updates, the changes take effect immediately (or on channel restart if you also modified WebSphere MQ link sender or receiver channels), otherwise restart the application server.
Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 11, 2013 8:40:09 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=tjc0032a_
File name: tjc0032A_.html