Viewing messages for object queues
View messages for object queues to gain insight into the health of your application's object queue traffic and to pinpoint the source of errors.
The Messages tab on the Object Queues page displays all undelivered messages for a selected object queue.
The Messages tab is divided into the
messages list at the top and the Detail area at the
bottom. The tab displays the following information:
- Delivery Time
- The date and time the message is scheduled to be delivered.
- Error Count
- The number of errors associated with the message.
- Following
- Identifies a message to which an order of delivery applies. The message will not be delivered until the current message completes successfully or fails completely.
- Is Processing
- Indicates whether the message is still processing.
- Last Priority
- Priority of a message for which the Delivery Time has not yet expired.
- Name
- The name of the message. This name is either defined by the application developer when the object queue was defined in NexJ Studio, or it is generated based on classes, events, and message type.
- Ordinal
- The ordinal value of the message. Reflects the position of the message in the object queue.
- Original Queue
The first queue to which the message was sent.
Use this information to when reviewing the default error queue that stores failed messages from the other originating queues.
- Preceding
- Indicates the order of operations of messages passing through a queue. A message will not be processed until the preceding message is processed.
- Priority
- The priority of the message. The priority is automatically set to the queue’s priority to which the message is sent. In certain cases, an administrator may set the priority manually to define ordering within a queue.
- Queue
- The queue to which the message has most recently been sent.
- Resource Held
- Indicates whether the message has acquired any resources or is processing. When true, the message will be recovered following any server failure.
- Sent
- The number of sent messages. Persistent messages are sent once, but may be dispatched more than once.
- Update Enabled
- Indicates whether further updates to this message are allowed.
- State
- The state of persistent messages. Persistent messages can be in
one of the following states:
- Blocked
- The message has exceeded the number of attempts specified in the queue’s errorCount. The message is sent to the error queue and remains in Blocked state until it is resubmitted.
- Dispatching
- The message is waiting to be transitioned by the dispatcher. Typically, the message needs to be prepared for delivery, or the message needs to be deleted because a worker has completed processing the message.
- Error
- The dispatcher failed to handle the message. The message will remain in Error state indefinitely.
- New
- The message has been created. The message will remain in New state until it is sent on a queue.
- Processing
- The message is being processed by a worker.
- Waiting
- The message has been prepared for delivery, but has not yet been handed off to a worker node for processing.
Note: When persistent messages complete successfully they are deleted and have no state. - User
- The name of the user under which the message is being processed or will be processed.
To view messages for an object queue:
- Optional:
To filter the list of messages, enter filter criteria in any of
the following fields, then click the Set Filter
button
.
- In the Message Name field, enter a keyword to use as a filter. Only messages that contain the specified keyword in their name will display in the messages list.
- In the Delivery Time Range fields, specify a start date and end date. Only messages transmitted during the specified date range will display in the messages list. If you do not specify start and end times, the times default to midnight on the specified date.
- In the User field, click the Select button, and select a user in the Select User dialog. Then, click OK.
- In the State drop-down, select a state. For example, select Blocked.
- In the Type drop-down, select a message type.
The list updates to display only messages that meet the specified filter criteria. - Optional:
Click the Refresh button
to update the messages list
with messages that were delivered since you opened the page.
button.