EXTRACT STATISTICS

描述

EXTRACT STATISTICS 命令将特定资源的当前统计信息或给定类型的资源的全局统计信息返回给调用应用程序。

CICS 返回的统计信息是在上次统计信息抽取时间间隔到期，日终到期或请求重置后累积的统计信息。 无法访问已写入 SMF 数据集的统计信息。 EXTRACT STATISTICS 命令不会导致重置统计信息计数器。

CICS 为此命令返回的数据获取足够的存储空间，并返回指向此区域的指针。 区域的前两个字节包含其长度。 此存储器可由后续 EXTRACT STATISTICS 命令复用，因此您必须将下次发出命令之后所需的任何数据存储在其他位置。 CICS 在任务终止时释放此存储器。

对于支持作为平台上部署的应用程序的专用资源的资源类型，将针对公共资源和专用资源编写不同的统计信息记录，每个记录都由不同的副本或 DSECT 映射。 LIBRARY ， JVMPROGRAM ， PROGRAM 和 PROGRAMDEF 资源类型作为专用资源受支持。 如果资源是公共资源，那么将使用公共副本来映射其数据，如果资源是专用资源，那么将使用专用副本来映射其数据。

使用 EXEC CICS EXTRACT STATISTICS 或 EXEC CICS COLLECT STATISTICS 命令返回声明为应用程序入口点的指定程序的统计信息时，仅返回一条统计信息记录。 如果命令是在应用程序上下文中发出的，并且程序被定义为应用程序的私有资源，则私有资源的 DSECT 用于格式化数据，即使程序当前已被提升为公共程序以使应用程序入口点可用。

提供 ASSEMBLER、C®、 COBOL 和 PL/I 版本的副本。

副本的名称在每种语言中都相同。 您可以在以下库中找到它们。 请注意，在下表中， CICSTSnn 是 CICS 发行版。

有关这些副本的更多信息，请参阅 CICS 统计信息简介。

选项

APPLICATION(数据值)

指定应用程序上下文的应用程序名称元素。 应用程序名称的长度最多可以为 64 个字符。

指定应用程序上下文以返回作为平台上部署的应用程序的一部分的专用资源的统计信息。 专用资源的统计信息只能作为特定资源返回，或者作为 JVMPROGRAM ， LIBRARY ， PROGRAM 或 PROGRAMDEF 资源类型的指定资源的统计信息返回，这些资源作为专用资源受支持。 必须指定完整的应用程序上下文，包括平台名称，应用程序名称和完整的应用程序版本号。 如果在指定的应用程序上下文中找不到您在 RESID 选项上命名的专用资源，那么不会返回任何统计信息。

如果命令是从属于相关应用程序的程序发出的，那么不需要指定应用程序上下文。 缺省情况下， CICS 从发出命令的应用程序返回专用资源的统计信息，如果找不到专用资源，那么返回公用资源的统计信息。

APPLMAJORVER(数据值)

以全字二进制格式指定应用程序上下文的应用程序主版本元素。

APPLMINORVER(数据值)

以全字二进制格式指定应用程序上下文的应用程序次版本元素。

APPLMICROVER(数据值)

以全字二进制格式指定应用程序上下文的应用程序微版本元素。

LASTRESET (数据区)

返回 4 字节压缩十进制字段，给出上次重置所请求统计信息的计数器的时间。 此时间通常是上一个时间间隔到期的时间。 上一次复位时间总是按本地时间返回。

重置时间有两种格式:

• 使用 LASTRESET 选项获取的组合格式 (压缩十进制格式 0hhmmss+)。
• 通过分别指定 LASTRESETHRS ， LASTRESETMIN 和 LASTRESETSEC 选项来分隔小时，分钟和秒。

LASTRESETAB (data-area)

返回 8 字节压缩十进制字段，给出上次重置所请求统计信息的计数器的时间。 返回的值采用 ABSTIME 格式。 ABSTIME 指定自 1900 年 1 月 1 00:00 以来的毫秒数 (称为绝对时间)。

您可以使用 FORMATTIME 将数据更改为其他熟悉的格式。

data-area 的格式为:

COBOL:  PIC S9(15) COMP-3
C:      char data_area[8];
PL/I:   FIXED DEC(15)
ASM:    PL8

LASTRESETHRS (数据区)

返回全字二进制字段，给出上次重置所请求统计信息的计数器的时间的小时数部分 (请参阅 LASTRESET 选项)。

LASTRESETMIN (数据区)

