SET MONITOR

更改 CICS® 监视选项。

语法

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

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

SET MONITOR

条件: INVREQ 和 NOTAUTH

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

此命令是线程安全的。

描述

使用 SET MONITOR 命令可打开或关闭 CICS 监视，修改监视选项的设置以及选择要记录的监视数据类。

CICS 监视由主开关 (STATUS 选项) 控制。仅当 STATUS 选项的值为 ON 时，才会累积监视数据，并且仅当 STATUS 为 ON 时开始的任务才会累积监视数据。

当监视处于活动状态时， CICS 会针对每个任务累积以下类型的数据:

性能数据 (例如， CICS 命令和计时的类型和计数)
异常数据 (例如，等待 VSAM 字符串)
事务资源数据 (各种文件获取，放置，浏览，添加和删除访问权的计数和计时以及总计)
身份类数据 (具有身份传播数据的事务的计数，计时和标识)

其他交换机确定将这些监视数据类中的哪些类写入 SMF 数据集。仅当 EXCEPTCLASS 为 EXCEPT 时，才会写入异常数据; 仅当 RESRCECLASS 为 RESRCE 时，才会写入事务资源数据; 仅当 IDNTYCLASS 为 IDNTY 时，才会写入身份类数据; 仅当 PERFCLASS 为 PERF 时，才会写入性能数据。对于单个任务，仅当在任务启动时和写出数据类时都开启了类开关时，才会记录类数据。

异常类数据在应用异常的事件结束时写入。性能类数据是在以下特定时间写入的:

任务结束时
在终端接收等待时，如果 CONVERSEST 值为 CONVERSE
在频率区间，如果区间不为零
在同步点，如果 SYNCPOINTST 值为 SYNCPOINT
在具有拯救者选项的用户事件监视点

仅在任务结束时写入身份类和事务资源类数据。

如果将 STATUS 从 ON 更改为 OFF ，那么 CICS 将停止累积和记录监视数据。即使在任务结束前重新开启监视，也会丢失未记录的飞行中任务的数据。

此外，如果要记录性能数据，请在设置 "关闭" 监视的任何命令中指定 NOPERF ，以确保清空包含已完成任务的已记录数据的缓冲区; 否则，可能会丢失其中部分数据。

但是，如果将 STATUS 保留为 on ，但将其中一个记录选项关闭，然后在任务期间重新开启，那么数据丢失取决于类，如下所示:

对于在 EXCEPTCLASS 为 NOEXCEPT 时发生的异常，不会写出异常数据，但是，如果更改回 EXCEPT ，将记录后续异常。
如果在运行任务时将 PERFCLASS 从 PERF 更改为 NOPERF ，那么将记录已累积的性能数据，但随后记录将停止。但是，积累仍在继续。因此，如果在任务结束之前更改回 PERF ，那么除非在 NOPERF 生效时出现具有拯救者选项的监视点，否则不会丢失任何数据。 (拯救者会重置计数器。) 通常导致写入的其他情况， SYNCPOINTST 值为 SYNCPOINT 的同步点， CONVERSEST 值为 SYNCPOINT 的终端接收等待或频率时间间隔到期的情况，都不会在记录关闭时重置计数，因此不会丢失计数，尽管它们可能组合在一起。
事务资源类和身份类数据是在任务结束时写入的，仅当在任务结束时设置了监视类 (对于事务资源类设置为 RESRCE ，对于身份类设置为 IDNTY) 时才会写入这些数据。

选项

COMPRESSST (cvda)

指定是否要对 CICS 监视设施生成的 CICS SMF 110 监视记录执行数据压缩。如果更改数据压缩选项的设置，那么新设置将应用于从该点开始写入的所有监视记录，即使这些记录用于在进行更改时正在处理的任务也是如此。新设置还适用于缓冲区中在进行更改时等待写入 SMF 的任何记录。此更改仅在 CICS 重新启动之前适用。

COMPRESS: CICS 将对监视记录执行数据压缩。在某些情况下，某些记录可能不会被压缩。数据压缩是缺省值。
NOCOMPRESS: CICS 不会对监视记录执行数据压缩。

CONVERSEST (cvda)

指定 CICS 如何记录会话式任务 (等待终端或会话输入的任务) 的性能数据。

CONVERSE: CICS 将在每次任务等待终端输入时以及在任务结束时生成性能类记录，表示自上次等待或任务启动以来任务的部分。在执行 CONVERSE 命令或 SEND 之后的 RECEIVE 命令期间发生等待。
NOCONVERSE: CICS 将在终端等待中累积性能数据，并生成单个性能类记录。

DPLLIMIT (data-value)

指定 CICS 要对其执行事务资源监视的分布式程序链接请求的最大数目 (作为半字二进制值)。指定的值必须在范围 0-64 内。

EXCEPTCLASS (cvda)

指定当监视处于活动状态时是否记录监视数据的异常类。 CVDA 值如下：

except: 将记录异常数据。
不适用: 不记录异常数据。

FILELIMIT (data-value)

指定 CICS 要对其执行事务资源监视的最大文件数 (作为半字二进制值)。指定的值必须在范围 0-64 内。

FREQUENCY (data-value)

