执行统计信息记录

立即记录统计信息。

语法

警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。

执行统计信息记录

读取语法图跳过可视语法图PERFORM STATISTICS RECORDALLRESETNOWASYNCSERVICEATOMSERVICEAUTOINSTALLBUNDLECAPTURESPECCIPHERCONNECTIONDB2 DISPATCHER DOCTEMPLATEENQUEUEEPADAPTEREVENTBINDINGEVENTPROCESSFEPIFILEIPCONNJOURNALNAMEJOURNALNUMJVMPROGRAMJVMSERVERLIBRARYLSRPOOLMONITOR MQCONN MQMONITORNODEJSAPPPIPELINEPOLICYPROGAUTOPROGRAMPROGRAMDEFRECOVERY SECURITYSTATSSTORAGESTREAMNAMESYSDUMPTABLEMGRTCPIPTCPIPSERVICETDQUEUETERMINALTRANCLASSTCLASSTRANDUMPTRANSACTION TSQUEUEURIMAPUSERVTAMWEBSERVICEXMLTRANSFORM

条件: IOERR , NOTAUTH 和 NOTFND

NOHANDLERESPRESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.

描述

PERFORM STATISTICS RECORD 命令将记录您指定的资源类型和系统功能的当前统计信息 (写出到 SMF 数据集)。 记录会立即发生,并且不受控制这些统计信息的记录的系统选项的控制。 (请参阅 SET 统计中有关区间统计的讨论)。

除非指定 RESETNOW,否则此命令的执行也不会影响时间间隔或日终统计信息,因为除非指定 RESETNOW ,否则不会重置计数。

您可以根据需要指定任意数量的统计信息类型,也可以请求全部 ( ALL 选项)。 对于您请求的每种类型, CICS 提供所有可用信息 (记录在时间间隔统计信息中的信息)。 对于系统服务 (例如,分派和动态事务回退) , CICS 会保留摘要 (全局) 统计信息。 对于资源类型, CICS 保留所讨论类型的每个已安装资源的特定或资源统计信息,对于某些资源类型, CICS 也保留全局计数。

对于支持作为平台上部署的应用程序的专用资源的资源类型,将针对公共资源和专用资源编写单独的统计信息记录,每个记录都由不同的 DSECT 映射。

使用 EXEC CICS PERFORM STATISTICS RECORD 命令编写资源统计信息时,请使用相同的资源类型关键字,无论该资源是公共资源还是专用资源。 如果资源是公共资源,那么将使用公共 DSECT 来映射其数据,如果资源是专用资源,那么将使用专用 DSECT 来映射其数据。

声明为应用程序入口点的程序由 DSECT 中用于公共和专用程序定义 (PROGRAMDEF 统计信息关键字) 和 JVM 程序 (JVMPROGRAM 关键字) 的字段标识。 为声明为应用程序入口点的程序定义或 JVM 程序生成时间间隔统计信息,日终统计信息,请求的统计信息,请求的重置统计信息或非请求的统计信息时,将写入两个统计信息记录,一个由公共资源的 DSECT 映射,另一个由专用资源的 DSECT 映射。 对于装入程序域 (PROGRAM 关键字) 生成的程序统计信息,未标识应用程序入口点,仅写入一个专用程序统计信息记录。

有关 CICS 统计信息的更多信息,请参阅 CICS 统计信息简介

选项

