Messages [Settings]

The properties for a message on the message point.

To view this page in the console, click the following path:

Service integration -> Buses -> bus_name -> [Destination resources] Destinations -> queue_name -> [Message points] Queue points -> queue_point_name -> Runtime > Messages -> message_name .

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. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.

General Properties

Messaging engine message identifier

Messaging engine message identifier.

Required No
Data type String

State

The current state of the message related to a transaction that the message is part of. If the message is part of a transaction, the transaction identifier is shown in the Transaction ID field.

Table 1. Message transaction state.. The first column of the table lists the transaction state of the messages. The second column provides the transaction identifier if the message is part of a transaction. The third column provides the comments.
State Transaction ID Comments
Locked An identifier is shown. The message is locked as part of the transaction identified. The message has not been consumed and the transaction is still in progress.
Locked An identifier is not shown. The message is locked, but the transaction has completed, so the message might not have been consumed. This indicates that some error might have occurred.
Required No
Data type drop-down list
Range
Available
The message is available for consumption.
Locked
The message is currently unavailable. The message is in this state temporarily, possibly because it is being consumed by a non-transacted consumer.
Remote lock
The message is currently locked to a consumer attached to another, remote, messaging engine in the bus. The message will remain locked until the remote messaging engine responds with a decision on the message. If the remote messaging engine is stopped, the message will remain locked until the messaging engine is restarted. A corresponding message request for a "known remote queue point" will identify the remote messaging engine that is making the request.
Removing
The message is currently being removed under a transaction. The message will be in this state until the transaction commits or rolls back. If this state persists, investigate the state of the transaction identified by Transaction ID.
Committing
The message is currently being added under a transaction. The message will be in this state until the transaction commits or rolls back. If this state persists, investigate the state of the transaction identified by Transaction ID.
Pending retry
The message is currently unavailable before being eligible for a retry. This might be because a message-driven bean is configured to delay failing message retries.
Blocked
This message is currently unavailable because the message point is blocked by the first message on the queue. The first message has reached its maximum failed delivery limit but no exception destination is configured. Identify the first message and resolve the problem that is preventing it from being consumed.

Transaction ID

The local transaction identifier of the transaction that this message is currently part of.

This field combined with the State field shows the state of the message related to the transaction. For more information about the combination of these fields, see Message transaction state..
Required No
Data type String

Run-time message properties

Message type

The type of the message (JMS, SDO, SUBSCRIPTION, TRM, BROKER_CONTROL, BROKER_RESPONSE, BROKER_ADMIN).

Required No
Data type String

Approximate length

The approximate length of the message.

Required No
Data type String

Time stamp

The time stamp of when the message was originally sent.

Required No
Data type String

Message wait time

The time the message has been waiting to be consumed.

Required No
Data type String

Current® messaging engine arrival time

The time that the message arrived on the current messaging engine.

Required No
Data type String

Redelivered count

The number of times that the message has been redelivered.

Required No
Data type String

Security user ID

The security user ID.

Required No
Data type String

Producer type

The producer type (API, Core, TRM).

Required No
Data type String

Exception destination timestamp

The timestamp at which the message was put to the exception destination.

Required No
Data type String

Exception destination reason

The reason the message was put to the exception destination.

Required No
Data type Text area

API Message properties

Message ID

The message ID.

Required No
Data type String

Correlation ID

The API correlation ID for request/response correlation.

Required No
Data type String

User ID

The user ID.

Required No
Data type String

Format

The Format of the message.

Required No
Data type String

JMS Message properties

JMS delivery mode

The JMS delivery mode (Persistent, Non-persistent).

Required No
Data type String

JMS expiration

The JMS expiration.

Required No
Data type String

JMS destination

The JMS destination.

Required No
Data type String

JMS reply to destination

The JMS reply to destination.

Required No
Data type String

JMS redelivered

The JMS redelivered flag.

Required No
Data type String

JMS type

The JMS type field (Text, Byte, Stream, Object, Map).

Required No
Data type String

JMSX delivery count

The JMSX delivery count.

Required No
Data type String

JMSX application ID

The JMSX application ID.

Required No
Data type String

Bus message properties

Topic

The bus discriminator.

Required No
Data type String

Priority

The bus priority (0-9).

Required No
Data type String

Reliability

The bus reliability (Assured persistent, Reliable persistent, Reliable non-persistent, Express non-persistent, Best effort non-persistent).

Required No
Data type String

Time to live

The time to live of the message.

Required No
Data type String

Reply discriminator

The reply discriminator value of the bus.

Required No
Data type String

Reply priority

The reply priority value of the bus (0-9).

Required No
Data type String

Reply reliability

The reply reliability value of the bus (Assured persistent, Reliable persistent, Reliable non-persistent, Express non-persistent, Best effort non-persistent).

Required No
Data type String

Reply time to live

The reply time to live value of the bus.

Required No
Data type String

System message ID

The unique id of the message, assigned by the bus.

Required No
Data type String

Additional Properties

Message body
The contents of the message body.





Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 5:16:49 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-base-iseries&topic=SIBMessages_DetailForm
File name: SIBMessages_DetailForm.html