-START TRACE 命令 ( )Db2

-START TRACE 命令启动 Db2 跟踪。

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

缩写：-STA TRA

环境 -START TRACE

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

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

授权 -START TRACE

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

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

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

语法 -START TRACE

约束块

注意：

¹ 请勿在AUDTPLCY中指定CLASS或IFCID。 AUDTPLCY适用于跟踪类型AUDIT。
² 使用不同的过滤条件指定多条AUDTPLCY轨迹会导致过滤在所有AUDTPLCY轨迹之间成为UNION。

过滤块

选项说明 -START TRACE

您必须指定跟踪类型。

PERFM、ACCTG、STAT、AUDIT和MONITOR选项用于识别启动的跟踪类型。

( PERFM )

性能追踪用于性能分析和调校。这条记录包括系统中特定事件的记录，包括与分布式数据处理相关的事件。这些数据可用于程序、资源、用户和子系统相关的调整。

缩写：P

( ACCTG )

会计跟踪记录了交易完成时写入的交易级数据。它提供的数据可用于进行 Db2 容量规划以及调整应用程序。

缩写：A

( STAT )

统计追踪收集由 Db2 的各个组件在一定时间间隔内广播的统计数据。您可以在安装过程中指定统计收集的时间间隔。

缩写：S

选择统计追踪时无法指定位置。

( AUDIT )

审计跟踪收集有关 Db2 安全控制的信息，可用于确保仅出于授权目的访问数据。

缩写：AU

( MONITOR )

显示器跟踪功能允许连接的显示器程序通过调用仪器设施接口（IFI）访问 Db2 跟踪数据。监控程序可通过发出READA请求，以异步方式通过 OPx缓冲区访问跟踪数据，或通过发出READS请求，以同步方式在监控返回区域访问跟踪数据。

缩写：MON

SCOPE

指定数据共享组中命令的范围。

（本地）: 指定仅在本地成员上启动跟踪。
(GROUP): 指定对数据共享组的所有成员启动跟踪。
FL 509 您不能指定范围（组）来启动使用防篡改审计策略的审计跟踪。

ASID（x'dddd' ）

指定跟踪数据收集的地址空间。

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

COMMENT （字符串）

给出一条注释，该注释将复制到跟踪输出中（驻留跟踪表中的注释除外）。此选项可用于记录发出命令的原因。

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

RMID

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

DEST

指定跟踪输出记录的位置。您可以使用多个数值，但不要使用相同的数值两次。如果您没有指定值，跟踪输出将发送到下表中显示的默认目标。

如果指定的目的地在您发出“开始跟踪”命令后处于非活动状态或变为非活动状态，您将收到消息 DSNW133I ，表明跟踪数据丢失。适用于GTF、SRV和SMF目的地。如果应用程序未发出“开始跟踪”命令，您也会收到目的地OP n 和OPX的这条消息。

缩写：D

允许值和默认值取决于启动的跟踪类型，如下表所示。

表 1. 每种跟踪类型的允许目的地
类型	GTF	SMF	SRV	`OPn`	OPX
PERFM	缺省值	允许	允许	允许	允许
会计	允许	缺省值	允许	允许	允许
stat	允许	缺省值	允许	允许	允许
AUDIT	允许	缺省值	允许	允许	允许
MONITOR	允许	允许	允许	允许	缺省值

每个数值含义如下：

GTF

z/OS generalized trace facility (GTF)。来自 Db2 的记录的记录标识符是 X'0FB9'。

SMF

z/OS System Management Facilities (SMF)。 Db2 跟踪记录的 SMF 记录类型取决于IFCID记录，如下所示：

IFCID记录: SMF记录类型
1（系统服务统计）: 0100
2（数据库服务统计）: 0100
3（代理会计）: 0101
202（动态系统参数）: 0100
225（系统存储汇总统计）: 0100
230（数据共享全球统计）: 0100
239（套餐会计）: 0101
369（会计统计汇总）: 0100
所有其他: 0102

SRV

用户编写例程的出口。有关如何编写此类例程的说明和示例，请参见库前缀 .SDSNMACS中的宏DSNWVSER。

OP n

一个特定的目的地。

n 可以是1到8之间的整数。

OPX

使用第一个空闲的 OP n 槽位的通用目的地。

只有启动对 OP n 缓冲区的跟踪的应用程序才能读取该缓冲区。

