&DOM

The &DOM verb issues an MVS DOM to erase a non-roll delete WTO.

This verb has the following format:

&DOM ID=domid

The verb lets an NCL procedure issue an MVS DOM (delete-operator-message). Typically, this would be sometime after the procedure had issued an &WTO verb to send an NRD message for display on system consoles. The &WTO verb returns the DOMID in &ZDOMID. By saving this value in a user variable, the &DOM verb can use it later.

The &DOM verb is not supported on z/VM.

Operands:

ID=domid

Specifies the DOMID of the message to delete. domid must contain eight hexadecimal digits. The value returned in &ZDOMID after an &WTO is in the correct format, as is the &AOMDOMID system variable value when a WTO or WTOR message is current in an AOMPROC.

The eight hexadecimal digits consist of a two-digit system ID and a six-digit message ID.

Examples: &DOM

&WTO DESC=1 DATA=SEVERE MESSAGE......
&SAVEID = &ZDOMID
... do something else ....
&DOM ID=&SAVEID
&AOMREAD SET
&IF .&AOMMSGID = .id-that-MVS-never-deletes &THEN +
   &DOM ID=&AOMDOMID  -* we delete it.....

Notes:

When using &DOM, consider the following recommendations:

Issue &DOM only with a valid DOMID. An invalid format DOMID (not eight hexadecimal digits) terminates the NCL procedure. If the DOMID appears valid, but the actual number is not valid, the wrong message may be deleted.
Delete messages only for a good reason. Indiscriminate deletion of critical messages can lead to severe operational problems.
The &DOM verb can also be used to delete NRD messages the system issues, which are not deleted by the system itself.

More information:

&WTO

&AOMDOMID