INQUIRE SYSTEM

检索 CICS® 系统信息。

语法

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

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

不同版本的语法有所不同。 受影响的命令选项在主图中表示为一个片段。 某些命令选项在特定版本中可用;有关受影响的选项,请参见主图下方的 命令选项的适用版本

INQUIRE SYSTEM

读取语法图跳过可视语法图INQUIRE SYSTEM ACTOPENTCBS( data-area)AIDCOUNT( data-area)AKP( data-area)CDSASIZE( data-area)CICSSTATUS( CVDA)CICSSYS( data-area)CICSTSLEVEL( data-area)CMDPROTECT( CVDA)COLDSTATUS( CVDA)DB2CONN( data-area)DEBUGTOOL( CVDA)DFLTUSER( data-area)DSALIMIT( data-area)DSRTPROGRAM( data-area)DTRPROGRAM( data-area)DUMPING( CVDA)ECDSASIZE( data-area)EDSALIMIT( data-area)EPCDSASIZE( data-area)EPUDSASIZE( data-area)ERDSASIZE( data-area)ESDSASIZE( data-area)EUDSASIZE( data-area)FORCEQR( CVDA)GCDSASIZE( data-area)GMMTEXT( data-area)GMMLENGTH( data-area)GRPLIST(data-area)GSDSASIZE( data-area)GUDSASIZE( data-area)GMMTRANID( data-area)HEALTHCHECK( CVDA)INITSTATUS( CVDA)JOBNAME( data-area)LASTCOLDTIME( data-area)LASTEMERTIME( data-area)LASTINITTIME( data-area)LASTWARMTIME( data-area)LOGDEFER( data-area)MAXOPENTCBS( data-area)MAXTASKS( data-area)MEMLIMIT( data-area)MESSAGECASE( CVDA)MQCONN( data-area)MROBATCH( data-area)MVSSMFID( data-area)MVSSYSNAME( data-area)OPREL( data-area)OPSYS( data-area)OSLEVEL( data-area)PCDSASIZE( data-area)PLTPIUSR( data-area)PROGAUTOCTLG( CVDA)PROGAUTOEXIT( data-area)PROGAUTOINST( CVDA)PRTYAGING( data-area)PUDSASIZE( data-area)RDSASIZE( data-area)REENTPROTECT( CVDA)REGIONUSERID( data-area)RELEASE( data-area)RLSSTATUS( CVDA)RUNAWAY( data-area)SCANDELAY( data-area)SDSASIZE( data-area)SDTMEMLIMIT( data-area)SDTRAN( data-area)SECURITYMGR( CVDA)SHUTSTATUS( CVDA)SOSABOVEBAR( CVDA)SOSABOVELINE( CVDA)SOSBELOWLINE( CVDA)SOSSTATUS( CVDA)SRRTASKS( data-value)STARTUP( CVDA)STARTUPDATE( data-area)STOREPROTECT( CVDA)TIME( data-area)TRANISOLATE( CVDA)UDSASIZE( data-area)XRFSTATUS( CVDA)
命令选项的适用版本
某些命令选项在特定版本中可用,如下所示:
  • 6.2 后来 GRPLIST

条件: NOTAUTH

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

此命令是线程安全的。

描述

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

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

