Dump User Trace (DMPUSRTRC)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Dump User Trace Buffer (DMPUSRTRC) command formats trace records in the user trace buffer for the specified job. The formatted trace records can be written to a database file or to the stdout special file.
Trace records are written to a user trace buffer using the Qp0zUprintf, Qp0zDump, Qp0zDumpStack, and Qp0zDumpTargetStack APIs. Refer to the APIs topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/, UNIX-type APIs for more information on the Problem Determination APIs.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JOB | Job name | Single values: * Other values: Qualified job name |
Optional, Positional 1 |
| Qualifier 1: Job name | Name | ||
| Qualifier 2: User | Name | ||
| Qualifier 3: Number | 000000-999999 | ||
| TRCRCID | Trace record identifiers | Values (up to 2 repetitions): *THD, *JOB | Optional |
| OUTPUT | Output | *FILE, *STDOUT | Optional |
| SLTTHD | Thread IDs to include | Single values: *ALL Other values (up to 8 repetitions): Hexadecimal value |
Optional |
| OMTTHD | Thread IDs to exclude | Single values: *NONE Other values (up to 8 repetitions): Hexadecimal value |
Optional |
| Top |
Job name (JOB)
Specifies the job for which the user trace buffer is being dumped.
The possible values are:
- *
- The user trace buffer for the job that the command is running in is dumped.
- job-name
- Specify the name of the job whose user trace buffer is being dumped. If no user name or job number qualifier is given, all of the jobs currently in the system are searched for the simple job name. If duplicates of the specified name are found, a qualified job name must be specified.
- user-name
- Specify the name of the user of the job whose user trace buffer is being dumped.
- job-number
- Specify the six-digit number of the job whose user trace buffer is being dumped.
| Top |
Trace record identifiers (TRCRCID)
Specifies the record identifiers to be used in the formatted tracepoint records. Up to two identifiers can be specified.
The possible values are:
- *THD
- Thread identifiers are used. Each identifier contains eight hexadecimal digits.
- *JOB
- Job identifiers are used. Each identifier contains the six-digit job number portion of the qualified job name.
| Top |
Output (OUTPUT)
Specifies where the output from the command is directed to.
The possible values are:
- *FILE
- The output is written to member QP0Znnnnnn in database file QAP0ZDMP in library QTEMP where 'nnnnnn' is the six-digit job number portion of the qualified job name.
- *STDOUT
- The output is written to the stdout special file.
| Top |
Thread IDs to include (SLTTHD)
Specifies a list of up to eight threads whose trace records are to be included. Only trace records for threads with the specified thread identifiers are included.
Note: This parameter and the OMTTHD parameter are mutually exclusive.
The possible values are:
- *ALL
- All trace records are included, unless excluded by another selection value.
- thread-identifier
- Specify the thread identifiers of up to eight threads whose trace records are to be included.
| Top |
Thread IDs to exclude (OMTTHD)
Specifies a list of up to eight threads whose trace records are to be excluded. Trace records for all threads except those specified are included.
Note: This parameter and the SLTTHD parameter are mutually exclusive.
The possible values are:
- *NONE
- No trace records are excluded based on their thread identifier.
- thread-identifier
- Specify the thread identifiers of up to eight threads whose trace records are to be excluded.
| Top |
Examples
Example 1: Dumping the Current User Trace Information
DMPUSRTRC
This command formats the user trace information for the current job and writes the formatted trace records to file QAP0ZDMP in library QTEMP.
Example 2: Dumping a Trace for a Specific Job
DMPUSRTRC JOB(004842/ACCT/WS6) OUTPUT(*STDOUT)
This command formats the user trace information for job WS6, which is associated with the user profile ACCT, and has the job number 004842, writing the formatted trace records to the stdout special file.
| Top |
Error messages
*ESCAPE Messages
- CPFA98B
- The User Trace buffer associated with job &3/&2/&1 could not be dumped.
- CPFA98C
- Job &3/&2/&1 not unique.
| Top |