在缓冲区标记为未使用时，必须停止所有前往OPX目的地的痕迹。开始于之前使用的OPX缓冲区的痕迹会覆盖之前任何痕迹在存储器中留下的痕迹。

限制和过滤块

约束和过滤模块对跟踪收集的数据类型设置了可选的限制。过滤选项与相应的约束选项具有相同的排除效果。

更改开始统计跟踪的START TRACE命令仅允许使用CLASS约束选项。任何其他跟踪类型的START TRACE命令允许任何约束选项或过滤选项。但是， Db2 不会使用您在跟踪以下任何IFCID时指定的任何过滤器或限制条件：更改结束

IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID
1	2	4	5	104	105	107	124	129	147
148	149	150	185	186	199	202	217	225	230
254	306	316	317	365	401	402	411	412

START TRACE命令可以包含多个约束选项、多个过滤选项，或两者的组合。约束或过滤选项可以包含多个值。但是，命令中不能包含多个约束选项，每个约束选项不能包含多个值。可通过以下方式指定一个具有多个值的约束选项：

多种其他约束选项，每种选项只有一个值
多种过滤选项，每种选项都有单个或多个值

如果START TRACE命令包含两个或更多约束选项，且每个约束选项都有多个选项，则会出现错误信息。

每个选项的含义如下。过滤选项及其相应的约束选项将在下文进行介绍。

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

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

默认值为 PLAN( * ).

( * ): 开始追踪所有计划。
计划名称: 是申请计划的名称。您最多可以输入八个名字；每个名字都会启动一个单独的追踪。如果您使用多个名称，则只能为AUTHID和LOCATION设置一个值。

PKGLOC 或者 XPKGLOC

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

PKGCOL 或者 XPKGCOL

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

PKGPROG 或者 XPKGPROG

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

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

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

默认值为 AUTHID( * ).

( * ): 开始追踪所有授权ID。
授权码: 指定授权ID。您最多可以使用八个标识符；每个标识符都会启动单独的跟踪。如果您使用多个识别码，则PLAN和LOCATION只能使用一个值。

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

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

地点名称

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

您最多可以指定八个地点；每个地点都会启动单独的轨迹。如果您使用多个计划名称或授权ID，则只能指定一个地点。

<luname>

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

ipaddr

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

IP地址的格式取决于TCP/IP协议栈是配置为 IPv4-only 协议栈还是双模协议栈。一个 IPv4 堆栈仅支持 IPv4 协议。双模式堆栈支持 IPv4 和 IPv6 协议。

对于 IPv4-only 堆栈，您以 IPv4 格式输入IP地址：
```
x.x.x.x
```
双模式堆栈：
- 请输入 IPv6 格式的 IPv6 地址：
```
y:y:y:y:y:y
```
- 您输入的 IPv4 地址为双 IPv6 和 IPv4 格式，其中 IPv6 部分为：::FFFF:
```
::FFFF:x.x.x.x
```

(*)

表示您希望开始跟踪分布式线程下发生的事件，无论这些事件连接到哪个位置。指定本地位置名称等同于指定 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的客户启动跟踪，请输入以下命令：

-START TRACE (PERFM) CLASS (*) LOCATION (<LULA>)

要使用 123.34.101.98 的IP地址为客户开始追踪，请输入以下命令：

-START TRACE (PERFM) CLASS (*) 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排除指定的连接。

CONNID或XCONNID值是以下数值之一：

CONNID 价值	连接类型 Db2
BATCH	批处理
TSO	TSO
DB2CALL	QMF
实用程序	Db2 实用程序
`子系统标识符`	Db2 内部
`cics连接名称`	CICS
`ims-连接名称`	IMS
RRSAF	RRSAF
`连接名称`	来自远程 Db2 for z/OS 请求者的连接。该值是请求位置处的线程连接名称。
SERVER	来自非 Db2 for z/OS 远程请求者的连接。

CORRID 或者 XCORRID

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

ROLE 或者 XROLE

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

CLASS( 整数 , …)

介绍所收集数据分类列表。允许哪些类别的跟踪及其含义取决于启动的跟踪类型。

缩写：C

当省略了 CLASS 选项时，跟踪类型中的默认类将被激活。默认类在以下表格的描述栏中标识。

( * ): 为跟踪类型的所有类别启动跟踪。
整数: 下表中的任意数字。您可以使用启动的跟踪类型允许的任意数量的类。

提示：

