| |
|---|
| Enter a four-character queue manager name in this field. You can specify up to 12 managers, each separated by either blanks or commas. In addition: - Pattern matching is permitted in this field; variables are not valid .
- An entry in this field is required.
- There is no default for this field.
|
| Enter 1 to 48 characters for the name of a specific IBM MQ queue. If not specified, the source of the message can be any queue on which BMC AMI Ops Automation is listening for messages. In addition: - Local and Shared variables are permitted. Pattern matching is also permitted.
- An entry in this field is not required.
- This field is left blank by default.
- The specified queue must have an entry in BBPARM member AAOMQLxx for the Rule to monitor the queue.
|
| Enter the message format in this field. Use to select messages based on the format found in the message descriptor. The following formats are recognized by BMC AMI OpsA: - MQFMT_EVENT: Event message
- USER: User defined format, any message format except MQFMT_EVENT; see the following list:
- —MQFMT_NONE: No format name
- —MQFMT_ADMIN: Command server request/reply message
- —MQFMT_CHANNEL_COMPLETED: Channel completed message
- —MQFMT_CICS: CICS information header
- —MQFMT_COMMAND_1: Type 1 command reply message
- —MQFMT_COMMAND_2: Type 2 command reply message
- —MQFMT_DEAD_LETTER_HEADER: Dead-letter header
- —MQFMT_IMS: IMS information header
- —MQFMT_IMS_VAR_STRING: IMS variable string
- —MQFMT_MD_EXTENSION: Message-descriptor extension
- —MQFMT_PCF: User-defined msg in programmable command format
- —MQFMT_REF_MSG_HEADER: Reference message header
- —MQFMT_STRING: Message consisting entirely of characters
- —MQFMT_TRIGGER: Trigger message
- —MQFMT_WORK_INFO_HEADER: Work information header
- —MQFMT_XMIT_Q_HEADER: Transmission queue header
- —MQFMT_RF_HEADER: Rules and formatting header
- —MQFMT_RF_HEADER_2: Rules and formatting header version 2
This field has no default. |
| Enter 1 to 28 characters to define a particular event type for which messages will be selected when the message format is MQFMT_EVENT. For a list of valid values, type a ?. Use only if the Format field is set to MQFMT_EVENT. In addition: - An entry in this field is not required
- This field is left blank by default to fire on all event types
|
| Select messages containing a specific Msgid in the Message Descriptor Structure. You can use the following input fields to specify a substring, a length and a special operator to use in comparisons: - Sub (Substring): Specifies the starting point of the comparison. Optional. Valid values are 1 to 24.
- Len (Length): Specifies the length of the substring comparison. Optional. If omitted, length is the remainder of the field following the substring. Valid values are 0 to 24.
- Op (Operator): Specifies the type of data and the type of comparison. Valid operators are EQ, NE, GT, LT, GE, LE, IN, EX, HE, HN, HG, HL, GX, LX, FO and FN. The default is EQ. To view a description of the operators, see the Help panel for this field.
- Value (Value): Specifies the data value against which the Msgid field of the Message Descriptor Block is compared. The data type must match that which is indicated by the Op field. Local and Shared variables are permitted.
In addition: - You can use this field only for messages that are not of format, MQFMT_EVENT
- An entry in this field is not required.
- This field is left blank by default.
|
| Select messages containing a specific CorrelId in the Message Descriptor Structure. You can use the following input fields to specify a substring, a length and a special operator to use in comparisons: - (optional) Sub (Substring): Specifies the starting point of the comparison. Valid values are 1 to 24.
- (optional) Len (Length): Specifies the length of the substring comparison. Optional. If omitted, length is the remainder of the field following the substring.
- Op (Operator): Specifies the type of data and the type of comparison. Valid operators are EQ, NE, GT, LT, GE, LE, IN, EX, HE, HN, HG, HL, GX, LX, FO and FN. Default is EQ. To view a description of the operators, see the Help panel for this field.
- Value (Value): Specifies the data value against which the Msgid field of the Message Descriptor Block is compared. The data type should match that indicated by the Op field. Local and Shared variables are permitted.
In addition: - An entry in this field is not required.
- Allowed only for messages that are not of format MQFMT_EVENT.
- This field is left blank by default.
|
| (Application Data) Select all messages that contain a specified text string. The first 255 bytes of the message participate in the Text String matching. You can use the following input: - (optional) Sub (Substring): Specifies the starting point of the comparison. Valid values are 1 to 24.
- (optional) Len (Length): Specifies the length of the substring comparison. If omitted, length is the remainder of the field following the substring.
- Op (Operator): Specifies the type of data and the type of comparison. Valid operators are EQ, NE, GT, LT, GE, LE, IN, EX, HE, HN, HG, HL, GX, LX, FO and FN. Default is EQ. To view a description of the operators, see the Help panel for this field.
- Value (Value): Specifies the data value against which the Msgid field of the Message Descriptor Block is compared. The data type should match that indicated by the Op field. Local and Shared variables are permitted.
Important Be aware that the variable, IMFTEXT, which is passed to an EXEC when scheduled from a Rule, has the same limitations as the MSG Buffer of the Selection Criteria Panel, 255 bytes. For more information regarding IMFTEXT, see section 4 in the Using-advanced-automation-with-BMC-AMI-Ops-Automation. To access data in the message beyond 255 bytes, use the variable IMFQ_BUFFER (for REXX EXECs only) that is created when the EXEC is invoked. This variable contains up to 16 MB of data from the buffer (minus 48 bytes for the message header). In addition: - An entry in this field is not required.
- Allowed only for messages that are not of format MQFMT_EVENT.
- This field is left blank by default.
|