指定 CICS 为长时间运行的任务生成性能类记录的时间间隔。如果任务的运行时间比时间间隔频率长，CICS 会为每个时间间隔或其一部分单独记录性能数据。仅当长时间运行的事务在 QR 或 CO TCB 上运行时， CICS 才能以此方式生成性能类监视记录。

频率区间可以用几种方式表示:

4 字节压缩十进制组合，格式为 0hhmmss+，使用 FREQUENCY 选项。
使用频率为小时，分钟和秒，使用频率为小时，频率为分钟和频率为小时，频率为分钟和 FREQUENCYSEC 选项。您可以单独或以任何组合方式使用这些选项。

无论您使用哪种方法，时间间隔值都必须为零或在 1 分钟到 24 小时的范围内。零指定 CICS 仅在任务结束时生成性能记录，而不考虑任务的长度。

此外，如果使用 FREQUENCY 或多个单独的选项，那么该值的分钟和秒部分不得大于 59。单独使用的 FREQUENCYMIN 或 FREQUENCYSEC 选项可以超过 59 个。例如，您可以通过以下任何方式来表示 1 小时 30 分钟的时间间隔:

频率 (13000)
光顾小时 (1) ， FREQUENCYMIN (30)
FREQUENCYMIN (90)
FREQUENCYSEC (5400)

频率 (data-value)

以全字二进制格式指定频率区间的小时数部分。请参阅 FREQUENCY 选项。

FREQUENCYMIN (data-value)

以全字二进制格式指定频率时间间隔的分钟数部分。请参阅 FREQUENCY 选项。

FREQUENCYSEC (data-value)

以全字二进制格式指定频率间隔的秒数部分。请参阅 FREQUENCY 选项。

IDNTYCLASS (cvda)

指定在监视处于活动状态时是否记录监视数据的身份类。 CVDA 值如下：

IDNTY: 将记录身份数据。
NOIDNTY: 不记录身份数据。

PERFCLASS (cvda)

指定当监视处于活动状态时是否记录监视数据的性能类。 CVDA 值如下：

NOPERF: 不记录性能数据。
PERF: 将记录性能数据。

RESRCECLASS (cvda)

指定 CICS 事务资源监视是处于活动状态还是处于不活动状态。 CVDA 值如下：

NORESRCE: CICS 不执行事务资源监视。不会累积任何事务资源数据或将任何事务资源数据写入 SMF。
重新认证: CICS 将执行事务资源监视。将针对 MCT 中指定的资源 (例如， CICS 文件) 累积数据并将其写入 SMF。

状态 (cvda)

指定 CICS 监视是处于活动状态还是处于禁用状态。 CVDA 值如下：

OFF: 不进行监视。无论监视数据类的设置如何，都不会累积或写出任何数据。
ON: 监视将处于活动状态。针对所有监视数据类累积数据，并针对那些处于活动状态的类写出数据。

SYNCPOINTST (cvda)

指定 CICS 是否为包含多个 UOW 的任务中的每个工作单元 (UOW) 单独记录性能类数据。当发生同步点 (显式 (SYNCPOINT 命令) 或隐式 (例如 DL/I TERM 调用或任务结束)) 时，任务中的 UOW 会结束; 新的 UOW 会立即开始，但任务结束时除外。在同步点上发生回滚时， UOW 不会结束。 CVDA 值如下：

原点: 将在任务中的所有 UOW 上组合性能数据。
SYNCPOINT: 将为每个 UOW 单独记录性能数据。

TSQUEUELIMIT (data-value)

指定 CICS 要对其执行事务资源监视的临时存储器队列的最大数目 (作为半字二进制值)。指定的值必须在范围 0-64 内。

URIMAPLIMIT (data-value)

指定 CICS 要对其执行事务资源监视的 WEB OPEN URIMAP 命令上指定的最大 URIMAP 数。指定的值必须在范围 0-64 内。

WEBSERVLIMIT (data-value)

指定 CICS 要对其执行事务资源监视的 INVOKE SERVICE 命令上指定的最大 WEBSERVICEs 数。指定的值必须在范围 0-64 内。

条件

INVREQ

RESP2 值：

1: STATUS 具有无效的 CVDA 值。
2: PERFCLASS 具有无效的 CVDA 值。
3: EXCEPTCLASS 具有无效的 CVDA 值。
5: CONVERSEST 具有无效的 CVDA 值。
6: SYNCPOINTST 具有无效的 CVDA 值。
7: FREQUENCY 值无效。 (小时数超过 24 ，分钟或秒超过 59 ，或总值超出范围。)
8: OURENCY小时值超出范围。
9: FREQUENCYMIN 值超出范围。
10: FREQUENCYSEC 值超出范围。
11: COMPRESSST 具有无效的 CVDA 值。
12: FILELIMIT 值超出范围。
13: DPLLIMIT 值超出范围。
14: TSQUEUELIMIT 值超出范围。
15: URIMAPLIMIT 值超出范围。
16: WEBSERVLIMIT 值超出范围。

NOTAUTH

INVREQ

RESP2 值：

15: IDNTYCLASS 具有无效的 CVDA 值。
100: 未授权与发出任务关联的用户使用此命令。