INCLUDE/EXCLUDE command definition description - Documentation for BMC AMI Message Advisor for IMS 1.9

The QMRAPI INCLUDE/EXCLUDE command definition generates an INCLUDE or EXCLUDE subcommand for a DISPLAY command. You can use multiple INCLUDE and EXCLUDE subcommands after the $QMRAPI DISPLAY instruction and before the $QMRAPI END instruction.

INCLUDE and EXCLUDE subcommands refine the selection criteria for node names. You can use the subcommands in place of the NODE_NAME keyword on the DISPLAY command, or you can use them in addition to the keyword. You can use as many INCLUDE and EXCLUDE subcommands as you desire.

Message Advisor always processes INCLUDE subcommands first, regardless of the subcommand order. Node names that match the INCLUDE criteria become part of an included subset. A node name must match all criteria on a specific INCLUDE subcommand to become part of the included subset; that is, the node name must match the specified range and the transaction ID (if specified).

Message Advisor processes the INCLUDE subcommands independently. If the node name matches any one of the INCLUDE subcommands, it becomes part of the included subset. Also, any node names that match the NODE_NAME keyword on the DISPLAY command become part of the included subset. If there are no INCLUDE subcommands and no NODE_NAME keyword, then all node names become part of the included subset.

After Message Advisor determines the included subset, it processes the EXCLUDE subcommands. Any node names in the included subset which match the exclude criteria on any EXCLUDE subcommand are eliminated from the subset. Again, Message Advisor processes the EXCLUDE subcommands independently. A node name must match all criteria on a specific EXCLUDE subcommand to be eliminated.

Message Advisor displays any node names remaining in the included subset.

Keyword descriptions for the INCLUDE/EXCLUDE command definition appear in this section in alphabetical order.

This section contains the following topics: