INQUIRE TASK

描述

INQUIRE TASK 命令返回有关特定用户任务的信息。 用户任务是与用户定义的事务或与通常由操作员调用的 CICS®提供的事务相关联的任务。

此命令上提供的许多选项与 INQUIRE TRANSACTION 命令上提供的选项相同，因为任务从其正在执行的事务的定义中获取其大部分特征。 但是，这些属性是在任务启动时确定的。

如果在任务开始后更改了事务定义，那么该任务的属性值可能与当前事务定义的值不同。 也可以使用 SET TASK 命令或其 CEMT 等效命令来更改任务值。

此外， INQUIRE TASK 命令始终生成有关您在本地 CICS 系统上指定的任务的信息。 对于需要路由的任务或发出 LINK 命令 (可能被输送到其他系统) 的任务，您需要记住这一点。

每当一个任务全部或部分在它所产生的系统之外的系统上执行时，远程系统上就会有一个匹配的任务。 发端系统上的任务从该系统上要执行的事务的定义中获取其特征。 远程系统上的相应任务 (如果发生路由或任务发出分布式程序链接) 从远程系统上的任何事务的定义中获取其特征，该事务由始发系统通知远程系统使用。 此远程事务的属性可能与发端系统上的事务的属性不同。 (它可能具有也可能不具有其他名称; 对于静态事务路由，远程系统中事务的名称来自本地系统中事务的 REMOTENAME 选项。)

因此，对发端系统上的任务的查询可能产生与对远程系统上的相应任务的查询完全不同的结果。 出于相同原因，发出分布式程序链接的任务可能会从 INQUIRE TASK 中获取不同的结果 (从 EIB 获取任务号) ，该任务在远程执行的程序中与在本地执行的程序中的相同命令不同。

选项

ACTIVITY (数据区)

返回代表此任务执行的 BTS 活动的 16 个字符，用户分配的名称。

ACTIVITYID (数据区)

返回代表此任务执行的 BTS 活动的 52 个字符，即 CICS分配的标识。

ATTACHTIME (数据区)

以 ABSTIME 格式返回 8 字节压缩十进制值，表示连接任务的时间 (以毫秒为单位)。

BRFACILITY (数据区)

返回表示当前任务在桥接环境中运行时所使用的虚拟终端的 8 字节设施令牌。 如果该任务未在 3270 网桥环境中运行，那么将返回零。

BRIDGE (数据区)

返回发出 START BREXIT TRANSID 命令以启动此任务的网桥监视器事务或发出指向 DFHL3270链接的客户机的 4 字符事务标识。 如果该任务当前未在 3270 网桥环境中运行，那么将返回空白。

CMDSEC (cvda)

返回一个 CVDA 值，指示任务正在执行的事务的定义是否指定命令安全性。 CVDA 值如下：

CMDSECNO

未指定命令安全性。

CMDSECYES

指定了命令安全性。

当正在检查的任务发出系统编程命令时， CICS 会调用外部安全管理器 (ESM) 以验证与该任务相关联的用户是否有权使用这些命令。

