Entering content frameProcedure documentation Auto-Reaction Method: Execute Operating System Command Locate the document in its SAP Library structure

Use

You can execute any operating system command as an auto-reaction to a monitoring architecture alert. For security reasons, this does, however, apply only for those commands that have previously been defined in the External Operating System Commands (SM69) transaction.

Prerequisites

If an auto-reaction method calls the operating system command, the following parameters are transferred to the command; ensure that the command can process these parameters in the following sequence:

Parameter

Description

<PARAM1>

Fixed parameter that is defined in transaction SM69 in the Parameter for Operating System Command field (optional)

<PARAM2>

Additional parameter, that is defined in the definition of the auto-reaction method under PARAMETERS (see below) (optional)

<SYSID>

System ID of the system in which the alert occurred

<DATE>

Date and time of the alert

<TIME>

<SEVERITY>

Severity and color of the alert that triggered the auto-reaction.

<COLOR>

<SHORTNAME>

Short name of the monitoring attribute and the name of the monitoring object in which the alert was triggered

<OBJECT>

<MESSAGE>

Message that is assigned to the alert

You must now define the desired operating system command in the External Operating System Commands transaction. To do this, follow the procedure below:

  1. Choose CCMS ® Configuration ® External Commands, or call transaction SM69.
  2. Choose change mode with the Display « Change (This graphic is explained in the accompanying text) pushbutton, and choose Create (This graphic is explained in the accompanying text).
  3. Now enter the details for the desired operating system command and save your entries.

Note

For information about defining the command, see Structure linkExternal Operating System Commands: Content.

Procedure

Copy Method

We recommend that you leave the original method CCMS_AUTO_REACT_OP_COMMAND unchanged and use it only as a template for your methods. In this way, you can set up as many logical commands as you wish as auto-reactions.

  1. Choose CCMS ® Configuration ® Alert Monitor, or call transaction RZ21.
  2. In the Methods group box, select Method Definitions and choose Display Overview.
  3. Select the method CCMS_AUTO_REACT_OP_COMMAND and choose Copy (This graphic is explained in the accompanying text).
  4. Enter the desired name and save your entries.

Adjust Method Parameters and Release Method

You must now specify the desired logical command in the method that you have created and release the method as an auto-reaction method.

  1. Select the copy of the method that you have just created and choose Edit Data (This graphic is explained in the accompanying text).
  2. The system displays the Monitoring: Methods screen. Choose change mode with the Display « Change (This graphic is explained in the accompanying text) pushbutton.
  3. Choose the Parameters tab page. You can set the following parameters here:
    4.

    Parameter

    Description

    Default

    COMMAND

    Logical command that is to be executed in the case of an alert

    		  

    PARAMETERS

    Additional parameter <PARAM2> that you want to transfer to the command (see above)

    		  

    REACT_ON_ALERTS

    Color of the alert at which the auto-reaction method is to be started: for red and yellow alerts (YELLOW) or only for red alerts (RED)

    RED

    Note

    The COMMAND parameter is required, all other parameters are optional.

  4. Choose the Release tab page and in the Execute Method as group box, select Auto-Reaction Method.
  5. Save your entries.

Note

By default, the operating system command is executed on the local server of the MTE that generated the alert. If the command is to be executed on a different server, change the execution location on the Execution tab page in the Execute Method On group box.

Assign Method to Desired MTE Classes

You must now assign the method to the desired MTEs or MTE classes. You can use either transaction RZ20 (only for the active properties variant) or transaction RZ21 to do this (see also Change Properties and Maintain Methods). Assignment using transaction RZ20 is described below:

  1. Start the Alert Monitor using transaction RZ20 or choose CCMS ® Control/Monitoring ® Alert Monitor.
  2. Start the desired monitor from the list by double clicking it.
  3. Select the desired node and choose Properties.
  4. The system displays the Monitoring: Properties and Methods screen. Choose the Methods tab page and then choose the Method Assignment pushbutton.
  5. The system displays the Monitoring: Methods screen. The rest of the procedure depends on whether you want to assign the analysis method only to this node or to the entire MTE class.

Assign Analysis Method to Only this MTE

  1. Choose change mode with the Display « Change (This graphic is explained in the accompanying text) pushbutton, and choose the Auto-Reaction tab page.
  2. In the Method Assignment group box, choose Method Name and, in the associated field, enter the method that you created as described above.
  3. Save your entries.

Assign Analysis Method to the Selected MTE Class

  1. Choose the name of the MTE class in the header data of the screen by double clicking it, and then choose the change mode with the Display « Change (This graphic is explained in the accompanying text) pushbutton.
  2. In the Auto-Reaction Method group box, choose Method Name and, in the associated field, enter the method that you created as described above.
  3. Save your entries.

Result

If an alert is triggered for one of the MTEs to which you have assigned this auto-reaction method, the monitoring architecture automatically calls the logical command with the parameters [<PARAM1>] [<PARAM2>] <SYSID> <DATE> <TIME> <SEVERITY> <COLOR> <SHORTNAME> <OBJECT> <MESSAGE>.

Leaving content frame