CA MIC Statements and Commands › (MIC) DOM Command-Delete Action Messages

(MIC) DOM Command-Delete Action Messages

The DOM command lets you immediately delete one or more action messages from local and external consoles. In this context, delete actually means that highlighted messages are changed to normal intensity, so they scroll off the console.

The DOM command only deletes messages that have been reissued by GCMF as a result of a COLLECT command. The DOM command must be issued on the same system from which the original message came. To display the action messages eligible for deletion, issue the DISPLAY DOM DETAIL command.

You would use this command if you did not want to wait for the highlighted message to be automatically changed to a non-highlighted message by GCMF (see SETOPTION AUTODELETE, DELETEINTERVAL). The DOM command is available only when you are running GCMF of the CA MIC component.

Scope: Local

This command has the following format:

DOM [ASID=asid] 
    [CLEAR] 
    [ERASE] 
    [JOBNAME=jobname] 
    [MSGID=msgid]

ASID

Deletes messages that have a designated address space ID. Specify this ID in place of the asid variable. GCMF deletes these messages from all MCS consoles, local and external.

You can use the DISPLAY DOM DETAIL command to see what address space IDs are assigned to messages.

CLEAR

Deletes all action messages from all MCS consoles, local and external.

ERASE

Deletes all action messages from external MCS consoles but not from local MCS consoles.

JOBNAME

Deletes all action messages issued by the designated job. Specify a single name in place of the jobname variable. GCMF deletes these messages from all MCS consoles, local and external.

MSGID

Deletes all action messages with the designated message ID. Specify a single ID in place of the msgid variable. GCMF deletes these messages from all MCS consoles, local and external.

Usage Notes: DOM Command

• The DOM command will not delete WTOR messages.
• The DOM command usually is issued from a console, rather than from the MIMPARMS data set.
• You must be authorized to issue system control commands to issue the DOM command. TSO users generally are not authorized to issue system control commands.
• When you delete action messages, you are changing the message to non-highlighted so it scrolls off the console screen.
• You can use the * and # wildcard characters with the JOBNAME and MSGID operands. For a description, see the Usage Notes for the COLLECT command in this chapter.
• The DOM options ASID, CLEAR, JOBNAME, and MSGID delete the messages from consoles on the originating system and on the systems where they were collected. ERASE deletes them only from the systems where they were collected.

Examples: DOM Command

• To delete all GCMF-managed action messages from all local and external MCS consoles, issue this command:

  DOM CLEAR
  

• To delete all messages issued by job PAYROLL from all local and external consoles, issue this command:

  DOM JOBNAME=PAYROLL
  

  Assume for this example that some or all messages from job PAYROLL have been collected to local consoles, external consoles, or both.