INQUIRE DISPATCHER
检索 CICS® 分派器信息。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。
条件: NOTAUTH
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
此命令是线程安全的。
描述
INQUIRE DISPATCHER 命令返回有关正在其中运行发出命令的任务的 CICS 系统的信息。
此命令中的许多选项对应于系统初始化参数中的选项,并从这些参数中获取其初始值。 您可以使用 SET DISPATCHER 命令来更改某些参数值。 其他选项返回 CICS 分派器状态数据。
选项
- ACTOPENTCBS (数据区)
- 返回一个全字二进制字段,给出当前分配给任务的 L8 和 L9 方式开放式 TCB 的总数。
L8 和 L9 方式 TCB 是从 CICS 连接的开放式 TCB 池中分配的,达到 MAXOPENTCBS 系统初始化参数设置的最大值。 CICS 分派器维护 L8 和 L9 方式 TCB 的池,以供 OPENAPI 应用程序和通过 OPENAPI 选项启用的任务相关用户出口使用。 与任务相关的用户出口仅使用 L8 方式 TCB; 例如,当连接到 Db2时, CICS Db2® 适配器。 ACTOPENTCBS 值可以等于或小于 MAXOPENTCBS 值。 如果它等于 MAXOPENTCBS ,那么将执行需要 L8 或 L9 方式开放式 TCB 的任务以等待。
- ACTSSLTCBS (数据区)
- 返回一个全字二进制字段,给出当前分配给任务的 S8 方式开放式 TCB 的总数。
S8 方式 TCB 是从 CICS 连接到 MAXSSLTCBS 系统初始化参数设置的最大数目的开放式 TCB 池中分配的。 S8 TCB 由需要 SSL 功能的任务使用。 ACTSSLTCBS 值可以等于或小于 MAXSSLTCBS 值。 如果它等于 MAXSSLTCBS ,那么将执行需要 S8 TCB 的任务以等待。
- ACTTHRDTCBS (数据区)
- 返回一个全字二进制字段,给出当前分配给已启用 JVM 服务器的 T8 方式开放式 TCB 的总数。
T8 方式 TCB 是从开放式 TCB 池分配的。 一个池由一个 JVM 服务器使用。 CICS 分派器维护 T8 方式 TCB 的池,以便在 JVM 服务器运行时环境中使用。
- ACTXPTCBS (数据区)
- 返回一个全字二进制字段,给出当前分配给任务的 X8 和 X9 方式开放式 TCB 的总数。
X8 和 X9 方式 TCB 从 CICS 连接的开放式 TCB 池中分配,直至达到 MAXXPTCBS 系统初始化参数设置的最大值。 CICS 调度程序维护一个 和 模式 TCB 池,供使用 XPLINK 选项编译的 C® 和 C++ 程序使用。 X8 X9 ACTXPTCBS 值可以等于或小于 MAXXPTCBS 值。 如果它等于 MAXXPTCBS ,那么需要 X8 或 X9 方式开放式 TCB 的任务将进行等待。
- MAXOPENTCBS (数据区)
- 返回一个全字二进制字段,给出允许 CICS 在其 L8 和 L9 方式 TCB 池中连接和维护的最大 L8 和 L9 方式开放式 TCB 数。
有关分配的数字的信息,请参阅 ACTOPENTCBS 选项。 MAXOPENTCBS 与 ACTOPENTCBS 之间的差异表示此类可用 TCB 的数量。
- MAXSSLTCBS (数据区)
- 返回一个全字二进制字段,给出允许 CICS 在其 S8 方式 TCB 池中连接和维护的 S8 方式开放式 TCB 的最大数目。
- MAXTHRDTCBS (数据区)
- 返回一个全字二进制字段,给出 CICS 区域中针对所有已启用和已禁用的 JVMSERVER 资源可并发存在的 T8 方式开放式 TCB 的最大数目; 即,为该区域中的所有 JVM 服务器保留的线程总数。 为每个 JVM 服务器保留的线程数是 JVMSERVER 资源上的 THREADLIMIT 值,加上 1 (为 JVM 服务器保留的 TCB)。 有关 THREADLIMIT 的更多信息,请参阅 JVMSERVER 资源。
MAXTHRDTCBS 与 ACTTHRDTCBS 之间的差异表示可用 TCB 数。 如果初始化另一个 JVM 服务器,那么将为 JVM 服务器保留一个 TCB。
- MAXXPTCBS (data-value)
- 返回一个全字二进制字段,给出允许 CICS 在其 X8 和 X9 方式 TCB 池中连接和维护的最大 X8 和 X9 方式开放式 TCB 数。
有关分配的数量的信息,请参阅 ACTXPTCBS 选项。 MAXXPTCBS 与 ACTXPTCBS 之间的差异表示此类可用 TCB 的数量。
- MROBATCH (数据区)
- 返回一个全字二进制字段,提供在显式发布 CICS 以处理事件之前必须发生的事件数,这些事件来自 CICS 正在等待的 MRO 和 DASD I/O 事件的列表。
- PRTYAGING (数据区)
- 返回一个全字二进制字段,给出 CICS 增加等待分派的任务优先级的速率。 在没有分派的每个 PRTYAGING 毫秒等待时间之后, CICS 会将任务优先级提高 1。
- RUNAWAY (data-area)
- 返回一个全字二进制字段,给出失控任务时间的缺省系统值。 此值用于运行具有未指定失控任务时间的概要文件的事务的任何任务。 请参阅 INQUIRE TRANSACTION 选项 RUNAWAY。
- SCANDELAY (数据区)
- 返回全字二进制字段,给出用户任务发出终端 I/O 请求与 CICS 分派终端控制任务以进行处理之间的最大毫秒数。 此值有时称为
终端扫描延迟
,由系统初始化表中的 ICVTSD 选项设置。 - 子任务 (数据区域)
- 返回一个全字二进制字段,给出由 SUBTSKS 系统初始化参数 (可以是 0 或 1) 设置的值。
- TIME (数据区)
- 返回一个全字二进制字段,其中给出 CICS 对操作系统进行控制的最大时间间隔 (以毫秒为单位) (如果没有可供分派的任务)。 此值由 ICV 系统初始化参数设置,有时称为 区域退出时间间隔。
条件
- NOTAUTH
- RESP2 值:
- 100
- 未授权与发出任务关联的用户使用此命令。