ALL
记录所有资源类型和系统服务的统计信息。 这是针对时间间隔统计信息记录的相同信息,并且包含来自用户域的计数,这些计数在其他情况下不可用于此命令。
ASYNCSERVICE
记录异步服务的全局统计信息。
ATOMSERVICE
记录安装在 CICS 区域中的所有 ATOMSERVICE 资源的特定统计信息。
自动安装
记录自动安装终端定义的全局统计信息。
BUNDLE
记录安装在 CICS 区域中的所有 BUNDLE 资源的特定统计信息。
CAPTURESPEC
记录安装在 CICS 区域中的所有捕获规范的特定统计信息。
密码
记录在 CICS 区域的握手中使用的密码的特定统计信息。
CONNECTION
记录 CICS 区域中安装的所有基于 SNA 和 MRO 连接的 ISC 的特定统计信息。
DB2
记录 CICS Db2® 连接的全局统计信息以及 CICS 区域中定义的每个 DB2ENTRY 的特定统计信息。
DISPATCHER
记录有关分派功能的全局统计信息,包括任务计数以及并行级别和限制。
DOCTEMPLATE
记录安装在 CICS 区域中的每个文档模板的特定统计信息。
ENQUEUE
记录入队管理器的全局统计信息。
EPADAPTER
记录 CICS 区域中安装的所有 EPADAPTER 资源的特定统计信息。
EVENTBINDING
记录 CICS 区域中安装的所有 EVENTBINDING 资源的特定统计信息。
事件处理
记录事件处理的全局统计信息。
FEPI
记录有关前端编程接口 (FEPI) 的全局统计信息以及有关 FEPI 连接,目标和池的特定统计信息。
FILE
记录 CICS 区域中安装的所有文件的特定统计信息。
IPCONN
记录 CICS 区域中安装的所有 IPIC 连接的特定统计信息。
JOURNALNAME
记录 CICS 区域中安装的所有日志的特定统计信息。 此参数替换 JOURNALNUM 参数。 要记录 CICS 区域中安装的所有日志的特定统计信息,建议您使用此参数。
JOURNALNUM
记录 JOURNALNAME 参数返回的特定统计信息。
JVMPROGRAM
记录在 JVM 中运行的 CICS 区域中所有公共和私有 Java™ 程序的特定统计数据。
JVMSERVER
记录所有 JVMSERVER 资源的特定统计信息。
LIBRARY
记录所有公共和私人图书馆资源的具体统计数据。
LSRPOOL
记录 CICS 区域中定义的所有 VSAM LSR 池的特定统计信息,包括池中除 FILE 选项生成的统计信息之外的文件的统计信息。
MONITOR
记录有关 CICS的监视功能的全局统计信息。
MQCONN
记录 IBM® MQ 连接的全局统计数据。
MQMONITOR
记录安装在 CICS 区域的所有 MQ 监控程序的统计信息。
NODEJSAPP
记录 CICS 区域中安装的所有 NODEJSAPP 资源的特定统计信息。
PIPELINE
记录与已安装的管道相关的统计信息。
POLICY
记录安装在 CICS 区域中的所有策略规则资源的特定统计信息。
进展
记录有关自动安装程序定义的全局统计信息。
PROGRAM
记录安装在CICS区域中的所有公共和私有程序的全局和特定统计信息,在 JVM 中运行的 Java 程序除外(可以使用 JVMPROGRAM 选项)。
PROGRAMDEF
记录公共和私营计划定义统计数据。
RECOVERY
记录有关恢复管理器的全局统计信息。
重置
记录后将所有统计信息重置为初始值。 只能将此选项与 ALL 选项结合使用。 初始值的定义取决于保留的统计信息; 有关更多信息,请参阅 DSECTS 和 DFHSTUP 报告中的 CICS 统计信息
SECURITY
记录安全域上的全局统计信息。
统计
记录有关 CICS的统计信息收集功能的全局统计信息。
STORAGE
记录所有 CICS 动态存储子池区域的全局统计信息,以及按子池列出的特定统计信息。
STREAMNAME
记录日志管理器上的全局统计信息以及当前连接的所有日志流的特定统计信息。
SYSDUMP
记录系统转储的全局统计信息以及系统转储代码表中每个转储代码的特定统计信息。
表 MGR
在 CICS 表管理器上记录全局统计信息。
TCLASS
记录 CICS 区域中定义的每个事务类的特定统计信息。 此选项与 TRANCLASS 具有相同的作用,保留此选项只是为了与较旧版本的 CICS 兼容; 请尽可能使用 TRANCLASS。
TCPIP
记录有关 IP 套接字的全局统计信息。
TCPIPSERVICE
记录安装在 CICS 区域中的每个 TCP/IP 服务的特定统计信息。
TDQUEUE
记录瞬时数据的全局统计信息以及在 CICS 区域中定义的每个队列的特定统计信息。
TERMINAL
记录安装在 CICS 区域中的每个终端和会话的特定统计信息。
TRANCLASS
记录 CICS 区域中定义的每个事务类的特定统计信息。
TRANDUMP
记录有关事务转储的全局统计信息以及事务转储表中每个转储代码的特定统计信息。
TRANSACTION
记录有关事务的全局统计信息以及系统中安装的每个事务的特定统计信息。
TSQUEUE
记录临时存储器的全局统计信息。
URIMAP
记录与 URIMAP 资源相关的统计信息。
USER
记录用户域上的全局统计信息。
VTAM(现为z/OS® Communications Server)
记录 CICS 区域的全局 z/OS Communications Server 统计信息。 VTAM® 是 z/OS Communications Server的前身。
WEBSERVICE
记录与 WEBSERVICE 资源相关的统计信息。
XMLTRANSFORM
记录与 XMLTRANSFORM 资源相关的统计信息。

