Command Event Reports

Event Report Action-Text Format

"TYPE=CO | CLASS=host-class | INSTANCE=host-name " \
		" | COMMAND=command-string " \
		" [| APPL=application-name] [| APPLQUAL=application-qualifier] "

For an explanation of the attributes CLASS, INSTANCE, APPL, and APPLQUAL, see the Operations Sentinel Administration and Configuration Guide. See 4.2 for formatting information.

Use an EVENT-REPORT action with TYPE=CO to send a command to any currently managed system, in response to a console message from the same system or any other managed system or console. This capability is referred to as cross-system automation.

A condition occurring on one system can cause actions to be invoked on other systems:

The completion of a job on one system could trigger the start of a job on another system.
The detection of a failure condition on one system could be used to perform recovery from another system.

The receiver of the command can be an MCP, OS 2200, UNIX, or other native X3.64 connected system. (You cannot send commands to Windows systems.)

For UNIX systems, the command has no effect unless the console path is accepting input. (This normally requires that the console be logged in.) If the console is not logged in, UNIX interprets the command as a response to the login prompt.

Example [SP-AMS]

The following example sends a terminal message to the OS 2200 system named system2, informing user BGK that a critical backup file has arrived at the MCP system named system7 (_HOSTID):

ACTION EVENT-REPORT \
   "TYPE=CO | CLASS=host | INSTANCE=system2 | APPL=backup08 | " \
   "COMMAND=TM/u BGK Backup File \_TOKEN1\ received on system7 at \_DT\ "

Required Attribute Value Pairs

Table 4–7 lists the attribute value pairs required for sending a command.

Table 11. Required Attribute Value Pairs for Command Event Reports

Attribute	Description
TYPE	Has a value of CO for sending a command.
CLASS	One of the standard set of supported host classes.
INSTANCE	The name of the system being managed by this Operations Sentinel server that is to receive the command.
COMMAND	The string of characters to send to the managed system. This string can be the NULL string.

Optional Attribute Value Pairs

Table 4–8 lists the optional attribute value pairs.

Table 12. Optional Attribute Value Pairs for Command Event Reports

Attribute	Description
APPL	The name of the application submitting the command (identifies the source of the event report)
APPLQUAL	Further qualifies the application name

It is suggested that you use sp-ams-database or cp-ams-database for application-name and \_DBNAME\ for application-qualifier.