CEMT INQUIRE UOWENQ
检索关于工作单元 (UOW) 挂起或等待的入队的信息，或关于挂起或等待指定入队的 UOW 的信息。
在 CICS Explorer®中， "工作单元入队" 视图提供与此命令等效的功能。
描述
INQUIRE UOWENQ 命令返回有关 UOW 挂起的入队的信息。 CICS® 使用入队来将可恢复资源 (例如文件记录或队列) 锁定到正在更新这些记录的 UOW。 还将返回由 EXEC CICS ENQ 命令获取的用户入队。
您可以使用 INQUIRE UOWENQ 命令来指示强制 UOW 时将影响哪些记录和队列。
该事务还会返回有关正在等待入队的 UOW 的信息。 您可以使用此选项来诊断要更新相同资源的任务之间的入队死锁。
入队通常处于活动状态，这意味着允许其他任务等待入队。 但是，如果拥有入队的 UOW 迂到不确定故障，那么通常会将入队转换为保留状态，直到可以解决不确定故障为止。 INQUIRE
UOWENQ 命令还会检索有关这些入队的信息，并可用于确定强制 UOW 时将影响哪些记录和队列。
注：
- UOW-lifetime 和 task-lifetime 入队都由 INQUIRE UOWENQ 命令返回。 (有关 UOW 和任务生存期入队的说明，请参阅 ENQ 命令的 MAXLIFETIME 选项。)
- 发生不确定故障时，将释放用户入队， 除非 EXEC CICS ENQ 命令指定了 MAXLIFETIME (TASK) ，并且不是任务结束同步点发生故障。
输入
按 "清除" 键以清除屏幕。 您可以通过两种方式启动此事务:
- 输入
CEMT INQUIRE UOWENQ(或关键字的适当缩写)。 生成的显示将列出所有当前 UOW 的所有入队。 - 输入
CEMT INQUIRE UOWENQ(或关键字的适当缩写) ，后跟限制所需信息范围所需的属性。 例如，如果输入cemt i uowe d，那么生成的屏幕仅显示以非 RLS 方式或 CICS维护的数据表打开的 VSAM 数据集中的记录上的入队详细信息。
样本屏幕
INQ UOWE
STATUS: RESULTS
Uow(AC143001D4A72601) Tra(CECI) Tas(0000038) Act Exe Own
Res(ACCOUNTS.DBASE1 ) Rle(015) Enq(00000000)
Uow(AC143001D4A72601) Tra(CECI) Tas(0000038) Act Add Own
Res(g... ) Rle(004) Enq(00000000)
注: 当值不适用或为负 (值以 "否" 开头) 时，屏幕上的字段为空白。 要修改这些字段，请通过跳进来查找这些字段 (它们以与扩展格式相同的顺序出现) ，并使用对该字段有效的输入来覆盖类型。 在设置其中一个值时，您可能会发现使用扩展格式更方便。
如果将光标放在列表中的特定条目上并按 ENTER 键，那么 CICS 将显示扩展格式，如 图 2中所示。
INQ UOWE
RESULT
Uowenq
Uow(AC143001D4A72601)
Transid(CECI)
Taskid(0000038)
State(Active)
Type(Execenq)
Relation(Owner)
Resource(ACCOUNTS.DBASE1)
Rlen(015)
Enqfails(00000000)
Netuowid(..GBIBMIYA.IYA2T5C2...Mx...)
Qualifier()
Qlen(000)
显示的字段
- DURATION (值)
- 显示自入队进入其当前状态 "所有者" ， "等待者" 或 "保留者" 以来的耗用时间 (以秒计)。
- ENQFAILS (value)
- 显示自上次获取入队以来，此资源的入队尝试失败次数 (对于保留状态的入队)。 这指示由于此入队而接收到 LOCKED 响应的 UOW 数。 ENQFAILS 选项可帮助您识别导致瓶颈的 UOW。
对于处于操作状态的入队， ENQFAILS 显示零。
- ENQSCOPE (value)
- 如果入队具有综合系统作用域，那么 ENQSCOPE 将显示用于限定此 CICS 区域发出的综合系统范围的 ENQUEUE 请求的 4 字符名称。 如果它具有区域作用域，那么 ENQSCOPE 显示空白。
具有相同 ENQSCOPE 值的所有 CICS 系统共享相同的综合系统入队名称空间。
- NETUOWID (值)
- 显示一个 27 个字符的字符串，其中包含拥有或正在等待入队的 UOW 的网络范围 LU6.2 名称。注: 不可显示的字符显示为句点。 您可以在展开的面板上使用 PF2 : 以查看十六进制值。
- QLEN (value)
- 显示 QUALIFIER 字段中显示的数据长度，范围在 0 到 255 之间。
- QUALIFIER (value)
- 显示 1 到 255 个字符的限定符 (例如，记录标识) ，该限定符进一步标识与入队锁定相关联的资源。 显示的数据取决于入队类型，如 表 1中所示。 如果没有 QUALIFIER 数据应用 (即用于 EXECUTE ， ADDREXECENQ 或 TSQ) ，那么将显示值 0。
- RELATION
- 显示数据是与入队的所有者相关联，还是与等待入队的任务相关联。 这些值如下：
- 所有者
- (value) ， NETUOWID ， TASKID 和 TRANSID 是入队所有者的那些值。
- 等待的线程 (waiter)
- (value) ， NETUOWID ， TASKID 和 TRANSID 是入队等待者的那些值。
- 资源 (value)
- 显示 1 到 255 个字符的字符串，其中包含与入队锁定关联的资源的名称。 显示的数据取决于入队类型，如 表 1中所示。注: 不可显示的字符显示为句点。 您可以在展开的面板上使用 PF2 : 以查看十六进制值。
- RLEN (value)
- 显示在 "资源" 字段中显示的数据长度，范围在 0 到 255 之间。
- STATE
- 显示入队保持的状态。 这些值如下：
- ACTIVE
- 入队处于活动状态。
- 保留
- 入队处于保留状态。 其拥有的 UOW 已被搁置，或正在被搁置。
- TASKID (value)
- 显示与 UOW 关联的任务的编号。 如果 UOW 被搁置，那么它是与 UOW 关联的任务编号 (在被搁置之前)。
- TRANSID (value)
- 显示与 UOW 关联的事务的 4 字符标识。 如果 UOW 被搁置，那么它是与 UOW 关联的事务在被搁置之前的标识。
- 类型
- 显示正在排队的资源的类型。 这些值如下：
- DATASET
- 该资源是 VSAM 数据集中的记录 (或 CICS维护的数据表)。 Resource 包含数据集的名称，而 QUALIFIER 包含记录标识。
- FILE
- 该资源是 BDAM 文件或用户维护的数据表中的记录。 Resource 包含文件的名称， QUALIFIER 包含记录标识。
当该文件是 BDAM 文件时，记录标识以 BDAM 块标识作为前缀。 如果此组合超过 255 个字符，那么将发生截断。
- 执行队列
- 该资源与 EXEC CICS ENQ 请求相关联。 Resource 包含在请求上传递的入队参数。
- ADDREXECENQ
- 该资源与 EXEC CICS ENQ 请求相关联。 Resource 包含在请求上传递的地址入队参数 (即，在请求上省略了 LENGTH 参数)。
- TDQ
- 资源是逻辑可恢复的瞬时数据队列。 Resource 包含队列的名称。 QUALIFIER 包含字符串 FROMQ 或 TOQ ，指示是对队列挂起读锁定还是写锁定。
READQ TD 请求获取 FROMQ 锁定，而 WRITEQ TD 请求获取与队列关联的 TOQ 锁定。 DELETEQ TD 请求同时获取 TOQ 和 FROMQ 锁定。
- TSQ
- 资源是可恢复的临时存储器队列。 Resource 包含队列的名称。
Resource 和 QUALIFIER 字段中显示的数据取决于资源类型，如 表 1中所示。
表 1. 在 RESOURCE 和 QUALIFIER 中显示的数据 类型 资源 限定符 DATASET 数据集名称 记录标识 执行队列 EXEC 入队参数 无 ADDREXECENQ EXEC 排队参数的地址 无 FILE 文件名 记录标识 TDQ TD 队列名称 FROMQ 或 TOQ TSQ TS 队列名称 无 - UOW (value)
- 显示关联工作单元的 16 个字符的本地标识。