|
|
|
There are several types of actions you can use in any sequence or combination to automate the processing of an input or output message. Actions labeled “Windows only” can be sent to a Windows computer running CA NSM.
Permits execution of a command entered at the system console or issued using the oprcmd command.
Return Code: Return code from the executed command
(Windows only) Adds text as an annotation to the last console log record.
Note: For detailed information, see the online help.
Automatically answers a message on the Event Console that is waiting a reply. The Text field lets you specify the answer.
Return Code:
Zero—OK
Nonzero—Invalid reply, message not found, or other failure to deliver
Example: &1 reply
Displays a scrolling ticker‑tape style message in a separate window on the desktop of the node specified in the message action. That node must be a Windows server and must be a node that has the Event Management real‑time components running on it.
The Text field specifies the text you want displayed.
Permits execution of a program or command. On UNIX platforms, this action is the same as UNIXCMD; you can use either term.
The Text field specifies text string for the command syntax. CA Common Services for z/OS interprets the first element of this text string as the name of a program, script, or batch file to execute. The remaining elements are passed as arguments.
On z/OS, COMMAND must name a shell script or a zSeries File System (zFS) executable that can be invoked using the "Spawn" system service.
You can use a number of command prefixes with the COMMAND action. For details on these prefixes, see the online help for the cautil MSGACTION statement.
(Windows only) Sends a message based on the TEXT operand to the specified Distributed State Machine (DSM).
Note: For detailed information, see the online help.
Causes message action processing to wait a specific amount of time before proceeding to the next action.
The Text field specifies the time.
Example: hh:mm:ss
Deletes a live console message previously retained by a SENDKEEP action.
The Text field specifies the text that must be matched and then deleted. Wildcards are accepted.
Return Code:
Zero—Message found and deleted
Nonzero—Message not found
Marks the message record currently being processed as unavailable for selection. When disabled, an input or output message cannot be selected for automatic processing until the message record is enabled with the ENABLE option.
For example, a typical response to an invalid reply is that the reply is rejected and the original message reissued. If the errant reply comes from an incorrectly defined Event Management message action, the result is an infinite loop of invalid replies. You can address this loop exposure by using the DISABLE message action.
Prevents an unwanted message from being displayed at an operator console. The message is not placed in the Event Console Log.
Marks a message record that was previously disabled as available for selection.
Initiates message selection based on the text supplied by the Text field. The text is itself matched against the message record as if it were a message received by Event Management. Then the actions associated with the matched text are performed. If a match is not found, EVALUATE functions identically to SENDOPER.
Return Code:
Zero—Match
Nonzero—No match
Terminates message processing for this event. Further actions are skipped.
Sets the value of an environment variable in the process in which the actions are being performed and in the Event Manager.
The Text field specifies the variable and its value:
variablename=value
In the local environment of the Event Management daemon, value is assigned to this environment variable. Any variable you specify can be tested later through the TEST message action.
(Windows only) Permits execution of a user-defined function in a dynamic-link library (DLL).
Return Code: Return code from the executed function
Forwards a message to another server for further evaluation.
The Text field specifies the text to be forwarded. If no text value is specified, the original message is forwarded. You can use this action to let a central node process all the messages generated on a set of remote nodes. The FORWARD action sends an event to a remote node, and allows for further matching and action on the remote node.
Chains non‑consecutive actions together to enable branching to another action associated with the message. Optionally, you can base the branching on the return code from the last action to perform a conditional GOTO.
The Text field specifies the action sequence number to go to.
Highlights the message when displayed on the Event Console.
The Text field specifies the text to highlight. If no value is specified, the original message is highlighted.
Indicates that all actions for this message are to be ignored and not performed.
Permits execution of a command that is either entered at the system console or issued using the caiopr oprcmd command.
Prevents the execution of a specific command entered at the Event Console. It also intercepts the oprcmd command to prevent execution of a specific command.
Prevents the execution of a specific command entered at the Event Console. It also intercepts the oprcmd command to prevent execution of a specific command.
Marks a message for persistent display in the held messages area of the Event Console. The console operator must acknowledge and delete the message.
The Text field specifies the text to display on the console. If no value is specified, the original message is displayed.
Sends a message to the Event Console.
The Text field specifies the text to be sent to the console. If no value is specified, the original message is displayed. The SENDOPER keyword sends an action to a remote node where the event is logged and no further matching is possible.
Sends the text specified by the Text field to the user who created the message.
Return Code: Return code from the UNIX write command
Prevents an unwanted message from being displayed on the Event Console but records the message in the Event Console Log.
The Text field specifies the message text to be suppressed on the Event Console.
(Windows only) Updates the status of WorldView objects.
Note: For detailed information, see the online help.
Indicates that a command or program is to be executed. This action applies only to UNIX platforms and is the same as COMMAND.
The Text field specifies the UNIX command to be issued.
Indicates that a UNIX shell script is to be executed or that you want to create a pipeline (for example, cmdI | grep xx | yy). This action applies only to UNIX platforms.
The Text field specifies the UNIX commands or shell script to be executed.
Sends the specified message to the CA Common Services for z/OS console and waits for a reply.
The Text field specifies the text to display. You can use the careply command to reply to the message.
Return Code:
Zero—OK
Nonzero—System error
Waits until the specified time before executing the next action.
The Text field specifies the wake-up time.
Example: hh:mm:ss
(Windows only) Populates the WorldView Common Database with objects.
Note: For detailed information, see the online help.
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |