INQUIRE TDQUEUE

描述

INQUIRE TDQUEUE 命令检索有关特定瞬时数据队列的信息。

您可以使用瞬时数据资源定义向 CICS® 定义瞬时数据队列。 有两种基本类型: 分区内 和 分区外。 分区内队列完全由 CICS管理和存储，并且受自动任务启动 (ATI) 的约束。 ATI 表示当队列中的项数达到 TRIGGERLEVEL 选项中的值时， CICS 会自动创建任务以处理队列。

分区外队列是 MVS 序列数据集或 spool 文件。 分区外队列不受 ATI 约束，因此关联的选项会生成空值。 此外，如果数据集未打开， CICS 可能无法确定某些值，如 BLOCKFORMAT 和 RECORDFORMAT。 在此类情况下，将返回 空值中说明的空值。

存在另两种类型的队列: 间接 和 远程，这两种类型最终都指向其中一种基本类型。

间接队列指向同一 CICS 系统上的另一个队列，基本上是另一个队列的别名。 在 INQUIRE TDQUEUE 命令中对间接队列进行命名时， CICS 仅返回 TYPE 值 (即间接) 以及间接定义指向的队列的名称 (INDIRECTNAME 值)。 您需要针对 INDIRECTNAME 值的第二个 INQUIRE TDQUEUE 来确定底层队列的特征。

浏览

您还可以使用 INQUIRE TDQUEUE 命令上的浏览选项 START ， NEXT 和 END 来浏览系统中定义的瞬时数据队列。 请参阅 浏览资源定义 ，以获取有关浏览的常规信息，包括语法，异常条件和示例。

资源特征符

您可以使用此命令来检索资源签名字段。 您可以使用这些字段来管理资源，方法是捕获资源的定义，安装和上次更改时间的详细信息。 有关更多信息，请参阅 标识对资源的更改 (资源特征符)。 请参阅 资源签名字段值摘要 ，以获取有关资源签名字段内容的详细信息。

选项

ATIFACILITY (cvda) (仅限分区内队列)

返回 CVDA 值，指示队列是否具有与其关联的终端 (或会话)。 如果这样做，并且 CICS 创建了一个任务来处理队列，因为已达到其触发器级别，那么会将终端指定为任务的主体设施。 另请参阅 ATITERMID 和 ATITRANID 选项。 CVDA 值如下：

NOTAPPLIC

队列不是分区内的。

NOTERMINAL

没有终端与队列相关联。

TERMINAL

终端与队列相关联。

ATITERMID (data-area) (仅限分区内队列)

返回与队列关联的终端或会话的 4 字符名称 (如果有)。 (请参阅 ATIFACILITY 选项。) 否则，返回空白。

ATITRANID (data-area) (仅限分区内队列)

返回要在 CICS 自动启动任务以处理队列时运行的事务的 4 字符标识。 此选项仅适用于用于 ATI 的分区内队列; 对于其他类型的队列，以及未在队列定义中指定事务的分区内队列，返回的值为空白。

ATIUSERID (data-area) (仅限分区内队列)

返回与队列关联的 8 字节用户标识。 如果没有终端与队列相关联，那么 CICS 会将此值分配给它为处理队列而创建的任务。 如果队列不是分区内队列，或者未使用 ATITRANID 选项为其定义事务，那么将返回空白。

如果安全管理器未处于活动状态，那么返回的值是缺省用户标识的值，而不是已包含在已安装定义中的任何值。

BLOCKFORMAT (cvda) (仅适用于分区外队列)

返回 CVDA 值，指示与队列关联的数据集是否为分块记录格式。 它仅适用于分区外队列。 CVDA 值如下：

已阻止

记录已阻塞。

NOTAPPLIC

数据集未打开或队列不是分区外队列。

已取消阻止

未阻止记录。

BLOCKSIZE (数据区域)

返回块的长度 (以字节为单位) ，范围为 1-32767。

CHANGEAGENT (cvda)

返回用于标识上次对资源定义进行更改的代理程序的 CVDA 值。 可能的值如下所示：

