Certain alerts from SP-AMS notify you that an abnormal condition has occurred involving Operations Sentinel automation. Abnormal conditions include problems with the following:

You must manually clear all such alerts raised by SP-AMS, because there is no corresponding event that SP-AMS can detect to clear the alert automatically. By manually clearing the alert, you are acknowledging that you are aware of the failed automation.

Database Activation Errors

A database activation error occurs if the database to be activated does not exist, cannot be read, or is not a valid SP-AMS database. All activation error alerts display the following text in the Alerts window:

Single Point AMS database activate error.

Activation error alerts contain additional information to identify who made the activation request, which database or databases are involved, and the resulting active database (if any). The additional information appears in the alert details pane in the following format:

This alert must be manually cleared.
information#: Activation of database attempted by requester.
Error error#: error-message-text
information#: resulting-active-database-text

where:

information#

is a unique information number associated with the resulting database state. These numbers are listed in the Operations Sentinel Autoaction Message System Administration Guide.

database

is the name of the database that could not be activated.

requester

is the entity requesting the database activation. requester is one of the following strings:

error#

is the unique error message number associated with the error. These numbers are listed in the Operations Sentinel Autoaction Message System Administration Guide.

error-message-text

is the text of the error message explaining the exact error condition.

resulting-active-database-text

is the text that identifies the resulting active database. This text includes the name of the active database, if any.

Activation Error Example

Single Point AMS database activate error.
This alert must be manually cleared.
I0007 : Activation of db2 attempted by operator.
Error E0011 : Database data-folder\sp-ams\db2 does not exist.
I0004 : Database db1 remains active.

This activate error alert indicates that a database activation request failed because the database does not exist. In this case, the request was made by the operator. The database that could not be found was db2. It was searched for in folder data-folder\sp-ams. SP-AMS recovered and continues to use database db1 for automation.

Action Processing Errors

Action processing errors can occur if SP-AMS cannot resolve a text substitution request or if an action, such as an EVENT-REPORT, is improperly constructed. All action error alerts display the following text in the Zone Alerts window:

Single Point AMS action processing error.

Action error alerts contain additional information to help you determine the exact cause of the error. This additional information appears in the alert details pane in the following format:

This alert must be manually cleared.
Message text : message-text
Match        : database= database Group= "group" Number= message#
tokens= total-tokens
Error error# : error-message-text

<level> action-type  : database-action-text
-------------> resulting-action

where:

message-text

is the first 80 characters of the message text that matched the pattern.

database

is the name of the database that contains the pattern that matched.

group

is the group name of the matching pattern.

message#

is the message number of the matching pattern.

total-tokens

is the total number of tokens in the message text.

error#

is the unique error message number associated with the error. These numbers are listed in the Operations Sentinel Autoaction Message System Administration Guide.

error-message-text

is the text of the error message explaining the exact error condition

level

is the level of conditional logic nesting. <level> appears only when the action is specified with conditional logic.

action-type

is the name of the action that failed.

database-action-text

is the text of the failed action as it was specified in the database.

resulting-action

is the text of the action when the error was detected. This text might be a partially built action if a substitution error is detected. For conditional logic actions and SET actions, action processing errors include the portion of the expression where the error occurred in place of the resulting action.

Action Processing Example

Single Point AMS action processing error.
This alert must be manually cleared.
Message text : Switch to SP-AMS database shift#1
Match        : Database= test Group= "activate" Number= 1 token= 5
Error E0002  : Text "shift#1" is an invalid database name.
ACTIVATE     : \5\
-------------> shift#1

This action error alert indicates that an invalid database name was specified for an ACTIVATE action. In this case, the error occurred when the message, "Switch to SPAMS database shift#1," matched the pattern identified as "activate-1" in database "test." After token 5 (\5\="shift#1") was substituted into the action, SP-AMS determined that the result was not a valid database name.