-DISPLAY TRACE 命令 ( )Db2

环境 -DISPLAY TRACE

该命令可以从 z/OS® 控制台、DSN会话或 DB2I 面板（ DB2 命令）、 IMS 或 CICS® 终端，或使用仪器设施接口（IFI）的程序。

数据共享范围： 团体或成员

授权 -DISPLAY TRACE

Db2 登录 控制台或TSO 发出的命令可通过 授权进行查看，使用主授权ID和次授权ID。 z/OS SDSF Db2 必须在 RACF 或类似的安全服务器中定义一个已登录的 z/OS 用户ID。

选项说明 -DISPLAY TRACE

-DISPLAY TRACE (PERFM) CLASS (1,2)

( * )

不限制痕迹列表。 默认值为 （* ）。

CLASS选项不能与DISPLAY TRACE（显示轨迹）一起使用（*）。

以下每个关键词都会将列表限制为相应类型的痕迹。

类型（缩写）

描述

PERFM (P)

特定活动的成绩记录

ACCTG（A）

每笔交易的会计记录

STAT（S）

统计数据

审计（AU）

审计数据

监控器（MON）

监视数据

DETAIL （ 输出类型 ）

根据括号内指定的输出类型，限制跟踪显示的信息。

输出类型的 可能值有：

1

显示跟踪信息摘要：跟踪编号、类型、等级、目的地

2

显示资质跟踪信息：跟踪号、认证号、位置、包裹、计划、实际、用户、工作站

1.2

显示摘要和资质信息

*

显示摘要和资质信息

如果 DETAIL 后没有参数，则显示 1 条跟踪信息。

此外，还会显示QUAL列，表明轨迹是否合格。 作为跟踪信息的一部分，QUAL列可用于确定是否还有关于跟踪的资格信息。 通过指定 DETAIL (2) 或 DETAIL (*)，可以获得此信息。QUAL 列的值为 YES 表示在鉴定跟踪信息中存在此特定跟踪的附加信息；值为 NO 表示此跟踪不存在附加信息。

COMMENT （字符串 ）

指定 注释字符串 出现在跟踪输出中，但驻留跟踪表中的输出除外。

字符串可以是 任何字符串；如果字符串中包含空格、逗号或特殊字符，则必须用单引号括起来。 该注释不会显示在显示屏上，但可以记录在跟踪输出中，前提是正在跟踪命令。

作用域

指定命令的范围。

（本地）

仅显示本地成员的跟踪。

（集团）

显示数据共享组中所有成员的轨迹。

DEST

将列表限制为特定目的地的行程。 可以指定多个值，但不要使用相同的值两次。 如果您没有为DEST指定值， Db2 不会使用记录跟踪输出结果的目的地来限制显示的跟踪列表。

缩写：D

可能的值及其含义如下：

值

追踪目的地

GTF

z/OS generalized trace facility (GTF).

SMF

z/OS System Management Facilities (SMF)

SRV

用户编写例程的出口

OP n

一个特定的目的地。 n 的取值范围是1到8。

RMID

指定资源管理器标识符。 您最多可以指定8个有效的RMID，它们是一或两位数的标识符。 您不能为会计或统计追踪指定RMID。

ASID（x'dddd' ）

指定显示地址空间跟踪信息。

dddd 是一个4字节十六进制地址空间ID（ASID）。

CLASS （整数 ，……）

将列表限制为特定班级开始的痕迹。

默认值为 CLASS( * )，这并不限制列表。

TNO （整数 ，……）

将列表限制为特定轨迹，由轨迹编号（1到32，01到09）识别。 最多可以使用八个跟踪号码。 如果使用多个号码，PLAN、AUTHID和LOCATION只能使用一个值。

默认值为 TNO( * )，这并不限制列表。

PLAN( 计划名称 , …) 或 XPLAN( 计划名称 , …)

介绍一系列具体计划，并收集了这些计划的跟踪信息。 使用PLAN将轨迹限制在指定的平面图上，使用XPLAN排除指定的平面图。 您不能将此选项用于STAT跟踪。

默认值为 PLAN( * ).

( * )

显示所有计划的轨迹。

计划名称

申请计划的名称。 最多可输入八个名字。 如果您使用多个名称，则只能为AUTHID和LOCATION设置一个值。

PKGLOC 或者 XPKGLOC

指定绑定包的位置名称。 使用PKGLOC将轨迹限制在指定位置，或使用XPKGLOC排除指定位置。

PKGCOL 或者 XPKGCOL

