Command Line Notifiers

Use a command line notifier to specify a command (executable, shell script, batch file, and so on) to run as a notification.

To configure a Command Line notifier:

  1. In the Configure Notifier window, select Command Line from the Notifier Type menu.
  2. In the Command text box, enter the command. Include any arguments, exactly as you would type them on the command line.
  3. Click Test Notifier to send a test notification.

Configuring the Command Line Notifier

Command Text Box

Specify the executable you want to run, including any arguments. Note that you need to specify the exact name, including any extensions such as .exe or .cmd.

If you want the message generated by Intermapper to be included in the command, place the text ${MESSAGE} where you want the message to go.

NOTE:

Double quotation marks (" ") must be used for special environment variables, such as "${MESSAGE}", when configuring the Command Line Notifier for Intermapper to accept the command.

To include the message escaped for use in an HTTP query string, use ${ESCAPED_MESSAGE} instead.

NOTE: Intermapper allows an expanded command line (that is, the command line with the path added and the message inserted) up to 65535 characters, but you might find that your host platform limits the command-line size to only 255 characters. For Microsoft Windows users, you can work around this limitation by converting your command-line script to a PowerShell script and use a PowerShell notifier.

Use ${STRIPPED_MESSAGE } to strip the message of any punctuation that might cause trouble for the command line notifier.

Use ${URLESCAPE} to escape the message for use as a URL.

NOTE: The command box must refer to an executable which resides in the Tools subdirectory of the InterMapper Settings directory, or a subdirectory. No other executables can be referred to. However, the executables in this directory can be links, shortcuts, or aliases to an executable elsewhere; they can be resolved and executed.

For an example of a command line notifier, see the Examples page.