U

uid_sql_stmts - Update/Insert/Merge/Delete SQL Statements Executed monitor element

The number of UPDATE, INSERT, MERGE and DELETE statements that were executed.

Table 1. Table function monitoring information
Table function	Monitor element collection level
MON_GET_CONNECTION table function - Get connection metrics	REQUEST METRICS BASE
MON_GET_CONNECTION_DETAILS table function - Get detailed connection metrics (reported in DETAILS XML document)	REQUEST METRICS BASE
MON_GET_DATABASE table function - Get database level information	REQUEST METRICS BASE
MON_GET_DATABASE_DETAILS table function - Get database information metrics	REQUEST METRICS BASE
MON_GET_ROUTINE table function - get aggregated execution metrics for routines	REQUEST METRICS BASE
MON_GET_ROUTINE_DETAILS table function - get aggregated execution metric details for routines	REQUEST METRICS BASE
MON_GET_SERVICE_SUBCLASS table function - Get service subclass metrics	REQUEST METRICS BASE
MON_GET_SERVICE_SUBCLASS_DETAILS table function - Get detailed service subclass metrics	REQUEST METRICS BASE
MON_GET_UNIT_OF_WORK table function - Get unit of work metrics	REQUEST METRICS BASE
MON_GET_UNIT_OF_WORK_DETAILS table function - Get detailed unit of work metrics (reported in DETAILS XML document)	REQUEST METRICS BASE
MON_GET_WORKLOAD table function - Get workload metrics	REQUEST METRICS BASE
MON_GET_WORKLOAD_DETAILS table function - Get detailed workload metrics	REQUEST METRICS BASE

Table 2. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database	dbase	Basic
Application	appl	Basic

For snapshot monitoring, this counter can be reset.

Table 3. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Connection	event_conn	Always collected
Database	event_db	Always collected
Statistics	event_scmetrics	REQUEST METRICS BASE
Statistics	event_wlmmetrics	REQUEST METRICS BASE
Unit of work	uow_metrics	REQUEST METRICS BASE

Usage

You can use this element to determine the level of database activity at the application or database level.

You can also use the following formula to determine the ratio of UPDATE, INSERT, MERGE, and DELETE statements to the total number of statements:

 
   uid_sql_stmts
 / (static_sql_stmts + dynamic_sql_stmts )

This information can be useful for analyzing application activity and throughput.

unread_prefetch_pages - Unread prefetch pages monitor element

Indicates the number of pages that the prefetcher read into the bufferpool that were never used.

Table 4. Table Function Monitoring Information
Table Function	Monitor Element Collection Command and Level
MON_GET_BUFFERPOOL table function - Get buffer pool metrics	DATA OBJECT METRICS BASE
MON_GET_DATABASE table function - Get database level information	DATA OBJECT METRICS BASE
MON_GET_DATABASE_DETAILS table function - Get database information metrics	DATA OBJECT METRICS BASE
MON_GET_TABLESPACE table function - Get table space metrics	DATA OBJECT METRICS BASE

Table 5. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database	dbase	Buffer Pool
Table Space	tablespace	Buffer Pool
Buffer Pool	bufferpool	Buffer Pool
Application	appl	Buffer Pool

For snapshot monitoring, this counter can be reset.

Table 6. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Database	event_db	Always collected
Tablespaces	event_tablespace	Always collected
Connection	event_conn	Always collected

Usage

If this number is high, prefetchers are causing unnecessary I/O by reading pages into the buffer pool that will not be used.

uow_client_idle_wait_time - Client idle time within a unit of work monitor element

Indicates the time spent idle within a unit of work (UOW).

Table 7. Table function monitoring information
Table function	Monitor element collection level
MON_GET_CONNECTION table function - Get connection metrics	REQUEST METRICS BASE
MON_GET_CONNECTION_DETAILS table function - Get detailed connection metrics (reported in DETAILS XML document)	REQUEST METRICS BASE

uow_comp_status - Unit of Work Completion Status monitor element

The status of the unit of work and how it stopped.

