INQUIRE TSQUEUE / TSQNAME
检索有关临时存储器队列的信息。 此主题也适用于命令 INQUIRE TSQNAME。 使用任一命令来查询长达八个字符的名称；使用 INQUIRE TSQNAME 来查询长达 16 个字符的 名称。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: END ， ILLOGIC ， INVREQ ， NOTAUTH ，PO可用， QIDERR 和 SYSIDERR
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
此命令是线程安全的。
描述
INQUIRE TSQUEUE 命令返回有关特定临时存储器队列的信息。
浏览
您可以使用 INQUIRE TSQUEUE 命令上的浏览选项 (START ， AT ， NEXT 和 END) 来浏览系统中的临时存储器队列。 在浏览方式下，将按字母顺序返回定义，如果需要，可以使用 AT 选项指定起始点。 例如，要查看名称以 ABC 开头的队列，请使用 AT 值 ABC 开始浏览，并在右边填充 8 个字符的空值 (X'00 ')。
要浏览共享临时存储池中的临时存储器队列，必须仅在浏览 START 请求上指定 POOLNAME 或 SYSID 选项。 对于由临时存储器表 (TST) 中的 TYPE=SHARED 条目定义并映射到共享 TS 池的队列，必须指定显式 SYSID。
在浏览中， CICS® 会返回所有队列，您可能会看到 CICS 为内部使用而创建的队列以及用户应用程序创建的队列。 名称以以下字符开头的队列是 CICS 队列: ** ， $$ ， X'FA ' 到 X'FF'， CEBR 和 DF。
请参阅 浏览资源定义 ，以获取有关浏览的常规信息，包括语法，异常条件和示例。
选项
- EXPIRYINT (数据区)
- 返回一个全字二进制字段，该字段给出在其 TSMODEL 资源定义中为临时存储器队列定义的到期时间间隔 (以小时为单位)。
返回的值派生自向上舍入到下一小时的 EXPIRYINTMIN 值，或者如果未指定分钟，那么派生自先前发行版的模型中定义的任何 EXPIRYINT 值。
如果在到期时间间隔内未引用临时存储器队列，那么它可以由 CICS自动删除。值为零表示没有到期时间间隔适用于临时存储器队列，因此它永远不适合自动删除。 此外， CICS从不自动删除以下类型的临时存储器队列，即使在匹配的 TSMODEL 资源定义中设置了非零到期时间间隔也是如此:- 辅助临时存储器中定义为可恢复的队列。
- 远程 CICS 区域中的队列。
- CICS 为自己使用而创建的队列。
CICS TS 5.3 ，过期时间间隔也适用于共享临时存储队列。
- EXPIRYINTMIN (数据区)
- 返回一个全字二进制字段，该字段给出在其 TSMODEL 资源定义中为临时存储器队列定义的到期时间间隔 (以分钟为单位)。 CICS 使用向上舍入到最接近的 10 分钟倍数的值。 如果在到期时间间隔内未引用临时存储器队列，那么它可以由 CICS自动删除。值为零表示没有到期时间间隔适用于临时存储器队列，因此它永远不适合自动删除。 此外， CICS从不自动删除以下类型的临时存储器队列，即使在匹配的 TSMODEL 资源定义中设置了非零到期时间间隔也是如此:
- 辅助临时存储器中定义为可恢复的队列。
- 远程 CICS 区域中的队列。
- CICS 为自己使用而创建的队列。
CICS TS 5.3 ，过期时间间隔也适用于共享临时存储队列。
- FLENGTH (数据区)
- 返回一个全字二进制字段，该字段给出临时存储器队列中所有项的总长度 (以字节计)。 有关队列长度的更多信息，请参阅 MAXITEMLEN 选项。
仅适用于共享队列: 当整个共享队列存储在耦合设施中的单个条目中时， FLENGTH 是所有项 (包括其控制信息) 的总大小。 在此情况下， FLENGTH 的返回值小于 32K (32768)。
当共享队列已存储为耦合设施中的单独列表时，总大小估计为 MAXITEMLEN 乘以 NUMITEMS。
- LASTUSEDINT (数据区)
- 返回一个全字二进制字段，该字段给出自上次引用临时存储器队列以来的时间间隔 (以秒计)。
针对大型共享临时存储器队列返回的值由针对关联的 TS 队列管理器指定的 LASTUSEDINTERVAL 参数的值控制。 请参阅 定义 TS 服务器区域 。
- 位置 (cvda)
- 返回一个 CVDA 值，指示临时存储器队列所在的位置。 CVDA 值如下：
- AUXILIARY
- 临时存储器队列保存在 CICS 临时存储器 VSAM 数据集 (或耦合设施) 中。
- MAIN
- 临时存储器队列保存在主存储器中。
- MAXITEMLEN (数据区)
- 返回半字二进制字段，该字段给出临时存储器队列中最大项的长度 (以字节计)。
- MINITEMLEN (数据区)
- 返回半字二进制字段，其中给出临时存储器队列中最小项的长度 (以字节计)。
- NUMITEMS (数据区)
- 返回半字二进制字段，用于提供临时存储器队列中的项数。
- POOLNAME (data-value) (仅限 TS 数据共享)
- 指定临时存储池的名称。 CICS 向管理池的临时存储器服务器提供命令。
对于浏览操作，请仅在浏览 START 请求上指定 POOLNAME ，而不在 NEXT 或 END 请求上指定 POOLNAME。
- RECOVSTATUS (cvda)
- 返回一个 CVDA 值，指示队列的恢复状态。 CVDA 值如下：
- 可恢复
- 队列可恢复。
- 不可逆
- 队列不可恢复。
- SYSID (data-value) (仅 TS 数据共享)
- 指定与临时存储池名称对应的系统名称。 如果 CICS 在 TST TYPE=SHARED 条目中找到指定的系统名称，那么它会将该命令提供给管理池的临时存储服务器。 如果 CICS 在 TST 中找不到系统名称，那么将发出 INVREQ 响应。
对于浏览操作，仅在浏览 START 请求上指定 SYSID ，而不在 NEXT 或 END 请求上指定 SYSID。
- TRANSID (data-value)
- 返回创建临时存储器队列的事务的标识。
- TSMODEL (data-value)
- 返回在创建临时存储器队列时使用的临时存储器模型的 8 字符名称。 请注意，自创建队列以来，可能已变更或删除模型。
- TSQUEUE (data-value)
- 指定要查询的临时存储器队列的 8 字符名称。
- TSQNAME (data-value)
- 是 TSQUEUE 的替代方法，并指定要查询的临时存储器队列的名称 (16 个字符)。
条件
- END
- RESP2 值：
- 2
- 没有更多此类型的资源定义。
- ILLOGIC
- RESP2 值：
- 1
- 当浏览此资源类型时，您已发出 START 命令，或者当浏览此资源类型时，您已发出 NEXT 或 END 命令。
- INVREQ
- RESP2 值：
- 1
- 在临时存储器表中的任何 TYPE=SHARED 条目中都不存在指定的 SYSID。
- 2
- 指定 INQUIRE TSQUEUE NEXT 时，要浏览的下一个队列的队列名称超过 8 个有效字符。 队列名称被截断，一些重要字符丢失。
- 4
- 无法删除此临时存储器队列名称，因为它是由 CICS 使用 PUTQ 宏写入的。
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。
- 101
- 未授权与发出任务关联的用户以此命令所需的方式访问此特定资源。
- 容错
- RESP2 值：
- 3
- POOLNAME 不存在。
- QIDERR
- RESP2 值：
- 1
- 找不到临时存储器队列。
- SYSIDERR
- RESP2 值：
- 3
- SYSID 未映射到共享池。
- 4
- 服务器错误。
- 5
- 耦合设施上发生 I/O 错误。