Each ACTION command specifies an action SP-AMS or CP-AMS should perform when it matches the pattern to a message.
ACTION Command Summary
Table B–1 provides a quick overview of ACTION commands, their purpose, and their availability. Detailed information on each command follows, listed alphabetically.
Table B.1. ACTION Command Summary
| Command | Purpose | Available on |
|---|---|---|
| ACTION ACTIVATE | Activate a database | All |
| ACTION ALARM | Issue a console alarm | CP-AMS |
| ACTION ANSWER | Automatically answer an outstanding read-and-reply message using message dialog. | CP-AMS |
| ACTION COMMAND | Generate an unsolicited console command | All |
| ACTION DEACTIVATE | Deactivate the currently active autoaction database | All |
| ACTION DISPLAY | Display specified action-text | CP-AMS |
| ACTION EVENT-REPORT | Create, change, or delete a Status component Write an entry to an Operations Sentinel log file Raise, clear, or acknowledge an alert Send a command to another managed system | All |
| ACTION EXECUTE | Execute a macro file containing console commands | CP-AMS |
| ACTION HIGHLIGHT | Attach a color (display attribute) to specified messages | CP-AMS |
| ACTION HOLD | Hold a message in the console window until released | CP-AMS |
| ACTION PASSWORD | Send a password or other command that is stored in unreadable form to a managed host | SP-AMS |
| ACTION RELEASE | Automatically release a held message | CP-AMS |
| ACTION RESPONSE | Respond to a read-and-reply message | CP-AMS |
| ACTION SUPPRESS | Suppress display of the matched message | CP-AMS |
| ACTION TCOMMAND | Transparently generate an unsolicited console command | CP-AMS |
| ACTION TEXECUTE | Transparently execute a macro file containing console commands | CP-AMS |
ACTION Formats
To define an action for a pattern in a CP-AMS database:
ACTION operation-mode action-type ["token text"] \ [WAIT nn [<SECONDS> ) MINUTES] ]
To define an action for a pattern in an SP-AMS database:
ACTION action-type ["action-text"] \ [WAIT nn [<SECONDS>) MINUTES] ]
EVENT-REPORT Formats Used for Action Text
To change the values for, or to dynamically create, a Single Point Operations Status component:
"TYPE=AC | CLASS=class | INSTANCE=instance |" \ "[attribute-name=attribute-value]..."
To delete a Single Point Operations Status component:
"TYPE=DE ) CLASS=class ) INSTANCE=instance"
To add an entry to an Operations Sentinel log:
"TYPE=LG ) CLASS=object-class ) INSTANCE=object-name " \ ")APPL=application-name [) APPLQUAL=application-qualifier]" \ "[) MSGTYPE=message-type] ) TEXT=message-text"
To raise, clear, or acknowledge an alert in Operations Sentinel:
"TYPE=AL ) CLASS=object-class ) INSTANCE=object-name " \ ") SEV=severity ) APPL=application-name" \ "[) APPLQUAL=application-qualifier] " \ ") ALERTID=alert-identifier [) ALERTQUAL=alert-qualifier]" \ "[) HELP=help-file] [) TEXT=alert-text]"
To send a command from one managed system to another managed system (cross-system automation):
"TYPE=CO ) CLASS=host-class ) INSTANCE=host-name " \ ") COMMAND=command-string" \ "[) APPL=application-name] [) APPLQUAL=application-qualifier]"