U

uid_sql_stmts - 已执行的 Update/Insert/Merge/Delete SQL 语句数监视元素

已执行的 UPDATE、INSERT、MERGE 和 DELETE 语句数。

表 1. 表函数监视信息
表函数 监视元素收集级别
MON_GET_CONNECTION 表函数 - 获取连接度量值 REQUEST METRICS BASE
MON_GET_CONNECTION_DETAILS 表函数 - 获取详细的连接度量值 （在 DETAILS XML 文档中报告） REQUEST METRICS BASE
MON_GET_DATABASE 表函数 - 获取数据库级别信息 REQUEST METRICS BASE
MON_GET_DATABASE_DETAILS 表函数 - 获取数据库信息度量值 REQUEST METRICS BASE
MON_GET_ROUTINE 表函数 - 获取例程的聚集执行度量值 REQUEST METRICS BASE
MON_GET_ROUTINE_DETAILS 表函数 - 获取例程的聚集执行度量值详细信息 REQUEST METRICS BASE
MON_GET_SERVICE_SUBCLASS 表函数 - 获取服务子类指标 REQUEST METRICS BASE
MON_GET_SERVICE_SUBCLASS_DETAILS 表函数 - 获取详细的服务子类指标 REQUEST METRICS BASE
MON_GET_UNIT_OF_WORK 表函数 - 获取工作单元指标 REQUEST METRICS BASE
MON_GET_UNIT_OF_WORK 表函数 - 获取详细的工作单元指标（在 XML 文档 DETAILS 中报告） REQUEST METRICS BASE
MON_GET_WORKLOAD 表函数 - 获取工作负载指标 REQUEST METRICS BASE
MON_GET_WORKLOAD_DETAILS 表函数 - 获取详细的工作负载度量值 REQUEST METRICS BASE
表 2. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库 dbase 基本
应用程序 appl 基本
可将快照监视的计数器重置。
表 3. 事件监视信息
事件类型 逻辑数据分组 监视开关
连接 event_conn 始终收集
数据库 event_db 始终收集
统计信息 event_scmetrics REQUEST METRICS BASE
统计信息 event_wlmmetrics REQUEST METRICS BASE
工作单元 uow_metrics REQUEST METRICS BASE
用法
可使用此元素来确定应用程序或数据库级别的数据库活动的级别。
还可使用以下公式来确定 UPDATE、INSERT、MERGE 和 DELETE 语句数与语句总数的比率：
 
      uid_sql_stmts
  / (static_sql_stmts + dynamic_sql_stmts )

此信息对于分析应用程序活动和吞吐量非常有用。

unread_prefetch_pages -“未读取的预取页数”监视元素

指示预取程序已读入缓冲池但从未使用的页数。

表 4. 表函数监视信息
表函数 监视元素收集命令和级别
MON_GET_BUFFERPOOL 表函数 - 获取缓冲池指标 DATA OBJECT METRICS BASE
MON_GET_DATABASE 表函数 - 获取数据库级别信息 DATA OBJECT METRICS BASE
MON_GET_DATABASE_DETAILS 表函数 - 获取数据库信息度量值 DATA OBJECT METRICS BASE
MON_GET_TABLESPACE 表函数 - 获取表空间指标 DATA OBJECT METRICS BASE
表 5. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库 dbase 缓冲池
表空间 tablespace 缓冲池
缓冲池 bufferpool 缓冲池
应用程序 appl 缓冲池
可将快照监视的计数器重置。
表 6. 事件监视信息
事件类型 逻辑数据分组 监视开关
数据库 event_db 始终收集
表空间 event_tablespace 始终收集
连接 event_conn 始终收集

用法

如果此数目很高，那么预取程序会将不会使用到的页读入缓冲池，从而导致执行不必要的 I/O。

uow_comp_status -“工作单元完成状态”监视元素

工作单元的状态以及停止方式。

