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 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.

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.

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.

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