IBM Tivoli Storage Manager, Version 7.1

DEFINE STATUSTHRESHOLD (Define a status monitoring threshold)

Use this command to define a new status monitoring threshold.

Status monitoring thresholds compare the defined conditions to the status monitoring server queries and inserts the results in the status monitoring table.

Multiple thresholds can be defined for an activity. For example, you can create a threshold that provides a warning status if storage pool capacity utilization is greater than 80%. You can then create another threshold that provides error status if storage pool capacity utilization is greater than 90%.

Note: If a threshold is already defined for an EXISTS condition, you cannot define another threshold with one of the other condition types.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-DEFine STAtusthreshold--threshold_name--activity------------->

   .-Condition--=--EXists-----.                        
>--+--------------------------+--+-----------------+------------>
   '-Condition--=--+-EXists-+-'  '-Value--=--value-'   
                   +-GT-----+                          
                   +-GE-----+                          
                   +-LT-----+                          
                   +-LE-----+                          
                   '-EQual--'                          

   .-STatus--=--Normal------.   
>--+------------------------+----------------------------------><
   '-STatus--=--+-Normal--+-'   
                +-Warning-+     
                '-Error---'     

Parameters

threshold_name (Required)
Specifies the threshold name. The name cannot exceed 48 characters in length.
activity (Required)
Specifies the activity for which you want to create status indicators. Specify one of the following values:
PROCESSSUMMARY
Specifies the number of processes that are currently active.
SESSIONSUMMARY
Specifies the number of sessions that are currently active.
CLIENTSESSIONSUMMARY
Specifies the number of client sessions that are currently active.
SCHEDCLIENTSESSIONSUMMARY
Specifies the number of scheduled client sessions.
DBUTIL
Specifies the database utilization percentage. The default warning threshold value is 80%, and the default error threshold value is 90%.
DBFREESPACE
Specifies the free space available in the database in gigabytes.
DBUSEDSPACE
Specifies the amount of database space that is used, in gigabytes.
ARCHIVELOGFREESPACE
Specifies the free space that is available in the archive log, in gigabytes.
STGPOOLUTIL
Specifies the storage pool utilization percentage. The default warning threshold value is 80%, and the default error threshold value is 90%.
STGPOOLCAPACITY
Specifies the storage pool capacity in gigabytes.
AVGSTGPOOLUTIL
Specifies the average storage pool utilization percentage across all storage pools. The default warning threshold value is 80%, and the default error threshold value is 90%.
TOTSTGPOOLCAPACITY
Specifies the total storage pool capacity in gigabytes for all available storage pools.
TOTSTGPOOLS
Specifies the number of defined storage pools.
TOTRWSTGPOOLS
Specifies the number of defined storage pools that are readable or writeable.
TOTNOTRWSTGPOOLS
Specifies the number of defined storage pools that are not readable or writeable.
STGPOOLINUSEANDDEFINED
Specifies the total number of defined volumes that are in use.
ACTIVELOGUTIL
Specifies the current percent utilization of the active log. The default warning threshold value is 80%, and the default error threshold value is 90%.
ARCHLOGUTIL
Specifies the current utilization of the archive log. The default warning threshold value is 80%, and the default error threshold value is 90%.
CPYSTGPOOLUTIL
Specifies the percent utilization for a copy storage pool. The default warning threshold value is 80%, and the default error threshold value is 90%.
PMRYSTGPOOLUTIL
Specifies the percent utilization for a primary storage pool. The default warning threshold value is 80%, and the default error threshold value is 90%.
DEVCLASSPCTDRVOFFLINE
Specifies the percent utilization of drives that are offline, by device class. The default warning threshold value is 25%, and the default error threshold value is 50%.
DEVCLASSPCTDRVPOLLING
Specifies the drives polling, by device class. The default warning threshold value is 25%, and the default error threshold value is 50%.
DEVCLASSPCTLIBPATHSOFFLINE
Specifies the library paths that are offline, by device class. The default warning threshold value is 25%, and the default error threshold value is 50%.
DEVCLASSPCTPATHSOFFLINE
Specifies the percentage of device class paths that are offline, by device class. The default warning threshold value is 25%, and the default error threshold value is 50%.
DEVCLASSPCTDISKSNOTRW
Specifies the percentage of disks that are not writable for the disk device class. The default warning threshold value is 25%, and the default error threshold value is 50%.
DEVCLASSPCTDISKSUNAVAILABLE
Specifies the percentage of the disk volumes that are unavailable, by device class. The default warning threshold value is 25%, and the default error threshold value is 50%.
FILEDEVCLASSPCTSCRUNALLOCATABLE
Specifies the percentage of scratch volumes that the server cannot allocate for a given non-shared file device class. The default warning threshold value is 25%, and the default error threshold value is 50%.
Condition
Specifies the condition that is used to compare the activity output to the specified value. The default value is EXISTS. Specify one of the following values:
EXists
Creates a status monitoring indicator if the activity exists.
GT
Creates a status monitoring indicator if the activity outcome is greater than the specified value.
GE
Creates a status monitoring indicator if the activity outcome is greater than or equal to the specified value.
LT
Creates a status monitoring indicator if the activity outcome is less than the specified value.
LE
Creates a status monitoring indicator if the activity outcome is less than or equal to the specified value.
EQual
Creates a status monitoring indicator if the activity outcome is equal to the specified value.
Value (Required)
Specifies the value to compare to the activity output of the specified condition. VALUE must be specified unless CONDITION is set to EXISTS. You can specify an integer from 0 to 9223372036854775807.
STatus
Specifies that the status indicator created in status monitoring if the condition that is being evaluated passes. This optional parameter has a default value of NORMAL. Specify one of the following values:
Normal
Specifies that the status indicator has a normal status value.
Warning
Specifies that the status indicator has a warning status value.
Error
Specifies that the status indicator has an error status value.

Define status threshold

Define a status threshold for average storage pool utilization percentage by issuing the following command:
define statusthreshold avgstgpl "AVGSTGPOOLUTIL" value=85 
  condition=gt status=warning 

Related commands

Table 1. Commands related to DEFINE STATUSTHRESHOLD
Command Description
DELETE STATUSTHRESHOLD (Delete a status monitoring threshold) Deletes a status monitoring threshold.
QUERY MONITORSTATUS (Query the monitoring status) Displays information about monitoring alerts and server status settings.
QUERY MONITORSETTINGS (Query the configuration settings for monitoring alerts and server status) Displays information about monitoring alerts and server status settings.
QUERY STATUSTHRESHOLD (Query status monitoring thresholds) Displays information about a status monitoring thresholds.
SET STATUSMONITOR (Specifies whether to enable status monitoring) Specifies whether to enable status monitoring.
SET STATUSATRISKINTERVAL (Specifies whether to enable client at-risk activity interval evaluation) Specifies whether to enable client at-risk activity interval evaluation
SET STATUSREFRESHINTERVAL (Set refresh interval for status monitoring) Specifies the refresh interval for status monitoring.
SET STATUSSKIPASFAILURE (Specifies whether to use client at-risk skipped files as failure evaluation) Specifies whether to use client at-risk skipped files as failure evaluation
UPDATE STATUSTHRESHOLD (Update a status monitoring threshold) Changes the attributes of an existing status monitoring threshold.


Feedback