A task is command-checked only when an ESM is active and either the CMDSEC value for the task is CMDSECYES or the system initialization option CMDSEC value is ALWAYS (see the SECURITYMGR option of 查询系统 for more information.

ProfilNTPROG (数据区)

返回针对此任务执行的当前程序的 1-to 8 字符名称 (对于 CICS 程序管理器域已知)。

DB2PLAN (data-area)

返回此任务正在使用的 DB2PLAN 的 1-to 8 字符名称，如果未使用 DB2PLAN ，那么返回空白。

DTIMEOUT (数据区)

返回一个全字二进制字段，给出死锁超时时间间隔 (以秒为单位)。 CICS 异常终止等待时间超过锁定资源死锁超时值的任务。

正在转储 (cvda)

返回 CVDA 值，指示如果任务异常终止， CICS 是否应执行事务转储。 CVDA 值如下：

NOTRANDUMP

不执行转储。

TRANDUMP

进行转储。

此值仅适用于异常终止转储，对 DUMP TRANSACTION 命令没有任何影响。

FACILITY (数据区)

返回与启动此任务关联的设施的 4 字符名称 (如果该设施是瞬时数据队列或终端或系统)。 如果任务以别的方式启动，那么设施的值为空。 FACILITYTYPE 选项告诉您是什么类型的设施导致了任务启动，因此说明了 FACILITY 表示的内容。

FACILITYTYPE (cvda)

返回用于标识启动此任务的设施类型的 CVDA 值。 CVDA 值包括：

DEST

CICS 已启动任务来处理已达到触发器级别的瞬时数据队列; FACILITY 选项返回队列的名称。

TASK

另一个任务使用未指定终端的 START 命令启动了该任务，或者 CICS 在内部创建了该任务; 在这种情况下， FACILITY 选项返回空白。

TERM

该任务已启动以处理主动输入，或者另一个任务已使用带有 TERMID 选项的 START 命令启动该任务。 在第一种情况下， FACILITY 选项返回发送输入的终端的名称，而在第二种情况下，它返回在 TERMID 中指定的终端。

IDENTIFIER (数据区域)

如果任务是在 3270 网桥环境中启动的，那么返回包含网桥出口提供的用户数据的 48 个字符的字段，否则返回空白。 此字段旨在帮助解决联机问题。 例如，它可能包含用于 CICS-MQ 网桥的 IBM® MQ 相关因子或 Web 令牌。

INDOUBT (cvda)

根据 TRANSACTION 资源定义的 ACTION 属性返回 CVDA 值，指示在 CICS 区域发生故障时要执行的操作，或者在工作单元处于不确定周期时与其协调程序断开连接时要执行的操作。

该操作依赖于IN可疑特和IN可疑特中返回的值; 如果IN可疑特返回 WAIT ，那么直到IN可疑特中返回的时间到期，才会执行该操作。

CVDA 值包括：

回退

将回退对可恢复资源所作的所有更改。

落实

将落实对可恢复资源所作的所有更改，并将工作单元标记为已完成。

注: 如果程序使用过时的 DTB 选项 (已被 INDOUBT 替换) ，那么将返回 CVDA 值 NOTSUPPORTED。

IN可疑 (数据区)

返回一个全字二进制字段，给出在不确定时间段内失败后的时间长度 (以分钟为单位) ，然后该任务将执行 INDOUBT 字段中返回的操作。 仅当工作单元不确定且 INDOUBT 返回 WAIT 时，返回的值才有效。

另请参阅 INDOUBT 和 INDOUBT。

IN可疑 (cvda)

返回基于 TRANSACTION 定义的 WAIT 属性的 CVDA 值，指示当工作单元 (UOW) 处于不确定状态时发生故障时如何进行响应。 CVDA 值包括：

无等待

工作单元不等待，暂挂从故障恢复。 CICS 将立即执行对 TRANSACTION 定义的 ACTION 属性指定的任何操作。

WAIT

工作单元将等待，暂挂从故障恢复，以确定是要回退还是落实可恢复资源。

有关 TRANSACTION 定义的 ACTION 和 WAIT 属性含义的更多信息，请参阅 TRANSACTION 资源。

IP设施 (ptr-ref)

返回 4 字节二进制令牌列表的地址，每个二进制令牌标识任务用于与另一个系统通信的 IPCONN 会话。 如果此任务没有此类 IP 设施，那么IP设施指针将包含空值。

CICS 获取列表的存储器，并在查询任务发出另一个 INQUIRE TASK 命令或结束时释放该存储器; 该任务无法释放存储器本身。

IPFLISTSIZE (数据区)

返回一个全字二进制字段，给出与此任务关联的 IP 设施的数量。 (即，它返回由IP设施选项寻址的列表中的项数。)

如果此任务没有 IP 设施，那么 IPFLISTSIZE 包含零。

ISOLATEST (cvda)

返回一个 CVDA 值，指示任务是否定义为隔离任务。 隔离会限制用户密钥程序对任务存储器的读和写访问。 代表隔离任务在用户密钥中执行的程序只能访问该任务的任务存储器，而不能由代表其他任务在用户密钥中执行的程序访问此存储器。 隔离不会影响 CICS密钥程序的访问，并且不适用于具有 SHARED 属性的存储器或任何其他非任务存储器。

ISOLATEST 的值取自创建任务时该任务正在执行的 TRANSACTION 的定义。 对于定义为隔离以执行隔离的任务，系统的事务隔离也必须处于活动状态 (请参阅 INQUIRE SYSTEM的 TRANISOLATION 选项)。

ISOLATE

该任务定义为隔离任务。

无隔离

该任务定义为未隔离。

PRIORITY (数据区域)

返回一个全字二进制字段，给出任务的总优先级。 总优先级是与任务关联的用户的优先级总和，作为主要设施的终端的优先级以及正在执行的事务的优先级 (请参阅 TRANPRIORITY 选项)。

PROCESS (数据区)

返回此任务所属的 BTS 进程的 36 个字符的名称。

PROCESSTYPE (数据区)

返回此任务所属的 BTS 进程的类型定义的 8 字符标识。

PROFILE (数据区)

返回此任务正在执行的事务的 PROFILE 的 8 字符名称。

PROGRAM (数据区)

返回在此任务中首先执行的程序的 8 字符名称。

PURGEABILITY (cvda)

返回一个 CVDA 值，指示是否允许 CICS 清除此任务 (即，异常终止此任务)。 清除请求来自 SET TASK PURGE 命令 (或 CEMT 等效命令) ， CICS 可以在内部生成这些请求，以回收资源来缓解系统停滞状况。 CVDA 值包括：

不可清除

无法清除该任务。

可清除

可以清除该任务。

PURGEABILITY 值最初由此任务正在执行的事务的定义中的 SPURGE 选项设置。

REMOTENAME (数据区)

返回在此任务正在执行的 TRANSACTION 定义的 REMOTENAME 选项中指定的 8 字符名称。

如果 REMOTESYSTEM 是 CICS 系统，那么 REMOTENAME 由 CICS transid 加上尾部空格组成。 如果 REMOTESYSTEM 是 IMS 系统，那么 REMOTENAME 由 IMS transid 组成。 应用程序必须提供可将此值移动到其中的 8 字节变量。

当 CICS 静态路由任务时， REMOTENAME 是远程系统上的伙伴任务执行的事务的名称。 因此， REMOTENAME 对于您仅在需要路由时查询的任务很重要。

如果事务定义未指定 REMOTENAME ，那么 CICS 将返回空白。

REMOTESYSTEM (数据区)

返回在此任务正在执行的 TRANSACTION 定义的 REMOTESYSTEM 选项中指定的 4 字符名称。 当 CICS 以静态方式路由任务时， REMOTESYSTEM 是任务所路由到的系统的 CONNECTION 定义的名称。 与 REMOTENAME 一样， REMOTESYSTEM 对于您仅在需要路由时查询的任务很重要。

如果 TRANSACTION 定义未指定 REMOTESYSTEM ，那么 CICS 返回空白。

RESNAME (数据区)

RESNAME (SUSPENDVALUE 的替代方法) 返回在 TS 队列上暂挂的任务的 16 个字符的资源名称。

RESSEC (cvda)

返回 CVDA 值，指示任务正在执行的 TRANSACTION 的定义是否指定资源级别安全性检查。 CVDA 值包括：

RESSECNO

未指定命令安全性。

支持

指定了命令安全性。

检查任务时， CICS 会在每个命令上验证与该任务关联的用户是否有权以请求的方式访问指定的资源。

A task is checked only when an external security manager is active and either the RESSEC value for the task is RESSECYES or the system initialization option RESSEC value is ALWAYS (see the SECURITYMGR option of 查询系统 for more information.

ROUTING (cvda)

返回一个 CVDA 值，指示此任务正在执行的事务是否指定动态路由 (在 TRANSACTION 定义中的 DYNAMIC 选项中)。 动态路由正好发生在任务的初始分派之前，因此此值指示动态路由可能已发生 (如果任务已在执行中) 还是可能尚未发生 (如果尚未分派)。 CVDA 值包括：

DYNAMIC

动态路由应用。

静态

动态路由不适用。

RTIMEOUT (数据区)

返回一个全字二进制字段，给出读取超时时间间隔 (以秒计)。 如果任务等待输入的时间超过其读超时值，那么 CICS 会异常终止该任务。 RTIMEOUT 值由与此任务正在执行的 TRANSACTION 关联的 PROFILE 定义中的 RTIMOUT 选项设置。

RUNAWAY (data-area)

以全字二进制值的形式返回此任务的 失控任务 时间 (以毫秒为单位)。 如果任务在单个分派上保持对处理器的控制超过此时间间隔，那么 CICS 将假定它处于循环中并异常终止。 如果该值为零，那么 CICS 不会监视任务是否存在失控情况。

RUNSTATUS (cvda)

返回 CVDA 值，指示任务的分派状态。 CVDA 值包括：

可分派

该任务已准备好运行。

正在运行

任务正在运行。

已暂挂

该任务未准备好运行。

SCRNSIZE (cvda)

返回一个 CVDA 值，指示备用屏幕大小还是缺省屏幕大小适用于此任务。 CVDA 值包括：

备用

备用屏幕大小适用。

缺省值

将应用缺省屏幕大小。

SCRNSIZE 值由与此任务正在执行的事务相关联的 PROFILE 定义中的同名选项设置。

SRRSTATUS (cvda)

返回一个 CVDA 值，指示事务安全性请求记录状态。 CVDA 值如下：

SRRACTIVE

安全请求记录处于活动状态。

源不活动

安全请求记录处于不活动状态。

STARTCODE (数据区)

返回一个 2 字符值，指示此任务的启动方式。 可能的值为：

D

已启动该任务以处理未指定 SYNCONRETURN 选项的分布式编程链接 (DPL) 命令。 （不允许任务发出同步点。）

DS

已启动该任务以处理包含 SYNCONRETURN 选项的分布式编程链接 (DPL) 命令。 （允许任务发出同步点）。

QD

CICS 启动了用于处理已达到触发器级别的瞬时数据队列的任务。

S

另一个任务使用未在 FROM 选项中传递数据的 START 命令启动了此任务。 START 命令可以传递通道，也可以不传递通道。

SD

另一个任务使用在 FROM 选项中传递数据的 START 命令启动了此任务。

SZ

该任务是使用 FEPI START 命令启动的。

TO

启动该任务以处理来自终端 (或其他系统) 的非请求输入，并从输入确定要执行的事务。

TP

已启动该任务以处理非请求的输入或响应另一任务中的 RETURN IMMEDIATE 命令。 在任何一种情况下，要执行的事务是（在 RETURN 命令或关联的 TERMINAL 定义中）预先设置的，无需引用输入。

U

CICS 在内部创建了该任务。

注: 当 IIOP 请求处理器在本地运行时， ASSIGN 命令或 INQUIRE TASK 的起始代码为 U。 当通过 MRO 链接以远程方式运行 IIOP 请求处理器时，这些命令的启动代码为 TO。 （如果尝试通过其他类型的连接远程运行 IIOP 请求处理器，将不会接受路由请求，因此上述命令启动码将不再适用）。

STORAGECLEAR (cvda)

返回 CVDA 值，指示 CICS 是否应该清除从此任务释放的存储器 (以防止其他任务意外查看机密数据)。 CVDA 值包括：

CLEAR

已清除存储器。

无

将不会清除存储器。

SUSPENDTIME (data-area)

返回一个全字二进制字段，给出自上次分派以来已暂挂任务的秒数 (向下舍入) (如果其 RUNSTATUS 值为 SUSPENDED)。 如果任务正在运行或可分派，那么 SUSPENDTIME 值为 − 1。

SUSPENDTYPE (data-area)

返回 8 字符文本字符串，指示暂挂此任务的原因 (如果是) (对于正在运行或可分派的任务，将返回空白)。 另请参阅 SUSPENDVALUE 选项。

SUSPENDVALUE (data-area)

返回此任务正在等待的资源的 8 字符名称 (例如，如果任务在记录上排队，那么为文件名)。 SUSPENDVALUE 仅适用于已暂挂的任务；如果任务正在运行或可分派，那么返回值为空白。

TASK (data-value)

指定要查询的任务的 4 字节压缩十进制序号。

TASKDATAKEY (cvda)

返回一个 CVDA 值，指示 CICS 在其中获取此任务的存储器的存储密钥。 这包括任务生存期存储器-事务工作区 (TWA) 和 EXEC 接口块 (EIB)-以及 CICS 代表在此任务下运行的程序获取的存储器。

请参阅 TRANSACTION resources 中 TASKDATAKEY 选项的描述以获取更多信息。

CVDA 值如下：

CICSplex 数据键

CICS 从 CICS键存储器获取存储器。

用户数据键

CICS 从用户密钥存储器获取存储器。

为 TASKDATAKEY 返回的值取自任务正在执行的 TRANSACTION 的定义。 要确定存储保护是否处于活动状态 (即，用户密钥是否具有与 CICS-key 不同的值) ，需要发出带有 STOREPROTECT 选项的 INQUIRE SYSTEM 命令。

TASKDATALOC (cvda)

返回 CVDA 值，指示此任务 (任务的CICS 控制块，例如 EIB 和 TWA) 的任务生存期存储器是应该在 16 MB 界线之上还是之下获取。 CVDA 值如下：

任何

任务生存期存储器可以低于或高于 16 MB 界线。

下面

任务生存期存储器必须低于 16 MB 界线。

TCB (cvda)

返回一个 CVDA 值，指示运行任务的 TCB 类型。 CVDA 值如下所示：

CKOPEN

该任务正在 CICS 密钥开放式 TCB 下运行。

内部

该任务正在其中一个 CICS 内部 TCB 下运行。 内部 TCB 可以是下列其中一项:

• 并发方式 (CO) TCB
• 文件拥有方式 (FO) TCB
• 资源拥有方式 (RO) TCB
• ONC/RPC 方式 (RP) TCB
• 套接字侦听器方式 (SL) TCB
• 安全套接字层方式 (SO) TCB
• 套接字方式 (S8) TCB
• FEPI 方式 (SZ) TCB。

QR

该任务正在 CICS QR TCB 下运行。

已打开

该任务正在用户密钥开放式 TCB 下运行。

TCLASS (数据区)

返回一个全字二进制字段，给出此任务所属的事务类的编号 (如果它属于已编号的事务类)。 保留此选项是为了与较早发行版兼容，其中事务类从 1 编号到 10。 如果任务不属于此类，那么返回的值为零。 (请参阅 TRANCLASS 选项以获取更多信息。)

跟踪 (cvda)

返回一个 CVDA 值，指示对此任务有效的跟踪类型。 CVDA 值包括：

特殊跟踪

此任务的跟踪是特殊的。

SPRSTRACE

禁止对此任务进行跟踪。

节跟踪

此任务的跟踪是标准的。

有关跟踪类型的更多信息，请参阅 CETR-跟踪控制。

TRANCLASS (数据区)

返回任务所属的事务类的 8 字符名称。 如果任务不隶属于任何类，那么会返回缺省类 DFHTCL00。 如果任务属于已编号的类，那么返回的值为 DFHTCLnn，其中 nn 是 2 数字的类号。

TRANPRIORITY (数据区)

返回一个全字二进制字段，该字段提供来自正在执行的 TRANSACTION 的定义中的 PRIORITY 选项的任务的总优先级部分。 (另请参阅此命令的 PRIORITY 选项。)

TRANSACTION (数据区)

返回此任务正在执行的事务的 4 字符名称。

TRPROF (数据区)

如果任务在 ISC 链接上路由，那么返回用于系统间流的概要文件定义的 8 字符名称。

TWASIZE (数据区)

返回一个全字二进制字段，其中给出此任务的事务工作区 (TWA) 的大小 (以字节计)。

UOW (数据区)

以 8 字节字段的形式返回与此任务关联的工作单元的本地标识。

USERID (数据区)

返回与任务关联的用户的 8 字符标识。

条件

INVREQ

RESP2 值：

1

指定了 SUSPENDVALUE ，但丢失了有效字符。

3

指定了 TCLASS ，但该任务属于指定的 CLASS ，而不是编号的 CLASS。 用户应指定 TRANCLASS 选项。

10

请求的数据保存在数据概要文件上，但数据概要文件不可用。

NOTAUTH

RESP2 值：

100

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

TASKIDERR

RESP2 值：

1

找不到该任务。

2

该任务正在执行不受此命令约束的事务类型。