IBM MQ link receiver channel [Settings]
The receiver channel that receives messages from the gateway IBM MQ queue manager. The receiver channel communicates with an IBM MQ sender channel on the gateway queue manager, and converts MQ format messages to service integration bus messages.
To view this page in the console, click the following path:
Service integration -> Buses -> bus_name -> [Topology] Messaging engines -> engine_name -> [Additional properties] IBM MQ links -> link_name -> [Additional Properties] Receiver channel -> channel_name.
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
IBM MQ link receiver channel name
The name of the receiver channel for the IBM MQ link, used to receive messages from IBM MQ onto the bus.
This name must be the same as the name of the sender channel on IBM MQ.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information Value Required No Data type String
Inbound nonpersistent message reliability
The acceptable reliability of message delivery for nonpersistent message flows from IBM MQ through this IBM MQ link, from Best effort to Reliable, in order of increasing reliability.
This reliability delivery option is assigned to all IBM MQ nonpersistent messages flowing over this receiver channel.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information Value Required No Data type drop-down list Range
- Best effort
- Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable or as a result of constrained system resources.
- Express
- Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable.
- Reliable
- Messages are discarded when a messaging engine stops or fails.
Inbound persistent message reliability
The acceptable reliability of message delivery for inbound persistent message flows from IBM MQ through this IBM MQ link, from Reliable to Assured, in order of increasing reliability.
Dynamic updates to this property are effective when the channel restarts. Use the Runtime tab to check the current state.
Information Value Required No Data type drop-down list Range
- Reliable
- Messages might be discarded when a messaging engine fails.
- Assured
- Messages are not discarded.
Prefer queue points local to this link's messaging engine
When this check box is selected, the link prefers to send inbound messages to available queue points of target destinations located on the messaging engine on which the link is hosted.
When this check box is not selected, or if no local queue point is available for a target destination, the link workload balances the messages across all available queue points of the target destination. By default the check box is selected.
This option is supported on links running on WebSphere Application Server v7.0 or later. If we are running on an earlier version, the default behavior of preferring local queue points is applied.
Information Value Required Yes Data type Boolean
Initial state
Whether the receiver channel is started or stopped when the associated IBM MQ link is first started. Until started, the channel is unavailable.
Dynamic updates to this property are effective on messaging engine restart or receiver channel creation. Use the Runtime tab to check the current state.
Information Value Required No Data type drop-down list Range
- Stopped
- When the associated messaging engine is started, the IBM MQ link is in a stopped state and cannot communicate with the IBM MQ network.
- Started
- When the associated messaging engine is started, the IBM MQ link is started automatically and is enabled for communication with the IBM MQ network.
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 receiver channel.
This shows the overall status for all receiver channels for the link.
Information Value Required No Data type drop-down list Range
- Inactive
- The IBM MQ link is ready and enabled to create connections, but no connections have yet been established.
- Stopped
- The IBM MQ link is in a stopped state and cannot process any new requests for connections.
- Multiple
- The IBM MQ link has established several sessions with IBM MQ, and the sessions can be in different states: Starting, Running, Stopping, or Stopped.
Additional Properties
- Receiver channel connections
- The connections that exist on the receiver channel of the IBM MQ link.
- Saved batch status
- The runtime status of message batches for the receiver channel of the IBM MQ link.
View the status of an IBM MQ link and its sender and receiver channels Add or modify an IBM MQ link receiver channel