DB2 Version 10.1 for Linux, UNIX, and Windows

HEALTH_DBM_HI table function

The HEALTH_DBM_HI table function returns health indicator information from a health snapshot of the DB2® database manager.

Important: This table function has been deprecated and might be removed in a future release because the health monitor has been deprecated in Version 9.7. It is not supported in DB2 pureScale® environments. For more information, see Health monitor has been deprecated..

Syntax


>>-HEALTH_DBM_HI--(--member--)---------------------------------><

The schema is SYSPROC.

Table function parameter

member: An input argument of type INTEGER that specifies a valid database member number. Specify -1 for the current database member, or -2 for an aggregate of all active database members. An active database member is a member where the database is available for connection and use by applications.
If the null value is specified, -1 is set implicitly.

Authorization

One of the following authorities is required to execute the routine:

EXECUTE privilege on the routine
DATAACCESS authority
DBADM authority
SQLADM authority

Default PUBLIC privilege

In a non-restrictive database, EXECUTE privilege is granted to PUBLIC when the function is automatically created.

Example

SELECT * FROM TABLE(HEALTH_DBM_HI(-1)) AS T

The following is an example of output from this query.

SNAPSHOT_TIMESTAMP         HI_ID     SERVER_INSTANCE_NAME     ... 
-------------------------- -----...- --------------------...- ... 
2006-02-13-12.30.19.773632         1 DB2                      ... 
2006-02-13-12.30.19.773632         4 DB2                      ... 
                                                                  
  2 record(s) selected.

Output from this query (continued).

... HI_VALUE HI_TIMESTAMP               HI_ALERT_STATE HI_ALERT_STATE_DETAIL ...
... -------- -------------------------- -------------- --------------------- ...
...        0 2006-02-13-12.26.26.158000              1 Normal                ...
...      100 2006-02-13-12.26.26.158000              4 Alarm                 ...

Output from this query (continued).

... HI_FORMULA                 HI_ADDITIONAL_INFO 
... ---------------------...-  ------------------ 
... 0                                           - 
... ((327680 / 327680) * 100)                   -

Table 1. Information returned by the HEALTH_DBM_HI table function
Column name	Data type	Description or corresponding monitor element
SNAPSHOT_TIMESTAMP	TIMESTAMP	snapshot_timestamp - Snapshot timestamp
HI_ID	BIGINT	A number that uniquely identifies the health indicator in the snapshot data stream.
SERVER_INSTANCE_NAME	VARCHAR(128)	server_instance_name - Server instance name
HI_VALUE	SMALLINT	The value of the health indicator.
HI_TIMESTAMP	TIMESTAMP	The date and time that the alert was generated.
HI_ALERT_STATE	BIGINT	The severity of the alert.
HI_ALERT_STATE_DETAIL	VARCHAR(20)	The text description of the HI_ALERT_STATE column.
HI_FORMULA	VARCHAR(2048)	The formula used to calculate the health indicator.
HI_ADDITIONAL_INFO	VARCHAR(4096)	Additional information about the health indicator.