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