QUERY ALERTSTATUS (Query the status of an alert)

Use this command to display information about alerts that are reported on the IBM Spectrum® Protect server.

Privilege class

Any administrator can issue this command.

Syntax

Parameters

Status

Specifies the status type that you want to display. If you do not specify a status, all alerts are queried and displayed. Specify one of the following values:

ACtive: Displays alerts that are specified in the IBM Spectrum Protect server database as active.
INactive: Displays alerts that are in the inactive state.
CLosed: Displays alerts that are in the closed state.
ANy: Displays all alerts, without regard to state.

MSGnum

Specifies the message number that you want to display. Specify the numerical portion of an IBM Spectrum Protect server message. Values are in the range 0 - 9999. For example, the message number in message ANR2044E is 2044. Specify multiple message numbers by separating them with commas and no intervening spaces.

CATegory

Specifies the category type for the alert, which is determined by the message types. Specify one of the following values:

APplication: Alert is classified as application category. For example, you can specify this category for messages that are associated with application (TDP) clients.
INventory: Alert is classified as inventory category. For example, you can specify this category for messages that are associated with the database, active log file, or archive log file.
Note: The category of CAtalog is used instead of INventory in alerts from servers that were not upgraded to IBM Spectrum Protect 7.1.0 or later.
CLient: Alert is classified as client category. For example, you can specify this category for messages that are associated with general client activities.
DEvice: Alert is classified as device category. For example, you can specify this category for messages that are associated with device classes, libraries, drives, or paths.
OBjectclient: Alert is classified as object client category. For example, you can specify this category for messages that are associated with object clients.
SErver: Alert is classified as general server category. For example, you can specify this category for messages that are associated with general server activities or events.
STorage: Alert is classified as storage category. For example, you can specify this category for messages that are associated with storage pools.
SYstems: Alert is classified under system clients category. For example, you can specify this category for messages that are associated with system backup and archive or hierarchical storage management (HSM) backup-archive clients.
VMclient: Alert is classified under VMclient category. For example, you can specify this category for messages that are associated with virtual machine clients.

SOURCEType

Specifies the source type that is being queried. Specify one of the following values:

LOcal: Displays alerts that originated from the local IBM Spectrum Protect server.
CLient: Displays alerts that originated from the IBM Spectrum Protect client.
REmote: Displays alerts that originated from another IBM Spectrum Protect server.

SOURCEName

Specifies the name of the source where the alert originated. SOURCENAME can be the name of a local or remote IBM Spectrum Protect server, or an IBM Spectrum Protect client.

ID

This optional parameter specifies the unique ID of the alert that you want to display. Specify a value from 1 to 9223372036854775807.

ASSigned

Specifies the administrator name that is assigned the alert that you want to query.

RESolvedby

Specifies the administrator name that resolved the alert that you want to query.

Query active alerts

Display only alerts that are active in the server database by issuing the following command:

query alertstatus status=active

Query active alerts for two messages issued by the local server

Issue the following command to display only active alerts for message numbers ANE4958I and ANR4952E that were issued by the local server:

query alertstatus msgnum=4958,4952 status=active sourcetype=local

Query active alerts for messages ANR4958I and ANR4952E issued by a client

Issue the following command to display only active alerts for message numbers ANE4958I and ANE4952I that were issued by a client:

query alertstatus msgnum=4958,4952 status=active sourcetype=client

Query all alerts on a server

Issue the following command to display all alerts that are on the server:

query alertstatus

Example output: Display all the alerts that are on the server:


      Alert Identifier: 83
  Alert Message Number: 293
           Source Name: SEDONA
           Source Type: LOCAL
      First Occurrence: 03/07/2013 17:08:35
Most Recent Occurrence: 03/07/2013 17:08:35
                 Count: 1
                Status: ACTIVE
    Last Status Change: 12/31/1969 17:00:00
              Category: INVENTORY
               Message: ANR0293I Reorganization for table AF_BITFILES 
                        started.
              Assigned:
           Resolved By:
                Remark:

      Alert Identifier: 85
  Alert Message Number: 293
           Source Name: SEDONA
           Source Type: LOCAL
      First Occurrence: 03/08/2013 05:45:00
Most Recent Occurrence: 03/08/2013 05:45:00
                 Count: 1
                Status: ACTIVE
    Last Status Change: 12/31/1969 17:00:00
              Category: INVENTORY
               Message: ANR0293I Reorganization for table 
                        BF_AGGREGATED_BITFILES started.
              Assigned:
           Resolved By:
                Remark:

      Alert Identifier: 1282
  Alert Message Number: 293
           Source Name: ALPINE
           Source Type: LOCAL
      First Occurrence: 02/13/2013 15:47:50
Most Recent Occurrence: 02/13/2013 15:47:50
                 Count: 1
                Status: CLOSED
    Last Status Change: 02/26/2013 09:46:39
              Category: INVENTORY
               Message: ANR0293I Reorganization for table
                        TSMMON_ALERT started.
              Assigned:
           Resolved By:
                Remark:


      Alert Identifier: 1792
  Alert Message Number: 293
           Source Name: ALPINE
           Source Type: LOCAL
      First Occurrence: 02/19/2013 08:58:14
Most Recent Occurrence: 02/19/2013 08:58:14
                 Count: 1
                Status: CLOSED
    Last Status Change: 03/01/2013 12:39:21
              Category: INVENTORY
               Message: ANR0293I Reorganization for table
                        ACTIVITY_LOG started.
              Assigned:
           Resolved By:
                Remark:

Field descriptions

Alert Identifier: The unique identifier for the alert.
Alert Message Number: The message number for the alert.
Source Name: The name of the source from where the alert originated.
Source Type: The type of the originating source.
First Occurrence: The date and time when the alert first occurred.
Most Recent Occurrence: The date and time when the alert occurred last.
Count: The total number of times the alert has been triggered.
Status: Specifies the status of the alert.
Last Status Change: Specifies the time and date when the status for the alert last changed.
Category: The category for the alert.
Message: The message that triggers the alert.
Assigned: Specifies the user whom this alert concerns.
Resolved By: Species the user who has investigated and resolved the alert.
Remark: An optional remark to be left by the resolver.

Related commands

Table 1. Commands related to QUERY ALERTSTATUS
Command	Description
DEFINE ALERTTRIGGER (Define an alert trigger)	Associates specified messages to an alert trigger.
DELETE ALERTTRIGGER (Remove a message from an alert trigger)	Removes a message number that can trigger an alert.
QUERY ALERTTRIGGER (Query the list of defined alert triggers)	Displays message numbers that trigger an alert.
QUERY MONITORSETTINGS (Query the configuration settings for monitoring alerts and server status)	Displays information about monitoring alerts and server status settings.
UPDATE ALERTTRIGGER (Update a defined alert trigger)	Updates the attributes of one or more alert triggers.
UPDATE ALERTSTATUS (Update the status of an alert)	Updates the status of a reported alert.