-STOP TRACE 命令 ( )Db2

-STOP TRACE 命令停止跟踪。

该命令还有一个附加选项，其他几个选项也有附加值。本附加信息用于在 IBM® 支持中心的指导下提供服务和使用。

缩写：-STO TRA

环境 -STOP TRACE

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

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

授权 -STOP TRACE

要执行此命令，您必须使用包含以下权限或授权之一的进程特权集：

TRACE特权
SQLADM 权限
系统 DBADM 权限
系统管理员权限
SYSCTRL 权限
SYSADM 权限
SECADM 权限

Db2 登录控制台或TSO 发出的命令可通过授权进行查看，使用主授权ID和次授权ID。 z/OS SDSF Db2

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

语法 -STOP TRACE

约束块

注意：

¹ 您不能在AUDTPLCY中指定CLASS或IFCID。 AUDTPLCY适用于跟踪类型AUDIT。

过滤块

选项说明 -STOP TRACE

有关以下各种跟踪类型的更多描述，请参阅 -START TRACE 命令（ Db2 ）。

( PERFM ): 指定停止用于性能分析和调校的跟踪。
缩写：P
( ACCTG ): 指定停止会计追踪。
缩写：A
( STAT ): 指定停止收集统计数据的跟踪。选择统计追踪时，无法指定位置选项。
缩写：S
( AUDIT ): 指定停止从 Db2 的各个组件收集审计数据的跟踪。
缩写：AU
( MONITOR ): 指定停止收集监控数据的跟踪。
缩写：MON
(*): 指定停止所有跟踪活动。请参阅 “-STOP TRACE”的使用说明，了解如何使用STOP TRACE (*)追踪6级监控追踪。

SCOPE

指定命令的范围。

（本地）: 仅在本地 Db2 子系统上停止跟踪。
(GROUP): 停止数据共享组中所有成员的跟踪。
FL 509 您不能指定范围（组）来阻止使用防篡改审计策略的审计跟踪。

ASID（x'dddd' ）

指定停止地址空间的跟踪。

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

RMID

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

COMMENT （字符串）

给出一条注释，该注释将复制到STOP TRACE命令的跟踪输出记录中（驻留跟踪表中的注释除外）。

字符串可以是任何SQL字符串；如果字符串中包含空格、逗号或特殊字符，则必须用单引号括起来。

DEST

为特定目的地设置的限制停止痕迹。您可以使用多个数值，但不要使用相同的数值两次。如果您没有为DEST指定值， Db2 不会使用目的地来限制停止哪些跟踪。

缩写：D

可能的值及其含义如下：

值: 追踪目的地
GTF: z/OS generalized trace facility (GTF)
SMF: z/OS System Management Facilities (SMF)
SRV: 用户编写例程的出口
OP n: 一个特定的目的地。
n 可以是1到8之间的整数。

请参阅 “开始跟踪”命令（ Db2 ），了解每种跟踪类型允许的目的地列表。

CLASS （整数，……）

特定类别的痕迹停止限制。有关允许的类别的描述，请参阅 -START TRACE 命令（ Db2 ）。如果您没有指定跟踪类型，就无法指定类别。

缩写：C

默认值为 CLASS( * ) ，这并不限制命令。

TNO （整数，……）

限制停止到特定的痕迹，由痕迹编号（1到32）识别。您最多可以使用八个跟踪号码。如果您使用多个号码，则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 的客户的跟踪，请输入以下命令：

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

要停止跟踪IP地址为 123.34.101.98 的客户端，请输入以下命令：

-STOP 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

停止与列出的审核策略中指定的类别相对应的IFCID。您最多可以指定八个审计策略名称。 AUDTPLCY适用于跟踪类型AUDIT。您不能在AUDTPLCY中指定CLASS或IFCID。

使用说明 -STOP TRACE

消除特定痕迹

除了TNO，您使用的每个选项都会限制命令的效果，使其仅作用于使用相同选项（明确或默认）启动的活跃跟踪，且参数值完全相同。例如，以下命令仅停止使用PERFM 和 CLASS（1,2）选项启动的活动轨迹：

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

例如，该命令不会停止任何使用 CLASS(1) 启动的跟踪。

您必须指定跟踪类型或星号。例如，以下命令将停止所有活动的跟踪：

-STOP TRACE (*)

