Printing and analyzing global traces
A trace must be active on the Db2 subsystem that you want to trace. For data sharing, the trace commands have member or group scope.
You can activate a trace at all members of a data sharing group by issuing the START TRACE command with the SCOPE(GROUP) parameter on one member of the data sharing group. Db2 routes the command to each member of the data sharing group. The trace output goes to the destination that is specified on the DEST parameter.
| Keyword | Valid with commands | Default | Other parameters | Comments and restrictions |
|---|---|---|---|---|
| TRACE | START | None | Type of trace | This keyword must be specified. A parameter does not need to be specified for the TRACE keyword if other keywords and their parameters provide sufficient detail to stop or display trace activity. |
| DISPLAY | ||||
| MODIFY | None | |||
| STOP | None | |||
| CLASS | START | Class number | None | |
| DISPLAY | ||||
| MODIFY | ||||
| STOP | ||||
| DEST | START | Established by trace type | GTF, RES, SMF SRV, or OPn | SRV is reserved for IBM® service personnel. |
| DISPLAY | ||||
| STOP | ||||
| PLAN | START | * | in the range 1–8 valid PLAN names | If several PLANs are specified, only one AUTHID and TNO can be specified. If several values are specified, only one LOCATION value can be specified. |
| DISPLAY | * | |||
| STOP | * | |||
| AUTHID | START | * | in the range 1–8 valid AUTHIDs | If several AUTHIDs are specified, you only one PLAN and TNO can be specified. If several values are specified, only one LOCATION value can be specified. |
| DISPLAY | * | |||
| STOP | * | |||
| RMID | START | * | in the range 1–8 RMIDs | None. |
| DISPLAY | * | |||
| STOP | * | |||
| TNO | DISPLAY | * | in the range 1–8 valid trace numbers | If several TNOs are specified, only one PLAN and AUTHID can be specified. TNO is required with MODIFY If several values are specified, only one LOCATION value can be specified. |
| MODIFY | * | |||
| STOP | * | |||
| IFCID | START | Set by trace type | IFCID number | When a trace type is specified, all IFCIDs specified by the trace type, classes and the IFCID are started. |
| MODIFY | ||||
| COMMENT | START | Blanks | Any character string | The comment is displayed within the stop or start trace record that is sent to SMF, GTF, or SRV. |
| DISPLAY | ||||
| MODIFY | ||||
| STOP | ||||
| TDATA | START | Established by trace type | COR, CPU, or TRA | The product section of a trace record can contain several headers. |
| LOCATION | START | * | in the range 1–8 valid location names | If several LOCATIONs are specified, only one PLAN, AUTHID, and TNO can be specified. |
| DISPLAY | * | |||
| STOP | * |