Table 8. Table function monitoring information
Table function	Monitor element collection level
MON_GET_CONNECTION table function - Get connection metrics	Always collected
MON_GET_CONNECTION_DETAILS table function - Get detailed connection metrics	Always collected
MON_GET_UNIT_OF_WORK table function - Get unit of work metrics	Always collected
MON_GET_UNIT_OF_WORK_DETAILS table function - Get detailed unit of work metrics	Always collected

Table 9. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Application	appl	Unit of Work
DCS Application	dcs_appl	Basic

Table 10. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Transactions	event_xact	Always collected

Usage

You may use this element to determine if the unit of work ended due to a deadlock or abnormal termination. It may have been:

Committed due to a commit statement
Rolled back due to a rollback statement
Rolled back due to a deadlock
Rolled back due to an abnormal termination
Committed at normal application termination.
Unknown as a result of a FLUSH EVENT MONITOR command for which units of work were in progress.

Note: API users should refer to the header file (sqlmon.h) containing definitions of database system monitor constants.

uow_completed_total - Total completed units of work monitor element

The total number of units of work that completed, either by being committed or rolled back.

Table 11. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses MON_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses	ACTIVITY METRICS BASE
MON_GET_WORKLOAD_STATS table function - Return workload statistics	ACTIVITY METRICS BASE
MON_SAMPLE_SERVICE_CLASS_METRICS - Get sample service class metrics	REQUEST METRICS BASE
MON_SAMPLE_WORKLOAD_METRICS - Get sample workload metrics	REQUEST METRICS BASE
WLM_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses	REQUEST METRICS BASE
WLM_GET_WORKLOAD_STATS table function - Return workload statistics	REQUEST METRICS BASE

Table 12. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Statistics	event_scstats (reported in the metrics document)	Always collected
Statistics	event_wlstats (reported in the metrics document)	Always collected

Usage

When returned by the WLM_GET_SERVICE_SUBCLASS_STATS or the WLM_GET_WORKLOAD_STATS function, this monitor element represents the total completed units of work since the last reset of the statistics.

When returned by the MON_SAMPLE_SERVICE_CLASS_METRICS or the MON_SAMPLE_WORKLOAD_METRICS function, this monitor element represents the total completed units of work since the function was executed.

uow_elapsed_time - Most Recent Unit of Work Elapsed Time monitor element

The elapsed execution time of the most recently completed unit of work.

Element identifier: uow_elapsed_time
Element type: time

Table 13. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Application	appl	Unit of Work, Timestamp
DCS Application	dcs_appl	Unit of Work, Timestamp

Usage

Use this element as an indicator of the time it takes for units of work to complete.

This element is composed of two subelements that report time spent as seconds and microseconds (one millionth of a second). The names of the subelements can be derived by adding "_s" and "_ms" to the name of this monitor element. To retrieve the total time spent for this monitor element, the values of the two subelements must be added together. For example, if the "_s" subelement value is 3 and the "_ms" subelement value is 20, then the total time spent for the monitor element is 3.00002 seconds.

uow_id - Unit of work ID monitor element

The unit of work identifier. The unit of work ID is unique within an application handle.

Table 14. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_ACTIVITY table function - Return a list of activities	Always collected
MON_GET_ACTIVITY_DETAILS table function - Get complete activity details	Always collected
MON_GET_AGENT table function - List agents, fenced mode processes, and system entities for the database	Always collected
MON_GET_UNIT_OF_WORK table function - Get unit of work metrics	Always collected
MON_GET_UNIT_OF_WORK_DETAILS table function - Get detailed unit of work metrics	Always collected
WLM_GET_SERVICE_CLASS_AGENTS table function - list agents running in a service class	Always collected
WLM_GET_SERVICE_CLASS_WORKLOAD _OCCURRENCES table function - list workload occurrences	Always collected
WLM_GET_WORKLOAD_OCCURRENCE _ACTIVITIES table function - Return a list of activities	Always collected

