CEMT INQUIRE TDQUEUE

检索有关瞬时数据队列的信息。

在 CICS Explorer中， TD 队列视图 提供与此命令等效的功能。

描述

INQUIRE TDQUEUE 命令返回有关 TDQUEUE 资源定义中定义的指定瞬时数据 (TD) 队列的信息。

资源特征符

您可以使用此命令来显示资源签名字段。 您可以使用这些字段来管理资源，方法是捕获资源的定义，安装和上次更改时间的详细信息。 有关更多信息，请参阅 审计资源。 资源签名字段为 CHANGEAGENT ， CHANGEAGREL ， CHANGETIME ， CHANGEUSRID ，DEFINES还是 DEFINETIME ， INSTALLAGENT ， INSTALLTIME 和 INSTALLUSRID。 请参阅 资源签名字段值摘要 ，以获取有关资源签名字段内容的详细信息。

输入

按 "清除" 键以清除屏幕。 您可以通过两种方式启动此事务:
  • 输入 CEMT INQUIRE TDQUEUE (或关键字的适当缩写)。 生成的显示将列出当前状态。
  • 输入 CEMT INQUIRE TDQUEUE (或关键字的适当缩写) ，后跟限制所需信息范围所需的属性。 例如，如果输入 cemt i td ind en，那么生成的显示仅显示那些间接且已启用的瞬时数据队列的详细信息。
您可以通过以下方式更改各种属性:
  • 将选项卡切换到相应字段后，在 INQUIRE 屏幕上覆盖您的更改。 请参阅 覆盖显示。
  • 使用 CEMT SET TDQUEUE 命令。
(value)
瞬时数据队列的 1-4 字符标识。
ALL
缺省值。

样本屏幕

图 1。 示例 CEMT INQUIRE TDQUEUE 屏幕
 IN TDQ
 STATUS:  RESULTS - OVERTYPE TO MODIFY
  Tdq(CADL)              Ind Nam(CSSL)
  Tdq(CAIL)              Ind Nam(CSSL)
  Tdq(CCPI)              Ind Nam(CSSL)
  Tdq(CCSE)              Ind Nam(CCSO)
  Tdq(CCSO)              Ext           Ena Ope
                             Mod Out Dat(001) Ddn(COUT    )
  Tdq(CDBC)              Ind Nam(CSSL)
  Tdq(CDUL)              Ind Nam(CSSL)
  Tdq(CESE)              Ext           Ena Ope
                             Shr Out Dat(001) Ddn(CEEMSG  )
  Tdq(CESO)              Ext           Ena Ope
                             Shr Out Dat(001) Ddn(CEEOUT  )
  Tdq(CMIG)              Ind Nam(CSSL)
  Tdq(CRDI)              Ind Nam(CSSL)
+ Tdq(CSCS)              Ind Nam(CSSL)
注: 当值不适用或为负 (值以 "否" 开头) 时，屏幕上的字段为空白。 要修改这些字段，请通过跳进来查找这些字段 (它们以与扩展格式相同的顺序出现) ，并使用对该字段有效的输入来覆盖类型。 在设置其中一个值时，您可能会发现使用扩展格式更方便。

如果将光标放在列表中的特定条目上并按 Enter 键，那么 CICS® 将显示扩展格式，如 图 2中所示。

图 2。 单个条目的展开显示
IN TDQ
RESULT - OVERTYPE TO MODIFY
  Tdqueue(CCSO)
  Type(Extra)
  Nameind()
  Triggerlevel(       )
  Enablestatus( Enabled )
  Openstatus( Open )
  Termid()
  Tranid()
  Userid()
  Disposition(Mod)
  Iotype(Output)
  Indoubt()
  Indoubtwait()
  Databuffers(001)
  Ddname(COUT)
  Dsname(BELL.CICSHT61.JOB04382.D0000105.?)

CEMT INQUIRE TDQUEUE