表 8. 表函数监视信息
表函数 监视元素收集级别
MON_GET_CONNECTION 表函数 - 获取连接指标 始终收集
MON_GET_CONNECTION_DETAILS 表函数 - 获取详细的连接指标 始终收集
MON_GET_UNIT_OF_WORK 表函数 - 获取工作单元指标 始终收集
MON_GET_UNIT_OF_WORK_DETAILS 表函数 - 获取详细的工作单元指标 始终收集
表 9. 快照监视信息
快照级别 逻辑数据分组 监视开关
应用程序 appl 工作单元
DCS 应用程序 dcs_appl 基本
表 10. 事件监视信息
事件类型 逻辑数据分组 监视开关
事务 event_xact 始终收集
用法
可使用此元素来确定工作单元是否因为死锁或异常终止而结束。 它可能已经：
  • 因为落实语句而落实
  • 因为回滚语句而回滚
  • 因为死锁而回滚
  • 因为异常终止而回滚
  • 在正常应用程序终止时落实。
  • 因为对正在运行的工作单元执行 FLUSH EVENT MONITOR 命令而处于未知状态。
注： API 用户应参考包含数据库系统监视器常量的定义的头文件（sqlmon.h）。

uow_completed_total -“完成的工作单元总数”监视元素

通过落实或回滚完成的工作单元总数。

表 11. 表函数监视信息
表函数 监视元素收集级别
MON_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 MON_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 ACTIVITY METRICS BASE
MON_GET_WORKLOAD_STATS 表函数 - 返回工作负载统计信息 ACTIVITY METRICS BASE
MON_SAMPLE_SERVICE_CLASS_METRICS - 获取样本服务类指标 REQUEST METRICS BASE
MON_SAMPLE_WORKLOAD_METRICS - 获取样本工作负载指标 REQUEST METRICS BASE
WLM_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 REQUEST METRICS BASE
WLM_GET_WORKLOAD_STATS 表函数 - 返回工作负载统计信息 REQUEST METRICS BASE
表 12. 事件监视信息
事件类型 逻辑数据分组 监视开关
统计信息 event_scstats（在 metrics 文档中报告） 始终收集
统计信息 event_wlstats（在 metrics 文档中报告） 始终收集

用法

如果由 WLM_GET_SERVICE_SUBCLASS_STATS 或 WLM_GET_WORKLOAD_STATS 函数返回此监视元素，那么此监视元素表示自上次重置统计信息以来完成的工作单元总数。

如果由 MON_SAMPLE_SERVICE_CLASS_METRICS 或 MON_SAMPLE_WORKLOAD_METRICS 函数返回此监视元素，那么此监视元素表示自执行该函数以来完成的工作单元总数。

uow_elapsed_time -“最新工作单元耗用时间”监视元素

最新完成的工作单元耗用的执行时间。

元素标识
uow_elapsed_time
元素类型
time
表 13. 快照监视信息
快照级别 逻辑数据分组 监视开关
应用程序 appl 工作单元，时间戳记
DCS 应用程序 dcs_appl 工作单元，时间戳记

用法

将此元素用作完成工作单元所花时间的指示符。

此元素由两个子元素组成，它们报告耗用时间的秒数和微秒（一秒的百万分之一）数。这些子元素的名称可通过将“_s”和“_ms”添加至此监视元素的名称派生而成。要检索此监视元素耗用的总时间，必须将这两个子元素的值加在一起。例如，如果“_s”子元素值为 3，“_ms”子元素值为 20，那么此监视元素耗用的总时间为 3.00002 秒。

uow_id -“工作单元标识”监视元素

工作单元标识。工作单元标识在应用程序句柄内是唯一的。

