General Information

Using the DO DOM statement, the Control-O monitor can delete from the console Highlighted, Unrollable or WTOR messages issued by Control-O or issued by other tasks in the system.

Each message is assigned a unique message identification number (DOM ID) that must be specified when deleting the message from the console. These message identifiers are made available to the rule through the %%$MDOMID and %%$LDOMID AutoEdit System variables.

DO statements that issue or intercept messages, such as DO SHOUT or DO COMMAND, result in the update of the %%$LDOMID variable. User-defined AutoEdit variables, specified in a DO SET statement, can be used to retain specific values of the %%$LDOMID variable for later use.

Note: Control-O detects the specified message and triggers the appropriate rule before the message appears on your console. Highlighted, unrollable messages cannot be deleted before they are displayed. Therefore, it is recommended that you use the DO DOM statement in one of two ways:

• Insert a DO WAIT statement before the DO DOM statement, so that processing of the DO DOM statement is delayed until the message is displayed on the console, or
• Save the value of the %%$LDOMID variable in a Global variable, and reference this variable in another rule. This method may be preferable when you want to ensure that a specific action is taken before the message is deleted.