CREATESPI

上次由 EXEC CICS CREATE 命令更改资源定义。

CSDAPI

上次由 CEDA 事务或 DFHEDAP 的可编程接口更改资源定义。

CSDBATCH

DFHCSDUP 作业上次更改资源定义。

DREPAPI

资源定义上次由 CICSPlex ® SM BAS API 命令更改。

OVERRIDE

资源定义上次由资源覆盖文件中的覆盖规则的应用程序更改。

SYSTEM

上次由 CICS 或 CICSPlex 系统更改资源定义。

CHANGEAGREL (data-area)

返回上次更改资源定义时运行的 CICS 版本的 4 位数字：例如， 0 760 是 CICS TS for z/OS®, Version 6. 3 的标识符。

CHANGETIME (data-area)

返回表示上次更改资源定义时的时间戳记的 ABSTIME 值。 有关 ABSTIME 值的格式的更多信息，请参阅 FORMATTIME。

CHANGEUSRID (data-area)

返回运行更改代理程序的 8 字符用户标识。

DATABUFFERS (data-area) (仅限分区外队列)

返回要由瞬时数据队列使用的缓冲区数，范围为 1-255。

DDNAME (data-area) (仅限分区外队列)

返回可引用启动 JCL 中使用的数据集名称的 8 字符标识，必要时用空格填充。

DEFINESOURCE (数据区域)

返回资源定义的 8 字符源。 DEFINESOURCE 值取决于 CHANGEAGENT 值。 有关更多信息，请参阅 资源签名字段值的摘要。

DEFINETIME (数据区)

返回 ABSTIME 值，该值表示创建资源定义时的时间戳记。

处置 (cvda) (仅限分区外队列)

返回一个 CVDA 值，指示关联数据集的状态。 CVDA 值如下：

MOD

系统首先假定数据集存在。 对于现有数据集， MOD 会使读/写机制位于数据集中的最后一条记录之后。 每当打开数据集进行输出的时候，读/写机制就会置于最后一条记录后。

如果系统在 DD 语句上，在目录中找不到数据集的卷信息，或者与先前步骤中的数据集一起传递，那么系统假定正在此作业步骤中创建数据集。 对于新的数据集， MOD 会使读/写机制定位在数据集的开头。

NOTAPPLIC

此选项不适用，因为队列未打开或不是分区外队列。

OLD

数据集在此作业步骤之前已存在。

共享

数据集在此作业步骤之前就已存在，并且可以由其他并发作业读取。

注: 使用 CEDA 来定义此参数时，可以使用缩写 SHR。

DSNAME (data-area) (仅限分区外队列)

返回 1 到 44 个字符的名称，该名称指示关联的 QSAM 数据集或 DUMMY 数据集。 如果使用 SYSOUTCLASS ，那么此数据区为空白。

EMPTYSTATUS (cvda) (仅限分区外队列)

返回 CVDA 值，指示队列在空间方面的状态。 仅当任务尝试添加记录并且没有空间时， CICS 才会检测 FULL 条件，并且仅当任务尝试读取并且没有记录时才会检测 EMPTY。 因此，除非检测到其中一个条件，否则将返回值 NOTEMPTY。 EMPTYSTATUS 仅适用于分区外队列。 CVDA 值如下：

EMPTY

队列为空。

full

队列已满。

NOTAPPLIC

此选项不适用，因为队列未打开或未分区外。

无临时

没有针对队列的操作指示该队列为空或已满。

ENABLESTATUS (cvda) (除间接队列外的所有队列)

返回 CVDA 值，指示应用程序是否可以访问该队列。 对于远程队列，此值反映本地 CICS 是将访问队列的命令转发至远程系统，还是以 DISABLED 异常条件拒绝这些命令; 它不一定反映远程系统上队列的状态。 CVDA 值如下：

DISABLED

应用程序无法访问该队列。 对于分区外队列，此值不一定表示关联的数据集已关闭。

DISABLING

当前正在禁用队列。

ENABLED

该队列可由应用程序访问。