表 14. 表函数监视信息
表函数 监视元素收集级别
MON_GET_ACTIVITY 表函数 - 返回活动列表 始终收集
MON_GET_ACTIVITY_DETAILS 表函数 - 获取完整的活动详细信息 始终收集
MON_GET_AGENT 表函数 - 列示正在服务类中运行的代理程序 始终收集
MON_GET_UNIT_OF_WORK 表函数 - 获取工作单元指标 始终收集
MON_GET_UNIT_OF_WORK_DETAILS 表函数 - 获取详细的工作单元指标 始终收集
WLM_GET_SERVICE_CLASS_AGENTS 表函数 - 列示正在服务类中运行的代理程序 始终收集
WLM_GET_SERVICE_CLASS_WORKLOAD _OCCURRENCES 表函数 - 列示工作负载出现次数 始终收集
WLM_GET_WORKLOAD_OCCURRENCE _ACTIVITIES 表函数 - 返回活动列表 始终收集
表 15. 事件监视信息
事件类型 逻辑数据分组 监视开关
活动 event_activity 始终收集
活动 event_activitystmt 始终收集
活动 event_activityvals 始终收集
活动 event_activitymetrics 始终收集
变更历史记录 ddlstmtexec
txncompletion		 始终收集
锁定 lock_participant_activities
lock_activity_values		 始终收集
阈值违例 event_thresholdviolations 始终收集
工作单元 uow
uow_metrics
uow_package_list
uow_executable_list		 始终收集

用法

将此元素与其他活动历史元素配合使用来分析活动的行为。

还可以将此元素与 activity_id 和 appl_id 监视元素配合使用来唯一地标识某项活动。

uow_lifetime_avg -“工作单元平均生存期”监视元素

工作单元的平均生存期。此监视元素以毫秒计。

表 16. 表函数监视信息
表函数 监视元素收集级别
MON_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 MON_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 ACTIVITY METRICS BASE
MON_GET_WORKLOAD_STATS 表函数 - 返回工作负载统计信息 ACTIVITY METRICS BASE
MON_SAMPLE_SERVICE_CLASS_METRICS - 获取样本服务类指标 REQUEST METRICS BASE
MON_SAMPLE_WORKLOAD_METRICS - 获取样本工作负载指标 REQUEST METRICS BASE
WLM_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 REQUEST METRICS BASE
WLM_GET_WORKLOAD_STATS 表函数 - 返回工作负载统计信息 REQUEST METRICS BASE
表 17. 事件监视信息
事件类型 逻辑数据分组 监视开关
统计信息 event_scstats（在 metrics 文档中报告） 始终收集
统计信息 event_wlstats（在 metrics 文档中报告） 始终收集

用法

如果由 WLM_GET_SERVICE_SUBCLASS_STATS 或 WLM_GET_WORKLOAD_STATS 函数返回此监视元素，那么此监视元素表示自上次重置统计信息以来的工作单元平均生存期。

如果由 MON_SAMPLE_SERVICE_CLASS_METRICS 或 MON_SAMPLE_WORKLOAD_METRICS 函数返回此监视元素，那么此监视元素表示自执行该函数以来的工作单元平均生存期。

uow_lock_wait_time -“工作单元等待锁定的总时间”监视元素

此工作单元等待锁定时的耗用总时间。此值以毫秒计。

元素标识
uow_lock_wait_time
元素类型
计数器
表 18. 快照监视信息
快照级别 逻辑数据分组 监视开关
应用程序 appl 工作单元
用法
此元素可帮助您确定资源争用问题的严重性。

uow_log_space_used -“使用的工作单元日志空间”监视元素

被监视应用程序的当前工作单元中使用的日志空间量（以字节计）。

表 19. 表函数监视信息
表函数 监视元素收集级别
MON_GET_UNIT_OF_WORK 表函数 - 获取工作单元指标 始终收集
MON_GET_UNIT_OF_WORK 表函数 - 获取详细的工作单元指标（在 XML 文档 DETAILS 中报告） 始终收集
表 20. 快照监视信息
快照级别 逻辑数据分组 监视开关
应用程序 appl 工作单元
表 21. 事件监视信息
事件类型 逻辑数据分组 监视开关
事务 event_xact 始终收集
工作单元 - 始终收集

用法

可使用此元素来了解工作单元级别的记录要求。

