Modifying an IBM 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 IBM MQ link by using the administrative console as described in this task, or you can modify a IBM 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 IBM MQ link you want to modify.

About this task

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

When you use the foreign bus connection wizard to connect a bus and a IBM 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 IBM 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 IBM 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 IBM 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 IBM 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] IBM MQ links -> link_name.
  2. Modify the properties of the link.

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

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

    Description
    An optional description for the IBM MQ link, for administrative purposes.
    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. By default, this option is not selected.
    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. 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 IBM MQ link is started or stopped when the hosting messaging engine is first started. Until started, the IBM MQ link is unavailable. By default, the value is "Started".
    Nonpersistent message speed
    The class of service for nonpersistent messages on channels of this IBM MQ link. By default, the value is "Fast".
  3. Configure the additional properties. You can configure any of the following additional properties of this IBM MQ link:
  4. Configure the related items. You can configure any of the following related items of this IBM 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 IBM MQ link sender or receiver channels), otherwise restart the application server.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 5, 2017 17:27
File name: tjc0032A_.html