The Dump Trace (DMPTRC) command copies data from the vertical microcode (VMC) trace table to a database file. You can run the job interactively or submit it as a batch job. (Batch jobs will run under the submitter's job description and user profile.)

Restrictions:

• This command is shipped with public *EXCLUDE authority.
• To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of the operating system through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) CL command or the Change Function Usage Information (QSYCHFUI) API, 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.
• The following user profiles have authority to this command:
  • QSRV
  • QPGMR

Parameters

Keyword	Description	Choices	Notes
MBR	Member	Name	Required, Positional 1
LIB	Library	Name, QPFRDATA	Optional
JOBQ	Job queue	Single values: *NONE Other values: Qualified object name	Optional
	Qualifier 1: Job queue	Name, QCTL
	Qualifier 2: Library	Name, QSYS, *LIBL, *CURLIB
TEXT	Text 'description'	Character value, *BLANK	Optional

Top

Member (MBR)

Specifies the member of the database file in which the trace table data is to be dumped.

This is a required parameter.

name

Specify the name of the database file member to be used.

Library (LIB)

Specifies the library where the database file for trace data is located. If the file is not found in the specified library, the system automatically creates it in that library.

QPFRDATA

IBM-supplied performance data library QPFRDATA is to be used.

name

Specify the name of the library to be used.

Job queue (JOBQ)

Specifies the job queue to be used if you want this Dump Trace (DMPTRC) command to run as a batch job.

Single values

*NONE

No job is submitted. The DMPTRC request runs interactively.

Qualifier 1: Job queue

QCTL

Job queue QCTL is to be used.

name

Specify the name of the job queue to be used.

Qualifier 2: Library

QSYS

The IBM-supplied system library, QSYS, is used to locate the job queue.

*LIBL

All libraries in the library list for the current job are searched until the first match is found.

*CURLIB

The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

name

Specify the name of the library to be searched.

Text 'description' (TEXT)

Specifies the text that briefly describes the database member.

*BLANK

No text is specified.

character-value

Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

DMPTRC   MBR(TUESAM)

This command causes existing VMC trace data to be written to the member TUESAM in library QPFRDATA. The file used is QAPMDMPT. The request is submitted to the job queue QCTL in library QSYS. It runs as a batch job.

Error messages

*ESCAPE Messages

CPF0A81

Performance trace cannot be sent to database file.

CPF0A82

Performance trace cannot be sent to database file.

CPF2110

Library &1 not found.

CPF3307

Job queue &1 in &2 not found.

CPF7207

Not able to start &2. Return code &3.