读取语法图跳过可视语法图CEMT INQUIRE TDQUEUE ALL( 值)TRIGGERLEVEL( 值)INDIRECTEXTRAINTRAREMOTENAMEIND( 值)ENABLEDDISABLEDOPENCLOSEDTERMID( 值)TRANID( 值)USERID( 值)SHROLDMODINPUTOUTPUTRDBACKQUEUEREJECTNOWAITWAITINDOUBT( 值)DATABUFFERS( 值)DDNAME( 值)DSNAME( 值)MEMBERINSTALLTIME( 日期时间)INSTALLUSRID( 值)CREATESPICSDAPIGRPLISTSYSTEMDEFINESOURCE( 值)DEFINETIME( 日期时间)CHANGETIME( 日期时间)CHANGEUSRID( 值)CREATESPICSDAPICSDBATCHDREPAPISYSTEMCHANGEAGREL( 值)

显示的字段

CHANGEAGENT (value)
显示用于标识对资源定义进行最后一次更改的代理程序的值。 不能使用 CEMT 对其中某些值进行过滤，因为这些值是重复的。 可能的值如下所示：
CREATESPI
上次由 EXEC CICS CREATE 命令更改资源定义。
CSDAPI
上次由 CEDA 事务或 DFHEDAP 的可编程接口更改资源定义。
CSDBATCH
DFHCSDUP 作业上次更改资源定义。
DREPAPI
资源定义上次由 CICSPlex SM BAS API 命令更改。
SYSTEM
上次由 CICS 或 CICSPlex 系统更改资源定义。
CHANGEAGREL (value)
显示上次更改资源定义时正在运行的 CICS 发行版的 4 数字。
CHANGETIME (日期时间)
显示上次更改资源定义的日期和时间。 日期的格式取决于您为 CICS 区域的 DATFORM 系统初始化参数选择的值。 时间的格式为 hh:mm:ss。
CHANGEUSRID (值)
显示运行更改代理程序的 8 字符用户标识。
DATABUFFERS (值) (仅适用于分区外队列)
显示可由关联 QSAM 数据集使用的缓冲区数，范围为 1-255。

分区外队列可以是输入或输出，但不能同时是两者。

DDNAME (值) (仅限分区外队列)
显示可能引用启动 JCL 中定义的数据集的 1-to-8 字符值。
DEFINESOURCE (值)
显示资源定义的源。 DEFINESOURCE 值取决于 CHANGEAGENT 选项。 有关详细信息，请参阅 资源特征符字段值摘要。
DEFINETIME (日期时间)
显示创建资源的日期和时间。 日期的格式取决于您为 CICS 区域的 DATFORM 系统初始化参数选择的值。 时间的格式为 hh:mm:ss。
处置 (仅分区外队列)
显示关联数据集的状态。
SHR
数据集在此作业步骤之前就已存在，并且可以由其他并发作业读取。
OLD
数据集在此作业步骤之前已存在。
MOD
系统首先假定数据集存在。 对于现有连续数据集，MOD 会使得读/写机制置于数据集的最后一条记录后。 每当打开数据集进行输出的时候，读/写机制就会置于最后一条记录后。

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

DSNAME (值) (仅限分区外队列)
显示关联 QSAM 数据集的名称 (长度为 1-44 个字符) ，或显示指示此瞬时数据队列是否将使用该数据集的哑元数据集 (或哑元数据集名称)。 此选项仅适用于输出资源。
ENABLESTATUS (除间接队列和远程队列外)
显示指示应用程序是否可以访问队列的值。
ENABLED
该队列可由应用程序访问。
DISABLED
虽然队列仍可打开，但应用程序无法访问该队列。 不能禁用名称以 C 开头的队列，因为它们通常保留供 CICS使用。
注：
  1. 您可以通过使用其他值覆盖此值来重置此值。
  2. 仅当没有当前用户时，才能禁用队列。 如果工作单元 (UOW) 当前正在使用队列，那么队列将进入 禁用暂挂 状态。 在队列上完成其操作的最后一个 UOW 完全禁用该队列。
  3. 当队列处于 禁用暂挂 状态时，无法更改 ENABLESTATUS 选项的值。
INDOUBT (值) (仅限分区内队列)
指示如果此队列的定义指定了 WAIT (YES) ，那么 CICS 将对不确定的工作单元 (UOW) 执行操作。
IN可疑的 (仅限分区内队列)
指定不确定工作单元 (UOW) (已修改逻辑可恢复队列) 是否应与其协调程序等待再同步以确定是落实还是回退更改。
无等待
UOW 不等待。 按照 TRANSACTION 资源定义上 ACTION 属性的指定，回退或落实对可恢复资源所作的任何更改。
WAIT
UOW 将等待，等待时所需的任何操作由 WAITACTION 属性确定。