Table 15. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Activities	event_activity	Always collected
Activities	event_activitystmt	Always collected
Activities	event_activityvals	Always collected
Activities	event_activitymetrics	Always collected
Change history	ddlstmtexec txncompletion	Always collected
Locking	lock_participant_activities lock_activity_values	Always collected
Threshold violations	event_thresholdviolations	Always collected
Unit of work	uow uow_metrics uow_package_list uow_executable_list	Always collected

Usage

Use this element in conjunction with other activity history elements for analysis of the behavior of an activity.

You can also use this element with the activity_id and appl_id monitor elements to uniquely identify an activity.

uow_lifetime_avg - Unit of work lifetime average monitor element

The average lifetime of a unit of work. Measured in milliseconds.

Table 16. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses MON_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses	ACTIVITY METRICS BASE
MON_GET_WORKLOAD_STATS table function - Return workload statistics	ACTIVITY METRICS BASE
MON_SAMPLE_SERVICE_CLASS_METRICS - Get sample service class metrics	REQUEST METRICS BASE
MON_SAMPLE_WORKLOAD_METRICS - Get sample workload metrics	REQUEST METRICS BASE
WLM_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses	REQUEST METRICS BASE
WLM_GET_WORKLOAD_STATS table function - Return workload statistics	REQUEST METRICS BASE

Table 17. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Statistics	event_scstats (reported in the metrics document)	Always collected
Statistics	event_wlstats (reported in the metrics document)	Always collected

Usage

When returned by the WLM_GET_SERVICE_SUBCLASS_STATS or the WLM_GET_WORKLOAD_STATS function, this monitor element represents the average unit of work lifetime since the last reset of the statistics.

When returned by the MON_SAMPLE_SERVICE_CLASS_METRICS or the MON_SAMPLE_WORKLOAD_METRICS function, this monitor element represents the average unit of work lifetime since the function was executed.

uow_lock_wait_time - Total time unit of work waited on locks monitor element

The total amount of elapsed time this unit of work has spent waiting for locks. The value is given in milliseconds.

Element identifier: uow_lock_wait_time
Element type: counter

Table 18. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Application	appl	Unit of Work

Usage: This element can help you determine the severity of the resource contention problem.

uow_log_space_used - Unit of work log space used monitor element

The amount of log space (in bytes) used in the current unit of work of the monitored application.

Table 19. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_UNIT_OF_WORK table function - Get unit of work metrics	Always collected
MON_GET_UNIT_OF_WORK_DETAILS table function - Get detailed unit of work metrics (reported in DETAILS XML document)	Always collected

Table 20. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Application	appl	Unit of Work

Table 21. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Transactions	event_xact	Always collected
Unit of work	-	Always collected

Usage

You may use this element to understand the logging requirements at the unit of work level.

uow_start_time - Unit of work start timestamp monitor element

The date and time that the unit of work first required database resources.

Table 22. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_CONNECTION table function - Get connection metrics	Always collected
MON_GET_CONNECTION_DETAILS table function - Get detailed connection metrics	Always collected
MON_GET_UNIT_OF_WORK table function - Get unit of work metrics	Always collected
MON_GET_UNIT_OF_WORK_DETAILS table function - Get detailed unit of work metrics (reported in DETAILS XML document)	Always collected

Table 23. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Application	appl	Unit of Work, Timestamp
DCS Application	dcs_appl	Unit of Work, Timestamp

Table 24. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Unit of work	uow	Always collected
Transaction	event_xact	-

Usage

This resource requirement occurs at the first SQL statement execution of that unit of work:

For the first unit of work, it is the time of the first database request (SQL statement execution) after conn_complete_time.
For subsequent units of work, it is the time of the first database request (SQL statement execution) after the previous COMMIT or ROLLBACK.

Note: The SQL Reference defines the boundaries of a unit of work as the COMMIT or ROLLBACK points.

The database system monitor excludes the time spent between the COMMIT/ROLLBACK and the next SQL statement from its definition of a unit of work. This measurement method reflects the time spent by the database manager in processing database requests, separate from time spent in application logic before the first SQL statement of that unit of work. The unit of work elapsed time does include the time spent running application logic between SQL statements within the unit of work.

