INQUIRE MONITOR
检索 CICS® 监视的状态。
语法
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: NOTAUTH
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
此命令是线程安全的。
描述
使用 INQUIRE MONITOR 命令可了解 CICS 监视是否处于活动状态，正在记录哪些类型的数据以及其他记录选项。
CICS 监视由一个主开关 (STATUS 选项) 和四个控制所记录数据类型的开关 (EXCEPTCLASS ， PERFCLASS ， RESRCECLASS 和 IDNTYCLASS 选项) 控制。 请参阅 SET MONITOR 命令，了解监控器数据类别的描述以及开关如何交互的详细信息。
选项
- APPLNAMEST (cvda)
- 返回 CVDA 值，指示是否启用 CICS 应用程序命名支持。 CVDA 值如下：
- APPLNAME
- 已启用 CICS 应用程序命名支持。
- 无应用名称
- 未启用 CICS 应用程序命名支持。
- COMPRESSST (cvda)
- 返回一个 CVDA 值，指示对于 CICS 监视设施生成的 CICS SMF 110 监视记录，数据压缩是否处于活动状态。 CVDA 值如下：
- COMPRESS
- 正在对监视记录执行数据压缩。 数据压缩是缺省值。
- NOCOMPRESS
- 未对监视记录执行数据压缩。
- CONVERSEST (cvda)
- 返回 CVDA 值，指示 CICS 如何记录会话式任务 (等待终端或会话输入的任务) 的性能数据。 CVDA 值如下：
- CONVERSE
- CICS 在每次等待终端输入时以及在任务结束时，都会为会话式任务生成性能类记录，表示自上次终端等待或任务启动以来的任务部分。 在执行 CONVERSE 命令或 SEND 之后的 RECEIVE 命令期间，会发生这些等待。
- NOCONVERSE
- CICS 在终端等待中累积性能数据，并为会话式任务生成单个性能类记录。
- DPLLIMIT (数据区)
- 返回 CICS 要对其执行事务资源监视的分布式程序链接请求的最大数目。
- EXCEPTCLASS (cvda)
- 返回 CVDA 值，指示监视处于活动状态时是否记录监视数据的异常类。 CVDA 值如下：
- except
- 记录异常数据。
- 不适用
- 未记录异常数据。
- FILELIMIT (数据区)
- 返回 CICS 要对其执行事务资源监视的最大文件数。
- FREQUENCY (数据区)
- 返回 CICS 为长时间运行的任务生成性能类记录的时间间隔。 如果任务运行时间大于频率的时间间隔，那么 CICS 会分别针对每个时间间隔或时间片段记录其性能数据。频率区间有两种格式:
- 使用 FREQUENCY 选项获取的组合 (压缩十进制格式 0hhmmss+，长度为 4 字节)。
- 通过指定频率值，频率值和 FREQUENCYSEC 选项来获取单独的小时，分钟和秒。
- 频率为小时 (data-area)
- 以全字二进制格式返回频率区间的小时数部分。 请参阅 FREQUENCY 选项。
- FREQUENCYMIN (数据区域)
- 以全字二进制格式返回频率区间的分钟数部分。 请参阅 FREQUENCY 选项。
- FREQUENCYSEC (数据区)
- 以全字二进制格式返回频率区间的秒数部分。 请参阅 FREQUENCY 选项。
- IDNTYCLASS (cvda)
- 返回 CVDA 值，指示监视处于活动状态时是否记录监视数据的身份类。 CVDA 值如下：
- IDNTY
- 将记录身份数据。
- NOIDNTY
- 未记录身份数据。
- PERFCLASS (cvda)
- 返回 CVDA 值，指示监视处于活动状态时是否记录监视数据的性能类。 CVDA 值如下：
- NOPERF
- 未记录性能数据。
- PERF
- 记录性能数据。
- RESRCECLASS (cvda)
- 返回 CVDA 值，指示事务资源监视在 CICS 区域中是否处于活动状态。 CVDA 值如下：
- NORESRCE
- 事务资源监视未处于活动状态。
- 重新认证
- 事务资源监视处于活动状态。
- RMIST (cvda)
- 返回一个 CVDA 值，指示对于事务所使用的资源管理器，其他性能监视是否处于活动状态。 CVDA 值如下：
- RMI
- 对于事务所使用的资源管理器，性能监视处于活动状态。
- 诺尔米
- 对于事务所使用的资源管理器，性能监视处于不活动状态。
- 状态 (cvda)
- 返回一个 CVDA 值，用于标识 CICS 监视在区域中是否处于活动状态。 CVDA 值如下：
- OFF
- CICS 监视在区域中处于不活动状态。 无论监视数据类的设置如何，都不会累积或写出任何监视数据。
- ON
- CICS 监视处于活动状态。 针对所有监视数据类累积数据，并针对那些处于活动状态的类写出数据。
- SYNCPOINTST (cvda)
- 返回 CVDA 值，指示 CICS 是否在包含多个 UOW 的任务中单独记录每个工作单元 (UOW) 的性能类数据。 当出现同步点 (显式 (SYNCPOINT 命令) 或隐式 (例如 DL/I TERM 调用或任务结束)) 时，任务中的 UOW 结束。 新 UOW 将紧接着开始，但任务结束时除外。 在同步点上发生回滚时， UOW 不会结束。 CVDA 值如下：
- 原点
- 性能数据将组合到任务中的所有 UOW 以进行记录。
- SYNCPOINT
- 针对每个 UOW 单独记录性能数据。
- 时间 (cvda)
- 返回 CVDA 值，该值标识使用 COLLECT STATISTICS MONITOR 命令返回到应用程序的性能类时间戳记字段是否以本地或格林威治标准时间表示。 此选项的值不会影响其他监视数据类。 有关 SMF 头的信息，请参阅 SMF 头和 SMF 产品部分 。 CVDA 值如下：
- GMT
- 时间戳记是格林威治标准时间。
- LOCAL
- 时间戳记是本地时间。
- TSQUEUELIMIT (data-area)
- 返回 CICS 要对其执行事务资源监视的最大临时存储器队列数。
- URIMAPLIMIT (数据区)
- 返回 CICS 要对其执行事务资源监视的 WEB OPEN URIMAP 命令上指定的最大 URIMAP 数。
- WEBSERVLIMIT (data-area)
- 返回在 CICS 要对其执行事务资源监视的 INVOKE SERVICE 命令上指定的最大 WEBSERVICEs 数。
条件
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。