返回一个全字二进制字段，给出上次重置所请求统计信息的计数器的时间的分钟部分 (请参阅 LASTRESET 选项)。

LASTRESETSEC (数据区)

返回一个全字二进制字段，给出上次重置所请求统计信息的计数器的时间的秒数部分 (请参阅 LASTRESET 选项)。

PLATFORM(数据值)

指定应用程序上下文的平台名称元素。 平台名称的长度最多可以为 64 个字符。

RESTYPE (cvda)

根据提供的 CVDA 值，请求特定资源类型的统计信息。 有效的 CVDA 值如下所示:

ASYNCSERVICE

请求异步服务域的全局统计信息。

ATOMSERVICE

ATOMSERVICE 资源的请求统计信息 ;RESID 标识特定 ATOMSERVICE 资源定义。

BUNDLE

BUNDLE 资源的请求统计信息 ;RESID 标识特定的 BUNDLE 资源定义。

DB2CONN

CICS-Db2® 连接的请求统计信息，包括池线程和命令线程的信息。

DB2ENTRY

DB2ENTRY;。

DISPATCHER

分派器域的请求统计信息。

DOCTEMPLATE

文档模板的请求统计信息 ;RESID 标识特定的 DOCTEMPLATE 资源定义。

ENQUEUE

入队请求的请求统计信息。

EPADAPTER

EPADAPTER 资源的请求统计信息 ;RESID 标识特定的 EPADAPTER 资源定义。

EVENTBINDING

特定 EVENTBINDING 资源的请求统计信息 ;RESID 标识特定 EVENTBINDING 资源定义。

事件处理

请求有关事件处理域的全局统计信息。

FILE

请求文件的统计信息。 RESID 标识特定文件定义。

IPCONN

IPCONN 资源的请求统计信息 ;RESID 标识特定的 IPCONN 资源定义。

JOURNALNAME

CICS 日志的请求统计信息。 RESID 标识特定日志。 要收集使用日记帐编号约定定义的日记帐的统计信息 (例如，对于文件资源定义中定义的自动日记帐) ，请将名称指定为 DFHJnn，其中 nn 是范围在 01 到 99 之间的日记帐编号。

注: 指定 DFHJ01 将返回写入该名称的用户日志的统计信息，而不是系统日志。

JVMPROGRAM

Java™ 程序的请求统计信息。 RESID 标识特定的 PROGRAM 资源定义。

JVMSERVER

JVMSERVER 资源的请求统计信息 ;RESID 标识特定的 JVMSERVER 资源定义。

LIBRARY

LIBRARY 资源的请求统计信息 ;RESID 标识特定的 LIBRARY 资源定义。

LSRPOOL

VSAM LSR 池上的请求统计信息 ;RESID 以全字二进制格式标识范围为 1-255 的特定池。

MONITOR

请求监视域的统计信息。 RESID 以 4 字节压缩十进制格式标识要为其返回性能类统计信息的特定任务。

MQCONN

IBM® MQ 连接的请求统计信息。

MQMONITOR

MQ 监视器的请求统计信息。 RESID 标识特定 MQ 监视器。

MVSTCB

z/OS® TCB 的请求统计信息。 RESID 标识特定 TCB 的地址。

PIPELINE

PIPELINE 资源的请求统计信息 ;RESID 标识特定的 PIPELINE 资源定义。

POLICY

与 POLICYRULE组合，请求策略规则的统计信息。 RESID 标识包含策略规则的特定 POLICY 资源定义。

注: 必须在请求中同时指定 POLICY 和 POLICYRULE ; 如果缺少任一项，那么您的请求将因 INVREQ 条件而失败。

进展

请求有关自动安装的程序定义的统计信息。

PROGRAM

非 Java 程序的请求统计信息。 RESID 标识特定程序。

PROGRAMDEF

请求有关程序定义的统计信息。 RESID 标识特定程序。

RECOVERY

请求恢复管理器域的统计信息。

SECURITY

安全域的请求统计信息。

统计

请求有关统计信息域的统计信息。

STORAGE

请求存储域的统计信息。 RESID 指定要针对特定存储域子池返回的统计信息。 ECDSA 中的CICS 子池中记录了可能的子池名称的完整列表。

子池

存储管理器域子池的请求统计信息。 RESID 指定特定的存储域子池。 ECDSA 中的CICS 子池中记录了可能的子池名称的完整列表。

STREAMNAME

CICS 日志管理器域的请求统计信息，或者如果指定了 RESID ，那么指定了特定日志流。