NOTAPPLIC

队列是间接的。

ERROROPTION (cvda) (仅适用于分区外队列)

返回一个 CVDA 值，指示如果迂到 I/O 错误， CICS 将执行的操作。 CVDA 值如下：

IGNORERR

接受导致错误的块。

跳过

将跳过导致错误的块。

INDIRECTNAME (data-area) (仅间接队列)

返回此间接队列所指向的队列的 4 字符名称。 此选项仅适用于定义为间接的队列; 对于其他类型的队列，将返回空白。

INDOUBT (cvda) (仅限分区内队列)

返回一个 CVDA 值，指示如果此队列的定义指定了 WAIT (YES) ，那么 CICS 将对不确定工作单元 (UOW) 执行的操作。 CVDA 值如下：

QUEUE

UOW 不确定并正在等待; UOW 对此队列持有的任何锁定都将保持活动状态，直到 UOW 的最终状态已知为止。 将暂挂任务，而不是接收 LOCKED 响应。 在知道 UOW 的最终状态时，提交或回退所作的所有更改。 在此之前，需要其中一个活动锁定的以下类型的任何其他请求都必须等待:

• READQ (如果不确定的 UOW 已发出 READQ 或 DELETEQ 请求)
• WRITEQ (如果不确定的 UOW 已发出 WRITEQ 或 DELETEQ 请求)
• DELETEQ (如果不确定的 UOW 已发出 READQ ， WRITEQ 或 DELETEQ 请求)

拒绝

UOW 处于不确定和等待状态，并且将保留 UOW 对此队列持有的任何锁定，直到 UOW 的最终状态已知为止。 当最终状态已知时，将落实或回退它所做的任何更改。 在此之前，需要其中一个保留锁定的任何其他请求都将被拒绝，并且将返回 LOCKED 条件。 REJECT 导致在与 QUEUE 导致事务等待的环境完全相同的情况下产生 LOCKED。

IN可疑 (cvda) (仅限分区内队列)

返回一个 CVDA 值，指示已修改可恢复队列的不确定工作单元 (UOW) 是否将等待与其协调程序进行再同步以确定是落实还是回退更改。 CVDA 值如下：

无等待

UOW 不等待，并且将回退或落实对可恢复资源所作的任何更改，如事务资源定义上的 ACTION 属性所指定。

WAIT

UOW 将等待，等待时所需的任何操作由 WAITACTION 选项确定。

此参数覆盖在 UOW 的事务定义上定义的 WAIT 选项。 请参阅 TRANSACTION 资源 ，以获取有关 TDQUEUE 和 TRANSACTION 定义上不确定属性的交互的说明。

INSTALLAGENT (cvda)

返回用于标识安装资源的代理程序的 CVDA 值。 可能的值如下所示：

CREATESPI

资源是通过 EXEC CICS CREATE 命令安装的。

CSDAPI

该资源是由 CEDA 事务或 DFHEDAP 的可编程接口安装的。

GRPLIST

该资源已由 GRPLIST INSTALL安装。

SYSTEM

该资源是由 CICS 或 CICSPlex SM 系统安装的。

INSTALLTIME (数据区)

返回表示安装资源时的时间戳记的 ABSTIME 值。

INSTALLUSRID (数据区)

返回安装资源的 8 字符用户标识。

IOTYPE (cvda) (仅限分区外队列)

返回 CVDA 值，指示是否为 INPUT ， OUTPUT 或 RDBACK 定义了队列。 CVDA 值如下：

输入

队列是为输入定义的，并且是向前读取的。

NOTAPPLIC

队列未打开或不是分区外队列。

输出

为输出定义了队列。

回退

队列是为输入定义的，并向后读取。

MEMBER (data-area) (仅限分区外队列)

如果队列是分区数据集的成员，那么返回 8 字符的成员名。 如果没有，那么将返回空白。

NUMITEMS (data-area) (仅限分区内队列)

返回一个全字二进制字段，给出队列中的项数。 值-1如果队列不是分区内的，则返回。

