IBM MQ link receiver channel connections [Settings]

A connection that exists on the receiver channel of the IBM MQ link.

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 -> Runtime > Receiver channel connections -> channel_connection_name.

Runtime tab

The Runtime tab shows runtime properties and current runtime state for this MQ link receiver channel connection. These properties are not preserved when the current runtime environment is stopped.

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

IBM MQ Queue Manager name

The name of the IBM MQ queue manager on which the IBM MQ sender channel, that is connected to this MQ link receiver channel connection instance, is running.

Information	Value
Required	No
Data type	String

IP address

The IP address of the queue manager for the IBM MQ link receiver channel connection.

Information	Value
Required	No
Data type	String

Status

The runtime status of the IBM MQ link receiver channel connection.

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. Starting The IBM MQ link has received a connection request, and is in the process of starting this connection. Binding The IBM MQ link is performing channel negotiation and is not yet ready to transfer messages. Initializing The IBM MQ link is initializing the session for a connection and is not yet ready to transfer messages. Retrying The IBM MQ link is retrying a failed connection. Standby The channel is being used for standby purposes. Messages can be transferred only when the channel is active. Run The IBM MQ link link has an active session with IBM MQ, and data can be flowing between IBM MQ link and the IBM MQ. Stopping The IBM MQ link, or a connection with that link, is in the process of being stopped. Paused The channel is waiting for the message-retry interval to finish. 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.

Batch size

The maximum number of messages that a batch can contain.

Information	Value
Required	No
Data type	String

Channel start time

The time at which the channel was last started.

Information	Value
Required	No
Data type	String

Channel start date

The date on which the channel was last started.

Information	Value
Required	No
Data type	String

Heartbeat interval

The negotiated time, in seconds, between heartbeat flows passed from the IBM MQ sender channel to the IBM MQ link receiver channel when there are no messages on the transmission queue being served by the IBM MQ sender channel.

Information	Value
Required	No
Data type	String

Sequence wrap

The value at which message sequence numbers wrap to start again at 1.

This is the highest number the message sequence number reaches before it restarts at 1. The default is 999999999.

For information about how to choose an appropriate value for this property, see the description of the Sequence Numberwrap (SEQWRAP) property in the IBM MQ Intercommunication book.

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	Long
Range	100 through 999999999

Adoptable

Whether or not a running instance of an 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 an 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. We 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.

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	true false

Maximum message length

The maximum message length, in bytes, that can be transmitted on the channel. This is compared with the value from the partner IBM MQ sender channel and the actual maximum used is the lower of the two values.

Information	Value
Required	No
Data type	String

Stop requested

Whether or not a manual stop request has been made for the receiver channel.

Information	Value
Required	No
Data type	drop-down list
Range	true The channel is in doubt about which messages have been committed by IBM MQ for the unit of work that it has sent. false The channel is not in doubt about which messages have been committed by IBM MQ.

Current LUWID

The current logical unit-of-work identifier of the IBM MQ link receiver channel connection.

Information	Value
Required	No
Data type	String

Current sequence number

The current sequence number for the message on the channel.

We can reset the sequence number of an MQLinkReceiver channel by resetting the sequence number of the partner IBM MQ sender channel. For details of how to reset the sequence number of an IBM MQ sender channel, see the IBM MQ Intercommunications Guide section of the IBM MQ library.

Information	Value
Required	No
Data type	String

Last LUWID

The last logical unit-of-work identifier for a message on the channel.

Information	Value
Required	No
Data type	String

Last Sequence number

The last sequence number for a message on the channel.

Information	Value
Required	No
Data type	String

Messages in current batch

The number of messages in the current batch on the channel.

Information	Value
Required	No
Data type	String

Number of batches received

The number of batches received on the channel.

Information	Value
Required	No
Data type	String

Number of messages received

The number of messages received on the channel.

Information	Value
Required	No
Data type	String

Buffers sent

The number of buffers sent on the channel.

Information	Value
Required	No
Data type	String

Buffers received

The number of buffers received on the channel.

Information	Value
Required	No
Data type	String

Bytes sent

The number of bytes sent on the channel.

Information	Value
Required	No
Data type	String

Bytes received

The number of bytes received on the channel.

Information	Value
Required	No
Data type	String

Last message receive time

The time at which the last message was received on the receiver channel connection.

Information	Value
Required	No
Data type	String

Last message receive date

The date on which the last message was received on the receiver channel connection.

Information	Value
Required	No
Data type	String

nonpersistent message speed

The class of service for nonpersistent messages on the receiver channel.

Information	Value
Required	No
Data type	drop-down list
Range	Fast Nonpersistent messages can be lost if there is a transmission failure or if the channel stops when the messages are in transit. Normal Nonpersistent messages are not lost if there is a transmission failure or if the channel stops when the messages are in transit.

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.

View the status of an IBM MQ link and its sender and receiver channels

Add or modify an IBM MQ link receiver channel