IFCID号码通常以三位或四位数字和前导零的形式出现在 Db2 及其文档中。例如，您可能会看到：“IFCID 1”、“IFCID 001”或“IFCID 0001” 不过，你可以认为这些参考资料的意思是相同的。更改结束

会计追踪 (ACCTG)

表 2. Db2 会计追踪课程
类	班级描述	激活的IFCID
1	标准会计数据。当您启动会计追踪时，如果从START TRACE命令中省略了 `CLASS` 关键字，则也会激活1级。	3、106、200、239
2	Db2 事件信号的输入或输出。	232
3	Db2 等待时间已过。	6、7、8、9、32、33、44、45、117、118、127、128、170、171、174、0175、213、214、215、216、226、227、242, 243, 321, 322, 329, 378, 379, 382, 383, 413, 414
4	安装定义的会计记录。	151
5	处理IFI请求所花费的时间。	187
6	已保留。
7	Db2 时间内的套餐级会计。	200、232、239、240
8	Db2 中的套餐级会计等待时间。	6、7、8、9、32、33、44、45、117、118、127、128、170、171、174、175、213、214、215、216、226、227、239、241、242、243、321、322、378、379、382、383、413、414
10	套餐详情。在写入IFCID 239记录之前，还必须激活以下其中一个跟踪：会计学7级会计学8级 7级显示器 8级显示器	239
11	计划级会计信息。当您启动会计追踪时，如果从START TRACE命令中省略了 `CLASS` 关键字，则第11类将被激活。如果您不希望返回IFCID 239记录，请改为搜索11年级会计课，而不是1年级会计课。	3200
12月29日	已保留。
30-32	可供本地使用。

审计跟踪 (AUDIT)

表 3. Db2 审核跟踪课程
类	班级描述	激活的IFCID
1	由于授权不足，访问尝试被拒绝。当您启动审计跟踪时，如果从START TRACE命令中省略了 `CLASS` 关键字，则也会激活1级。	140
2	明确授予和撤销。	141
3	对已审核的表进行创建、修改和删除操作。	142
4	审计对象首次变更。	143
5	首次阅读审计对象。	144
6	绑定涉及审计对象的SQL语句的时间信息。	145
7	授权ID的分配或变更。	55、83、87、169、319
8	公用事业。	23、24、25、219、220
9	安装定义的审计记录。	146, 392
10	可信的上下文信息。	269、270
11	成功访问的审计。	3 ⁶ 11
12-29	已保留。
30–32	可供本地使用。
注：如果通过START TRACE启动IFCID 361，则所有成功的访问都会被追踪。如果因为审计策略类别 SYSADMIN 处于开启状态而启动 IFCID 361，则仅跟踪使用 SYSADMIN 管理权限的成功访问。如果因为审计策略类别 DBADMIN 处于开启状态而启动 IFCID 361，则仅跟踪使用 DBADMIN 管理权限的成功访问。

统计跟踪 (STAT)

表 4. Db2 统计追踪课程
类	班级描述	激活的IFCID
1	有关系统服务的信息、数据库统计信息、数据库服务地址空间的统计信息（`ssnm`DBM1 )、按连接类型汇总的 CPU 和等待时间统计信息，以及有关启动跟踪时有效的系统参数的信息。当您启动统计跟踪时，如果从START TRACE命令中省略 `CLASS` 关键字，也会激活1级。	1、2、105、106、202、225、369
2	安装定义的统计记录	152
3	死锁、锁升级、组缓冲池、数据集扩展信息以及长时间未提交读取和活动日志空间不足的指示。	172、196、250、258、261、262、313、330、335、337
4	Db2 特殊情况。	173、191、192、193、194、195、203、204、205、206、207、208、209、210、235、236、238、267、268、334、343、402
5	Db2 数据共享统计。	230、254
6	Db2 子系统的存储统计信息。	225
7	DRDA位置统计。	365
8	数据集I/O统计。	199 ，389
9	按连接类型统计的CPU和等待时间汇总。	369
10	DRDA远程应用统计基于当前客户端应用程序名称（CURRENT CLIENT_APPLNAME）特殊注册。客户库存信息。	411
十一	DRDA远程用户统计基于当前客户端用户ID的特殊注册。客户库存信息。	412
12-29	已保留。
30-32	可供本地使用。

性能跟踪 (PERFM)

