Alert Environment Variables

In addition to the environment variables supplied for all external applications, the following environment variables are provided when an external application is launched from an alert.

Environment Variable

Description

SP_ALERT_CLASS

**SP_ALARM_CLASS

The class name specified in the AL event report that raised the alert. If the external application acknowledges or clears the alert, it should use this class value in the event report.

SP_SEV

Severity of the alert.

SP_APPL

Alert application.

SP_APPLQUAL

Alert application qualifier.

SP_ALERTID

**SP_ALARMID

Alert identifier.

SP_ALERTQUAL

**SP_ALARMQUAL

Alert qualifier.

SP_HELP

Value of the HELP attribute for the alert. This could be a file name or actual text.

SP_TEXT

Text of the alert, including any newline characters.

SP_ACK_TEXT

Acknowledge text of the alert, including any newline characters. If the alert has not been acknowledged, this is set to the null string.

SP_EXT_ACTION_LIST

Name of the external action list for the alert.

SP_SENDER_DATE

Date (according to the sender) on which the alert was raised. This is set to the null string if the sender has not specified a sender date/time for the alert.

SP_SENDER_TIME

Time (according to the sender) at which the alert was raised. This is set to the null string if the sender has not specified a sender date/time for the alert.

SP_SERVER_DATE

Date, according to the Operations Sentinel server, on which the alert was raised.

SP_SERVER_TIME

Time, according to the server, at which the alert was raised.

SP_user-defined

One of these for each user-defined attribute associated with the alert, where user-defined is the name of the attribute in all uppercase with all white space characters removed.

**These environment variables are retained for compatibility until Operations Sentinel level 12.0. If a Command String or application executable currently refers to one of these environment variables, you should update it to use the new name.