QUERY ALERTSTATUS (Query the status of an alert)

Use this command to display information about alerts that are reported on the Tivoli® Storage Manager server.

Privilege class

Any administrator can issue this command.

Syntax


                      .-STAtus--=--ANy--------------.   
>>-Query ALERTSTatus--+-----------------------------+----------->
                      |            .-,------------. |   
                      |            V              | |   
                      '-STAtus--=----+-ACtive---+-+-'   
                                     +-INactive-+       
                                     +-CLosed---+       
                                     '-ANy------'       

>--+----------------------------+--+------------------------------+-->
   |            .-,-----------. |  '-CATegory--=--+-APplication-+-'   
   |            V             | |                 +-INventory---+     
   '-MSGnum--=----message_num-+-'                 +-CLient------+     
                                                  +-DEvice------+     
                                                  +-SErver------+     
                                                  +-STorage-----+     
                                                  +-SYstem------+     
                                                  '-VMclient----'     

>--+-----------------------------------------------------------+-->
   '-SOURCEType--=--+-LOcal--+--+----------------------------+-'   
                    +-CLient-+  '-SOURCEName--=--source_name-'     
                    '-REmote-'                                     

>--+---------------------+--+-------------------+--------------->
   |        .-,--------. |  '-ASSigned--=--text-'   
   |        V          | |                          
   '-ID--=----alert_id-+-'                          

>--+---------------------+-------------------------------------><
   '-RESolvedby--=--text-'

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 Tivoli Storage Manager 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 a Tivoli Storage Manager 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 Tivoli Storage Manager 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.
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 Tivoli Storage Manager server.
CLient: Displays alerts that originated from the Tivoli Storage Manager client.
REmote: Displays alerts that originated from another Tivoli Storage Manager server.

SOURCEName

Specifies the name of the source where the alert originated. SOURCENAME can be the name of a local or remote Tivoli Storage Manager server, or a Tivoli Storage Manager 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:

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.