WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES 表函数 - 列出工作负载实例
WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES 函数会返回特定成员上正在某个指定服务类中运行的所有工作负载实例的列表。 一个工作负载实例是一个其属性与某个工作负载的定义匹配的具体数据库连接，因此与该工作负载关联或已分配给该工作负载。
请参阅 表 1 ，以获取可返回的完整信息列表。
语法
模式为 SYSPROC。
表函数参数
- service_superclass_name
- 类型为 VARCHAR(128) 的输入参数，用于指定当前连接的数据库中服务超类的名称。 如果该参数为 NULL 或空字符串，那么会针对数据库中与其他参数的值匹配的所有超类检索数据。
- service_subclass_name
- 工作负载实例的目标服务子类。 此工作负载实例提交的任何工作都将在目标服务超类下的此服务子类中运行，映射或重新映射到另一子类的活动除外。
- 成员
- 类型为 INTEGER 的输入参数，用于指定与当前连接的数据库在同一实例中的成员数。 指定 -1（表示当前数据库成员）或 -2（表示所有活动数据库成员）。 如果指定空值，那么会隐式设置 -1。
权限
需要下列其中一项权限才能执行此例程：
- 对例程的 EXECUTE 特权
- DATAACCESS 权限
- DBADM 权限
- SQLADM 权限
- WLMADM 权限
缺省 PUBLIC 特权
无
示例
如果管理员希望查看在整个系统上运行的工作负载实例，那么管理员可以通过为 member的 service_superclass_name 和 service_subclass_name 和 -2 指定空值或空字符串来调用WLM_GET_SERVICE_CLASS_WORKLOAD_实例函数:
SELECT SUBSTR(SERVICE_SUPERCLASS_NAME,1,19) AS SUPERCLASS_NAME,
SUBSTR(SERVICE_SUBCLASS_NAME,1,18) AS SUBCLASS_NAME,
SUBSTR(CHAR(MEMBER),1,4) AS MEMB,
SUBSTR(CHAR(COORD_MEMBER),1,4) AS COORDMEMB,
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
(CAST(NULL AS VARCHAR(128)), CAST(NULL AS VARCHAR(128)), -2))
AS SCINFO
ORDER BY SUPERCLASS_NAME, SUBCLASS_NAME, MEMB, APPHNDL,
WORKLOAD_NAME, WLO_ID
如果系统具有四个数据库成员并且当前正在运行两个工作负载，那么前面的查询产生的结果与下列结果类似：
SUPERCLASS_NAME SUBCLASS_NAME MEMB COORDMEMB ...
------------------- ------------------ ---- --------- ...
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 地址 |
| APPL_ID | VARCHAR(128) | appl_id - 应用程序标识 |
| MEMBER | SMALLINT | member -“数据库成员”监视元素 |
| COORD_MEMBER | SMALLINT | coord_member -“协调程序成员”监视元素 |