Creating a Threshold Command using the Windows Client

Commands from Thresholds are setup from the Message Destinations tab of the Threshold Conditions properties dialog.

More than one Command can be added to a single Threshold condition. When this occurs, multiple Command tabs will appear in the Message Destinations Dialog. The order of the Tabs from left to right implies the order of the command execution.

Within the Commands Destination dialog, the various fields are completed as follows:

Execute command for:
This is a drop-down list box that determines whether this command destination is triggered on the Off event, On event, Open Acknowledgement, Close Acknowledgement or Any Acknowledgement of the corresponding Threshold. If the command is to be run under multiple conditions, separate command destinations need to be configured.

Type:
This is a drop-down box for the Command Type selection. The choices available are:

  • Control Automated Analyst (Analyst)
    Send a command to the Automated Analyst server (irautoan.exe)

  • Control Threshold (Threshold)
    Send a command to the Threshold server (irautoan.exe)

  • Shell on the server (Shell)
    Send a command to be executed via the command server (ircmdsrv.exe)

  • Acknowledge Traps (SNMP Trap Receiver)
    Send a command to acknowledge an SNMP Trap message.

  • ATM Ticketing (ATM Ticketing Management)
    Send a command that will change the state of an ATM problem ticket. For details on this option see Commands for ATM Manager.

Command:
This is a text input field where the command to be executed is entered. This is a mandatory field that must be completed in order to save the document.

  • The Build button, to the right of this text box can be used to search for executable files using a path or folder search.

  • The Build button also provides access to a list of data fields based upon the record being used. This allows for variable data from these fields to be added into the command text.

Description:
This is a text entry field where an optional description of the command can be added. This text will appear in the PROBLEM record log when the command is executed thereby providing the operator with an understanding of what command was run and why. For example, the command 'Dir' could have the Description field text of 'Display a directory listing'.

  • The Build button, to the right of this text box, can be used to search for a path or folder name that can be included in the description text, for example:
    'Deleted all files at: \\Admin\Database\Temp'.

  • The Build button also provides access to a list of data fields based upon the record being used. This allows for variable data from these fields to be added into the description text.

Password Key:
This is a text field where the Password 'user-id-key' is entered. See Threshold Command Passwords for further details.

Command Node:
Enter or select the node that the command is to be executed on. The (Browse) button to the right of this field will open the Node selection dialog box displaying a list of the currently available nodes. #SourceNode is an option that will execute the command on the node where the condition was triggered. Node Groups are not supported.

Override Default Command Node:
Check this box to override the Default Command node, as set in the Default Destinations tab of the Threshold Properties dialog box. This will also enable the adjacent Command Node field where the alternative node can be entered or selected. When unchecked, the command node specified in the defaults dialog is used.

If this box has not been checked and if a node has not been specified in the Command field of the Default Destinations tab of the Threshold properties dialog then an error message will be displayed

Acknowledgement required by operator:
(This field is only active for 'On Events')
Check this box if operator acknowledgment is required before the command is executed. The default is unchecked, i.e. no operator acknowledgment required.

Command Shell Sharing:
A drop-down list box that determines whether the execution of commands on the same node can use the same shell, or require a new shell for each command. Valid selections are Default, Enabled and Disabled.

Provide feedback on this article