Dump User Trace (DMPUSRTRC)

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 System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter, OS/400 UNIX-type APIs for more information on the Problem Determination APIs.

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.

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.

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.

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.

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.

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.