You may use this element with the uow_stop_time monitor element to calculate the total elapsed time of the unit of work and with the prev_uow_stop_time monitor element to calculate the time spent in the application between units of work.

You can use the uow_stop_time and the prev_uow_stop_time monitor elements to calculate the elapsed time for the SQL Reference definition of a unit of work.

uow_status - Unit of Work Status monitor element

The status of the unit of work.

Element identifier: uow_status
Element type: information

Table 25. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Transactions	event_xact	Always collected

Usage: You may use this element to determine the status of a unit of work. API users should refer to the sqlmon.h header file containing definitions of database system monitor constants.

uow_stop_time - Unit of work stop timestamp monitor element

The date and time that the most recent unit of work completed, which occurs when database changes are committed or rolled back.

Table 26. Table function monitoring information
Table function	Monitor element collection level
MON_GET_CONNECTION table function - Get connection metrics	Always collected
MON_GET_CONNECTION_DETAILS table function - Get detailed connection metrics	Always collected
MON_GET_UNIT_OF_WORK table function - Get unit of work metrics	Always collected
MON_GET_UNIT_OF_WORK_DETAILS table function - Get detailed unit of work metrics	Always collected

Table 27. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Application	appl	Unit of Work, Timestamp
DCS Application	dcs_appl	Unit of Work, Timestamp

Table 28. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Unit of work	uow	Always collected

Usage

Use this element with the prev_uow_stop_time monitor element to calculate the total elapsed time between COMMIT/ROLLBACK points, and with the uow_start_time monitor element to calculate the elapsed time of the latest unit of work.

The timestamp contents will be set as follows:

When the application has completed a unit of work and has not yet started a new one (as defined in the uow_start_time monitor element), this element reports a valid, non-zero timestamp.
When the application is currently executing a unit of work, this element reports zeros.
When the application first connects to the database, this element is set to the value of the conn_complete_time monitor element

As a new unit of work is started, the contents of this element are moved to the prev_uow_stop_time monitor element.

uow_throughput - Unit of work throughput monitor element

The completion rate of units of work measured in units of work per second.

Table 29. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_SAMPLE_SERVICE_CLASS_METRICS - Get sample service class metrics	REQUEST METRICS BASE
MON_SAMPLE_WORKLOAD_METRICS - Get sample workload metrics	REQUEST METRICS BASE
MON_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses MON_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses	ACTIVITY METRICS BASE
MON_GET_WORKLOAD_STATS table function - Return workload statistics	ACTIVITY METRICS BASE
WLM_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses	REQUEST METRICS BASE
WLM_GET_WORKLOAD_STATS table function - Return workload statistics	REQUEST METRICS BASE

Table 30. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Statistics	event_scstats (reported in the metrics document)	Always collected
Statistics	event_wlstats (reported in the metrics document)	Always collected

Usage

When returned by the WLM_GET_SERVICE_SUBCLASS_STATS or the WLM_GET_WORKLOAD_STATS function, this monitor element represents the unit of work throughput since the last reset of the statistics.

When returned by the MON_SAMPLE_SERVICE_CLASS_METRICS or the MON_SAMPLE_WORKLOAD_METRICS function, this monitor element represents the unit of work throughput since the function was executed.

uow_total_time_top - UOW total time top monitor element

High watermark for unit of work lifetime, in milliseconds.

Table 31. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses MON_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses	Always collected
MON_GET_WORKLOAD_STATS table function - Return workload statistics	Always collected
WLM_GET_SERVICE_SUBCLASS_STATS table function - Return statistics of service subclasses	Always collected
WLM_GET_WORKLOAD_STATS table function - Return workload statistics	Always collected

Table 32. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Statistics	event_wlstats	Always collected
Statistics	event_scstats	Always collected

Usage

This element can be used to help determine whether or not the UOWTOTALTIME threshold is effective and can also help to determine how to configure such a threshold.

For service classes, this monitor element returns -1 when COLLECT AGGREGATE ACTIVITY DATA for the service class is set to NONE.

