The DOM macro deletes the messages that were created using the
WTO or WTOR macros. Depending on the timing of a DOM macro relative
to the WTO or WTOR, the message may or may not have already appeared
on the operator's console.
- When a message already exists on the operator screen, it has a
format that indicates to the operator whether the message still requires
that some action be taken. When the operator responds to a message,
the message format changes to remind the operator that a response
was already given. When DOM deletes a message, it does not actually
erase the message. It only changes its format, displaying it like
a non-action message.
- If the message is not yet on the screen, DOM deletes the message
before it appears. The DOM processing does not affect the logging
action. That is, if the message is supposed to be logged, it will
be, regardless of when or if a DOM is issued. The message is logged
in the format of a message that is waiting for operator action.
The program that generates an action message is responsible for
deleting that message. To delete a message, identify the message by
using the MSG, MSGLIST, or TOKEN parameters on the DOM macro, and
issue DOM.
When you issued WTO or WTOR to write the message, the system returned
a message ID in general purpose register 1. Use this ID as input
on the MSG or MSGLIST parameters on the DOM macro. MSGLIST (message
list) associates several message IDs with the delete request. The
number of message IDs in the message list is defined by the COUNT
parameter or it is defined by a 1 in the high-order bit position of
the last message ID in the list. The COUNT parameter cannot exceed
60. If you specified the TOKEN parameter on WTO to generate your own
message ID, use the same value on the TOKEN parameter on DOM to delete
that message.