Add operator-initiated commands to a policy rule

For every rule, you can configure an operator-initiated command to be attached to the message that the rule sends to the message browser. This command can be started by the operator from the message browser. The command might be a script that requires operator input to solve the problem, or instructions that appear in the web browser on the management console.

You can set the following properties:

• Graph (available only for the Measurement Threshold policy type). Select Graph if the source of your policy is a metric in the Embedded Performance Component and you want the operator-initiated command to show a graph of that metric's value over time. See Set threshold source properties for more information. Use Date range to indicate how much historical data the graph should present. For example, if you select 1 Hour, the graph shows the metric's value over the hour before the threshold was crossed.
• Graph Template (available only for the Measurement Threshold policy type). By selecting Graph Template, you can choose a predefined HP Performance Manager graph that you want the operator-initiated command to show. When an operator starts this command, HP Performance Manager generates a graph using data from the affected node and the selected graph template.
  • Graph template name: Click Browse and select the name of the graph template that you want to provide to the operator.
  • Date Range: Select the span of time for which data should be displayed in the graph.
  • Filter on Instance: If want the graph to only show data from a specific instance, enter the instance name here.

  NOTE:
  Graphs are available only if HP Performance Manager integration is correctly configured on the management server. For more details, see HP Performance Manager Integration.

• In the Command text box, you specify the command to run when the command is started for this message. The command runs on the node specified in the Node box. If the command contains spaces, enclose it in quotation marks. Commands that are internal to the Windows command shell (for example echo or move), must be preceded by cmd /c. See the Windows help for more information about cmd.
• In the Node text box, you specify the name of the node on which the command will be started. You can also use the variables <$OPC_MGMTSV>, <$MSG_NODE_NAME>, <$OPC_GUI_CLIENT>, or <$OPC_GUI_CLIENT_WEB>, to configure reusable policies for replicated sites. See policy variables for more information. Note that the options below cannot be used when the variables <$OPC_GUI_CLIENT>, or <$OPC_GUI_CLIENT_WEB> are selected.
• When Append output of command as annotation to the message is selected, an annotation is added to the message when the command completes. The annotation contains the start time, output, exit value, and finish time of the command. If a command fails, an annotation is provided even if this item is not selected.
• When Acknowledge the message when command is successful is selected, the message is automatically acknowledged (that is, moved to the acknowledged messages browser) if the command is successful.

To set up an operator-initiated command

1. Right-click the policy and select All Tasks Edit...
2. Select Rules.
3. Select the rule to which you want to add a command.
4. Select Modify.
5. Select Actions.
6. Select Operator-initiated command and set up the command.

Related Topics:

• Automatic command
• Quick start: how to create a policy