For workloads, this monitor element returns -1 if COLLECT AGGREGATE ACTIVITY DATA for the workload is set to NONE.

For a service class, measurements taken for this high watermark are computed for the service class assigned by the workload. Any mapping by a work action set to change the service class of an activity does not affect this high watermark.

update_sql_stmts - Updates monitor element

This element contains a count of the total number of times the federated server has issued an UPDATE statement to this data source on behalf of any application from the start of the federated server instance, or the last reset of the database monitor counters.

Table 33. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database	dbase_remote	Basic
Application	appl_remote	Basic

For snapshot monitoring, this counter can be reset.

Usage

Use this element to determine the level of database activity directed against this data source by the federated server or an application.

You can also use this element to determine the percentage of write activity against this data source by the federated server or an application, with the following formula:

   write_activity =
     (INSERT statements + UPDATE statements + DELETE statements ) /
     (SELECT statements + INSERT statements + UPDATE statements +
     DELETE statements)

update_time - Update Response Time monitor element

This element contains the aggregate amount of time, in milliseconds, that it has taken this data source to respond to UPDATEs from all applications or a single application running on this federated server instance from the start of the federated server instance, or the last reset of the database monitor counters.

Table 34. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database	dbase_remote	Timestamp
Application	appl_remote	Timestamp

For snapshot monitoring, this counter can be reset.

The response time is measured as the difference in time between the time the federated server submits an UPDATE statement to the data source, and the time the data source responds to the federated server, indicating the UPDATE has been processed.

Usage: Use this element to determine how much actual time transpires while waiting for UPDATEs to this data source to be processed. This information can be useful for capacity planning and tuning.

usage_list_last_state_change - Last state change monitor element

A timestamp that indicates when the value of the usage_list_state monitor element last changed.

Table 35. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_USAGE_LIST_STATUS table function - Returns the status on a usage list	Always collected

usage_list_mem_size - Usage list memory size monitor element

The total amount of memory that is allocated for a particular usage list, in kilobytes.

Table 36. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_USAGE_LIST_STATUS table function - Returns the status on a usage list	Always collected

usage_list_name - Usage list name monitor element

A usage list name.

Table 37. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_INDEX_USAGE_LIST table function - Returns information from an index usage list	Always collected
MON_GET_TABLE_USAGE_LIST table function - Returns information from a table usage list	Always collected
MON_GET_USAGE_LIST_STATUS table function - Returns the status on a usage list	Always collected

usage_list_schema - Usage list schema monitor element

The name of the schema of a usage list.

Table 38. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_INDEX_USAGE_LIST table function - Returns information from an index usage list	Always collected
MON_GET_TABLE_USAGE_LIST table function - Returns information from a table usage list	Always collected
MON_GET_USAGE_LIST_STATUS table function - Returns the status on a usage list	Always collected

usage_list_size - Usage list size monitor element

The maximum number of entries that a particular usage list can hold.

Table 39. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_USAGE_LIST_STATUS table function - Returns the status on a usage list	Always collected

usage_list_state - Usage list state monitor element

The state of a particular usage list.

Table 40. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_USAGE_LIST_STATUS table function - Returns the status on a usage list	Always collected

Usage

Possible values are as follows:

A: Active.
F: Failed to activate.
I: Inactive.
P: Activation pending.

usage_list_used_entries - Usage list used entries monitor element

The number of entries currently in a usage list. If the usage list in an Inactive state, this monitor element represents the number of entries that were in this usage list when it was last active for monitoring.

Table 41. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_USAGE_LIST_STATUS table function - Returns the status on a usage list	Always collected

usage_list_wrapped - Usage list wrap indicator monitor element

An indicator of whether a particular usage list has wrapped. When a usage list becomes full, the default behavior is for entries to wrap, which means the oldest entries get replaced the by newest entries.

Possible values are Y and N.

Table 42. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_USAGE_LIST_STATUS table function - Returns the status on a usage list	Always collected

user_cpu_time - User CPU time monitor element

