+

Search Tips | Advanced Search

Configure message preferences

We can configure browsing limits and set how message properties are displayed.


About this task

To configure message preferences within IBM MQ Explorer, complete one of the following tasks:

Parent topic: Preferences for IBM MQ Explorer


Configure browsing limits


About this task

We can configure he following values:

  • The maximum number of messages that can be browsed in the range 1 - 5000.
  • The maximum number of bytes of data to be displayed per message in the range 0 - 16 384.

Important: Ensure that the system has enough random access memory (RAM) to display large numbers of messages or system performance might be affected.


Procedure

  1. Click Window, and then click Preferences. The Preferences dialog opens.
  2. Click Messages. Messages settings appear.
  3. Change the maximum number of messages that are browsed by either clicking the up or down arrows, or by typing a new value. The default value is 500.
  4. Change the maximum data bytes that are displayed by either clicking the up or down arrows, or by typing a new value. The default value is 1000.


Showing message properties


About this task

We can set how message properties are displayed. We can show no message properties, or we can show message properties as Named Properties, as an MQRFH2 structure in the message body, or as an MQRFH2 structure in the message body compatible with IBM WebSphere MQ Version 6.0.


Procedure

  1. Click Window, and then click Preferences. The Preferences dialog opens.
  2. Click Messages. Messages settings appear.
  3. To show no message properties, except those properties that are contained in the message descriptor or extension, clear the Show message properties check box. For more information, see Named Properties page.
  4. To show message properties as Named Properties, select the as Named Properties check box. Properties of the message, except those properties that are contained in the message descriptor or extension, are represented in the Named Properties panel in name-value pairs, and the properties are removed from the message data. For more information, see the entry for MQGMO_PROPERTIES_IN_HANDLE in Named Properties page.
  5. To show message properties as an MQRFH2 structure in the message body, select the as an MQRFH2 structure in message body check box. Properties of the message, except those properties that are contained in the message descriptor or extension, are represented in the MQRFH2 Properties panel and the properties remain in the message data. For more information, see the entry for MQGMO_PROPERTIES_FORCE_MQRFH2 in MQRFH2 Properties page.
  6. To show message properties as an MQRFH2 structure in the message body, select the as an MQRFH2 structure in message body, compatible with WebSphere MQ V6 check box. If the message contains a property with a prefix of mcd., jms., usr., or mqext., all message properties, except those properties that are contained in the message descriptor or extension, are represented in the MQRFH2 Properties panel and the properties remain in the message data. Otherwise, all properties of the message, except those properties that are contained in the message descriptor or extension, are discarded and not displayed. For more information, see the entry for MQGMO_PROPERTIES_FORCE_MQRFH2 in MQRFH2 Properties page.

Last updated: 2020-10-04