SYSDUMPCODE

请求有关系统转储的统计信息，或者如果指定了 RESID ，那么指定特定的系统转储代码。

任务分包

存储管理器任务子池的请求统计信息。

TCPIP

IP 套接字的请求统计信息。

TCPIPSERVICE

TCP/IP 服务的请求统计信息 ;RESID 标识特定 TCP/IP 服务。

任务分包

存储管理器任务子池的请求统计信息。

TDQUEUE

请求瞬时数据的统计信息，或者如果指定了 RESID ，那么请求特定瞬时数据队列的统计信息。

TRANCLASS

请求事务类的统计信息。 RESID 标识特定 TRANCLASS 定义。

TRANDUMPCODE

请求有关事务转储的统计信息，或者如果指定了 RESID ，那么为特定事务转储代码。

TRANSACTION

请求有关事务的统计信息，或者如果指定了 RESID ，那么请求特定事务的统计信息。

TSQUEUE

请求有关临时存储器的统计信息。

URIMAP

URIMAP 资源的请求统计信息 ;RESID 标识特定 URIMAP 资源定义。

USER

用户域的请求统计信息。

WEBSERVICE

WEBSERVICE 资源的请求统计信息 ;RESID 标识特定的 WEBSERVICE 资源定义。

XMLTRANSFORM

XMLTRANSFORM 资源的请求统计信息 ;RESID 标识特定的 XMLTRANSFORM 资源定义。

RESID (数据区)

指定要返回其统计信息的特定资源的名称。 缺少此关键字意味着要抽取全局统计信息。 RESID 是字符字段。

如果指定了 RESID ，那么将对 CICS 资源执行资源安全性检查。 因此，发出 EXTRACT STATISTICS 的用户需要对资源的 READ 访问权。

RESIDLEN (data-value)

指定 RESID 数据区的长度。 如果省略，默认值为表 1 中给出的长度。

SET (ptr-ref)

指定要设置为包含所返回统计信息的数据区的地址的指针引用。 数据区的前 2 个字节包含半字二进制格式的数据区长度。

SUBRESTYPE (cvda)

根据提供的 CVDA 值，请求特定资源类型的统计信息。 使用方法见表 1。 有效的 CVDA 值如下所示:

CAPTURESPEC

请求捕获规范的统计信息。 此 subrestype 参数是可选的。

政策规则

请求特定 POLICY 资源中包含的策略规则的统计信息。 此 subrestype 参数是必需的。 请参阅 注释。

SUBRESID (数据区)

指定要抽取统计信息的特定资源的名称。 缺少此关键字意味着将抽取指定 RESTYPE 的统计信息。 SUBRESID 是字符字段。

如果指定了 SUBRESID ，那么将对 CICS 资源执行资源安全性检查。 因此，发出 EXTRACT STATISTICS 的用户需要对资源的 READ 访问权。

SUBRESIDLEN (data-value)

指定 SUBRESID 数据区的长度。 如果省略，默认值为表 1 中给出的长度。

条件

未找到

RESP2 值：

1

已发出指定应用程序上下文的命令，但找不到指定的应用程序。

INVREQ

RESP2 值：

5

指定了无效的 RESTYPE。 表 1 列出了有效类型。

6

没有为请求的 RESTYPE 指定必需的 RESID。

8

指定了无效的 SUBRESTYPE。 表 1 列出了有效类型。

9

尚未对请求的 SUBRESTYPE 指定必需的 SUBRESID。

11

指定了无效的 RESTYPE 和 SUBRESTYPE 组合。 表 1 列出了有效类型。

IOERR

RESP2 值：

3

请求的统计信息区域未运行。 例如，如果覆盖统计信息控制块，那么会发生此问题。

LENGERR

RESP2 值：

7

为请求的 RESID 提供了无效的 RESIDLEN。

10

为请求的 SUBRESID 提供了无效的 SUBRESIDLEN。

NOTAUTH

RESP2 值：

100

未授权与发出任务关联的用户使用此命令。

101

未授权与发出任务关联的用户以此命令所需的方式访问此特定资源。

NOTFND

RESP2 值：

1

找不到请求的资源。

2

未在 CICS 系统中定义资源类型; 例如，当 FEPI 系统初始化参数指定 NO 时，如果使用 POOL 或 NODE 请求 FEPI 统计信息。

6.2 后来 3

任务的性能类数据不可用。 在初始化任务时，将关闭监视; 或者监视性能类处于不活动状态。