Database Deactivation Message

When an SP-AMS or CP-AMS database is deactivated, SP-AMS or CP-AMS produces a database deactivation message.

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

AMS deactivates a database when an autoaction database is currently active and any of the following occurs:

A DEACTIVATE action is executed.
An ACTIVATE action is executed.
An operator activates or deactivates a database.

Matching the Database Deactivation Message

One database deactivation message is generated each time a database is deactivated. AMS handles this message the same way it handles system messages: It compares the message to the patterns defined in the active autoaction database. Therefore, you can create a pattern to match the database deactivation message and specify actions for AMS to execute just before the database is deactivated.

Restrictions

The database deactivation message is generated when a database is being activated or deactivated. As a result, if the pattern that matches the 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 or deactivation has completed.

Additional SP-AMS Restrictions

You cannot use PASSWORD or COMMAND actions in a pattern that matches the database deactivation 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 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 definition intended to match the database deactivation message because these actions can cause run-time errors.

Text of the SP-AMS Database Deactivation Message

The text of the database deactivation message is one of the two listed below. The second message is generated when a request has been submitted to deactivate the active database and to activate another database:

  MI002: Deactivating SP-AMS database db-name 
         requested by source.
  MI002: Deactivating SP-AMS database db-name
         requested by source (Activating db-name3).

where:

db-name

is the name of the database to be deactivated.

source

identifies what caused the database to be deactivated. source is one of the following text strings:

```
operator
```
The database was deactivated by the operator from the Operations Sentinel Console.
```
database db-name2
```
The database was deactivated by a DEACTIVATE action in the previously active database. db-name2 is the name of the database where the DEACTIVATE action originated.
```
Reactivate AMS Database utility
```
AMS database is deactivated as a part of database automatic reactivation. Refer to Section 6.7, “RADB Utility”, for information on database reactivation.

db-name3

is the name of the database that is to be activated.

Text of the CP-AMS Database Deactivation Message

A deactivation message has a message type of OTHER and a sender type of ANY‑SENDER. There are two deactivation messages. The first one is generated when a request has been submitted to deactivate the database. The text of this message is

AMS002: DEACTIVATING db-name REQUESTED BY source

The other message is generated when a request has been submitted to deactivate the active database and to activate another database. The text of this message is

AMS002: DEACTIVATING db-name REQUESTED BY
       source (ACTIVATING db-name2)

where:

db-name

is the database that will be deactivated

source

is one of the following requesting entities:

Computer-name.user-name
The source of the deactivate came from either the OS 2200 Console View or as part of a database reactivate request from 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 ACTION
A deactivate action in the active database deactivated itself.

db-name2

is the database that will become active.

Notes:

If database db-name2 is corrupted, activation fails. AMS tries to reactivate database db-name. If you need to take special actions in this case, you can set a retained variable in response to message AMS002 and check the actions that are taken when message AMS001 (see 7.4) is matched.
If you activate the database that was already active, the second deactivation message is generated with db-name and db-name2 identical.