ADDRESS AXC Commands › Commands for Utilities › DOM Command

DOM Command

The DOM command deletes an action message from the action message area of the Merged Messages window and from the Action Message Recall window (by deleting it from the CA Automation Point action message recall list).

Note: Invoke the DOM command only after you have invoked the GETMSGI command or the GETVAR command. The GETMSGI command returns the domid value. The GETVAR command retrieves a previously saved DOMID value.

This command has the following format:

"DOM DOMID(domid)"

DOMID

Specifies the internal pointer to a specific action message in the action message recall list.

Usage Note:

When you invoke the GETMSGI command, it stores the internal pointer value to an action message in the DOMID.n REXX variable. Before invoking the DOM command, assign the DOMID.n value to another variable name-a name that does not contain a period-and use the new variable name for domid.

Examples:

• Suppose that you want to delete all of the action messages containing the word completed. You could write a REXX program containing statements like the following:

  "GETMSGI"
  DO CNT=1 TO DOMID.0 BY 1
    INTERPRET 'CUR_ACTION_MSG=DOMID_MSG.'CNT
    IF POS('completed',CUR_ACTION_MSG) > 0 THEN DO
      INTERPRET 'CUR_DOMID=DOMID.'CNT
      "DOM DOMID(&CUR_DOMID)"
      END
  END
  

• Suppose that you want to delete a specific action message. The first step is to save the internal pointer (stored in the &DOMID environmental variable) to a working variable. Assume that this rule exists in your rules file:

  MSGID(SAVEDOM), HILIGHT, SET(&SAVE_ID=&DOMID)
  

  Your REXX program could contain these statements:

  "GETVAR SAVE_ID CUR_DOMID"
  "DOM DOMID(&CUR_DOMID)"
  "SETVAR SAVE_ID (0)"
  

  The first statement invokes the GETVAR command, which fetches the internal pointer to the action message produced by the rule and stores it in the CUR_DOMID variable. The second statement invokes the DOM command, which deletes the action message that the CUR_DOMID value points to in The CA Automation Point action message recall list. The last statement invokes the SETVAR command, which resets the SAVE_ID working variable used by the rule to 0.