The total user CPU time (in seconds and microseconds) used by the database manager agent process, the unit of work, or the statement. For event monitors that write to tables, the value of this element is given in microseconds by using the BIGINT data type.

When either the statement monitor switch or the timestamp switch is not turned on, this element is not collected and -1 is written instead.

Table 43. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Connection	event_conn	Always collected
Transactions	event_xact	Always collected
Statements	event_stmt	Always collected
Activities	event_activity	Always collected

Usage

This element along with the other related CPU-time elements can help you understand the level of activity within an application, and can help you identify applications that could benefit from additional tuning.

Note: If this information is not available for your operating system, this element will be set to 0.

Note: Due to the differences in granularity with which the DB2® system collects statistics, the value of the total_exec_time monitor element might not equal the sum of values of system_cpu_time and user_cpu_time monitor elements. In this case, the sum of system_cpu_time and user_cpu_time monitor elements more accurately reflects the actual total execution time.

utility_dbname - Database Operated on by Utility monitor element

The database operated on by the utility.

Table 44. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database Manager	utility_info	Basic

utility_description - Utility Description monitor element

A brief description of the work a utility is performing. For example, a rebalance invocation may contain "Tablespace ID: 2" representing that this rebalancer is working on table space with ID 2. The format of this field is dependent on the class of utility and is subject to change between releases.

Table 45. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database Manager	utility_info	Basic

utility_detail - Utility detail monitor element

This element contains a brief description of the work a utility is performing.

Table 46. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_UTILITY table function - Get utilities running on the database	Always collected

Table 47. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Change History	UTILSTART	Always collected

Usage

A brief description of the work a utility is performing, including some options specified for the utility. For example, a record for the invocation of REORG includes a partially reconstructed command string including some of the different options used by the utility such as access mode . The format of this field is dependent on the type of utility and might change between releases.

utility_id - Utility ID monitor element

The unique identifier corresponding to the utility invocation.

Table 48. Table Function Monitoring Information
Table Function	Monitor Element Collection Command and Level
MON_GET_ACTIVITY table function - Return a list of activities	Always collected
MON_GET_ACTIVITY_DETAILS table function - Get complete activity details (reported in DETAILS XML document)	Always collected
MON_GET_UTILITY table function - Get utilities running on the database	Always collected
WLM_GET_WORKLOAD_OCCURRENCE _ACTIVITIES table function - Return a list of activities	Always collected

Table 49. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database Manager	utility_info	Basic

utility_invocation_id - Utility invocation ID monitor element

A unique identifier corresponding to the utility invocation.

Table 50. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_ACTIVITY table function - Return a list of activities	Always collected
MON_GET_ACTIVITY_DETAILS table function - Get complete activity details	Always collected
MON_GET_AGENT table function - List agents running in a service class	Always collected
MON_GET_UTILITY table function - Get utilities running on the database	Always collected
WLM_GET_SERVICE_CLASS_AGENTS table function - list agents running in a service class	Always collected
WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES table function - Return a list of activities	Always collected

Table 51. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Element Collection Level
Activities	event_activity	Always collected
Change History	changesummary utillocation utilphase utilstart utilstop	Always collected

Usage

The utility_invocation_id is a binary token that uniquely identifies a given invocation of a utility. The utility_invocation_id is the same on each member where the utility is executing. The utility_invocation_id will retain its uniqueness across database deactivation, reactivation, and member shutdown, allowing quick identification of all event monitor records corresponding to a given invocation of a utility.

utility_invoker_type - Utility Invoker Type monitor element

This element describes how a utility was invoked.

Table 52. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_UTILITY table function - Get utilities running on the database	Always collected

Table 53. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database Manager	utility_info	Basic

Table 54. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Change history	utilstart	Always collected

Usage

Use this element to determine how a utility was invoked. For example, you can use it to determine whether a utility was invoked automatically by DB2 or by a user. The values for this element, listed as follows, are defined in sqlmon.h.

API Constant	Utility
SQLM_UTILITY_INVOKER_USER	Utility was invoked by user
SQLM_UTILITY_INVOKER_AUTO	Utility was invoked automatically by DB2