表 1. INQUIRE SYSTEM 选项
选项
ACTOPENTCBS 系统状态
AIDCOUNT 系统状态
AKP AKPFREQ 系统初始化参数
CDSASIZE 系统状态
CICSSTATUS 系统状态
CICSSYS 系统状态
CICSTSLEVEL CICS 控制块
CMDPROTECT CMDPROT 系统初始化参数
COLDSTATUS 系统状态
DB2CONN 已安装 DB2CONN 资源定义
DEBUGTOOL DEBUGTOOL 系统初始化参数
DFLTUSER DFLTUSER 系统初始化参数
DSALIMIT DSALIM 系统初始化参数
DSRTPROGRAM DSRTPGM 系统初始化参数
DTRPROGRAM DTRPGM 系统初始化参数
DUMPING DUMP 系统初始化参数
ECDSASIZE 系统状态
EDSALIMIT EDSALIM 系统初始化参数
EPCDSASIZE 系统状态
EPUDSASIZE 系统状态
ERDSASIZE 系统状态
ESDSASIZE 系统状态
EUDSASIZE 系统状态
FORCEQR FORCEQR 系统初始化参数
GCDSASIZE 系统状态
GMMTEXT 和 GMMLENGTH GMTEXT 系统初始化参数
GMMTRANID GMTRAN 系统初始化参数
6.2 后来 GRPLIST GRPLIST 系统初始化参数
GSDSASIZE 系统状态
GUDSASIZE 系统状态
运行状况检查 标记文件
INITSTATUS 系统状态
作业名 JCL 或编目过程
LASTCOLDTIME 系统状态
LASTEMERTIME 系统状态
LASTINITTIME 系统状态
LASTWARMTIME 系统状态
逻辑延迟 LGDFINT 系统初始化参数
MAXOPENTCBS CICS 自动设置的限制
MAXTASKS MXT 系统初始化参数
MEMLIMIT 系统状态
消息 GECASE 系统状态
MQCONN 已安装的 MQCONN 资源定义
MROBATCH MROBTCH 系统初始化参数
MVSSMFID 4 字节系统标识
MVSSYSNAME 8 字节系统名称
OPREL 操作系统 ( MVS )
OPSYS 操作系统 ( MVS )
OSLEVEL 操作系统 (z/OS)
PCDSASIZE 系统状态
PLTPIUSR PLTPIUSR 系统初始化参数
PROGAUTOCTLG PGAICTLG 系统初始化参数
PROGAUTOEXIT PGAIEXIT 系统初始化参数
PROGAUTOINST PGAIPGM 系统初始化参数
PRTYAGING PRTYAGE 系统初始化参数
PUDSASIZE 系统状态
RDSASIZE 系统状态
REENTPROTECT RENTPGM 系统初始化参数
REGIONUSERID 系统状态
RELEASE CICS 系统代码
RLSSTATUS RLS 系统初始化参数
RUNAWAY ICVR 系统初始化参数
SCANDELAY ICVTSD 系统初始化参数
SDSASIZE 系统状态
SDTMEMLIMIT SDTMEMLIMIT 系统初始化参数
SDTRAN SDTRAN 系统初始化参数
安全管理器 SEC 系统初始化参数
SHUTSTATUS 系统状态
SOSABOVEBAR 系统状态
SOSABOVELINE 系统状态
SOSBELOWLINE 系统状态
SOSSTATUS 系统状态
SRRTASKS 系统状态
STARTUP 系统状态
STARTUPDATE 系统状态
商店保护 STGPROT 系统初始化参数
时间 ICV 系统初始化参数
TRANISOLATE TRANISO 系统初始化参数
UDSASIZE 系统状态
XRFSTATUS XRF 系统初始化参数和系统状态
注:CICS Transaction Server for z/OS中, CSCS , ECSCS , ERSCS , EUSCS 和 USCS 选项 (每个选项返回了特定动态存储区的存储缓冲器大小) 已过时。 转换程序接受它们并发出警告。 在运行时,提供的数据区保持不变。

选项

ACTOPENTCBS (数据区)
返回一个全字二进制字段,该字段提供当前分配给用户任务的开放式 TCB 数。 CICS 分派器维护 L8 和 L9 方式 TCB 的池,供 OPENAPI 应用程序和通过 OPENAPI 选项启用的与任务相关的用户出口使用。 与任务相关的用户出口仅使用 L8 方式 TCB; 例如,当连接到 Db2时, CICS Db2® 适配器。 ACTOPENTCBS 值可以等于或小于 MAXOPENTCBS 值。 如果该值等于 MAXOPENTCBS ,那么将执行需要开放式 TCB 的任务以等待。
AIDCOUNT (数据区)
返回一个全字二进制值,该值提供本地系统的 AID 链中的自动发起程序描述符 (AID) 的当前数目。
AKP (数据区)
返回一个全字二进制字段,给出活动关键点触发值,即在获取关键点之间对 CICS 系统日志流输出缓冲区的写请求数。

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

