SET STATISTICS

更改 CICS® 统计信息的记录。

语法

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

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

SET STATISTICS

条件: INVREQ 和 NOTAUTH

NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。命令语法图和选项说明中没有明确包含这些选项。有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。

此命令是部分线程安全的。使用关键字 RECORDNOW 或 RESETNOW 将导致收集统计信息，并且某些 AP 域统计信息将强制切换到 QR TCB。

描述

您可以使用 SET STATISTICS 命令来更改用于控制 CICS 统计信息记录的值以及重置计数。

CICS 会定期记录系统和资源统计信息 (如果 RECORDS 开关处于打开状态) ，频率由 INTERVAL 选项控制。这些统计信息称为时间间隔统计信息。在日终时间 (ENDOFDAY 选项) ， CICS 记录日终统计信息，这是自上次重置以来的时间间隔的统计信息，无论开关是否开启，确保每天至少写入一次统计信息。在系统管理设施 (SMF) 数据集上进行记录，并在记录后重置计数。

初始化 CICS 时，将调整第一个时间间隔的长度，以便将整数个时间间隔保留到每天结束时间为止。如果更改记录时间间隔，那么将对当前时间间隔进行相同的调整。结束时间 (无论是否更改) 的到达将结束当前记录时间间隔。统计信息写出后，必要时再调整下一个时间间隔，使记录时间间隔将剩余时间平均划分为下一个日终时间。

注: 无论是否记录时间间隔的统计信息，都会进行这些调整。因此，如果要捕获所有统计信息，请通过将记录时间间隔设置为 24 小时来设置 SETTING ON 或让日终记录覆盖所有这些统计信息。

以下示例说明了这些规则。 I 指示时间间隔记录， E 指示日终记录。系统使用 STATRCD冷启动，该选项用于设置录音开关的初始值，设置为 ON。

此示例显示了使用 ENDOFDAY (000000) 和 INTERVALHRS (03) 初始化的 CICS 。还有对 INTERVAL (020000) 的更改和对 ENDOFDAYDAY (17) 的更改。标记为从 08 到 17 的时间刻度显示针对 9 的 I ，针对的 10,12 和 15 以及针对 17 的 E。

CICS 统计信息简介包含有关 CICS 统计信息的更多详细信息，包括将各种类型的统计信息重新初始化到的值。

可以使用此命令设置的两个时间值可以通过多种方式表示:

4 字节压缩十进制组合，格式为 0hhmmss+，使用 ENDOFDAY 或 INTERVAL 选项指定。
使用 ENDOFDAYHOURS ， ENDOFDAYMINS 和 ENDOFDAYSECS 选项 (而不是 ENDOFDAY) 以及 INTERVALHRS ， INTERVALMINS 和 INTERVALSECS (而不是 INTERVAL) 来指定单独的小时，分钟和秒。您可以单独或以任何组合方式使用这些选项。

例如，您可以通过以下任何方式表示 INTERVAL 为 1 小时 30 分钟:

INTERVAL (13000)
INTERVALHRS (1) ， INTERVALMINS (30)
INTERVALMINS (90)
INTERVALSECS (5400)

选项

ENDOFDAY (data-value)

以格式 0hhmmss+指定 4 字节压缩十进制字段的结束时间。

日终时间以当地时间表示，必须在 00:00:00-23:59:59 范围内。当您使用 ENDOFDAY 选项或多个单独的日终选项时，分钟和秒部分各不能超过 59。如果仅使用 ENDOFDAYMINS ，那么限制为 1439。如果单独使用 ENDOFDAYSECS ，那么限制为 86399。

ENDOFDAY小时 (data-value)

以全字二进制格式指定日终时间的小时数部分。 (请参阅 ENDOFDAY 选项。)

ENDOFDAYMINS (data-value)

以全字二进制格式指定日终时间的分钟数部分。 (请参阅 ENDOFDAY 选项。)

ENDOFDAYSECS (data-value)

以全字二进制格式指定日终时间的秒数部分。 (请参阅 ENDOFDAY 选项。)

INTERVAL (data-value)

指定系统统计信息的记录时间间隔，格式为 0hhmmss+的 4 字节压缩十进制字段。时间间隔必须至少为 1 分钟且不超过 24 小时。当您使用 INTERVAL 选项或多个单独的时间间隔选项时，每个时间的分钟和秒部分不得超过 59。如果仅使用 INTERVALMINS ，那么范围为 1-1440。如果仅使用 INTERVALSECS ，那么范围为 60-86400。

INTERVALHRS (data-value)

以全字二进制格式指定记录时间间隔的小时数部分。 (请参阅 INTERVAL 选项。)

INTERVALMINS (data-value)

以全字二进制格式指定记录时间间隔的分钟数部分。 (请参阅 INTERVAL 选项。)

INTERVALSECS (data-value)

以全字二进制格式指定记录时间间隔的秒数部分。 (请参阅 INTERVAL 选项。)

记录 (cvda)

指定是否记录时间间隔统计信息。将始终记录每日结束统计信息，请求的统计信息和非请求的统计信息，而不考虑录音选项的设置。 (统计信息始终是累积的，并且每天结束，未请求和请求的统计信息始终会被记录，而不考虑录音选项的设置。未请求的统计信息是废弃资源时记录的资源统计信息。请求的统计信息是由 PERFORM STATISTICS RECORD 命令或 CEMT PERFORM STATISTICS 事务调用的统计信息。)

CVDA 值包括：

OFF: 不记录时间间隔统计信息。
ON: 记录时间间隔统计信息。

记录 NOW

指定立即写出当前统计信息。效果与 PERFORM STATISTICS RECORD ALL 命令相同，并且与该命令一样，除非同时指定 RESETNOW ，否则不会重置计数。仅当 RECORD 状态从 ON 更改为 OFF 或从 OFF 更改为 ON 时，才能指定 RECORDNOW。

重置

指定将统计信息计数器重置为其初始值。给定计数器的初始值取决于要收集的统计信息类型; 请参阅 DSECTS 和 DFHSTUP 报告中的 CICS 统计信息以获取特定信息。仅当 "记录" 状态从 "开启" 更改为 "关闭" 或从 "关闭" 更改为 "开启" 时，才能请求重置。

条件

INVREQ

RESP2 值：

1: INTERVAL 值超出范围。
2: ENDOFDAY 值超出范围。
3: 记录具有无效的 CVDA 值。
4: INTERVALHRS 值超出范围。
5: InterVALMINS 值超出范围。
6: InterVALSECS 值超出范围。
7: 已使用多个时间间隔值，并且该组合超过 24 小时或小于 1 分钟。
8: ENDOFDAYDAY 值超出范围。
9: ENDOFDAYMINS 值超出范围。
10: ENDOFDAYSECS 值超出范围。
11: 已指定 RESETNOW 或 RECORDNOW ，但未更改 RECORD 值。

NOTAUTH

RESP2 值：

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