For the MON_GET_UTILITY table function and the change event history monitor, this element indicates how a utility was invoked:

USER: Utility was invoked by a user
AUTO: Utility was invoked automatically by DB2

utility_operation_type - Utility operation type monitor element

Indicates the type of utility operation.

Table 55. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_UTILITY table function - Get utilities running on the database	Always collected

Table 56. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Change History	UTILSTART	Always collected

Usage

For the change history event monitor, this element contains details about utility events (UTILITY_TYPE) that were started .

If UTILITY_TYPE is BACKUP, one of:

D: Delta
I: Incremental
F: Full

If UTILITY_TYPE is LOAD, one of:

I: Insert
R: Replace
S: Restart
T: Terminate

If UTILITY_TYPE is MOVETABLE, one of:

A: Cancel
C: Copy
I: Init
L: Cleanup
M: Move
R: Replay
S: Swap
V: Verify

If UTILITY_TYPE is REDISTRIBUTE, one of:

A: Abort
C: Continue
D: Default
T: Target Map

If UTILITY_TYPE is REORG, one of:

A: Reorganize all table indexes
I: Index reorganization
N: Inplace table reorganization
R: Reorganize table reclaim extents
T: Classic table reorganization

If UTILITY_TYPE is RESTORE, one of:

A: Incremental automatic
B: Incremental abort
F: Full
M: Incremental manual

If UTILITY_TYPE is ROLLFORWARD, one of:

E: End of logs
P: Point in time

If UTILITY_TYPE is RUNSTATS, one of:

A: All indexes on a table
I: Index
T: Table

utility_phase_detail - Utility phase detail monitor element

This element reserved for future use.

Table 57. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Change History	UTILPHASE	Always collected

utility_phase_type - Utility phase type monitor element

Identifies the utility phase type.

Table 58. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Change History	UTILPHASE	Always collected

Usage

For the change history event monitor, if the utility_type element is BACKUP, the phase type is:

BACKUPTS: Backup table space

utility_priority - Utility Priority monitor element

Utility priority specifies the amount of relative importance of a throttled utility with respect to its throttled peers. A priority of 0 implies that a utility is executing unthrottled. Non-zero priorities must fall in the range of 1-100, with 100 representing the highest priority and 1 representing the lowest.

Table 59. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_UTILITY table function - Get utilities running on the database	Always collected

Table 60. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database Manager	utility_info	Basic

Table 61. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Change history	utilstart	Always collected

utility_start_time - Utility Start Time monitor element

The date and time when the current utility was originally invoked.

Table 62. Table Function Monitoring Information
Table Function	Monitor Element Collection Level
MON_GET_UTILITY table function - Get utilities running on the database	Always collected

Table 63. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database Manager	utility_info	Basic

utility_start_type - Utility start type monitor element

This element indicates how a utility was started.

Table 64. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Change History	UTILSTART	Always collected

Usage

For the change history event monitor, utility start information is one of:

RESUME
START

utility_state - Utility State monitor element

This element describes the state of a utility.

Element identifier: utility_state
Element type: information

Table 65. Snapshot Monitoring Information
Snapshot Level	Logical Data Grouping	Monitor Switch
Database Manager	utility_info	Basic

Usage

Use this element to determine the state of an active utility. The values for this field, listed as follows, are defined in sqlmon.h.

API Constant	Description
SQLM_UTILITY_STATE_EXECUTE	Utility is executing
SQLM_UTILITY_STATE_WAIT	Utility is waiting for an event to occur before resuming progress
SQLM_UTILITY_STATE_ERROR	Utility has encountered an error
SQLM_UTILITY_STATE_SUSPENDED	Utility has been suspended

utility_stop_type - Utility stop type monitor element

This element indicates how a utility was stopped.

Table 66. Event Monitoring Information
Event Type	Logical Data Grouping	Monitor Switch
Change History	UTILSTOP	Always collected

Usage

For the change history event monitor, a utility was stopped in one of the following ways:

PAUSE
STOP