此属性覆盖在 UOW 事务定义上定义的 WAIT 参数。

INSTALLAGENT (值)
显示用于标识安装资源的代理程序的值。 不能使用 CEMT 对其中某些值进行过滤，因为这些值是重复的。 可能的值如下所示：
CREATESPI
资源是通过 EXEC CICS CREATE 命令安装的。
CSDAPI
该资源是由 CEDA 事务或 DFHEDAP 的可编程接口安装的。
GRPLIST
该资源已由 GRPLIST INSTALL安装。
SYSTEM
该资源是由 CICS 或 CICSPlex SM 系统安装的。
INSTALLTIME (日期时间)
显示安装资源的日期和时间。 日期的格式取决于您为 CICS 区域的 DATFORM 系统初始化参数选择的值。 时间的格式为 hh:mm:ss。
INSTALLUSRID (值)
显示安装资源的 8 字符用户标识。
IOTYPE (仅限分区外队列)
显示要使用的数据集的类型:
输入
输入数据集。
输出
输出数据集。
RDBACK
要向后读取的输入数据集。
MEMBER (仅限分区外队列)
返回 1-to 8 字符的名称，该名称指示分区数据集的成员名。 如果 QSAM 数据集不是分区数据集，那么此名称为空白。
打开状态 (仅适用于分区外队列)
显示分区外队列是打开还是关闭。
OPEN
队列已打开。
CLOSED
队列已关闭。
注：
  1. 您可以通过使用其他值覆盖此值来重置此值。
  2. 在可以打开或关闭队列之前，不再需要启用队列。 建议先禁用队列，然后再将其打开或关闭。
NAMEIND (value) (仅限间接队列)
显示用于标识间接队列指向的队列的名称的 4 字符字符串。
QUEUE
UOW 不确定并正在等待; UOW 对此队列持有的任何锁定都将保持活动状态，直到 UOW 的最终状态已知为止。 因此，将暂挂任务，而不是接收 LOCKED 响应。 当 UOW 的最终状态已知时，将落实或回退它所做的任何更改。 在此之前，需要其中一个活动锁定的以下类型的任何其他请求都必须等待:
  • READQ (如果不确定的 UOW 已发出 READQ 或 DELETEQ 请求)
  • WRITEQ (如果不确定的 UOW 已发出 WRITEQ 或 DELETEQ 请求)
  • DELETEQ (如果不确定的 UOW 已发出 READQ ， WRITEQ 或 DELETEQ 请求)
拒绝
UOW 不确定且正在等待。 此队列的 UOW 持有的任何锁定都将保留，直到 UOW 的最终状态已知为止。 当最终状态已知时，将落实或回退 UOW 所做的任何更改。 在此之前，需要其中一个保留锁定的任何其他请求将被拒绝，并且将返回 LOCKED 响应。 INDOUBT = REJECT 导致在与 INDOUBT = QUEUE 导致事务等待的情况完全相同的情况下发出 LOCKED 响应。
TDQUEUE (value)
指示此面板与 TDQUEUE 查询相关，并显示瞬时数据队列的 4 字符标识。 以 C 开头的队列名称通常保留供 CICS使用。
TERMID (值)
显示在发生自动事务启动 (ATI) 时要与此队列关联的终端或会话的 4 字符名称。 另请参阅 TRANID 和 TRIGGERLEVEL。
TRANID (value)
显示在达到队列触发器级别时要自动启动的事务的 4 字符标识。
TRIGGERLEVEL (value) (仅适用于分区内队列)
显示在发生自动事务启动 (ATI) 之前必须累积的队列输出请求数。 该数字可以在 0 到 32767 之间。

您可以通过使用其他值覆盖此值来重置此值。

类型
显示此瞬时数据队列的类型。
INDIRECT
队列类型是间接的。 最终目标队列的名称显示在下一个字段中。
EXTRA
队列类型为分区外。
INTRA
队列类型为分区内。
REMOTE
队列类型是远程的。
USERID
显示与用于 ATI 的分区内队列关联的 8 字节标识。