WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES_V97 表函数 -工作负载实例列表
WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES_V97 函数返回在特定成员上的指定服务类中运行的所有工作负载实例的列表。 一个工作负载实例是一个其属性与某个工作负载的定义匹配的具体数据库连接,因此与该工作负载关联或已分配给该工作负载。
注: 已不推荐使用此表函数,并将其替换为 WLM_GET_SERVICE_CLASS_WORKLOAD_实例表函数。
工作负载实例是特定数据库连接,其属性与工作负载的 定义 相匹配,因此与工作负载相关联或分配给工作负载。
语法
模式为 SYSPROC。
表函数参数
- service_superclass_name
- 类型为 VARCHAR(128) 的输入参数,用于指定当前连接的数据库中服务超类的名称。 如果该参数为 NULL 或空字符串,那么会针对数据库中与其他参数的值匹配的所有超类检索数据。
- service_subclass_name
- 工作负载实例的目标服务子类。 此工作负载实例提交的任何工作都将在目标服务超类下的此服务子类中运行,映射或重新映射到另一子类的活动除外。
- 成员
- 类型为 INTEGER 的输入参数,用于指定与当前连接的数据库在同一实例中的成员数。 请指定 -1(对于当前数据库成员)或 -2(对于所有数据库成员)。 如果指定空值,那么会隐式设置 -1。
权限
需要下列其中一项权限才能执行此例程:
- 对例程的 EXECUTE 特权
- DATAACCESS 权限
- DBADM 权限
- SQLADM 权限
- WLMADM 权限
缺省 PUBLIC 特权
无
示例
如果管理员想要查看在整个系统上运行的工作负载实例,那么管理员可以通过为 service_superclass_name 和 service_subclass_name 以及 -2 for member指定空值或空字符串来调用 WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES_V97 函数:
SELECT SUBSTR(SERVICE_SUPERCLASS_NAME,1,19) AS SUPERCLASS_NAME,
SUBSTR(SERVICE_SUBCLASS_NAME,1,18) AS SUBCLASS_NAME,
SUBSTR(CHAR(DBPARTITIONNUM),1,4) AS PART,
SUBSTR(CHAR(COORD_PARTITION_NUM),1,4) AS COORDPART,
SUBSTR(CHAR(APPLICATION_HANDLE),1,7) AS APPHNDL,
SUBSTR(WORKLOAD_NAME,1,22) AS WORKLOAD_NAME,
SUBSTR(CHAR(WORKLOAD_OCCURRENCE_ID),1,6) AS WLO_ID
FROM TABLE(WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES_V97
(CAST(NULL AS VARCHAR(128)), CAST(NULL AS VARCHAR(128)), -2))
AS SCINFO
ORDER BY SUPERCLASS_NAME, SUBCLASS_NAME, PART, APPHNDL,
WORKLOAD_NAME, WLO_ID
如果系统具有四个数据库成员并且当前正在运行两个工作负载,那么前面的查询产生的结果与下列结果类似:
SUPERCLASS_NAME SUBCLASS_NAME PART COORDPART ...
------------------- ------------------ ---- --------- ...
SYSDEFAULTMAINTENAN SYSDEFAULTSUBCLASS 0 0 ...
SYSDEFAULTSYSTEMCLA SYSDEFAULTSUBCLASS 0 0 ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS 0 0 ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS 0 0 ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS 1 0 ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS 1 0 ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS 2 0 ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS 2 0 ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS 3 0 ...
SYSDEFAULTUSERCLASS SYSDEFAULTSUBCLASS 3 0 ...... APPHNDL WORKLOAD_NAME WLO_ID
... ------- ---------------------- ------
... - - -
... - - -
... 1 SYSDEFAULTUSERWORKLOAD 1
... 2 SYSDEFAULTUSERWORKLOAD 2
... 1 SYSDEFAULTUSERWORKLOAD 1
... 2 SYSDEFAULTUSERWORKLOAD 2
... 1 SYSDEFAULTUSERWORKLOAD 1
... 2 SYSDEFAULTUSERWORKLOAD 2
... 1 SYSDEFAULTUSERWORKLOAD 1
... 2 SYSDEFAULTUSERWORKLOAD 2使用说明
这些参数实际上是一起评估的。 即,如果指定有冲突的输入参数(例如指定服务超类 SUP_A 和子类 SUB_B,这样 SUB_B 不是 SUP_A 的子类),那么不会返回任何行。
注: 当针对工作负载实例 (例如 coord_act_completed_total) 报告的统计信息与相应的工作负载统计信息组合在一起时,将在每个工作单元开始时重置这些统计信息。
返回的信息
| 列名 | 数据类型 | 描述 |
|---|---|---|
| SERVICE_SUPERCLASS_NAME | VARCHAR(128) | service_superclass_name -“服务超类名”监视元素 |
| SERVICE_SUBCLASS_NAME | VARCHAR(128) | service_subclass_name -“服务子类名”监视元素 |
| DBPARTITIONNUM | SMALLINT | dbpartitionnum -“数据库分区号”监视元素 |
| COORD_PARTITION_NUM | SMALLINT | coord_partition_num -“协调程序分区号”监视元素 |
| APPLICATION_HANDLE | BIGINT | application_handle -“应用程序句柄”监视元素 |
| WORKLOAD_NAME | VARCHAR(128) | workload_name -“工作负载名称”监视元素 |
| WORKLOAD_OCCURRENCE_ID | INTEGER | workload_occurrence_id -“工作负载项标识”监视元素 |
| UOW_ID | INTEGER | uow_id -“工作单元标识”监视元素 |
| WORKLOAD_OCCURRENCE_STATE | VARCHAR(32) | workload_occurrence_state -“工作负载实例状态”监视元素 |
| SYSTEM_AUTH_ID | VARCHAR(128) | system_auth_id -“系统授权标识”监视元素 |
| SESSION_AUTH_ID | VARCHAR(128) | session_auth_id -“会话授权标识”监视元素 |
| APPLICATION_NAME | VARCHAR(128) | appl_name -“应用程序名称”监视元素 |
| CLIENT_WRKSTNNAME | VARCHAR(255) | client_wrkstnname -“客户机工作站名称”监视元素 |
| CLIENT_ACCTNG | VARCHAR(255) | client_acctng -“客户机记帐字符串”监视元素 |
| CLIENT_USER | VARCHAR(255) | 此工作负载实例的 CLIENT_USERID 专用寄存器的当前值。 |
| CLIENT_APPLNAME | VARCHAR(255) | client_applname -“客户机应用程序名称”监视元素 |
| COORD_ACT_COMPLETED_TOTAL | INTEGER | coord_act_completed_total -“完成的协调程序活动总数”监视元素 |
| COORD_ACT_ABORTED_TOTAL | INTEGER | coord_act_aborted_total -“异常终止的协调程序活动总数”监视元素 |
| COORD_ACT_REJECTED_TOTAL | INTEGER | coord_act_rejected_total -“被拒绝的协调程序活动总数”监视元素 |
| CONCURRENT_ACT_TOP | INTEGER | concurrent_act_top -“最大并行活动数”监视元素 |
| ADDRESS | VARCHAR(255) | address - 从中发起连接的 IP 地址 |
