Db2 Database Status Test

If a user complaints of problems while accessing a database, the knowledge of the current state of that database will enable administrators to promptly diagnose the reason for such an occurrence. The Db2 Database Status test helps administrators to track the status of the database easily.

This test auto-discovers all the databases on a Db2 UDB server and reports the current state of each database, thereby enabling administrators to easily troubleshoot issues related to database access.

Target of the test : A DB2 database server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every database on the DB2 database server.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.


Specify the IP address of the DB2 server in this text box.


Specify the port at which the target host is listening. The default port is 50000.

Username, Password and Confirm Password

To monitor Db2 UDB database server, the eG agent should be configured with the credentials of a user with any of the following privileges SYSADM or SYSCTRL or SYSMAINT or SYSMON. Specify the credentials of such a user in the User and Password text boxes. Confirm the Password by retyping it in the Confirm Password text box.


The test uses a database on the monitored Db2 UDB server. Specify the name of the database in the Database text box.

Include DB

Specify the list of databases that you wish to monitor in a comma-seperated list in the Include DB text box. By default this is set to ALL.

Exclude DB

Specify the list of databases that you wish to exclude from monitoring in a comma-seperated list in the Exclude DB text box. By default this is set to NONE.


If the IBM Db2 UDB being monitored is SSL-enabled, then set the SSL flag to Yes. If not, then set the SSL flag to No.

DD Row Count

By default, the detailed diagnosis of this test, if enabled, will report only the top-10 records. This is why, the DD Row Count parameter is set to 10 by default. If you want to include more or less records in detailed diagnosis, then change the value of this parameter accordingly.

Measures made by the test:
Measurement Description Measurement Unit Interpretation


Indicates the current status of this database.


These measure values and their corresponding numeric values are listed in the table below:

Measure value

Numeric value


By default, this measure reports the Measure values to indicate current status of each database. However, the graph of this measure is represented using the numeric equivalents only.