Open Queue Dialog

Set the options for the JMS queue you are opening and select the row and column filters to be applied to the messages in the queue.

Filters

Options

Filters

Since queues may contain messages of more than one format, you can specify any number of filters to be applied to the queue. However, only one filter of each type (row data, row header, column data, column header) can be applied to each format.

Note: Since there is only one message header format for JMS messages (JMSHD), you can only select one column or row header filter at any time. You must check the box beside the list box title to enable selection of a header filter.

If you apply any filters, messages that do not belong to any of the formats to which the filters apply are not retrieved. If the Ignore Message Format option is selected, only text or header filters can be applied.

See also:  About Message Filters

Options

Display Header

Display message header as well as message data fields.

Ignore Message Formatting

Selecting Ignore Message Formatting suppresses the use of user-defined message formats and XML formatting. Messages are displayed as either text or hexadecimal. (Messages are returned as text unless they contain unprintable characters, in which case they are displayed as strings of hexadecimal digits.)

Edit Under Syncpoint Control

Editing under syncpoint control enables the Commit and Rollback commands on the File menu. If you do not select this, you will not be able to roll back any changes you make to a queue or to messages.  All changes will take place immediately.

Field Size and Field Count

For nonformatted messages, allows you to specify the number of bytes displayed per field and the number of fields retrieved per message. By default, the number of bytes per field is 100 bytes and the number of fields is 10. (If messages are truncated because they exceed the specified number of fields, a red * appears to the left of the message in the Message window.)

Max Number of Messages Displayed

The maximum number of messages displayed at a time. For example, if you select 25, only 25 messages are shown at one time. After you have browsed the first set of 25, you must click the button to retrieve the next 25. The maximum number that can be retrieved at one time is 200. (You can change the number of messages retrieved in the Message window by changing the queue Depth.)

Note: The number of messages displayed may also be affected by the Maximum Response Size parameter. When the maximum size is reached, no more messages are retrieved. Messages that exceed the maximum size limit may be split.