uow_start_time -“工作单元开始时间戳记”监视元素

工作单元第一次需要数据库资源的日期和时间。

表 22. 表函数监视信息
表函数 监视元素收集级别
MON_GET_CONNECTION 表函数 - 获取连接指标 始终收集
MON_GET_CONNECTION_DETAILS 表函数 - 获取详细的连接指标 始终收集
MON_GET_UNIT_OF_WORK 表函数 - 获取工作单元指标 始终收集
MON_GET_UNIT_OF_WORK 表函数 - 获取详细的工作单元指标（在 XML 文档 DETAILS 中报告） 始终收集
表 23. 快照监视信息
快照级别 逻辑数据分组 监视开关
应用程序 appl 工作单元，时间戳记
DCS 应用程序 dcs_appl 工作单元，时间戳记
表 24. 事件监视信息
事件类型 逻辑数据分组 监视开关
工作单元 uow 始终收集
事务 event_xact -

用法

此资源要求出现在该工作单元的第一个 SQL 语句执行中：
  • 对于第一个工作单元，这是 conn_complete_time 之后的第一个数据库请求（SQL 语句执行）的时间。
  • 对于后续工作单元，这是上一个 COMMIT 或 ROLLBACK 之后第一个数据库请求（SQL 语句执行）的时间。
注： SQL Reference 将工作单元的边界定义为 COMMIT 或 ROLLBACK 点。

数据库系统监视器排除 COMMIT/ROLLBACK 与工作单元定义中的下一个 SQL 语句之间所耗用的时间。此量度方法反映数据库管理器在处理数据库请求时所耗用的时间，并且将此时间与该工作单元的第一个 SQL 语句之间的应用程序逻辑所耗用的时间隔开。工作单元耗用时间包括在工作单元内的 SQL 语句之间运行应用程序逻辑所耗用的时间。

可将此元素与 uow_stop_time 监视元素配合使用来计算工作单元的耗用总时间，并与 prev_uow_stop_time 监视元素配合使用来计算在工作单元之间的应用程序上耗用的时间。

可使用 uow_stop_time 和 prev_uow_stop_time 监视元素来计算工作单元的 SQL Reference 定义的耗用时间。

uow_status -“工作单元状态”监视元素

工作单元的状态。

元素标识
uow_status
元素类型
信息
表 25. 事件监视信息
事件类型 逻辑数据分组 监视开关
事务 event_xact 始终收集
用法
可使用此元素来确定工作单元的状态。API 用户应参考包含数据库系统监视器常量定义的 sqlmon.h 头文件。

uow_stop_time -“工作单元停止时间戳记”监视元素

最新工作单元的完成日期和时间，它会在落实或回滚数据库更改时进行。

表 26. 表函数监视信息
表函数 监视元素收集级别
MON_GET_CONNECTION 表函数 - 获取连接指标 始终收集
MON_GET_CONNECTION_DETAILS 表函数 - 获取详细的连接指标 始终收集
MON_GET_UNIT_OF_WORK 表函数 - 获取工作单元指标 始终收集
MON_GET_UNIT_OF_WORK_DETAILS 表函数 - 获取详细的工作单元指标 始终收集
表 27. 快照监视信息
快照级别 逻辑数据分组 监视开关
应用程序 appl 工作单元，时间戳记
DCS 应用程序 dcs_appl 工作单元，时间戳记
表 28. 事件监视信息
事件类型 逻辑数据分组 监视开关
工作单元 uow 始终收集

用法

通过将此元素与 prev_uow_stop_time 监视元素配合使用，可以计算 COMMIT/ROLLBACK 点之间的耗用总时间，通过将此元素与 uow_start_time 监视元素配合使用，可以计算最后一个工作单元的耗用时间。

时间戳记内容的设置将为如下所示：
  • 如果应用程序已完成一个工作单元并且尚未启动新的工作单元（由 uow_start_time 监视元素定义），那么此元素将报告有效的非零时间戳记。
  • 如果应用程序当前在执行工作单元，那么此元素将报告零。
  • 当应用程序第一次连接至数据库时，此元素将设为 conn_complete_time 监视元素的值。

