INQUIRE SYSTEM

描述

INQUIRE SYSTEM 命令返回有关发出该命令的任务正在其中运行的 CICS 系统的信息。

此命令中的许多选项对应于系统初始化参数，并从参数中获取其初始值。 某些选项可由后续的 SET SYSTEM 命令或其 CEMT 等效项进行更改。 其他选项返回有关 CICS 或 MVS™ 发行版级别的信息，其他选项返回仅由系统的当前状态确定的信息。 表 1 指示选项值的来源，对于在系统初始化参数中指定的选项，指示参数的名称。

选项

ACTOPENTCBS (数据区)

返回一个全字二进制字段，给出当前分配给用户任务的打开 TCB 数。 CICS 分派器维护 L8 和 L9 方式 TCB 的池，供 OPENAPI 应用程序和通过 OPENAPI 选项启用的与任务相关的用户出口使用。 与任务相关的用户出口仅使用 L8 方式 TCB; 例如，连接到 DB2时的 CICS DB2® 适配器。 ACTOPENTCBS 值可以等于或小于 MAXOPENTCBS 值。 如果该值等于 MAXOPENTCBS ，那么将执行需要开放式 TCB 的任务以等待。

AKP (数据区)

返回一个全字二进制字段，给出活动关键点触发值，即在获取关键点之间对 CICS 系统日志流输出缓冲区的写请求数。

值减 1 (不适用) 表示不采用密钥点。

CDSASIZE (数据区)