指定软件包的集合名称。 使用PKGCOL将轨迹限制在指定的集合中，使用XPKGCOL将指定的集合排除在外。

PKGPROG 或者 XPKGPROG

指定DBRM或程序名称。 使用PKGPROG将跟踪限制在指定的程序中，或使用XPKGPROG排除指定的程序。

AUTHID( 授权ID , …) 或 XAUTHID( 授权ID , …)

列出需要收集跟踪信息的特定授权ID列表。 使用AUTHID将跟踪限制在指定的授权ID内，使用XAUTHID则可排除指定的授权ID。 指定的授权ID必须是主授权ID。 您不能将此选项用于STAT跟踪。

默认值为 AUTHID( * ).

( * )

显示所有授权ID的记录。

授权码

指定授权ID。 您最多可以使用八个标识符。 如果您使用多个识别码，则PLAN和LOCATION只能使用一个值。

LOCATION （地点名称 ，……） 或者 XLOC （地点名称 ，……）

指定位置名称列表，系统将收集这些位置的信息。 使用“位置”将轨迹限制在指定位置，或使用“XLOC”排除指定位置。 使用“位置”或“XLOC”选项将排除没有分布式数据关系的跟踪线程。

地点名称

标识您想要追踪其分布式线程的 Db2 子系统。 激活远程TCP/IP或SNA位置的 Db2 跟踪，您可以通过位置名称指定位置。

您最多可以指定八个地点。 如果您使用多个计划名称或授权ID，则只能指定一个地点。

<luname>

激活 Db2 跟踪，用于通过您在 luname中指定的远程SNA LU名称连接到DDF的远程客户端。

ipaddr

激活远程客户端的 Db2 跟踪，这些客户端通过远程TCP/IP主机连接到DDF。ipaddr 是IP地址。

(*)

表示您希望显示分布式线程下发生的跟踪事件，无论它们连接到哪个位置。 指定本地位置名称等同于指定 LOCATION(*)。

Db2 for z/OS 以外的客户 ： Db2 for z/OS 不会从非 Db2 for z/OS 子系统的客户那里收到位置名称。 若要显示非 Db2 for z/OS 子系统的客户端的跟踪信息，请输入其LUNAME或IP地址。 用小于（<）和大于（>）符号将LUNAME括起来。 在表格中输入IP地址 nnn.nnn.nnn.nnn。 例如，要为 LULA 的 LUNAME 客户显示跟踪信息，请输入以下命令：

-DISPLAY TRACE (*) LOCATION (<LULA>)

要显示IP地址为 123.34.101.98 的客户端的跟踪记录，请输入以下命令：

-DISPLAY TRACE (*) LOCATION (::FFFF:123.34.101.98)

USERID 或者 XUSERID

指定用户标识。 将跟踪限制在指定的用户ID范围内，或者 USERID 将跟踪限制在指定的用户ID范围内，或 XUSERID 排除指定的用户ID。 您可以指定多个值和通配符值，如使用说明中所述。

USERID 且 XUSERID 最多可包含16个字符。

APPNAME 或者 XAPPNAME

指定应用程序名称。 将跟踪限制在指定的应用程序中，或者 APPNAME 将跟踪限制在指定的应用程序中，或 XAPPNAME 排除指定应用。 您可以指定多个值和通配符值，如使用说明中所述。

APPNAME 且 XAPPNAME 最多可包含32个字符。

WRKSTN 或者 XWRKSTN

指定工作站名称。 将跟踪限制在指定的工作站或 WRKSTN 将跟踪限制在指定的工作站，或 XWRKSTN 排除指定的工作站。 您可以指定多个值和通配符值，如使用说明中所述。

WRKSTN 且 XWRKSTN 最多可输入18个字符。

CONNID 或者 XCONNID

指定连接ID。 使用CONNID将轨迹限制在指定的连接上，使用XCONNID排除指定的连接。

CORRID 或者 XCORRID

指定关联ID。 使用CORRID将轨迹限制在指定的相关ID内，使用XCORRID排除指定的相关ID。

ROLE 或者 XROLE

指定连接角色。 使用ROLE将跟踪限制为指定的角色，使用XROLE排除指定的角色。

AUDTPLCY

包含策略名称的128字节区域。 您最多可以指定八个审计策略名称。 AUDTPLCY适用于跟踪类型AUDIT。 您不能在AUDTPLCY中指定CLASS或IFCID。

使用说明 -DISPLAY TRACE

使用*通配符显示追踪的线程