表5。 Db2 性能追踪课程
类	班级描述	激活的IFCID
1	背景事件。当您启动性能追踪时，如果从START TRACE命令中省略 `CLASS` 关键字，也会激活1级。	1、2、31、42、43、76、77、78、79、102、103、105、106、107、153
2	子系统事件。当您启动性能追踪时，如果从START TRACE命令中省略 `CLASS` 关键字，也会激活2级。	3、68-75、80、81、82、83、84、85、86、87、88、89、106、174、175
3	SQL事件。当您启动性能追踪时，如果从START TRACE命令中省略 `CLASS` 关键字，也会激活3级。	22、53、55、58、59、60、61、62、63、64、65、66、92、95、96、97、106、112、173、177、233、237、250、272、273、325
4	从缓冲区和EDM池中读取和写入。	6、7、8、9、10、29、30、105-107、127、128、226、227、321、322、477
5	写入日志；归档日志。	32、33、34、35、36、37、38、39、40、41、104、106、114、115、116、117、118、119、120、228、229
6	锁信息摘要。	20、44、45、105、106、107、172、196、213、214、218、337
7	详细的锁具信息。	21、105、106、107、223
8	数据扫描详情。	13-18、105、106、107、125、221、222、231、305、311、 363
9	排序详情。	26、27、28、95、96、106
10	绑定、命令和实用程序详情。	23、24、25、90、91、0105、106、107、108、109、110、111、201、256
11	执行单元开关和锁存器争论。	46-52、56、57、93、94、106、113
12	仓储经理。	98、99、100、101、106
13	编辑和验证退出。	11、12、19、105、106、107
14	进入和退出应用程序。	67、106、121、122
15	安装定义的性能记录。	154
16	分布式处理	157、158、159、163、167、183
17	索赔和理赔信息。	211、212、213、214、215、216
18	基于事件的控制台消息。	197
19	数据集打开和关闭活动。	370、371
20	数据共享一致性摘要。	249、251、256、257、261、262、267、268
21	数据共享一致性详细信息。	255、259、263
22	授权退出参数。	314
23	语言环境运行时诊断。	327
24	存储过程详情。	380、499
25-29岁	已保留。
30-32	可供本地使用。

监控跟踪 (MONITOR)

表6。 Db2 监控类型课程
类	班级描述	激活的IFCID
1	标准会计数据。当您启动显示器跟踪时，如果从START TRACE命令中省略 `CLASS` 关键字，也会激活1级。	200
2	Db2 事件信号的输入或输出。	232
3	Db2 输入/输出、锁的等待时间；资源使用信息。	6、7、8、9、32、33、44、45、117、118、127、128、170、171、174、175、213、214、215、216、226、227、242、243、321、322、378、379、382、383、413、414
4	安装定义的监控记录。	155
5	处理IFI请求所花费的时间。	187
6	对使用数据捕获创建的表格所做的更改。	185
7	输入或输出 Db2 事件信号，用于包裹核算。数据记录了代理商在 Db2 处理每个包裹所花费的时间。	200、232、240
8	包裹等待时间。	6、7、89、32、33、44、45、51、52、56、57、117、118、127、128、170、171、174、175、213、214、215、216、226、227, 239, 241, 242, 243, 321, 322, 378, 379, 382, 383, 413, 414
9	支持报表级会计。	124
10	缓冲管理器、锁管理器和SQL统计信息的详细包。在写入IFCID 239记录之前，还必须激活以下其中一个跟踪：会计学7级会计学8级 7级显示器 8级显示器	239
11	计划级会计信息。当您启动显示器跟踪时，如果从START TRACE命令中省略了 `CLASS` 关键字，则第11类将被激活。	3200
12月28日	已保留。
29	控制子系统范围内的SQL语句统计信息。	316、318、400、401
30-32	可供本地使用。

IFCID （ifcid ，……）

指定除了“类别”选项中指定的类别所包含的 IFCID 之外，还要启动哪些其他 IFCID（跟踪事件）。要仅启动IFCID选项中指定的IFCID，请使用跟踪类别30、31或32。这些课程没有预先确定的IFCID，可供各地使用。有关仅激活IFCID选项中指定的跟踪事件的示例，请参见示例：具有远程活动的线程的性能跟踪。

如果您没有指定 IFCID 选项，则仅启动已激活跟踪类别中包含的那些 IFCID。

