UPDATE STATUSTHRESHOLD (Update a status monitoring threshold)

Use this command to update an existing 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.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-UPDate STAtusthreshold--threshold_name--+----------------------------+-->
                                           '-Activity--=--activity_name-'   

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

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

Parameters

threshold_name (Required)
Specifies the threshold name that you want to update. The name cannot exceed 48 characters in length.
activity (Required)
Specify this value to change the activity for an existing threshold. 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
Specify this value to change the condition of an existing threshold. This parameter is optional. 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
Specify this parameter to change the value that is compared with the activity output for the specified condition. You can specify an integer in the range 0 - 999999999999999.
STatus
Specify this value to change the status of the indicator that is created in status monitoring if the condition that is being evaluated passes. This parameter is optional. 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.

Update an existing status threshold

Update a status threshold for average storage pool utility percentage by issuing the following command:
update statusthreshold avgstgpl "AVGSTGPOOLUTIL" value=90 condition=gt status=error 

Related commands

Table 1. Commands related to UPDATE 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.