当新的工作单元启动时，此元素的内容将移至 prev_uow_stop_time 监视元素。

uow_throughput -“工作单元吞吐量”监视元素

工作单元完成速率，以每秒工作单元数计。

表 29. 表函数监视信息
表函数 监视元素收集级别
MON_SAMPLE_SERVICE_CLASS_METRICS - 获取样本服务类指标 REQUEST METRICS BASE
MON_SAMPLE_WORKLOAD_METRICS - 获取样本工作负载指标 REQUEST METRICS BASE
MON_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 MON_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 ACTIVITY METRICS BASE
MON_GET_WORKLOAD_STATS 表函数 - 返回工作负载统计信息 ACTIVITY METRICS BASE
WLM_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 REQUEST METRICS BASE
WLM_GET_WORKLOAD_STATS 表函数 - 返回工作负载统计信息 REQUEST METRICS BASE
表 30. 事件监视信息
事件类型 逻辑数据分组 监视开关
统计信息 event_scstats（在 metrics 文档中报告） 始终收集
统计信息 event_wlstats（在 metrics 文档中报告） 始终收集

用法

如果由 WLM_GET_SERVICE_SUBCLASS_STATS 或 WLM_GET_WORKLOAD_STATS 函数返回此监视元素，那么此监视元素表示自上次重置统计信息以来的工作单元吞吐量。

如果由 MON_SAMPLE_SERVICE_CLASS_METRICS 或 MON_SAMPLE_WORKLOAD_METRICS 函数返回此监视元素，那么此监视元素表示自执行该函数以来的工作单元吞吐量。

uow_total_time_top -“最长 UOW 总时间”监视元素

工作单元生存期的高水位标记（以毫秒计）。

表 31. 表函数监视信息
表函数 监视元素收集级别
MON_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 MON_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 始终收集
MON_GET_WORKLOAD_STATS 表函数 - 返回工作负载统计信息 始终收集
WLM_GET_SERVICE_SUBCLASS_STATS 表函数 - 返回服务子类的统计信息 始终收集
WLM_GET_WORKLOAD_STATS 表函数 - 返回工作负载统计信息 始终收集
表 32. 事件监视信息
事件类型 逻辑数据分组 监视开关
统计信息 event_wlstats 始终收集
统计信息 event_scstats 始终收集

用法

此元素可用来帮助确定 UOWTOTALTIME 阈值是否有效，还可以帮助确定如何配置这种阈值。

对于服务类，当服务类的 COLLECT AGGREGATE ACTIVITY DATA 设为 NONE 时，此监视元素返回 -1。

对于工作负载而言，如果工作负载的 COLLECT AGGREGATE ACTIVITY DATA 设为 NONE，那么此监视元素将返回 -1。

对于服务类，将计算由工作负载指定的服务类的此高水位标记采用的度量。工作操作集用来更改活动的服务类的任何映射都不会影响此高水位标记。

update_sql_stmts -“更新数”监视元素

此元素包含自联合服务器实例启动或数据库监视计数器最后一次重置以后，联合服务器代表任何应用程序对此数据源发出 UPDATE 语句的总次数。

表 33. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库 dbase_remote 基本
应用程序 appl_remote 基本
可将快照监视的计数器重置。
用法
使用此元素来确定联合服务器或应用程序对此数据源执行的数据库活动的级别。
还可使用此元素并借助以下公式来确定联合服务器或应用程序对此数据源执行的写入活动的百分比：
   write_activity =
           (INSERT 语句数 + UPDATE 语句数 + DELETE 语句数 ) /
           (SELECT 语句数 + INSERT 语句数 + UPDATE 语句数 +
           DELETE 语句数)

update_time -“更新响应时间”监视元素

