Browsing a Client Queue

If you want to view the contents of a client's queue, you can browse the queue. When you browse a queue, you retrieve a list of the documents in the queue. For each document, My webMethods specifies the acknowledgement status of the document, the document size, and the document's sequence number.

For example, you might want to browse a queue to verify that a sales order was routed to the proper client. Or, if a client continually crashes when attempting to process a document from its queue, you might want to browse the queue to obtain more information about the document and possibly delete the document. Or, you might want to browse the dead letter queue to see which documents the Broker routed to this queue.

2. In the Client List, click the client ID of the client whose queue you want to browse. If the client does not appear in the list, use the Search tab to locate it.

In this field...	Specify...
Start Position	The location in the queue where you want to begin browsing. The default is 0 (the first document in the queue).
Number of Documents	The number of documents that you want to view at one time. The default is 10 documents.
Timeout	The length of time (in seconds) that My webMethods waits for the set of documents to be returned. When the specified time elapses, a time-out exception is thrown. The default is 30 seconds.

5. If you want to create (or edit filters) while viewing the queue content, click Yes next to Document Type Filters. Yes indicates that filters will be used to limit the number of documents for browsing. For more information about using filters when browsing a queue, see Filtering Queue Contents while Browsing.

Field	Description
Document Type	The document type for the document. Click the document type name to view document content.
Ack Status	Indicates whether or not the document has been retrieved by the client. Available.The document is available for retrieval by the client program. Unacked.The client program retrieved the document but has not yet acknowledged the document.
Sequence Number	Receipt sequence number for the document. The client assigns this number to the document when it is placed in the queue. The sequence number is unique within the client queue.
Size	Size of the document measured in bytes.

7. If necessary, do one or more of the following to view more documents in the queue or view information about a specific document in the queue:

Note:Broker maintains a redelivery count for each document in a queue. A redelivery count of -1 indicates that the document has not been delivered to the client. A redelivery count of 0 indicates that the document has been delivered once. A redelivery count of 1 indicates that the document has been redelivered once.

For information about deleting documents in a queue, see Deleting Documents from a Client Queue. For information about saving documents in a queue to file, see Saving Client Queue Documents to a File.