DB2 Version 9.7 for Linux, UNIX, and Windows

MON_CONNECTION_SUMMARY - Retrieve metrics for all connections

The MON_CONNECTION_SUMMARY administrative view returns key metrics for all connections in the currently connected database. It is designed to help monitor the system in a high-level manner, showing incoming work per connection.

Note: If your database was created in Version 9.7 before Fix Pack 1, to run this routine you must have already run the db2updv97 command. If your database was created before Version 9.7 , it is not necessary to run the db2updv97 command (because the catalog update is automatically taken care of by the database migration). If you downgrade to Version 9.7, this routine will no longer work.

The metrics returned represent the accumulation of all metrics for requests that were submitted by the identified connection across all members of the database.

The schema is SYSIBMADM.

Authorization

One of the following authorizations is required:
  • SELECT privilege on the MON_CONNECTION_SUMMARY administrative view
  • CONTROL privilege on the MON_CONNECTION_SUMMARY administrative view
  • DATAACCESS authority

Information returned

Table 1. Information returned by the MON_CONNECTION_SUMMARY administrative view
Column name Data type Description or Monitor element
APPLICATION_HANDLE BIGINT application_handle - Application handle
APPLICATION_NAME VARCHAR(128) appl_name - Application name
APPLICATION_ID VARCHAR(128) appl_id - Application ID
SESSION_AUTH_ID VARCHAR(128) session_auth_id - Session authorization ID
TOTAL_APP_COMMITS BIGINT total_app_commits - Total application commits monitor elements
TOTAL_APP_ROLLBACKS BIGINT total_app_rollbacks - Total application rollbacks monitor element
ACT_COMPLETED_TOTAL BIGINT act_completed_total - Total completed activities monitor element

APP_RQSTS_COMPLETED
  _TOTAL

BIGINT Total number of external (application) requests that completed successfully across all members of the database for the specified service subclass
AVG_RQST_CPU_TIME BIGINT Average amount of CPU time, in microseconds, used by all external requests that completed successfully. It represents the total of both user and system CPU time. Formula to calculate ratio: TOTAL_CPU_TIME / APP_RQSTS_COMPLETED_TOTAL

ROUTINE_TIME_
  RQST_PERCENT

DECIMAL(5,2) The percentage of time the database server spent working on requests that was spent executing user routines. Formula to calculate ratio: TOTAL_ROUTINE_TIME / TOTAL_RQST_TIME

RQST_WAIT_
  TIME_PERCENT

DECIMAL(5,2) The percentage of the time spent working on requests that was spent waiting within the DB2® database server. Formula to calculate ratio: TOTAL_WAIT_TIME / TOTAL_RQST_TIME

ACT_WAIT_TIME_
  PERCENT

DECIMAL(5,2) The percentage of the time spent executing activities that was spent waiting within the DB2 database server. Formula to calculate ratio: TOTAL_ACT_WAIT_TIME / TOTAL_ACT_TIME
IO_WAIT_TIME_PERCENT DECIMAL(5,2) The percentage of the time spent waiting within the DB2 database server that was due to I/O operations. This includes time spent performing direct reads or direct writes, and time spent reading data and index pages from the table space to the bufferpool or writing them back to disk. Formula to calculate ratio: (POOL_READ_TIME + POOL_WRITE_TIME + DIRECT_READ_TIME + DIRECT_WRITE_TIME) / TOTAL_WAIT_TIME

LOCK_WAIT_TIME_
   PERCENT

DECIMAL(5,2) The percentage of time spent waiting within the DB2 database server that was spent waiting on locks. Formula to calculate ratio: LOCK_WAIT_TIME / TOTAL_WAIT_TIME

AGENT_WAIT_TIME_
  PERCENT

DECIMAL(5,2) The percentage of time spent waiting within the DB2 database server that was spent by an application queued to wait for an agent under concentrator configurations. Formula to calculate ratio: AGENT_WAIT_TIME / TOTAL_WAIT_TIME

NETWORK_WAIT_
  TIME_PERCENT

DECIMAL(5,2) The percentage of time spent waiting within the DB2 database server that was spent on client-server communications. This includes time spent sending and receiving data over TCP/IP or using the IPC protocol. Formula to calculate ratio: (TCPIP_SEND_WAIT_TIME + TCPIP_RECV_WAIT_TIME + IPC_SEND_WAIT_TIME + IPC_RECV_WAIT_TIME) / TOTAL_WAIT_TIME

