DSNC DISPLAY

使用 CICS® DB2® 连接设施命令 DSNC DISPLAY 来显示有关活动 CICS DB2 线程以及使用这些线程的 CICS 事务的信息,或者显示与 DB2ENTRYs 和 DB2CONN 资源相关联的统计信息。

环境

只能从 CICS 终端发出此命令。

语法

DISPLAY 语法

读取语法图跳过可视语法图 DSNC DISPlay   PLAN-planName-TRANsaction-transactionID-STATistics destination

缩写

DSNC DISP 或 DISP (使用 CICS DB2 样本组 DFH$DB2中的 DISP 事务)。

Authorization

可以使用事务 DSNC 的 CICS 事务连接安全性检查和资源 DB2CONN的 CICS 命令安全性检查来控制对此命令的访问。 此命令需要 READ 访问权。

有关 CICS 安全性的更多信息,请参阅 CICS DB2 环境中的安全性

参数描述

PLAN planname
显示有关 planname的线程的信息。 Planname 是显示其信息的有效计划名称。

如果未指定 planname (或者如果指定了星号 *) ,那么将显示所有活动线程的信息。

例如,以下命令显示有关所有活动 CICS DB2 计划标识的信息,并将显示信息发送到指定为 MTO2的另一个终端。

DSNC DISP PLAN * MTO2
事务 transactionID
包含显示其线程信息的事务标识。 transactionID 是显示线程信息的有效事务标识。

如果未指定事务标识,那么将显示所有活动线程的信息。

例如,以下命令显示有关所有活动 CICS DB2 事务的信息。

 
           DSNC DISP TRAN
统计信息
显示与每个 CICS DB2 资源定义相关联的统计计数器。 计数器涉及 CICS DB2 连接设施与 DB2的可用连接的使用情况。

请注意,可以使用标准 CICS 统计信息接口 (例如,命令 EXEC CICS COLLECT STATISTICSEXEC CICS PERFORM STATISTICS) 或使用 DFH0STAT 样本程序来获取一组更详细的 CICS DB2 统计信息。

目标
指定另一终端以接收所请求的信息。 destination 是另一个终端的标识,用于接收所请求的显示信息。 它必须是定义到 CICS 并受基本映射支持 (BMS) 支持的有效终端。

因为可选目标有时以命令中的可选计划名称或事务标识作为前缀,所以每个参数必须唯一且可单独标识为名称或终端标识。 如果仅输入了一个参数,那么将首先检查它是计划名称还是事务标识,然后将其作为目标进行检查。 要使用既是计划名称或事务标识又是有效终端标识的字符串,必须同时使用名称和目标参数在所需终端上显示所需信息。

当指定备用目标以接收所请求的显示信息时,将向请求终端发送以下消息:

DFHDB2032 日期时间 applid 备用目标显示命令完成

使用说明

如果在 CICS DB2 连接设施处于活动状态但 DB2 子系统未处于活动状态时从 CICS 发出此命令,那么将生成统计信息屏幕,其中没有明显指示该子系统不可操作。

消息 DFHDB2037 显示在 CICS 消息日志中,以指示连接设施正在等待 DB2 启动。