Database Activation Message

When an autoaction database is activated, SP-AMS or CP-AMS produces a database activation message. After producing this message, SP-AMS begins automating each managed host, and CP-AMS begins automating the managed host.

This database activation message differs from the database activation message that is placed in the log SP-AMS or the host log SP-AMS (see Appendix D) and CP-AMS messages logged through LG keyins. Since this message is generated internally, it is not displayed in any console window.

Matching the Database Activation Message

The database activation message allows you to prepare AMS to automate managed systems. AMS handles this message the same way it handles system messages: It compares the message to the patterns defined in the active automation database. Therefore, you can create a pattern to match this message and specify initialization actions for AMS to execute.

Restrictions

The database activation message is generated when a database is being activated. As a result, if the pattern that matches this message includes an ACTIVATE or DEACTIVATE action, the action is not executed and a warning message is produced. However, if the ACTIVATE or DEACTIVATE action is delayed with a WAIT clause, it is executed after the original activation has completed.

Additional SP-AMS Restrictions

You cannot use the PASSWORD or COMMAND actions in a pattern that matches the database activation message because these actions are specific to a host. In addition, the values of the hostid token and the predefined variable _HOSTID are undefined. Since the database activation message applies to all managed hosts, host-specific information is not included in the message.

Additional CP-AMS Restrictions

You cannot use HOLD, HIGHLIGHT, RELEASE, SUPPRESS, or DISPLAY actions in a pattern intended to match the database activation message because these actions can cause run-time errors. In addition, use caution with the COMMAND, TCOMMAND, EXECUTE, and TEXECUTE actions, because database activation can occur before system connections are established.

Text of the SP-AMS Database Activation Message

The text of the SP-AMS database activation message is as follows:

MI001: SP-AMS database db-name activated by source.

where:

db-name

is the name of the database being activated.

source

identifies what caused the activation of the database. source is one of the following text strings:

```
Single Point AMS initialization
```
The database was activated when SP-AMS was started.
```
Operator
```
The database was activated by an operator from Operations Sentinel Console.
```
database dbname2
```
The database was activated by an ACTIVATE action in the previously active database. dbname2 is the name of the database where the ACTIVATE action originated.
```
Single Point AMS recovery
```
SP-AMS activated this database to recover from an error while activating a new database. This database was active prior to the failed database activation.
```
Reactivate AMS Database utility
```
AMS database is activated as a part of database automatic reactivation. Refer to Section 6.7, “RADB Utility”, for information on database reactivation.

Text of the CP-AMS Database Activation Message

A CP-AMS activation message has the message type OTHER and the sender type ANY‑SENDER. The text of this message is:

AMS001: db-name ACTIVATED BY source

where:

db-name

is the newly activated database

source

is one of the following requesting entities:

AMS INITIALIZATION
The initialization process names the database to activate.
AMS RECOVERY
CP-AMS activated this database to recover from an error while activating a new database.
Computer-name.user-name
The source of the activate came from either the OS 2200 Console View or the Reactivate AMS Database utility. The computer-name is the name of the workstation where the program is running and the user-name is the name of the user that started the program.
DATABASE db-name2
where db-name2 is the name of the previously active database. An activate action in the previously active database activated another database.

The sample database spastart.bld supplied with Operations Sentinel contains examples of patterns used to match the database activation message.