Auto-Reaction Method: Execute Operating System Command

Use

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

The key feature of this auto-reaction method is that you can transfer details about the alert to the operating system command as parameters. Use method parameters to do this, which can contain arguments that are in turn replaced by the relevant alert data at runtime.

In detail, the auto-reaction method has the following method parameters:

The following arguments in the method parameters MTENAME and PARAMLIST_<n> are replaced by the relevant values at runtime:

Prerequisites

You must define the desired operating system command in the External Operating System Commands transaction. To do this, proceed as follows:

1. Choose CCMS → Configuration → External Commands, or call transaction SM69.
2. Choose change mode with the Display «Change () button, and choose Create ().
3. Now enter details about the desired operating system command, ensure that the Additional Parameters Allowed indicator is activated, and save your entries.

The optional static parameter, which you defined in the input field Parameter for Operating System Command in transaction SM69, is first transferred to the operating system command. Which other parameters are additionally transferred to the command depends on the configuration of the corresponding auto-reaction method.

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 ().
4. Enter the desired name and save your entries.

Adjust Method Parameters and Release Method

1. Select the copy of the method that you have just created and choose Edit Data ().
2. The Monitoring: Methods screen appears. Choose change mode with the Display «Change () button.
3. Choose the Parameters tab page, and set the logical command to be executed and the other method parameters (see above).
4. Choose the Release tab page and in the Execute Method as group box, select Auto-Reaction Method.
5. Save your entries.

Assigning the Method to the Desired Node

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 Changing Properties and Method Assignments). 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 Monitoring: Properties and Methods screen appears. Choose the Methods tab page and then choose the Method Assignmentbutton.
5. The Monitoring: Methods screen appears. 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 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 () button.
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.

Assign Analysis Method to Only this MTE

1. Choose change mode with the Display «Change () button, 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.

Result

If an alert is triggered for one of the MTEs to which you have assigned this auto-reaction method, the monitoring architecture will automatically execute the corresponding logical command.

Example

Alerts are to be logged. To do this, a file with the name alert_<date>_<time>.txt is to be created, which contains information about the alert, such as:

yellow alert from 'PDR/SAP_CCMS_pdrhost_PRD_00/prdhost_PRD_00/R3Syslog/BasisSystem' A04 'Load format of SAPLQDIS abload1 0413 invalid.'

1. Use the method CCMS_AUTO_REACT_OP_COMMAND as a template for your own method. The parameters MTENAME and PARAMLIST_1 are already filled by default. Add the command Z_TEST and the parameter ID under PARAMLIST_2:

   Parameter	Parameter Value
   COMMAND	Z_TEST
   PARAMETERS
   REACT_ON_ALERTS
   MTENAME	SID/SEGMENT/CONTEXT/OBJECT/ATTRIBUTE
   PARAMLIST_1	COLOR DATE_TIME MSG
   PARAMLIST_2	ID
   PARAMLIST_3
   PARAMLIST_4

2. In transaction SM69, define the logical command Z_TESTfor the Linux operating system; specify the Linux script test.sh in it (it must be possible for user <SID>adm to execute this script)
3. In transaction SM69, define the logical command Z_TEST for the Windows NT operating system; specify the Microsoft Windows script test.cmd in it.

   With the settings that you have just adjusted, the following command is executed if an alert occurs:

   • Linux:

     test.sh '<SID>/<SEGMENT>/<CONTEXT>/<OBJECT>/<ATTRIBUTE>' <COLOR> <DATE>_<TIME> '<MSG>' <ID>

   • Microsoft Windows:

     test.cmd '<SID>/<SEGMENT>/<CONTEXT>/<OBJECT>/<ATTRIBUTE>' <COLOR>

     <DATE>_<TIME> '<MSG>' <ID>

4. Create a script that generates a file with the name alert_<date>_<time>.txt:
   • Linux script test.sh:

     #!/usr/bin/shecho $2 alert from $1 Message $5 $4 > alert_$3.txt

   • Microsoft Windows script test.cmd:

     echo %2 alert from %1 Message %5 %4 > alert_%3.txt

   If you are not using absolute path specifications, the file is stored in the DIR_HOME directory.