您可以使用通配符后缀“*”来过滤想要显示的帖子。 例如，如果您指定“-DISPLAY TRACE PLAN (A,B,C*)”， Db2 将显示轨迹A、B、CDE、CDEFG、CDEFGH等。 它将显示“A”、“B”和所有以“C”开头的线程。

使用位置（_）通配符显示追踪的线程

当您希望将通配符放在中间，或者希望追踪特定长度的线程时，可以使用由“_”字符表示的位置通配符来显示追踪的线程。 例如，如果您指定“-DISPLAY TRACE PLAN (A_B)”，则所有显示的跟踪线程都以“A”为第一个字符，以任意字符为“_”，以“C”为计划过滤器。

使用通配符同时显示多条追踪的线索

您还可以根据多个追踪条件显示多条追踪记录。 例如，您可以指定“-DISPLAY TRACE PLAN (A*, B*, C*)”，以同时显示以“A”、“B”和“C”开头的计划的所有跟踪线程。 通配符“*”将显示所有追踪的线索。 您可以指定更复杂的组合，例如“-DISPLAY TRACE PLAN (A_B*, C*, AND C/_D*)”，它将返回所有满足以下条件的线程：

• 以“A”开头，以一个字符的通配符作为线程中的第二个字符，以“B”作为线程中的第三个字符，并以任意类型或数量的字符结尾（ A D B IOP、 A O B TYJDP、）
• 以“C”开头，以任意字符组合结尾 （CDE 、CGHKO ）
• 以“C_D ” 开头，以任意类型的字符组合结尾 （ C_DEFGH、 C_DlMNOP ）

以上列出的所有可能的线程组合都将通过上述命令返回。

您可以同时过滤多个线程，为跟踪设置特定条件。 例如，您可以指定“-DISPLAY TRACE PLAN (A) USERID (B)” 这将显示计划线程为“A”，用户ID为“B”的所有追踪线程 注意 ：当显示跟踪的线程时，您只能为显示跟踪命令的每个过滤器指定一个线程条件。 例如，您可以指定“-DISPLAY TRACE PLAN(A,B)USERID (B) WRKSTN (E)”，但不能指定“-DISPLAY TRACE PLAN(A, B) USERID(A, B) WRKSTN(E)”，因为在这个例子中，两个过滤条件有两个元素被定义为要跟踪的，而 Db2 只允许一个属性在每个跟踪中具有多个跟踪元素。

使用排除功能过滤要显示的已追踪的线程

当您在过滤主题时，使用任何限制关键字（例如“XPLAN”）指定“X”，即表示您正在使用显示跟踪命令的排除功能。 在运行跟踪命令时，您可以选择排除要显示的特定类型的线程。 当您运行显示跟踪命令时，可以使用“X”字符排除特定的字符组合。 例如，您可以指定“-DISPLAY TRACE XPLAN(A)”，以显示除“A”之外的所有跟踪线程。 在这种情况下，可能会返回B、BCD、BCDE或CD。

您也可以选择从跟踪中排除多种类型的线程。 例如，您可以指定“-DISPLAY TRACE XPLAN (A*, B*)”，以显示所有跟踪的线程，但以“A”开头的除外，以及“A”后面的任意字符组合，以及以“B”开头的所有字符，以及“B”后面的任意字符组合。 注意：指定XPLAN（*）将排除所有搜索结果，因此不允许使用。 在带有排除功能的显示跟踪命令中，您也不能使用通配符，例如“-DISPLAY TRACE XPLAN (A*C)” 但是，您可以指定“-DISPLAY TRACE XPLAN (A_ _ C *)”，这将返回除以下内容之外的所有线程：以“A”开头，后面是两个字符，第四个空格是“C”，最后是各种字符。 通配符不能放在追踪条件的中间。

您可以同时显示两条轨迹，以帮助您优化追踪功能。 例如，您可以指定 (-DISPLAY TRACE XPLAN (A, B, C) USERID (D))”。 这告诉 Db2 显示所有正在追踪的“计划”线程，但“A”、“B”或“C”线程除外，仅当用户ID =“D”时。

您可以在显示跟踪命令中引入通配符，为您的跟踪添加更多自定义。 例如，您可以指定“-DISPLAY TRACE PLAN (C*) USERID (Z, X) XPLAN (C, D, E)”。 在这个例子中，要追踪的线程，计划必须以“C”开头，用户ID必须等于“Z”或“X”，计划不能是“C”、“D”或“E” 因此，用户ID为“Z”的计划“CB”会通过，并显示正在追踪的线程，但用户ID为“X”的计划C会失败，因为命令指定不追踪计划为“C”且线程中没有附加字符的线程。