此元素包含此数据源响应 UPDATE 所耗用的总时间（以毫秒计），这些 UPDATE 来自联合服务器启动后或上次重置数据库监视计数器后在此联合服务器实例上运行的所有应用程序或单个应用程序。

表 34. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库 dbase_remote 时间戳记
应用程序 appl_remote 时间戳记
可将快照监视的计数器重置。

响应时间是以联合服务器将 UPDATE 语句提交给数据源的时间与数据源响应联合服务器以指示已处理 UPDATE 的时间之差量度的。

用法
使用此元素来确定等待处理对此数据源执行 UPDATE 语句所花的实际时间。此信息对于容量规划和容量调整非常有用。

usage_list_state -“用法列表状态”监视元素

特定用法列表的状态。

表 40. 表函数监视信息
表函数 监视元素收集级别
MON_GET_USAGE_LIST_STATUS 表函数 - 返回用法列表的状态 始终收集

用法

可能的值如下所示：
A
处于活动状态。
F
未能激活。
I
处于不活动状态。
P
激活暂挂。

usage_list_used_entries -“用法列表已使用条目数”监视元素

用法列表中当前已使用的条目数。如果用法列表处于不活动状态，那么此监视元素表示此用法列表上次激活以进行监视时此用法列表中的条目数。

表 41. 表函数监视信息
表函数 监视元素收集级别
MON_GET_USAGE_LIST_STATUS 表函数 - 返回用法列表的状态 始终收集

usage_list_wrapped -“用法列表合并指示符”监视元素

说明特定用法列表是否已合并的指示符。用法列表变满时，缺省行为是合并条目，这意味着最旧的条目被最新的条目替换。

可能的值为 Y 和 N。

表 42. 表函数监视信息
表函数 监视元素收集级别
MON_GET_USAGE_LIST_STATUS 表函数 - 返回用法列表的状态 始终收集

user_cpu_time -“用户 CPU 时间”监视元素

数据库管理器代理进程、工作单元或语句使用的总用户 CPU 时间（以秒和微秒计）。 对于写至表的事件监视器，此元素的值将通过使用 BIGINT 数据类型以微秒为单位给出。

当监视开关或时间戳记开关未打开时，将不收集此元素，并改为写入 -1。

表 43. 事件监视信息
事件类型 逻辑数据分组 监视开关
连接 event_conn 始终收集
事务 event_xact 始终收集
语句 event_stmt 始终收集
活动 event_activity 始终收集

用法

此元素与其他相关 CPU 时间元素一起使用可帮助您了解应用程序内的活动级别，还可以帮助您标识可能因为调整而受益的应用程序。

注： 如果此信息对您的操作系统不可用，那么此元素将设为 0。
注： 由于 DB2® 系统收集统计信息时所使用的详细程度不同，total_exec_time 监视元素的值可能与 system_cpu_time 和 user_cpu_time 监视元素的值的总和不相等。在这种情况下，system_cpu_time 与 user_cpu_time 监视元素的值之和更准确地反映了实际总执行时间。

utility_dbname -“实用程序操作的数据库”监视元素

实用程序操作的数据库。

表 44. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库管理器 utility_info 基本

utility_description -“实用程序描述”监视元素

对实用程序执行的任务的简短描述。例如，重新平衡调用可能包含“Tablespace ID: 2”，表示此重新平衡程序正在处理标识为 2 的表空间。 此字段的格式取决于实用程序的类，并且在不同发行版之间可能有所更改。
表 45. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库管理器 utility_info 基本

utility_detail -“实用程序详细信息”监视元素

此元素包含实用程序正在执行的工作的简短描述。

表 46. 表函数监视信息
表函数 监视元素收集级别
MON_GET_UTILITY 表函数 - 获取正在数据库上运行的实用程序 始终收集
表 47. 事件监视信息
事件类型 逻辑数据分组 监视开关
变更历史记录 UTILSTART 始终收集

用法

