Some of the content described in this article is available in meshIQ Manage versions 12.1 and greater.
For a quick overview of what's new or changed, visit the meshIQ Highlights page for a version-by-version breakdown.
Jump to Section:
Version 12.x and Later
Version 11.3 and Earlier
Version 12.x and Later
The Message Commands tab located on the Settings window provides settings for browsing messages. You can also configure Message Criteria to apply filters to messages across viewlets.
The Message Commands tab is available in both the User Settings and Initial User Settings.
- User Settings – Personal preferences specific to the logged-in user.
- Initial User Settings – Default settings are applied to new users when they log in for the first time or when an existing user restores their settings by clicking the Restore Initial Settings button. Only users with elevated permissions (Admins) can modify these settings.
Message Commands | |
|---|---|
| Name | Description |
| Message Criteria Settings | |
| Message Criteria |
A filter for messages. When criteria set is specified, it can be used to browse, copy, move, re-route and delete messages which satisfy the selected criteria's specifications. When a message criteria record is selected to filter messages, it also applies to the Put New Message option. Message criteria are also available to set default MQMD header values when you load messages from a file (Load from File option). Select an existing message criteria set from the drop-down list to apply to the messages. Only one message criteria set can be specified. |
| Configure button | Create, edit or delete Message Criteria. See Filtering messages across viewlets with message criteria configurations. |
| Browse Settings | |
| Message Cursor | Enter message cursor; that is, where to start reading the message. Range: 1 – 999999999. Default: 1 (Required) |
| Data Offset | Enter message data offset. (Required) |
| Message Count | Enter the number of messages to be displayed in the Message tab. (Required) The default setting is 500, but the Administrator can change this to any value from 1 to 1,000. However, if the user enters a value that is greater than the default, it will not be saved. The value will revert to the default. |
| Data Size | Enter the message data size (in bytes) you would like the system to load. (Required) |
| Load full message for XML/JSON |
Full messages are required for XML and JSON views. Enable this option to load full messages when viewing data in XML or JSON format. When this option is enabled, the following settings become available to control whether a confirmation prompt is displayed before loading the full message. Select one of the following options:
|
| Copy/Move/Delete Settings |
These settings decide how the system identifies messages when you copy, move, or delete them.
|
______________________________________________________________________________________________________________
Version 11.3 and Earlier
The Message Commands tab located on the Settings window provides settings for browsing messages. You can also configure Message Criteria to apply filters to messages across viewlets.
Message Commands | |
|---|---|
| Name | Description |
| Message Criteria Settings | A filter for messages. When criteria set is specified, it can be used to browse, copy, move, re-route and delete messages which satisfy the selected criteria's specifications. When a message criteria record is selected to filter messages, it also applies to the Put New Message option. Message criteria are also available to set default MQMD header values when you load messages from a file (Load from File option). |
| Message Criteria | Select an existing message criteria set from the drop-down list to apply to the messages. Only one message criteria set can be specified. |
| Configure button | Create, edit or delete Message Criteria. See Filtering messages across viewlets with message criteria configurations. |
| Browse Settings | The following describes browse options: |
| Message Cursor | Enter message cursor; that is, where to start reading the message. Range: 1 – 999999999. Default: 1 (Required) |
| Data Offset | Enter message data offset. (Required) |
| Message Count | Enter the number of messages to be displayed in the Message tab. (Required) The default setting is 500, but the Administrator can change this to any value from 1 to 1,000. However, if the user enters a value that is greater than the default, it will not be saved. The value will revert to the default. |
| Data Size | Enter the message data size (in bytes) you would like the system to load. (Required) |
| Load full msg. for XML and Decode views |
Full messages are needed for XML and decode views. Enable this option to allow full messages to be loaded when in an XML or decode view. When enabled, the system can be configured so that a confirmation prompt can appear before loading the full message. See below Prompt options to select desired criteria. |
| Prompt |
When the Load full msg. for XML and Decode views option is enabled, the Prompt options appear. These options control whether to display a confirmation prompt before loading a full message for XML and decode views. Select one of the following options:
|
| Messages Selection by radio buttons |
Provides Copy/Move/Delete options. Available when User settings is clicked or if you are in Copy/Move/Delete messages operations. As noted in the description on the dialog, the disadvantage of selecting messages by position (the Message Position method) is that a message’s position might change within a queue. For this reason, when you select the Message Position method, the icons for deleting, rerouting, copying, and editing are not available when multiple individual messages are selected. You can still choose to copy, move, or delete all messages using the message(s) pop-up menu. |
| Restore Default | Restores the default settings. |