结合跟踪限定符

您可以通过发送邮件至 Db2 来追踪特定的线程，同时排除其他特定的线程，从而自定义您追踪的线程。 例如，您可以指定“-DISPLAY TRACE USERID(A,B) XPLAN (C)”。 此条件仅追踪用户ID等于“A”或“B”且计划不等于“C”的情况。 在这个例子中，用户ID为“A”且计划为“D”的线程会通过并被追踪，但用户ID为“A”且计划为“C”的线程不会通过，也不会被追踪。

当没有活动轨迹时，显示返回代码

如果在批处理环境中运行DISPLAY TRACE，且没有激活任何跟踪，则作业步骤的返回代码为12。

以组为范围发出的命令的跟踪信息

如果此命令在 Db2 数据共享成员中指定了组范围，则它也将在所有其他活动成员中运行。 IFICID 090 跟踪记录显示，除了发出原始命令的成员的跟踪记录外， 016.TLPKN5F 相关 ID 的 SYSOPR 授权 ID 也发出了相同的命令。 请参阅 Db2 数据共享中的命令范围。

输出 -DISPLAY TRACE

消息显示DISPLAY TRACE命令的输出。 DSNW127I 消息显示DISPLAY TRACE命令的输出。 输出格式取决于命令中指定的DETAIL选项的值。

DSNW127I  CURRENT TRACE ACTIVITY IS -                
TNO           TYPE        CLASS       DEST         QUAL      IFCID                    
trace-number  trace-type  type-class  destination  qualified ifcid
trace-number  trace-type  type-class  destination  qualified ifcid
*********END OF DISPLAY TRACE SUMMARY DATA*********                       

DSNW143I  CURRENT TRACE QUALIFICATIONS ARE -
DSNW152I  BEGIN TNO trace-number QUALIFICATIONS   
NO QUALIFICATIONS
END TNO trace-number QUALIFICATIONS
DSNW185I BEGIN TNO trace-number AUDIT POLICIES
NO AUDIT POLICIES ACTIVE
END TNO trace-number AUDIT POLICIES

DSNW152I  BEGIN TNO trace-number QUALIFICATIONS   
PLAN: plan-qualification
AUTHID: authid-qualification
LOCATION: location-qualification
USERID: userid-qualification
APPLICATION/TRANSACTION NAME: application/transaction-name-qualification
WORKSTATION: workstation-qualification
PACKAGE LOCATION: package-location-qualification
PACKAGE COLLECTION ID: package-collection-ID-qualification
PACKAGE PROGRAM NAME: package-program-name-qualification
ROLE: role-qualification
RMID: rmid-qualifications
CONNECTION ID: connection-ID-qualification
CORRELATION ID: correlation-ID-qualification
EXCLUDE PLAN: xplan qual1,xplan qual2,...,xplan qual8
EXCLUDE AUTHID: xauthid qual1,xauthid qual2,...,authid qual8
EXCLUDE LOCATION: xloc qual1,xloc qual2,...,xloc qual8 
EXCLUDE USERID: xuserid qual1,xuserid qual2,...,xuserid qual8
EXCLUDE APP/TXACT NAME: xappname qual1,xappname qual2,...,xappname qual8 
EXCLUDE WORKSTATION: xwrkstn qual1,xwrkstn qual2,...,xwrkstn qual8
EXCLUDE PACKAGE LOC: xpkgloc qual1,xpkgloc qual2,...,xpkgloc qual8
EXCLUDE PACKAGE COLLID: xpkgcol qual1,xpkgcol qual2,...,xpkgcol qual8
EXCLUDE PACKAGE PROGNAME: xpkgprog qual1,xpkgprog qual2,...,xpkgprog qual8
EXCLUDE CONNECTION ID: xconnid qual1,xconnid qual2,...,xconnid qual8
EXCLUDE CORRELATION ID: xcorrid qual1,xcorrid qual2,...,xcorrid qual8
EXCLUDE ROLE: xrole qual1,xrole qual2,...,xrole qual8
END TNO trace-number QUALIFICATIONS
DSNW185I BEGIN TNO trace-number AUDIT POLICIES
AUDIT POLICY: policy-name
END TNO trace-number AUDIT POLICIES

DSNW148I  ******END OF DISPLAY TRACE QUALIFICATION

DSNW198I DISPLAY TRACE OUTPUT TO BE CONTINUED (CMDID=command-id)

DSNW199I DISPLAY TRACE OUTPUT CONTINUED (CMDID=command-id)

DSN9022I  '-DISPLAY TRACE' NORMAL COMPLETION