实用程序正执行的工作的简短描述，包括对该实用程序指定的一些选项。例如，针对 REORG 调用的记录将包括部分重构的命令字符串，包括该实用程序使用的某些不同选项，例如，访问方式。此字段的格式取决于实用程序的类型，并且在不同发行版中可能变化。

utility_id -“实用程序标识”监视元素

对应于实用程序调用的唯一标识。

表 48. 表函数监视信息
表函数 监视元素收集命令和级别
MON_GET_ACTIVITY 表函数 - 返回活动列表 始终收集
MON_GET_ACTIVITY_DETAILS 表函数 - 获取完整的活动详细信息 （在 DETAILS XML 文档中报告） 始终收集
MON_GET_UTILITY 表函数 - 获取正在数据库上运行的实用程序 始终收集
WLM_GET_WORKLOAD_OCCURRENCE _ACTIVITIES 表函数 - 返回活动列表 始终收集
表 49. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库管理器 utility_info 基本

utility_invocation_id -“实用程序调用标识”监视元素

对应于实用程序调用的唯一标识。

表 50. 表函数监视信息
表函数 监视元素收集级别
MON_GET_ACTIVITY 表函数 - 返回活动列表 始终收集
MON_GET_ACTIVITY_DETAILS 表函数 - 获取完整的活动详细信息 始终收集
MON_GET_AGENT 表函数 - 列示正在服务类中运行的代理程序 始终收集
MON_GET_UTILITY 表函数 - 获取正在数据库上运行的实用程序 始终收集
WLM_GET_SERVICE_CLASS_AGENTS 表函数 - 列示正在服务类中运行的代理程序 始终收集
WLM_GET_WORKLOAD_OCCURRENCE _ACTIVITIES 表函数 - 返回活动列表 始终收集
表 51. 事件监视信息
事件类型 逻辑数据分组 监视元素收集级别
活动 event_activity 始终收集
变更历史记录 changesummary
utillocation
utilphase
utilstart
utilstop		 始终收集

用法

utility_invocation_id 实用程序是二进制标记，用于唯一标识实用程序的给定调用。utility_invocation_id 在执行该实用程序的每个成员上相同。utility_invocation_id 在数据库取消激活、重新激活和成员关闭期间保持其唯一性，以允许快速标识对应实用程序的给定调用的所有事件监视器记录。

utility_invoker_type -“实用程序调用者类型”监视元素

此元素描述实用程序是如何被调用的。

表 52. 表函数监视信息
表函数 监视元素收集级别
MON_GET_UTILITY 表函数 - 获取正在数据库上运行的实用程序 始终收集
表 53. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库管理器 utility_info 基本
表 54. 事件监视信息
事件类型 逻辑数据分组 监视开关
变更历史记录 utilstart 始终收集

用法

使用此元素来确定实用程序是如何被调用的。例如，可以使用此元素来确定实用程序是 DB2 自动调用的还是用户调用的。此元素的值（列示如下）是在 sqlmon.h 中定义的。
API 常量 实用程序
SQLM_UTILITY_INVOKER_USER 实用程序是用户调用的
SQLM_UTILITY_INVOKER_AUTO 实用程序是 DB2 自动调用的
对于 MON_GET_UTILITY 表函数和变更事件历史记录监视器，此元素指示已如何调用实用程序：
USER
实用程序由用户调用
AUTO
实用程序是 DB2 自动调用的

utility_operation_type -“实用程序操作类型”监视元素

指示实用程序操作的类型。

表 55. 表函数监视信息
表函数 监视元素收集级别
MON_GET_UTILITY 表函数 - 获取正在数据库上运行的实用程序 始终收集
表 56. 事件监视信息
事件类型 逻辑数据分组 监视开关
变更历史记录 UTILSTART 始终收集

用法

对于变更历史记录事件监视器，此元素包含有关启动的实用程序事件 (UTILITY_TYPE) 的详细信息。