IFCID的最大数量为156。适用于IFCID选项的数值范围为1-511，但以下数值除外：4、5、185、187、217、232、234、240、241和362。这些例外是IFCID选项的无效值。 IFCIDs 4和5始终自动激活。

提示：

如果您指定了AUDTPLCY选项，IFCID 362将自动启动。其他一些无效的IFCID只能由某些跟踪类别激活。仅可由跟踪类启动的IFCID选项的无效值包括：

首先……: 启动...
国际金融公司185号: 6级监控追踪
国际金融公司232号: 监控跟踪级别2或7，或会计跟踪级别2或7
IFCID 240: 监控跟踪7级或会计跟踪7级
国际金融公司241号: 监控跟踪8级或会计跟踪8级

默认值为 IFCID( * ).

BUFSIZE ( k_bytes, …)

指定接收跟踪数据的IFC管理缓冲区的大小。仅当您指定了 OP n目的地时，才能选择此选项。

k_bytes 的范围是 256 KB 到 65536 KB。数字必须能被4整除。如果您指定的值超出此范围，则使用最接近指定值的范围限制。要分配256 KB的缓冲区大小，请指定BUFSIZE(256)。

默认值为 BUFSIZE （* ），这是安装 Db2 时设置的大小。

AUDTPLCY （政策名称，……）

列出最多八个审计策略名称，并收集其跟踪信息。此选项启动与所列审核策略中指定的类别相对应的IFCID，并启动IFCID 0362的跟踪。

AUDTPLCY适用于跟踪类型AUDIT。您不能将AUDTPLCY与CLASS或IFCID一起指定。

TDATA

指定要放入每个跟踪记录的产品部分的产品部分标题。如果您没有指定TDATA，则跟踪类型将决定产品部分标题的类型。跟踪记录的产品部分可以包含多个标题。

所有IFC记录都有一个标准的IFC标题。添加关联标题是为了会计、绩效、审计和监控记录。添加跟踪标题是为了便于记录维护信息。

CORRELATION: 在记录中放置关联标题。
缩写：COR
TRACE: 在记录上放置一个跟踪头。
缩写：TRA
CPU: 在记录中放置一个CPU标头。 CPU标头包含当前 z/OS TCB或SRB执行的处理器时间。
DISTRIBUTED: 在记录中放置一个分布式标题。
缩写：DIST

使用说明 -START TRACE

查找跟踪字段（IFCID）描述

您可以在IFCID平面文件（DSNWMSGS）中找到跟踪记录的描述。最新版本的DSNWMSGS仅适用于拥有 Db2 12 for z/OS 许可证的客户。信息以PDF文件的形式提供。要查找此信息，请访问 Db2 12 for z/OS IFCID 平面文件（DSNWMSGS ）。

审计策略

最多可同时启用32个审计策略。如果您指定了多个审计策略来启动，而其中一些策略无法成功启动，则会返回警告消息 DSNW196I。启动其余审计策略。

建议： FL 509 通过一个 START TRACE 命令启动所有防篡改审计策略，该命令将它们分配到一个跟踪编号。如果使用SCOPE(GROUP)选项来阻止防篡改审计策略，这样做有助于避免数据共享成员之间的跟踪编号不匹配。

痕迹数量

如果您在 PLAN、AUTHID 或 LOCATION 中使用一个或没有使用任何值，START TRACE 命令将启动单个跟踪。如果您为计划、授权ID或地点使用多个值，命令将为每个计划、授权ID或地点启动跟踪。

最多可同时激活32个轨迹。

如果从控制台或 DB2I 面板向 OP n 或OPX目的地输入START TRACE命令，则发送消息 DSNW133I ，表示跟踪数据丢失。

在启动监视器跟踪1级时使用选项PLAN、AUTHID或LOCATION对IFI READS请求返回的数据量没有影响。

当启动会计或监控跟踪2、5或7类时，使用PLAN、AUTHID或LOCATION选项不起作用。

停止与启动 Db2

如果您在开始跟踪后停止并重新启动 Db2 ，跟踪不会自动重启。

指定范围（组别）

当您发出带有范围（组）的启动跟踪命令时， Db2 会对数据共享组中的每个成员发出启动跟踪命令。数据将按照数据共享组中每个成员的定义发送到目的地。如果您想将数据共享组中所有成员的跟踪数据收集到一个位置，请使用带有IFI READA或READS调用的监控程序来收集数据。