条件

IOERR
RESP2 值:
n
至少一个所选选项的统计信息不可用; 发生此错误的原因通常是在其中累积这些选项的内存损坏。 有关更多信息,请参阅 不可用统计信息
NOTAUTH
RESP2 值:
100
未授权与发出任务关联的用户使用此命令。
NOTFND
RESP2 值:
n
至少有一个所选选项的统计信息不可用,因为虽然资源类型有效,但 CICS 已初始化而不支持该功能。 有关更多信息,请参阅 不可用统计信息

不可用统计信息

当统计信息不可用于您请求的资源类型时, CICS 会返回相应的响应,如下所示:
  • 如果统计信息由于错误而不可用,那么 CICS 将返回 IOERR 异常情况。 通常,此错误的原因是在其中累积了统计信息的内存损坏。
  • 如果您请求的资源类型有效,但 CICS 已初始化而不支持该功能,那么 CICS 将返回 NOTFND 异常条件。
  • 如果请求的资源类型已过时,那么 CICS 将返回正常响应,但不会尝试记录该资源类型的任何统计信息。
如果请求了其他资源类型的统计信息,那么 CICS 将继续处理其余类型,记录尽可能多的可用信息。 当 CICS 返回 IOERR 或 NOTFND 异常条件时, RESP2 值 n 将标识以该方式失败的最后一个资源类型,如下所示:
n 资源类型
1 自动安装
2 CONNECTION
3 DISPATCHER
6 FILE
8 JOURNALNUM 和 JOURNALNAME
10 LSRPOOL
11 MONITOR
12 PROGRAM
13 统计
14 STORAGE
15 SYSDUMP
16 表 MGR
18 TCLASS 和 TRANCLASS
19 TDQUEUE
20 TERMINAL
21 TRANDUMP
22 TRANSACTION
23 TSQUEUE
24 VTAM
25 FEPI
26 日 进展
27 NODEJSAPP
28 日 ENQUEUE
29 日 RECOVERY
30 STREAMNAME
31 日 DB2
32 TCPIPSERVICE
33 TCPIP
39 JVMPROGRAM
40 MQCONN
41 URIMAP
42 WEBSERVICE
43 PIPELINE
44 DOCTEMPLATE
45 IPCONN
46 LIBRARY
47 PROGRAMDEF
48 BUNDLE
49 ATOMSERVICE
50 EVENTBINDING
51 事件处理
52 JVMSERVER
53 XMLTRANSFORM
54 CAPTURESPEC
55 EPADAPTER
56 POLICY
57 MQMONITOR
58 ASYNCSERVICE
59 USER
60 SECURITY
61 密码