OPENSTATUS (cvda) (仅限分区外队列)

返回 CVDA 值，指示队列是打开，关闭还是处于中间状态。 CVDA 值如下：

CLOSED

队列已关闭。

关闭

队列正在关闭。

NOTAPPLIC

队列不是分区外的。

OPEN

队列已打开。

打开

队列正在打开。

PRINTCONTROL (cvda) (仅限分区外队列)

返回一个 CVDA 值，指示为队列定义的打印控制类型 (如果有)。 打印机控制字符在使用时出现在每个记录的第一个位置。 但是， CICS 不会在将记录写入队列时检查此字符，也不会在从队列中读取记录时除去此字符; 打印机控制约定的使用和实施由使用队列的应用程序完成。 CVDA 值如下：

ASACTL

使用 ASA 控制字符。

MCHCTL

使用机器控制字符。

NOCTL

不使用打印控制字符。

NOTAPPLIC

队列未打开或未分区外。

RECORDFORMAT (cvda) (仅适用于分区外队列)

返回 CVDA 值，指示队列是具有固定长度记录还是可变长度记录。 CVDA 值如下：

固定

队列具有固定长度的记录。

NOTAPPLIC

队列未打开或未分区外。

UNDEFINED

未定义队列上记录的格式。

变量

队列具有可变长度记录。

RECORDLENGTH (data-area) (仅适用于分区外队列)

返回全字二进制字段，给出具有固定长度记录的队列的记录长度 (以字节计) 或具有可变长度记录的队列的最大记录长度。 RECORDLENGTH 选项仅适用于分区外队列；对于其他队列，-1被返回。

RECOVSTATUS (cvda) (仅限分区内队列)

返回 CVDA 值，指示为队列定义的恢复类型。 恢复仅可用于分区内队列。 CVDA 值如下：

逻辑

队列在逻辑上是可恢复的。

NOTAPPLIC

队列不是分区内的。

不可撤销

队列不可恢复。

物理

队列在物理上是可恢复的。

REMOTENAME (data-area) (仅限远程队列)

返回在其中定义队列的远程 CICS 区域中此队列的 4 字符名称 (根据其定义中的 RMTNAME 选项)。 REMOTENAME 选项仅适用于定义为远程的队列; 对于其他队列，返回的值为空白。

REMOTESYSTEM (data-area) (仅远程队列)

返回在其中定义队列的 CICS 区域的 4 字符名称 (从其定义中的 SYSIDNT 值)。 REMOTESYSTEM 选项仅适用于定义为远程的队列; 对于其他队列，返回的值为空白。

REWIND (cvda) (仅限分区外队列)

返回一个 CVDA 值，指示磁带数据集的处置。 CVDA 值如下：

保留

当前磁带定位到数据集的逻辑端。

读

当前磁带定位为重新处理数据集。

SYSOUTCLASS (数据区)

返回指示关联 SYSOUT 数据集的类属性的单个字符，如果使用 DSNAME ，那么返回空白。

TDQUEUE (data-value)

指定要查询的瞬时数据队列的 4 字符名称。

TRIGGERLEVEL (data-area) (仅限分区内)

返回一个全字二进制字段，给出在发生自动事务启动 (ATI) 之前队列必须达到的项数。 当队列达到此深度时， CICS 会调用任务以自动对其进行处理。 零值表示该队列不受 ATI 约束；-1如果队列不是分区内的，则返回。

类型 (cvda)

返回用于标识队列类型的 CVDA 值。 CVDA 值如下：

EXTRA

队列是分区外的。

INDIRECT

队列是间接的。

INTRA

队列是分区内的。

REMOTE

队列是远程的。

条件

END

RESP2 值：

2

没有更多此类型的资源定义。

ILLOGIC

RESP2 值：

1

浏览顺序错误

正常

RESP2 值：

0

没有任何错误

NOTAUTH

RESP2 值：

100

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

101

未授权与发出任务关联的用户以此命令所需的方式访问此特定资源。

QIDERR

RESP2 值：

1

找不到指定的队列。