使用6级显示器跟踪的痕迹

当停止跟踪类时，如果监视器跟踪类 6 处于活动状态，就会出现一种特殊情况。监控跟踪6级启用和禁用数据传播。为了避免意外停止此跟踪类，如果监视器跟踪类6处于活动状态，则命令STOP TRACE（*）和STOP TRACE（MON）CLASS（*）将失败。

要停止监控跟踪级别6，必须将其明确指定为STOP TRACE命令的CLASS选项的参数之一，包括任何其他以监控跟踪级别6启动的监控跟踪级别。例如，如果使用命令 -START TRACE(MON) CLASS(1,3,6) 启动监视器跟踪级别 6，则使用以下命令可将其停止：

-STOP TRACE(MON) CLASS(1,3,6)

如果使用命令 -START TRACE(MON) CLASS(*) 启动监视器跟踪级别 6，则必须明确指定所有 32 个监视器跟踪级别，才能停止监视器跟踪级别 6：

-STOP TRACE(MON) CLASS(1,2,3,4,5,6,...32)

但是，如果监视器跟踪级别6未激活，则STOP TRACE（停止跟踪）(*)命令将停止所有激活的跟踪。

使用防篡改审计策略的审计跟踪

更改开始 FL 509 如果您使用 SCOPE(GROUP) 选项指定 STOP TRACE(*) 命令来停止使用防篡改审计策略的审计跟踪，则不会停止数据共享组的防篡改审计策略，并发出消息 DSNW122I。您不能使用SCOPE(GROUP)来阻止防篡改审计策略。更改结束

建议： FL 509 使用 STOP TRACE 命令停止一个跟踪号组中的所有防篡改审计策略。如果使用SCOPE(GROUP)选项来阻止防篡改审计策略，这样做有助于避免数据共享成员之间的跟踪号不匹配。

更改开始要停止对数据共享组中所有成员执行防篡改审计策略，请在数据共享组中的每个成员上发出STOP TRACE命令。更改结束

不要停止由IFI/IFC计划启动的痕迹

在停止活动跟踪之前，请确保 IFI 应用程序或 IFC 选择性转储实用程序（ DSN1SDMP ）未启动跟踪。如果停止由 DSN1SDMP 启动的跟踪， DSN1SDMP 实用程序将异常终止。

使用*通配符为特定线程停止跟踪

您可以使用通配符后缀“*”来隐藏某些线程的痕迹。例如，如果您指定 -STOP TRACE PLAN (A,B,C*)， Db2 将停止跟踪线程“A”、“B”和所有以“C”开头的线程。

使用位置（_）通配符为特定线程停止跟踪

