Substitution characters

For alert variables, right-click menus are available for actions. The selected variable is inserted at the cursor location.

The right-click menu is available only for these actions:

  • tcl action: Tcl code field
  • exec action: Command field
  • email action: Subject and Message fields

These variables are available on the right-click menu:

Substitution character Description Action
%A Alert

%A characters are replaced with the alert message.

You can set up custom messages or replace the entire alert message, including % variables for alert values.

%F Temporary file name

%F characters are replaced with the file name of a temporary file containing the alert message.

%G Group membership

%G characters are replaced with the alert’s group membership list.

If no groups exist, then the two characters are replaced by the text "none."

%N Alert name

%N characters are replaced with the alert’s name.

%P All processes in the current site

%P returns all triggered process names.

The process status alert supports %P.

"N/A" is returned if the processes cannot be found.

%p Triggered process

Process name of a thread-based (%t) alert that has triggered.

%R Current repeat count

%R characters are replaced with the current value of the repeat count, starting from zero.

If no repeat was specified, then the two characters are replaced by the text "none."

%T All threads in the current site

%T returns all triggered threads.

%T is supported on all alerts, except process status.

"N/A" is returned if the thread cannot be found.

%t Triggered thread

%t is one triggered thread.

%V Current value

%V characters are replaced with the current source value or a keyed list of sources and values.

If the current value of a source is not available, then the two characters are replaced by the text "n/a."

  • When the value is a delta, the delta is shown as the current value.

    For these alert types, %V is replaced with the value keyed list:

    • transactions/sec
    • forward count
    • error count
    • inbound queue depth
    • outbound queue depth
    • prexlate queue depth
    • postxlate queue depth
    • error database messages
    • file size
    • inbound latency
    • outbound latency
    • total latency
    • last receive
    • last send

    For these single source alert types, %V is replaced by the numerical value:

    • tcl
    • system CPU %
    • wait CPU %
    • user CPU %
    • idle CPU %
    • virtual memory % free
    • virtual memory free
    • disk I/O per second
    • disk % full
    • disk free space
Note:  These values are the values available for the sources when the alert was fired. Some of the values might not have been involved in causing the alert to fire.