如果 UTILITY_TYPE 为 BACKUP，那么为下列其中一个：
D
变化量
I
增量
F
完全
如果 UTILITY_TYPE 为 LOAD，那么为下列其中一个：
I
插入
R
替换
S
重新启动
T
终止
如果 UTILITY_TYPE 为 MOVETABLE，那么为下列其中一个：
A
取消
C
复制
I
初始化
L
清除
M
移动
R
重演
S
交换
V
验证
如果 UTILITY_TYPE 为 REDISTRIBUTE，那么为下列其中一个：
A
中止
C
继续
D
缺省值
T
目标映射
如果 UTILITY_TYPE 为 REORG，那么为下列其中一个：
A
重组所有表索引
I
索引重组
N
原地表重组
R
重组表回收扩展数据块
T
典型表重组
如果 UTILITY_TYPE 为 RESTORE，那么为下列其中一个：
A
增量自动
B
增量中止
F
完全
M
增量手动
如果 UTILITY_TYPE 为 ROLLFORWARD，那么为下列其中一个：
E
日志结束
P
时间点
如果 UTILITY_TYPE 为 RUNSTATS，那么为下列其中一个：
A
表的所有索引
I
索引
T
表

utility_phase_detail -“实用程序阶段详细信息”监视元素

此元素已保留以供将来使用。

表 57. 事件监视信息
事件类型 逻辑数据分组 监视开关
变更历史记录 UTILPHASE 始终收集

utility_phase_type -“实用程序阶段类型”监视元素

标识实用程序阶段类型。

表 58. 事件监视信息
事件类型 逻辑数据分组 监视开关
变更历史记录 UTILPHASE 始终收集

用法

对于变更历史记录事件监视器，如果 utility_type 元素为 BACKUP，那么阶段类型为：
BACKUPTS
备份表空间

utility_priority -“实用程序优先级”监视元素

实用程序优先级指定调速实用程序相对其调速层而言的相对重要性。优先级 0 指示实用程序以非调速方式执行。非零优先级的范围必须在 1 到 100 之间，100 表示最高优先级，1 表示最低优先级。

表 59. 表函数监视信息
表函数 监视元素收集级别
MON_GET_UTILITY 表函数 - 获取正在数据库上运行的实用程序 始终收集
表 60. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库管理器 utility_info 基本
表 61. 事件监视信息
事件类型 逻辑数据分组 监视开关
变更历史记录 utilstart 始终收集

utility_start_time -“实用程序启动时间”监视元素

初次调用当前实用程序的日期和时间。

表 62. 表函数监视信息
表函数 监视元素收集级别
MON_GET_UTILITY 表函数 - 获取正在数据库上运行的实用程序 始终收集
表 63. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库管理器 utility_info 基本

utility_start_type -“实用程序启动类型”监视元素

此元素指示实用程序如何启动。

表 64. 事件监视信息
事件类型 逻辑数据分组 监视开关
变更历史记录 UTILSTART 始终收集

用法

对于变更历史记录事件监视器，实用程序将以下列其中一种方式启动：
  • RESUME
  • START

utility_state -“实用程序状态”监视元素

此元素描述实用程序的状态。

元素标识
utility_state
元素类型
信息
表 65. 快照监视信息
快照级别 逻辑数据分组 监视开关
数据库管理器 utility_info 基本
用法
使用此元素来确定活动实用程序的状态。此字段的值（列示如下）是在 sqlmon.h 中定义的。
API 常量 描述
SQLM_UTILITY_STATE_EXECUTE 实用程序正在执行
SQLM_UTILITY_STATE_WAIT 实用程序正在等待事件发生，然后才会继续执行
SQLM_UTILITY_STATE_ERROR 实用程序遇到了错误
SQLM_UTILITY_STATE_SUSPENDED 实用程序已暂挂

utility_stop_type -“实用程序停止类型”监视元素

此元素指示如何停止实用程序。

表 66. 事件监视信息
事件类型 逻辑数据分组 监视开关
变更历史记录 UTILSTOP 始终收集

用法

对于变更历史记录事件监视器，实用程序将以下列其中一种方式停止：
  • PAUSE
  • STOP