Work with Traces (WRKTRC)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Work with Traces (WRKTRC) command can be used to show a panel with the list of existing communications traces, job traces, licensed internal code (LIC) traces and performance explorer (PEX) traces around the system. You can work with the existing traces or start a new trace. When you run this command, the Work with Traces panel is shown.
Restrictions:
- To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service trace function of the IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| TRC | Trace | Single values: *ALL Other values (up to 4 repetitions): *CMN, *JOB, *LIC, *PEX |
Required, Positional 1 |
| Top |
Trace (TRC)
Specifies the type of traces to be shown on the Work with Traces panel.
This is a required parameter.
Single values
- *ALL
- All communications traces, job traces, licensed internal code (LIC) traces and performance explorer (PEX) traces are listed in the Work with Traces panel.
Other values
- *CMN
- All communications traces are shown in the Work with Traces panel.
- *JOB
- All job trace session identifiers are shown in the Work with Traces panel. This includes trace sessions started by the Start Trace (STRTRC) command and the Trace TCP/IP Application (TRCTCPAPP) command specifying the Additional traces (ADLTRC) parameter.
- *LIC
- All LIC traces are shown in the Work with Traces panel. This includes traces started by the Trace Internal (TRCINT) command, the Trace Connection (TRCCNN) command, the Trace TCP/IP Application (TRCTCPAPP) command specifying the Additional traces (ADLTRC) parameter, the Start System Service Tools (STRSST) command, or the Start DST (STRDST) command.
- *PEX
- All PEX traces are shown in the Work with Traces panel.
| Top |
Examples
WRKTRC TRC(*LIC)
This command displays the Work with Traces panel, showing all traces started issuing the Trace Internal (TRCINT) command, the Trace Connection (TRCCNN) command, the Trace TCP/IP Application (TRCTCPAPP) command specifying the Additional traces (ADLTRC) parameter, the Start System Service Tools (STRSST) command, and Start DST (STRDST) command.
| Top |
| Top |