DMPTRC (Dump Trace) Command Description

DMPTRC Command syntax diagram

Purpose

The Dump Trace (DMPTRC) command copies data from the vertical microcode (VMC) trace table to a database file. The user can optionally 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:

1. This command is shipped with public *EXCLUDE authority.
2. To use this command have *SERVICE special authority, or be authorized to the Service Trace function of Operating System/400 through iSeries Navigator's Application Administration support. 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.
3. The following user profiles have private authorities to use the command:

   • QSRV
   • QPGMR

Required Parameter

MBR

Specifies the member name of the database file where the trace table data is dumped. If STRPFRMON was used to collect the trace data, the same name that was specified on the Start Performance Monitor (STRPFRMON) command should be used. If Performance Tools/400 is installed, this is a requirement for the reporting function of the Print Transaction Report (PRTTNSRPT) command.

Optional Parameters

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.

The name of the database file can be qualified by one of the following library values:

QPFRDATA: The data is located in the IBM-supplied performance data library, QPFRDATA.

library-name: Specify the name of the library to be searched.

JOBQ

Specifies the qualified name of the job queue on which this job is placed. The name of the job queue can be qualified by one of the following library values:

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

*LIBL: All libraries in the job's library list 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.

library-name: Specify the name of the library to be searched.

QCTL: The IBM-supplied controlling subsystem QCTL is used.

job-queue-name: Specify the name of the job queue.

*NONE: No job is submitted. The DMPTRC request runs interactively.

TEXT

Specifies the text that briefly describes the database member. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

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

Example for DMPTRC

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 for DMPTRC

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