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
>>-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