您可以使用由“_”字符表示的位置通配符，来停止中间带有特定字符的线程的跟踪，或者当您想要停止特定长度的线程的跟踪时。例如，如果您指定 -STOP TRACE PLAN (A_C)，则所有以“A”为第一个字符、以“C”为第三个字符的三个字符的线程的跟踪都将停止。如果您想停止跟踪“A_C”计划的线程，请输入 -STOP TRACE PLAN (A/_C)。 “_”前面的“/”告诉 Db2 停止跟踪名称中带有下划线的计划，而不是将下划线视为通配符。如果您尝试停止包含“/”或“*”字符的线程，则遵循相同的逻辑。因为字符“/”是一个转义字符，如果您想停止跟踪某个计划中包含字符“/”的线程，您可以指定，例如，-STOP TRACE PLAN (A//C)来停止跟踪计划“A/C”的线程。您也可以指定 -STOP TRACE PLAN (A/*C) 来停止计划名称为“A*C”的线程跟踪。

使用通配符一次停止多个线程的跟踪

您还可以根据多个跟踪条件停止多个线程的跟踪。例如，您可以指定 -STOP TRACE PLAN (A*, B*, C*)，以同时停止以“A”、“B”和“C”开头的计划的所有线程的跟踪。通配符“*”可停止所有线程的跟踪。您可以指定更复杂的组合，例如-STOP TRACE PLAN (A_B*, C*, AND C/_D*)，该组合将停止所有线程的跟踪，条件是：

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

以上列出的所有可能的线程组合的痕迹都将通过上述命令停止。

您可以同时过滤多个线程，设置特定的标准来停止跟踪。例如，您可以指定 -STOP TRACE PLAN (A) USERID (B)。这将停止计划为A、用户ID为B的线程的跟踪。当停止线程跟踪时，每个-STOP TRACE命令只能为一个过滤器指定多个线程条件。例如，您可以指定 -STOP TRACE PLAN (A,B) USERID (B) WRKSTN (E)，但不能指定 -STOP TRACE PLAN (A, B) USER ID (A, B) WRKSTN (E)，因为在此示例中，两个过滤条件都定义了两个元素，而 Db2 只允许一个属性为跟踪定义多个跟踪元素。

使用排除功能过滤主题

当您在任何限制性关键字（如“XPLAN”）前指定一个“X”时，您正在使用–STOP TRACE命令的排除功能。在停止跟踪时，您可以选择排除特定类型的线程。当您停止追踪时，可以使用“X”字符来排除特定的字符组合。例如，您可以指定 -STOP TRACE XPLAN(A)，以停止除“A” 之外的所有线程的跟踪。在这种情况下，可能会返回B、BCD、BCDE或CD。

您也可以选择从跟踪中排除多种类型的线程。例如，您可以指定 -STOP TRACE XPLAN (A*, B*)，以停止跟踪所有线程，除了以“A”开头的线程、以“A”后任何字符组合开头的线程以及以“B”开头的所有字符、以“B”后任何字符组合开头的线程。注意：指定XPLAN（*）会排除所有搜索结果，因此不允许使用。在具有排除功能的STOP TRACE命令中，也不能使用通配符，例如-STOP TRACE XPLAN (A*C)。但是，您可以指定 -STOP TRACE XPLAN (A_ _ C *)，这将停止除以“A”开头、中间为两个字符、第四个空格为“C”、结尾为各种字符的所有线程的跟踪。通配符不能放在追踪条件的中间。

你能够同时停止两条痕迹。例如，您可以指定 -STOP TRACE XPLAN (A, B, C) USERID (D)。这告诉 Db2 ，除了 “A”、“B”或“C”计划，停止追踪所有线程，仅追踪用户ID为“D”的计划。

结合跟踪限定符

您可以通过指定某些线程并排除其他线程来自定义停止跟踪的线程。例如，您可以指定 -STOP TRACE USERID (A,B) XPLAN (C)。此条件仅用于停止用户ID为“A”或“B”且计划不等于 “C”的线程的跟踪。在这个例子中，用户ID为“A”且计划为“D”的线程的跟踪将被停止，但用户ID为“A”且计划为“C”的线程的跟踪不会被停止。

您可以在停止跟踪命令中引入通配符，进一步自定义要停止的跟踪。例如，您可以指定 -STOP TRACE PLAN (C*) USER ID (Z, X) XPLAN (C, D, E)。在这个例子中，要停止跟踪，计划必须从C开始，用户ID必须等于Z或X，且计划不能是C、D或E。因此，用户ID为Z的CB计划的跟踪将被停止，但用户ID为X的C计划的跟踪不会被停止，因为命令指定不停止计划为“C”且线程中没有附加字符的线程的跟踪。

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

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

例子 -STOP TRACE

示例1： 停止所有以 z/OS generalized trace facility (GTF) 为唯一目的地的痕迹。

-STOP TRACE (*) DEST (GTF)

示例2 ：停止计划 DSN8BC81 中本地和 USIBMSTODB21 Db2 子系统之间所有线程的会计跟踪。请留言。

-STOP TRACE (ACCTG)
  PLAN (DSN8BC81)
  LOCATION (USIBMSTODB21)
  COMMENT('ACCTG TRACE FOR DSN8BC81')

示例3： 停止跟踪编号4。

-STOP TRACE (P) TNO(4)

示例4： 停止 USIBMSTODB22 的所有活动痕迹。

-STOP TRACE (*) LOCATION (USIBMSTODB22)

示例5 ：停止所有性能跟踪。

-STOP TRACE=P

示例6 ：停止所有显示器跟踪。

-STOP TRACE(MON)

示例7 ：停止数据共享组中的所有监视器跟踪。

-STOP TRACE(MON) SCOPE(GROUP)

例8： 停止使用审计策略AUDITADMIN的所有审计跟踪。

-STO TRACE(AUDIT) DEST(GTF) AUDTPLCY(AUDITADMIN)