SECTION_PROC_
  TIME_PERCENT

DECIMAL(5,2) The percentage of time the database server spent actively working on requests that was spent executing sections. This includes the time spent performing sorts. Formula to calculate ratio: TOTAL_SECTION_PROC_TIME / (TOTAL_RQST_TIME - TOTAL_WAIT_TIME)

SECTION_SORT_
  PROC_TIME_PERCENT

DECIMAL(5,2) The percentage of time the database server spent actively working on requests that was spent performing sorts while executing sections. Formula to calculate ratio: TOTAL_SECTION_SORT_PROC_TIME / (TOTAL_RQST_TIME - TOTAL_WAIT_TIME)

COMPILE_PROC_
  TIME_PERCENT

DECIMAL(5,2) The percentage of time the database server spent actively working on requests that was spent compiling an SQL statement. This includes explicit and implicit compile times. Formula to calculate ratio: (TOTAL_COMPILE_PROC_TIME + TOTAL_IMPLICIT_COMPILE_PROC_TIME) / (TOTAL_RQST_TIME - TOTAL_WAIT_TIME)

TRANSACT_END_PROC
  _TIME_PERCENT

DECIMAL(5,2) The percentage of time the database server spent actively working on requests that was spent performing commit processing or rolling back transactions. Formula to calculate ratio: (TOTAL_COMMIT_PROC_TIME + TOTAL_ROLLBACK_PROC_TIME) / (TOTAL_RQST_TIME - TOTAL_WAIT_TIME)

UTILS_PROC_
  TIME_PERCENT

DECIMAL(5,2) The percentage of time the database server spent actively working on requests that was spent running utilities. This includes performing runstats, reorganization, and load operations. Formula to calculate ratio: (TOTAL_RUNSTATS_PROC_TIME + TOTAL_REORG_PROC_TIME + TOTAL_LOAD_PROC_TIME) / (TOTAL_RQST_TIME - TOTAL_WAIT_TIME)

AVG_LOCK_WAITS
  _PER_ACT

BIGINT The average number of times that applications or connections waited for locks per coordinator activities (successful and aborted). Formula to calculate ratio: LOCK_WAITS / (ACT_COMPLETED_TOTAL + ACT_ABORTED_TOTAL)

AVG_LOCK_TIMEOUTS
  _PER_ACT

BIGINT The average number of times that a request to lock an object timed out per coordinator activities (successful and aborted). Formula to calculate ratio: LOCK_TIMEOUTS / (ACT_COMPLETED_TOTAL + ACT_ABORTED_TOTAL)

AVG_DEADLOCKS_
  PER_ACT

BIGINT The average number of deadlocks per coordinator activities (successful and aborted). Formula to calculate ratio: DEADLOCKS / (ACT_COMPLETED_TOTAL + ACT_ABORTED_TOTAL)

AVG_LOCK_ESCALS
  _PER_ACT

BIGINT The average number of times that locks have been escalated from several row locks to a table lock per coordinator activities (successful and aborted). Formula to calculate ratio: LOCK_ESCALS / (ACT_COMPLETED_TOTAL + ACT_ABORTED_TOTAL)

ROWS_READ_PER_
  ROWS_RETURNED

BIGINT The average number of rows read from the table per rows returned to the application. Formula to calculate ratio: ROWS_READ / ROWS_RETURNED

TOTAL_BP_HIT_
  RATIO_PERCENT

DECIMAL(5,2) The percentage of time that the database manager did not need to load a page from disk to service a data or index page request, including requests for XML storage objects (XDAs). Formula to calculate ratio: 1 - ((POOL_DATA_P_READS + POOL_TEMP_DATA_P_READS + POOL_INDEX_P_READS + POOL_TEMP_INDEX_P_READS + POOL_XDA_P_READS + POOL_TEMP_XDA_P_READS) / (POOL_DATA_L_READS + POOL_TEMP_DATA_L_READS + POOL_INDEX_L_READS + POOL_TEMP_INDEX_L_READS + POOL_XDA_L_READS + POOL_TEMP_XDA_L_READS))