DOM


This command deletes a WTO or WTOR.


Command

Parameters

DOM

ID(domid)

Certain descriptor codes indicate to MVS that a WTO should not roll off the master console but should stay there until explicitly deleted by the operator. If the cause for this WTO is no longer present, or the reply for a WTOR is no longer required, the WTO(R) can be deleted using the IMFEXEC DOM command.

Two BMC AMI Ops Automation variables are used to determine the DOMID of a WTO or WTOR, or Rule-initiated EXECs. IMFWTDOM is set when an IMFEXEC WTO or IMFEXEC WTOR command is issued. IMFDOMID is set for Rule-initiated EXECs triggered by WTOs, WTORs, or MWTO events. It may be necessary to save IMFWTDOM or IMFDOMID in a shared variable so that a subsequent EXEC can issue the DOM.

The following table describes the parameters:

Parameter

Function

Notes

ID(domid)

WTO(R) sequenceNumber

It uniquely identifies a WTO(R) and can be retrieved either

  • In Rule-initiated EXECs (that are triggered by the event types WTO, WTOR, or MWTO) by using the IMFDOMID variable
  • In an EXEC that issues IMFEXEC WTOs or WTORs from IMFWTDOM

Condition codes are listed in the following table:

Value

Description

0

DOM issued.

8

DOM ID is missing, non numeric or zero.

Example

This example deletes the WTO(R) that caused the EXEC to be triggered.

/* REXX */
"IMFEXEC DOM ID("IMFDOMID")"

CLIST example:

IMFEXEC DOM ID(&IMFDOMID)

The DOMID for a WTO or WTOR that is issued by an EXEC is placed in variable IMFWTDOM.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Automation 8.3.01