以全字二进制格式返回 CICS 动态存储区 (CDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 DSALIMIT 值内自动计算和管理，即驻留在 16 MB 以下 (低于界线) 的动态存储区的总体限制。

CICSSTATUS (cvda)

返回用于标识 CICS当前执行状态的 CVDA 值:

ACTIVE

CICS 完全处于活动状态。

详细信息

CICS 处于关闭的最终停顿阶段。 要关闭的程序列表 (PLTSD) 的第二阶段中的程序在此阶段中运行。

FIRSTQUIESCE

CICS 处于关闭的第一个停顿阶段。 PLTSD 的第一阶段中的程序在此阶段中运行。

STARTUP

CICS 正在启动，但尚未完全处于活动状态。 程序列表中用于程序启动的程序 (PLTPI) 将在启动期间运行。 请参阅 INITSTATUS 选项以获取更多信息。

CICSSYS (数据区)

返回 1 字符值，用于标识已为其构建运行中的 CICS 系统的操作系统。 值 "X" 表示 MVS。

CICSTSLEVEL (数据区域)

返回 6 字符值，用于标识运行 CICS 区域的 CICS Transaction Server for z/OS 产品的版本，发行版和修改级别。 该值的格式为 弗尔姆， z/OS 的 CICS 事务服务器, V 5 发行版 4 返回 050400。

CMDPROTECT (cvda)

返回指示命令保护是否处于活动状态的 CVDA 值。 当任务发出命令和命令保护处于活动状态时， CICS 会验证该任务是否对 CICS 要返回信息的每个区域的第一个字节具有写访问权。 如果任何区域测试失败，那么将发生 AEYD 异常终止。

CVDA 值如下所示：

CMDPROT

命令保护处于活动状态。

NOCMDPROT

命令保护未处于活动状态。

COLDSTATUS (cvda)

返回一个 CVDA 值，该值指示 CICS 是执行冷启动还是初始启动。

CVDA 值如下所示：

COLD

CICS 执行了冷启动。 已擦除有关本地资源的日志信息，但保留了有关允许远程系统或与 RMI 连接的资源管理器再同步其资源所需的本地工作单元结果的信息。

初始

CICS 执行了初始启动。 已擦除有关本地资源和远程资源的所有日志信息。

NOTAPPLIC

CICS 既未执行冷启动，也未执行初始启动。

DB2CONN (data-area)

返回当前为 CICS 区域安装的 DB2CONN 资源定义的 1-8 字符名称，如果当前未安装任何 DB2CONN 定义，那么返回空白。 一次只能安装一个 DB2CONN 定义。 DB2CONN 资源定义指定 CICS 与 DB2之间的连接的属性。

DEBUGTOOL (cvda)

返回一个 CVDA 值，该值指示您是否可以使用调试概要文件来选择将在调试工具控制下运行的程序。 下列调试工具使用调试概要文件：

• Debug Tool ，用于已编译的语言应用程序 (以 COBOL ， PL/I ， C ， C++ 和汇编程序编写的程序)
• 远程调试工具（用于编译型语言应用程序和 Java™ 程序）

其他调试机制 (例如 CICS 执行诊断设施 (CEDF)) 不使用调试概要文件。 CVDA 值如下所示：

DEBUG

您可以使用 CICS 调试概要文件来选择将在调试工具控制下运行的程序。

节点 BUG

不能使用 CICS 调试概要文件来选择将在调试器工具控制下运行的程序。

有关使用调试概要文件的更多信息，请参阅 调试概要文件。

DFLTUSER (data-area)

返回此 CICS 区域的缺省用户的 8 字符标识。

DSALIMIT (数据区)

返回一个全字二进制字段，提供最大存储量 (以字节为单位) ， CICS 可以在此存储量内为驻留在 16 MB 以下 (低于该行) 的四个单独动态存储区动态分配存储量。 请参阅此命令的 CDSASIZE ， RDSASIZE ， SDSASIZE 和 UDSASIZE 选项。

DSRTPROGRAM (数据区)

返回分布式路由程序的 8 字符名称。

DTRPROGRAM (数据区)

返回动态路由程序的 8 字符名称。

正在转储 (cvda)

返回一个 CVDA 值，该值指示是否禁止执行 CICS 系统转储:

无系统转储

禁止系统转储。

SYSDUMP

不禁止系统转储。

这些值由系统初始化参数 DUMP=YES 或 NO 设置。

ECDSASIZE (数据区)

以全字二进制格式返回扩展 CICS 动态存储区 (ECDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理，即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。

EDSALIMIT (数据区)

返回一个全字二进制字段，其中提供最大存储量 (以字节为单位) ， CICS 可以在此存储量内为位于 16 MB 以上但 2 GB 以下 (行上方) 的各个动态存储区动态分配存储器。 请参阅此命令的 ECDSASIZE ， ERDSASIZE ， ESDSASIZE 和 EUDSASIZE 选项。

ERDSASIZE (数据区)

以全字二进制格式返回扩展只读动态存储区 (ERDSA) 的当前大小 (以字节计)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理，即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。

ESDSASIZE (数据区)

以全字二进制格式返回扩展共享动态存储区 (ESDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理，即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。

ETDSASIZE (数据区)

以全字二进制格式返回扩展可信动态存储区 (ETDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理，即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。

EUDSASIZE (数据区)

以全字二进制格式返回扩展用户动态存储区 (EUDSA) 的当前大小 (以字节计)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理，即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。

FORCEQR (cvda)

返回 CVDA 值，该值指示 CICS 是否强制定义为线程安全的 CICSAPI 用户应用程序在拟重入 (QR) TCB 上运行:

FORCE

CICS 强制使用 CONCURRENCY (THREADSAFE) 属性指定的所有用户应用程序在 QR TCB 下运行，就像使用 CONCURRENCY (QUASIRENT) 指定它们一样。 强制不适用于某些程序，例如 OPENAPI 程序，或者使用 XPLINK 编译的 C 或 C++ 程序。 有关详细信息，请参阅 FORCEQR 系统初始化参数。

NOFORCE

CICS 在 CICSAPI 用户应用程序上遵循 CONCURRENCY (THREADSAFE) 属性，并允许用户程序在开放式 TCB 上运行以避免不必要的 TCB 切换。

GCDSASIZE (数据区)

以双字二进制格式返回以上条 CICS 动态存储区 (GCDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 自动计算和管理。

GMMLENGTH (data-area)

返回一个半字二进制字段，该字段显示 good 早晨 消息文本的长度 (以字节计)。

GMMTEXT (data-area)

返回您提供的数据区中的 good 早晨 消息文本，该文本必须足够长以容纳该文本。 任何 good 晨 消息的最大长度为 246 字节。 实际长度在 GMMLENGTH 选项值中返回。

GMMTRANID (数据区)

返回生成 good 晨 消息的事务的 4 字符名称。

GSDSASIZE (数据区)

以双字二进制格式返回上条共享动态存储区 (GSDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 自动计算和管理。

GUDSASIZE (数据区)

以双字二进制格式返回上条用户动态存储区 (GUDSA) 的当前大小 (以字节计)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 自动计算和管理。

INITSTATUS (cvda)

返回显示 CICS 系统初始化状态的全字二进制字段。 CVDA 值如下：

第一次初始化

CICS 初始化的第一阶段。

不完整

CICS 初始化已完成。

秒初始化

初始化的第二阶段。

(THIRDINIT)

初始化的第三阶段。

作业名 (data-area)

返回运行 CICS 的 8 字符 MVS 作业名。

LOG延迟 (data-area)

返回显示日志延迟时间间隔的半字二进制值，这是 CICS 日志管理器在确定在调用 MVS 系统记录器之前延迟强制日志写入请求的时间长度时使用的时间段。 请参阅 LGDFINT 系统初始化参数 ，以获取有关LOG延迟参数和关联系统初始化参数 LGDFINT 的信息。

MAXOPENTCBS (数据区)

返回一个全字二进制字段，其中提供 CICS 在其 L8 和 L9 方式 TCB 池中连接和维护的 L8 和 L9 方式开放式 TCB 的最大数目。 CICS 使用以下公式，根据为 CICS 区域指定的最大任务数 (MXT 或 MAXTASKS) 自动设置此限制:

(2 * MXT Value) + 32

有关已分配的 L8 和 L9 方式开放式 TCB 数的信息，请参阅 ACTOPENTCBS 值。 MAXOPENTCBS 与 ACTOPENTCBS 之间的差异表示可用 L8 和 L9 方式开放式 TCB 的数目。

MAXTASKS (数据区)

返回一个全字二进制字段，该字段显示在此 CICS 系统中的任何时候可以进行分派的最大任务数。 活动任务和暂挂任务都计入此限制，但未达到初始分派点的任务不会计入此限制。 不计入终端和日志控制任务等系统任务。

MEMLIMIT (数据区域)

返回一个双字二进制字段，该字段显示界线上供 CICS 区域使用的最大存储量 (以字节计)。 值为 -1 表示未对区域可尝试使用的存储量 (也称为 NOLIMIT) 施加任何限制。 可以通过 JCL 或通过 IEFUSI 全局用户出口将 MEMLIMIT 值设置为 PARMLIB 成员。

MESSAGECASE (cvda)

返回 CVDA 值，该值显示消息域如何显示混合大小写消息 (由 MSGCASE 系统初始化参数设置)。 CVDA 值如下：

混合

CICS 消息域或 CICSPlex ® SM 消息域显示的所有消息保持混合大小写。

UPPER

消息域仅以大写形式显示所有混合大小写消息。

MQCONN (数据区)

返回当前为 CICS 区域安装的 MQCONN 资源定义的 1-to 8 字符名称，如果当前未安装 MQCONN 定义，那么返回空白。 一次只能安装一个 MQCONN 定义。 MQCONN 资源定义指定 CICS 与 WebSphere® MQ之间的连接的属性。

MROBATCH (数据区)

返回一个全字二进制字段，该字段显示在显式发布 CICS 以处理事件之前，必须从 CICS 正在等待的 MRO 和 DASD I/O 事件列表中发生的事件数。

MVSSMFID (数据区)

返回指示 MVS 系统标识的 4 字节值。 此字段是从 SMCA MVS 控制块的 SMCASID 字段复制的。

MVSSYSNAME (数据区)

返回指示 MVS 系统名称的 8 字节值。 此字段是从 MVS CVT 控制块的 CVTSNAME 字段复制的。

OPREL (data-area) (仅支持兼容性)

返回一个半字二进制字段，该字段显示运行 CICS 区域的操作系统的级别号的最后 2 个数字。 例如， z/OS Release 9 由 09 表示。

注: 仅出于兼容性目的支持此字段。 此信息派生自 MVS CVTPRODN 字段中的最后两个数字。 请参阅 OSLEVEL 字段以获取 z/OS的完整版本和发行版号。

OPSYS (数据区)

返回用于标识运行 CICS 的操作系统的 1 字符值。 值 X 表示 MVS。

OSLEVEL (数据区)

返回一个 6 字节字段，该字段显示正在运行 CICS 的 z/OS 产品的版本，发行版和修改级别。 例如， z/OSV 2 Release 1 Modiation 0 返回值 020100。

PROGAUTOCTLG (cvda)

返回一个 CVDA 值，该值指示是否以及何时对自动安装的程序定义进行编目。 在热重新启动或紧急重新启动时复原已编目的定义。 未编目的文件在关闭时将被废弃，如果在 CICS的后续执行中使用这些文件，那么必须重新安装这些文件。

在初始安装时以及每当修改自动安装的定义时，都会根据当时的 PROGAUTOCTLG 值来制定目录决策。 CVDA 值如下：

CTLGALL

在安装和修改时，都会对定义进行编目。

CTLGMODIFY

仅当修改时，才会对定义进行编目。

CTLGNONE

未对定义进行编目。

PROGAUTOEXIT (data-area)

返回由 CICS 程序自动安装代码调用以提供模型定义的用户提供的程序的 8 字符名称。

PROGAUTOINST (cvda)

返回一个 CVDA 值，该值指示程序的自动安装是处于活动状态还是不活动状态。 当任务请求未定义的程序，映射集或分区集时，如果程序的自动安装处于活动状态，那么 CICS 会尝试自动为其创建定义。 否则， CICS 会引发 PGMIDERR 异常情况。 CVDA 值如下：

自动活动

程序的自动安装处于活动状态。

自动不活动

程序的自动安装未处于活动状态。

PRTYAGING (数据区)

返回一个全字二进制字段，给出 CICS 增加等待分派的任务优先级的速率。 在没有分派的每个 PRTYAGING 毫秒等待时间之后， CICS 会将任务优先级提高 1。

RDSASIZE (数据区)

以全字二进制格式返回只读动态存储区 (RDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 DSALIMIT 值内自动计算和管理，即驻留在 16 MB 以下 (低于界线) 的动态存储区的总体限制。

REENTPROTECT (cvda)

返回一个 CVDA 值，该值指示重入程序 (RDSA 和 ERDSA) 的存储器是在键 0 还是 CICS 键中。 MVS 密钥 0 存储器受写保护，不受在 CICS 密钥或用户密钥中运行的程序的保护; 仅当 CICS 密钥和用户密钥不同 (即，当存储器保护处于活动状态时) 时， CICS 密钥存储器中的程序才受保护，不受在用户密钥中运行的程序的保护。 CVDA 值如下：

REENTPROT

只读 DSA 位于密钥 0 存储器中。

NOREENTPROT

只读 DSA 位于 CICS密钥存储器中。

REGIONUSERID (数据区)

返回所提供数据区中的区域用户标识。

RELEASE (data-area) (仅支持兼容性)

返回包含 CICS 代码的级别号的 4 字符字符串。 在此发行版中，值为 0710。

仅支持此选项以与先前发行版兼容。 作为 CICS Transaction Server for z/OS的独占元素， CICS 没有自己的产品版本和发行版号。 建议您使用 CICSTSLEVEL 来确定 CICS Transaction Server的版本和发行版号。

RLSSTATUS (cvda)

返回 CVDA 值，该值指示 VSAM RLS 是否处于活动状态-即，已使用 SMSVSAM 地址空间注册 CICS 区域 (使用当前打开的控制 ACB):

NOTAPPLIC

由于下列其中一个原因，此 CICS 区域不支持 VSAM RLS:

• 使用 RLS=NO 作为系统初始化参数初始化 CICS
• CICS 已强制 RLS=NO ，因为运行 CICS 的 MVS 中的 VSAM 级别不支持 VSAM RLS。

RLSACTIVE

CICS 已向 SMSVSAM 服务器注册， VSAM RLS 当前处于活动状态。

RLSINACTIVE

CICS 已向 SMSVSAM 服务器注册，但由于 SMSVSAM 服务器故障， VSAM RLS 当前处于不活动状态。 在 CICS 执行动态 VSAM RLS 重新启动之前，所有 RLS 请求都将失败，这将在 SMSVSAM 服务器重新启动时自动发生。

RUNAWAY (data-area)

返回显示失控任务时间的缺省值的全字二进制字段。 此值用于执行其概要文件未指定失控任务时间的事务的任何任务 (请参阅 INQUIRE TRANSACTION 命令的 RUNAWAY 选项)。

SCANDELAY (数据区)

返回全字二进制字段，给出用户任务发出终端 I/O 请求与 CICS 分派终端控制任务以进行处理之间的最大毫秒数。 此值有时称为 终端扫描延迟，由系统初始化表中的 ICVTSD 选项设置。

SDSASIZE (数据区)

以全字二进制格式返回共享动态存储区 (SDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 DSALIMIT 值内自动计算和管理，即驻留在 16 MB 以下 (低于界线) 的动态存储区的总体限制。

SDTRAN (data-area)

返回要在正常或立即关闭开始时运行的事务的 4 字符名称。 这可以是用户提供的事务的名称，也可以是 CICS提供的缺省事务 CESD 的名称。

SECURITYMGR (cvda)

返回用于标识外部安全管理器 (例如 RACF®) 在系统中是否处于活动状态的 CVDA 值:

扩展安全性

外部安全管理器处于活动状态。

无安全

未使用安全性。

SHUTSTATUS (cvda)

返回指示 CICS 关闭状态的 CVDA 值 (请参阅 CICSSTATUS 选项):

CANCELLED

CICS 已取消。

控制关闭

CICS 正在执行受控关闭 (即，具有热关键点的正常关闭)。

NOTAPPLIC

CICS 未关闭。

SHUTDOWN

CICS 正在执行立即关闭。

SO破坏栏 (cvda)

返回一个 CVDA 值，该值指示 CICS 在界线以上的动态存储区中是否存储空间不足:

NOTSOS

CICS 在条形上方的任何动态存储器区域中都没有存储空间不足。

SOS

CICS 在界线以上的至少一个动态存储区中存储空间不足。

SOSABOVELINE (cvda)

返回 CVDA 值，该值指示 CICS 在高于 16 MB 但低于 2 GB (高于该行) 的动态存储器区域中的存储空间是否不足:

NOTSOS

CICS 在高于 16 MB 但低于 2 GB 的任何动态存储器区域中都没有存储空间不足。

SOS

CICS 在至少一个高于 16 MB 但低于 2 GB 的动态存储区中存储空间不足。

SOSBELOWLINE (cvda)

返回一个 CVDA 值，该值指示 CICS 在低于 16 MB 的动态存储区 (低于该行) 中是否存储空间不足:

NOTSOS

CICS 在低于 16 MB 的任何动态存储器区域中都没有存储空间不足。

SOS

在至少一个低于 16 MB 的动态存储区域中， CICS 存储空间不足。

SOSSTATUS (cvda)

返回一个 CVDA 值，该值指示 CICS 在低于 2 GB (低于界线) 的任何动态存储器区域中是否缺少存储器:

NOTSOS

CICS 在低于 2 GB 的任何动态存储区域中都没有存储空间不足。

SOS

CICS 在至少一个低于 16 MB 的动态存储区和至少一个高于 16 MB 但低于 2 GB 的动态存储区中存储空间不足。

SOSABOVE

CICS 在至少一个高于 16 MB 但低于 2 GB 的动态存储区中存储空间不足，但在任何低于 16 MB 的动态存储区中存储空间不足。

下索斯

CICS 在低于 16 MB 的至少一个动态存储区中的存储空间不足，但在高于 16 MB 但低于 2 GB 的任何动态存储区中的存储空间不足。

STARTUP (cvda)

返回一个 CVDA 值，该值指示 CICS 的当前执行是如何启动的:

颜色 DSTART

CICS 执行了初始启动或冷启动。

注: STARTUP 选项不会区分初始启动和冷启动。 请参阅 COLDSTATUS 选项。

急救

CICS 执行了紧急重新启动，因为先前的运行未正常关闭。

热启动

在先前运行的正常关闭之后， CICS 执行了热重新启动。

STARTUPDATE (数据区)

返回包含 CICS 当前执行开始日期的 4 字节压缩十进制字段。 日期的格式为 0cyyddd+，其中 c 是世纪代码 (0 表示 1900s， 1 表示 2000-2099) ， yy 是年的低阶两位数， ddd 是年的日。

STOREPROTECT (cvda)

返回一个 CVDA 值，该值指示存储器保护是否处于活动状态。 要使存储器保护处于活动状态，必须将系统初始化参数 STGPROT 设置为 YES 或允许缺省值为 YES。 CVDA 值如下：

ACTIVE

存储器保护处于活动状态。

INACTIVE

存储器保护未处于活动状态。

TIME (数据区)

返回一个全字二进制字段，其中给出 CICS 对操作系统进行控制的最大时间间隔 (以毫秒为单位) (如果没有可供分派的任务)。 此值由系统初始化表中的 ICV 选项设置，有时称为 区域退出时间间隔。

TRAN集中 (cvda)

返回一个 CVDA 值，该值指示事务隔离是否处于活动状态。 要使其处于活动状态，必须为 CICS 区域指定事务隔离和存储器保护 (TRANISO 和 STGPROT 系统初始化参数)。 CVDA 值如下：

ACTIVE

事务隔离处于活动状态。

INACTIVE

事务隔离未处于活动状态。

UDSASIZE (数据区)

以全字二进制格式返回用户动态存储区 (UDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 DSALIMIT 值内自动计算和管理，即驻留在 16 MB 以下 (低于界线) 的动态存储区的总体限制。

XRFSTATUS (cvda)

返回 CVDA 值，该值指示 CICS 的当前执行是作为扩展恢复设施 (XRF) 下的活动区域还是备用区域启动:

NOTAPPLIC

CICS 在没有 XRF 支持的情况下运行。 (系统初始化表中的 XRF=NO。)

PRIMARY

CICS 已作为活动区域启动。

接管

CICS 作为备用区域启动。

条件

NOTAUTH

RESP2 值：

100

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