更改开始 FL 509 如果您使用 SCOPE(GROUP) 选项指定多个要启动的审核策略，则审核策略将发送给数据共享组的所有成员。但是，如果指定的审核策略之一是防篡改审核策略，则数据共享组的所有成员都无法使用该防篡改审核策略。您不能使用SCOPE(GROUP)启动防篡改审计策略。更改结束

如果跟踪以SCOPE(GROUP)开始，并且新成员在跟踪开始后加入数据共享组，则新成员也会写入START TRACE命令指定的跟踪数据。

使用SCOPE(GROUP)启动跟踪可能会生成大量跟踪数据，因此您可能需要增加显示器程序中返回区域的大小，以容纳额外数据。

在部分名称或地址中使用*通配符进行搜索

在部分名称或地址中，您可以使用通配符后缀“*”来过滤主题。例如，如果您指定“-START TRACE PLAN (A,B,C*)”， Db2 将跟踪并返回A、B、CDE、CDEFG、CDEFGH等。它将追踪“A”、“B”和所有以“C”开头的线程。

您不能在部分名称或地址的中间包含通配符。

使用部分名称或地址中的位置（_）通配符来追踪线索

在部分名称或地址中，您可以使用位置通配符（由“_”字符表示）来追踪线程，当您希望在中间使用通配符或追踪特定长度的线程时，可以使用位置通配符。例如，如果您指定“-START TRACE PLAN (A_C)”，则将跟踪所有以“A”为第一个字符、以“C”为第三个字符的三个字符组成的线程。此命令将返回“ABC”、“ADC”、“AEC”等。如果您想追踪“A_C”的线索，则可以指定“-START TRACE PLAN (A/_C)”。 “_”前面的“/”告诉 Db2 在搜索中追踪下划线，而不是将其视为通配符。如果您要追踪包含“/”或“*”字符的字符串，请遵循同样的逻辑。因为字符“/”是一个转义字符，如果您想追踪包含“/”字符的线程，可以指定“-START TRACE PLAN (A//C)”来追踪“A/C”线程。您也可以指定“-START TRACE PLAN (A/*C)”来跟踪“A*C”线程。

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

您还可以根据多个跟踪条件来跟踪多个线程。例如，您可以指定“-START TRACE PLAN (A*, B*, C*)”，以同时跟踪以“A”、“B”和“C”开头的计划的所有线程。通配符“*”可以追踪所有线索。您可以指定更复杂的组合，例如“-START 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）

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

指定线程的过滤条件

您可以通过在-START TRACE命令中设置特定的过滤条件来控制写入跟踪记录的线程集。以下规则适用于所有跟踪过滤器：

Db2 当写入外部跟踪记录时，应用跟踪过滤器。根据线程的状态，决定是继续写入还是完全删除。例如，如果指定了PKGPROG(ABC)选项，则只有在导致跟踪记录外部化的SQL事件期间，ABC包处于活动状态时，才会为执行ABC包的线程写入跟踪记录。
跟踪过滤器不会更改跟踪记录的内容。
与特定跟踪记录无关的跟踪类别或IFCID不受过滤影响，例如会计类别2、3、7、8和10，或IFCID 318。例如，以下命令不会产生过滤结果，因为会计类别7或8没有写入外部记录：
```
-START TRACE(ACCTG) CLASS(7,8) DEST(SMF) PKGPROG(ABC)
```
Db2 在-START TRACE命令中，只允许一个过滤选项具有多个值。例如，以下命令是有效的：
```
-START TRACE PLAN(A,B) USERID(B) WRKSTN(E)
```
以下命令无效：
```
-START TRACE PLAN(A,B) USERID(A,B) WRKSTN(E)
```

使用排除功能过滤主题

当您在过滤线程时，使用任何限制关键字（如XPLAN）指定“X”，即表示您正在使用–START TRACE命令的排除功能。在运行跟踪命令时，您可以选择排除特定类型的线程。当您运行跟踪时，可以使用“X”字符排除特定的字符组合。例如，您可以指定此命令来追踪除“A”以外的所有线程：

-START TRACE XPLAN(A)

在这种情况下，可能会返回b、bcd、bcde或cd。

您也可以从跟踪中排除多种类型的线程。例如，您可以指定此命令来启动对除以“A”开头的计划的线程之外的所有线程的跟踪，这些计划的线程后面是任意字符组合，并且所有以“B”开头的计划的线程后面是任意字符组合：

-START TRACE XPLAN(A*, B*)

指定XPLAN（*）将排除所有搜索结果，因此不允许使用。在具有排除功能的跟踪条件中，您也不能使用*通配符，例如：“-START TRACE XPLAN (A*C)” 但是，您可以指定此命令返回除以下计划外的所有线程：以“A”开头，接下来是任意两个字符 ，第四个空格是“C”，最后是任意字符。

-START TRACE XPLAN (A_ _ C *)

您可以同时开始两条轨迹，以帮助您优化追踪功能。例如，您可以指定以下命令：

-START TRACE XPLAN (A, B, C) USERID(D)

这条命令告诉 Db2 ，除了计划“A”、“B”或“C”，仅当用户ID = “D”时，开始追踪所有计划的线程。

结合跟踪限定符

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

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

追踪目的地优先级

如果IFCID与类相关联，并且在IFCID关键字中指定了该IFCID，则类的目标优先。这条规则会影响会计类2、3、5、7、8和监控类1、2、3、5、7、8中的IFCID，因为这些类别的IFCID有预设的目的地。

例如，以下命令“-START TRACE(ACCTG) CLASS (1,2,3) IFCID(6,7) DEST SMF”不会将IFCID 6和7写入SMF，因为它们属于会计类别3，而该类别有预设的目的地。要将IFCID 6和7写入SMF，需要按以下步骤开始跟踪：

-START TRACE(ACCTG) CLASS(1,2,3) DEST(SMF)
-START TRACE(ACCTG) CLASS(30) IFCID(6,7) DEST(SMF)

供当地使用的IFCIDs

更改开始 Db2 不使用1999年之前的国际财务报告准则，仅供本地使用。更改结束

例子 -START TRACE

示例：远程活动的线程性能跟踪

开始追踪远程活动的线程，位置为 USIBMSTODB21。仅激活IFCID 0044（锁定暂停）和0045（锁定恢复）。 30级跟踪可用于安装。

-START TRACE (PERFM)
  DEST(GTF)
  LOCATION(USIBMSTODB21)
  CLASS(30)
  IFCID(44,45)

示例：计划的会计追踪

开始计划 DSN8BC81 的会计追踪。将记录写入SMF（默认情况下会这样做）。请留下评论以确认身份。

-START TRACE (ACCTG)
  PLAN (DSN8BC81)
  COMMENT ('ACCTG TRACE FOR DSN8BC81')

示例：统计追踪

开始统计追踪。将记录写入SMF（默认设置）。

-START TRACE=S

示例：启动监视器跟踪

在数据共享组上启动监视器跟踪（通常由应用程序完成）。将记录写入OPX（默认）。

-START TRACE(MON) SCOPE(GROUP)

示例：正在执行包的线程的性能跟踪记录

使用PKGPROG选项，仅针对在SQL事件期间执行包ABC的线程写入性能跟踪记录，该SQL事件导致跟踪记录外部化。

-START TRACE(PERFM) CLASS(3) DEST(SMF) PKGPROG(ABC)

示例：激活包级计费的会计追踪

启动会计追踪，激活软件包级会计，并收集由IFCID 3和IFCID 239外部化的数据。使用PKGPROG选项，将ABC包的会计记录写入时写入的会计信息导出。

-START TRACE(ACCTG) CLASS(1,2,3,7,8) DEST(SMF) PKGPROG(ABC)

外部记录包含会计期间执行的所有程序包的信息。

示例：为相关ID提供IFC排除过滤

START TRACE (A) XCORRID (*)
- 10.46.05 STC00051  DSNW150I  ) EXCLUDE FOR ALL CORRID VALUES IS NOT       
-  ALLOWED                                                                  
- 10.46.05 STC00051  DSN9023I  ) DSNWVCM1 '-START TRACE' ABNORMAL COMPLETION

使用审计策略的审计跟踪示例

使用审计策略AUDITADMIN开始审计追踪。

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

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

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

IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID
1	2	4	5	104	105	107	124	129	147
148	149	150	185	186	199	202	217	225	230
254	306	316	317	365	401	402	411	412

IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID
1	2	4	5	104	105	107	124	129	147
148	149	150	185	186	199	202	217	225	230
254	306	316	317	365	401	402	411	412

IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID	IFCID
1	2	4	5	104	105	107	124	129	147
148	149	150	185	186	199	202	217	225	230
254	306	316	317	365	401	402	411	412