CDSASIZE (数据区)
以全字二进制格式返回 CICS 动态存储区 (CDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 DSALIMIT 值内自动计算和管理,即驻留在 16 MB 以下 (低于界线) 的动态存储区的总体限制。
CICSSTATUS (cvda)
返回用于标识 CICS当前执行状态的 CVDA 值:
ACTIVE
CICS 完全处于活动状态。
详细信息
CICS 处于关闭的最终停顿阶段。 要关闭的程序列表 (PLTSD) 的第二阶段中的程序在此阶段中运行。
第一批
CICS 处于关闭的第一个停顿阶段。 PLTSD 的第一阶段中的程序在此阶段中运行。
STARTUP
CICS 正在启动,但尚未完全处于活动状态。 程序列表中用于程序启动的程序 (PLTPI) 将在启动期间运行。 请参阅 INITSTATUS 选项以获取更多信息。
CICSSYS (数据区)
返回一个 1 字符值,用于标识为其构建正在运行的 CICS 系统的操作系统。 X 值代表z/OS。
CICSTSLEVEL (数据区域)
返回一个 6 个字符的值,用于标识 区域所运行产品的版本、发行版和修改级别。 CICS Transaction Server for z/OSCICS 产品的版本、版本号和修改级别。 该值的形式为非常快。 例如, CICS Transaction Server for z/OS, Version 6 Release 3 返回 060300
CMDPROTECT (cvda)
返回一个 CVDA 值,该值指示命令存储器保护是否处于活动状态。 当任务发出命令并且命令存储器保护处于活动状态时, CICS 将验证该任务是否对 CICS 要返回信息的每个区域的第一个字节具有写访问权。 如果任何区域测试失败,那么将发生 AEYD 异常终止。
CVDA 值如下所示:
CMDPROT
命令存储器保护处于活动状态。
NOCMDPROT
命令存储器保护未处于活动状态。
COLDSTATUS (cvda)
返回一个 CVDA 值,该值指示 CICS 是执行冷启动还是初始启动。
CVDA 值如下所示:
CICS 执行了冷启动。 已擦除有关本地资源的日志信息,但保留了有关允许远程系统或与 RMI 连接的资源管理器再同步其资源所需的本地工作单元结果的信息。
初始
CICS 执行了初始启动。 已擦除有关本地资源和远程资源的所有日志信息。
NOTAPPLIC
CICS 既未执行冷启动,也未执行初始启动。
DB2CONN (data-area)
返回为 CICS 区域安装的 DB2CONN 资源定义的 1-8 字符名称,如果当前未安装任何 DB2CONN 定义,那么返回空白。 一次只能安装一个 DB2CONN 定义。 DB2CONN 资源定义指定 CICS 与 Db2之间的连接的属性。
DEBUGTOOL (cvda)
返回一个 CVDA 值,该值指示您是否可以使用调试概要文件来选择在调试工具控制下运行的程序。 下列调试工具使用调试概要文件:
  • 调试工具,用于编译语言应用程序(用 COBOL, PL/I, C®, C++ 和汇编程序编写的程序)
  • 远程调试工具(用于编译型语言应用程序和 Java™ 程序)
其他调试机制 (例如 CICS 执行诊断设施 (CEDF)) 不使用调试概要文件。 CVDA 值如下所示:
DEBUG
您可以使用 CICS 调试概要文件来选择在调试工具控制下运行的程序。
节点 BUG
不能使用 CICS 调试概要文件来选择在调试器工具控制下运行的程序。

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

DFLTUSER (data-area)
返回此 CICS 区域的缺省用户的 8 字符标识。
DSALIMIT (数据区)
返回一个全字二进制字段,提供最大存储量 (以字节为单位) , CICS 可以在此存储量内为驻留在 16 MB 以下 (低于该行) 的四个单独动态存储区动态分配存储量。 请参阅此命令的 CDSASIZE , PCDSASIZE , RDSASIZE , SDSASIZE , UDSASIZE 和 PUDSASIZE 选项。
DSRTPROGRAM (数据区)
返回分布式路由程序的 8 字符名称。
DTRPROGRAM (数据区)
返回动态路由程序的 8 字符名称。
正在转储 (cvda)
返回一个 CVDA 值,该值指示是否禁止执行 CICS 系统转储:
无系统转储
禁止系统转储。
仅表
将禁止系统转储,但那些在转储表中具有允许执行 SDUMP 的条目的系统转储除外。
SYSDUMP
不禁止系统转储。

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

ECDSASIZE (数据区)
以全字二进制格式返回扩展 CICS 动态存储区 (ECDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理,即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。
EDSALIMIT (数据区)
返回一个全字二进制字段,该字段提供最大存储量 (以字节计) , CICS 可以在此存储量内为驻留在 16 MB 以上但 2 GB 以下 (行上方) 的各个动态存储区动态分配存储器。 请参阅此命令的 ECDSASIZE , EPCDSASIZE , EPUDSASIZE , ERDSASIZE , ESDSASIZE 和 EUDSASIZE 选项。
EPCDSASIZE (数据区)
以全字二进制格式返回不受指令执行 (EPCDSA) 保护的扩展 CICS 动态存储区的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理,即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。
EPUDSASIZE (数据区)
以全字二进制格式返回从不受指令执行 (EPUDSA) 保护的扩展用户动态存储区的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理,即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。
ERDSASIZE (数据区)
以全字二进制格式返回扩展只读动态存储区 (ERDSA) 的当前大小 (以字节计)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 EDSALIMIT 值内自动计算和管理,即驻留在高于 16 MB 但低于 2 GB (高于该行) 的动态存储区的总体限制。
ESDSASIZE (数据区)
以全字二进制格式返回扩展共享动态存储区 (ESDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 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 字符名称。
6.2 后来 GRPLIST(数据区域)
返回一个 36 个字符的字段,该字段显示包含在 CICS 冷启动的系统初始化期间装入的资源定义组的列表的名称。
GSDSASIZE (数据区)
以双字二进制格式返回上条共享动态存储区 (GSDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 自动计算和管理。
GUDSASIZE (数据区)
以双字二进制格式返回上条用户动态存储区 (GUDSA) 的当前大小 (以字节计)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 自动计算和管理。
HEALTHCHECK (cvda)
返回一个 CVDA 值,该值指示是否将 CICS 区域排除在 z/OS 运行状况检查程序检查之外。
NoCheck
CICS 区域将从所有 z/OS 运行状况检查程序检查中排除。
CHECK
不会从所有 z/OS 运行状况检查程序检查中排除 CICS 区域。
INITSTATUS (cvda)
返回显示 CICS 系统初始化状态的全字二进制字段。 CVDA 值如下:
第一次初始化
CICS 初始化的第一阶段。
不完整
CICS 初始化已完成。
秒初始化
初始化的第二阶段。
(THIRDINIT)
初始化的第三阶段。
作业名 (data-area)
返回 8 个字符z/OS工作名称CICS運行。
LASTCOLDTIME (数据区)
返回 ABSTIME 值,该值表示自上次初始启动以来 CICS 系统上次冷启动的日期和时间。 如果自上次初始启动以来未冷启动 CICS 系统,那么将返回空值。

ABSTIME 值派生自系统时间时钟,该时间时钟调整为跳跃秒和本地时区偏移量 (包括夏令时)。 自上次冷启动以来,这些可能已更改,并且将相应地调整此字段中返回的时间。

LASTEMERTIME (数据区)
返回 ABSTIME 值,该值表示自上次初始启动以来 CICS 系统上一次紧急启动的日期和时间。 如果自上次初始启动以来 CICS 系统未紧急启动,那么将返回空值。

ABSTIME 值派生自系统时间时钟,该时间时钟调整为跳跃秒和本地时区偏移量 (包括夏令时)。 自上次冷启动以来,这些可能已更改,并且将相应地调整此字段中返回的时间。

LASTINITTIME (数据区)
返回 ABSTIME 值,该值表示 CICS 系统上次初始启动的日期和时间。

ABSTIME 值派生自系统时间时钟,该时间时钟调整为跳跃秒和本地时区偏移量 (包括夏令时)。 自上次冷启动以来,这些可能已更改,并且将相应地调整此字段中返回的时间。

LASTWARMTIME (数据区)
返回 ABSTIME 值,该值表示自上次初始启动以来 CICS 系统上次热启动的日期和时间。 如果自上次初始启动以来 CICS 系统未热启动,那么将返回空值。

ABSTIME 值派生自系统时间时钟,该时间时钟调整为跳跃秒和本地时区偏移量 (包括夏令时)。 自上次冷启动以来,这些可能已更改,并且将相应地调整此字段中返回的时间。

LOG延迟 (data-area)
返回显示日志延迟间隔的半字二进制值,该间隔是CICS日志管理器在确定强制日志写入请求延迟多长时间后再调用z/OS系统记录器。 看LGDFINT 系统初始化参数有关 LOGDEFER 参数和相关系统初始化参数 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 值如下:
MIXED
CICS 消息域或 CICSPlex ® SM 消息域显示的所有消息保持混合大小写。
UPPER
消息域仅以大写形式显示所有混合大小写消息。
MQCONN (数据区)
返回为 CICS 区域安装的 MQCONN 资源定义的 1-to 8 字符名称,如果当前未安装 MQCONN 定义,那么返回空白。 一次只能安装一个 MQCONN 定义。 MQCONN 资源定义指定 CICS 与 IBM® MQ之间的连接的属性。
MROBATCH (数据区)
返回一个全字二进制字段,该字段显示在显式发布 CICS 以处理事件之前,必须从 CICS 正在等待的 MRO 和 DASD I/O 事件列表中发生的事件数。
MVSSMFID (数据区)
返回一个 4 字节值,表示 MVS 系统标识。 该字段复制自 SMCA MVS 控制块的 SMCASID 字段。
MVSSYSNAME (数据区)
返回表示 MVS 系统名称的 8 字节值。 该字段从 MVS CVT 控制块的 CVTSNAME 字段复制而来。
OPREL (data-area) (仅支持兼容性)
返回一个半字二进制字段,该字段显示运行 CICS 区域的操作系统的级别号的最后 2 个数字。 例如, z/OS Release 9 由 09 表示。
注: 仅出于兼容性目的支持此字段。 该信息来自 MVS CVTPRODN 字段中的最后两个数字。 有关 z/OS 的完整版本和发行号,请参见 OSLEVEL 字段。
OPSYS (数据区)
返回用于标识运行 CICS 的操作系统的 1 字符值。 X 值代表 MVS。
OSLEVEL (数据区)
返回一个 6 字节字段,显示运行 CICS 的 z/OS 产品的版本、发行版和修改级别。 例如,z/OS 3.1 修改 0 返回 030100 值。
PCDSASIZE (数据区)
以全字二进制格式返回不受指令执行 (PCDSA) 保护的 CICS 动态存储区的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 DSALIMIT 值 (即驻留在 16 MB 以下的动态存储区的总体限制) 内自动计算和管理。
PLTPIUSR (数据区)
返回适用于所提供数据区中的 PLTPI 处理的用户标识。
PROGAUTOCTLG (cvda)
返回一个 CVDA 值,该值指示是否以及何时对自动安装的程序定义进行编目。 在热重新启动或紧急重新启动时复原已编目的定义。 未编目的那些定义将在关闭时废弃,如果在 CICS的后续执行中使用这些定义,那么必须再次安装这些定义。
在初始安装时以及每当修改自动安装的定义时,都会根据当时的 PROGAUTOCTLG 值来制定目录决策。 CVDA 值如下:
CTLGALL
在安装和修改时,都会对定义进行编目。
CTLGMODIFY
仅当修改时,才会对定义进行编目。
CTLGNONE
未对定义进行编目。
PROGAUTOEXIT (data-area)
返回由 CICS 程序自动安装代码调用以提供模型定义的用户提供的程序的 8 字符名称。
PROGAUTOINST (cvda)
返回一个 CVDA 值,该值指示程序的自动安装是处于活动状态还是不活动状态。 当任务请求未定义的程序,映射集或分区集时,如果程序的自动安装处于活动状态,那么 CICS 会尝试自动为其创建定义。 否则, CICS 会引发 PGMIDERR 异常情况。 CVDA 值如下:
自动活动
程序的自动安装处于活动状态。
自动不活动
程序的自动安装未处于活动状态。
PRTYAGING (数据区)
返回一个全字二进制字段,该字段提供 CICS 提高正在等待分派的任务的优先级的速率。 在没有分派的情况下, CICS 在每次 PRTYAGING 毫秒等待时间之后将任务优先级提高 1。
PUDSASIZE (数据区)
以全字二进制格式返回从不受指令执行 (PUDSA) 保护的用户动态存储区的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 DSALIMIT 值 (即驻留在 16 MB 以下的动态存储区的总体限制) 内自动计算和管理。
RDSASIZE (数据区)
以全字二进制格式返回只读动态存储区 (RDSA) 的当前大小 (以字节为单位)。 它包括正在使用的存储器和可供使用的存储器。 此大小由 CICS 在 DSALIMIT 值内自动计算和管理,即驻留在 16 MB 以下 (低于界线) 的动态存储区的总体限制。
REENTPROTECT (cvda)
返回一个 CVDA 值,该值指示重入程序 (RDSA 和 ERDSA) 的存储器是在键 0 还是 CICS-key 中。 z/OS密钥 0 存储受到写保护,以防止在CICS-key 或用户密钥;程序CICS-key 存储仅对在用户密钥中运行的存储进行保护CICS-key 和用户密钥不同(即当存储保护处于活动状态时)。 CVDA 值如下:
REENTPROT
只读 DSA 位于密钥 0 存储器中。
NOREENTPROT
只读 DSA 位于 CICS密钥存储器中。
REGIONUSERID (数据区)
返回所提供数据区中的区域用户标识。
RELEASE (data-area) (仅支持兼容性)
返回包含 CICS 代码级别编号的 4 个字符字符串。 例如, CICS TS 6.3 的值为 0760

仅支持此选项以与先前发行版兼容。 作为 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,因为 VSAM 的水平z/OS系统CICS正在运行不支持 VSAM RLS。
RLSACTIVE
向 SMSVSAM 服务器和 VSAM RLS 注册的 CICS 当前处于活动状态。
RLSINACTIVE
已向 SMSVSAM 服务器注册 CICS ,但由于 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 以下 (低于界线) 的动态存储区的总体限制。
SDTMEMLIMIT (数据区)
返回一个双字二进制值,该值显示 CICS 使共享数据表可用于控制信息 (条目描述符,回退元素和索引节点) 的界线上的最大存储量的当前设置 (以字节计)。 该值向下舍入为最接近的兆字节。
SDTRAN (data-area)
返回要在正常或立即关闭开始时运行的事务的 4 字符名称。 这可以是用户提供的事务的名称,也可以是 CICS 缺省事务 CESD。
SECURITYMGR (cvda)
返回用于标识外部安全管理器 (例如 RACF®) 在系统中是否处于活动状态的 CVDA 值:
扩展安全性
外部安全管理器处于活动状态。
无安全
未使用安全性。
SHUTSTATUS (cvda)
返回指示 CICS 关闭状态的 CVDA 值 (请参阅 CICSSTATUS 选项):
已取消
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 的动态存储区中存储空间不足。
索萨博夫
CICS 在至少一个高于 16 MB 但低于 2 GB 的动态存储区中存储空间不足,但在任何低于 16 MB 的动态存储区中存储空间不足。
下索斯
CICS 在低于 16 MB 的至少一个动态存储区中的存储空间不足,但在高于 16 MB 但低于 2 GB 的任何动态存储区中的存储空间不足。
SRRTASKS (数据区)
返回包含当前正在记录安全性请求的任务数的全字二进制字段。
STARTUP (cvda)
返回一个 CVDA 值,该值指示 CICS 的当前执行是如何启动的:
颜色 DSTART
CICS 执行了初始启动或冷启动。
注: STARTUP 选项不会区分初始启动和冷启动。 请参阅 COLDSTATUS 选项。
急救
CICS 执行了紧急重新启动,因为先前的运行未正常关闭。
热启动
在先前运行的正常关闭之后, CICS 执行了热重新启动。
STARTUPDATE (数据区)
返回包含 CICS 当前执行开始日期的 4 字节压缩十进制字段。 日期格式为 0cyyddd+,其中 c 是世纪代码 (0 表示 1900s, 1 表示 2000-2099) , yy 是年的低阶 2 数字, 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。)
主要
CICS 已作为活动区域启动。
接管
CICS 作为备用区域启动。

条件

NOTAUTH
RESP2 值:
100
与发出任务关联的用户无权使用此命令。