Print Trace Data (PRTTRC)

The Print Trace (PRTTRC) command formats and writes the trace records to the selected output file. The trace records were written to a set of database files by the ENDTRC (End Trace) command and PRTTRC is used to format these trace records to a spooled output file or to a database output file. If the trace records are written to a spooled output file, printer file QPSRVTRCJ is used. The user data for the spooled file will be the same as the value specified for the DTAMBR (Data member) parameter.

Restrictions:

To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service trace function of Operating System through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, 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.
You must have authority to the library and the database files within that library where the trace data is stored.
If DLTTRC(*YES) is specified, you must have authority to the DLTTRC (Delete Trace Data) command.
The record format of the database output file must match the record format of the IBM-supplied output file QASCTJFL.
The ENDTRC command that produced the trace data and the PRTTRC command that processes and formats the trace data must be run on the same release of Operating System.

Parameters

Keyword	Description	Choices	Notes
DTAMBR	Data member	Name	Optional, Positional 1
DTALIB	Data library	Name, *CURLIB	Optional
SLTJOB	Select jobs	Single values: ALL Other values (up to 10 repetitions): Qualified job name*	Optional
	Qualifier 1: Select jobs	Generic name, name
	Qualifier 2: User	Generic name, name, *ALL
	Qualifier 3: Number	000001-999999, *ALL
DLTTRC	Delete trace	YES, NO	Optional
SORT	Sort by	TIME, THREAD	Optional
OUTPUT	Output	PRINT, OUTFILE	Optional
OUTFILE	File to receive output	Qualified object name	Optional
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	ADD, REPLACE

Top

Select jobs (SLTJOB)

Specifies which jobs to include in the trace listing. This allows the user to reduce the size of the trace listing by selecting only a subset of the jobs that were part of the trace. Up to ten qualified job names can be specified.

Single values

*ALL: All jobs that were part of the trace are included.

Qualifier 1: Select jobs

generic-name: Specify the generic name of the jobs to be included in the trace listing. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic job name specifies all jobs with job names that begin with the generic prefix.
name: Specify the name of the job to be included in the trace listing.

Qualifier 2: User

*ALL: All jobs that match the specified job name are included.
generic-name: Specify the generic user name of the jobs to be included.
name: Specify the name of the user of the job to be included.

Qualifier 3: Number

*ALL: All jobs that match the specified job name and user name are included.
000001-999999: Specify the job number to further qualify the job name and user name.

File to receive output (OUTFILE)

Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

Qualifier 1: File to receive output

name: Specify the name of the database file to which the command output is directed.

Qualifier 2: Library

*LIBL: The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
*CURLIB: The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.

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

Note: If this command creates the file, the text is "OUTFILE created by PRTTRC command" and the public authority is *EXCLUDE.

Output member options (OUTMBR)

Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the Output (OUTPUT) parameter.

Element 1: Member to receive output

*FIRST: The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter.
name: Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.
If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.

Element 2: Replace or add records

*REPLACE: The existing records in the specified database file member are replaced by the new records.
*ADD: The new records are added to the existing information in the specified database file member.

Examples

Example 1: Print and Delete Trace

PRTTRC   DTAMBR(TRACE8)  DTALIB(TRCLIB1)  DLTTRC(*YES)

This command formats and prints the trace data contained in database file members named TRACE8 in library TRCLIB1. The trace data members are removed after the trace data spooled file has been written. All jobs which were part of the trace will be part of the trace listing.

Example 2: Print Subset Trace

PRTTRC   DTAMBR(T123456789)  DTALIB(QGPL)
         SLTJOB(*ALL/QSYS/QCMN*)  DLTTRC(*YES)

This command formats and prints the trace data contained in database file members named T123456789 in library QGPL. The trace data members are removed after the trace data spooled file has been written. Only those traced jobs that were started under user profile QSYS and had job names that started with "QCMN" will be part of the trace listing.

Example 3: Print Trace and Sort by Time

PRTTRC   DTAMBR(MYTRACE)  DTALIB(MYTRCLIB)
         DLTTRC(*YES)  SORT(*TIME)

This command formats and prints the trace data contained in database file members named MYTRACE in library MYTRCLIB. The trace data members are removed after the trace data spooled file has been written. The trace records are sorted by the time the record was collected. If the traced jobs were multithreaded, the trace output is sorted by job, with all threads in that job sorted by time. The resulting output may have trace information for multiple threads intermingled.

Example 4: Print Trace to an Output File

PRTTRC   DTAMBR(BIGTRACE)  DTALIB(TRACELIB)  DLTTRC(*YES)
         OUTPUT(*OUTFILE)  OUTFILE(MYLIB/MYFILE)

This command stores the trace data contained in database file members named BIGTRACE in library TRACELIB into a database output file named MYFILE in library MYLIB. The trace data members named BIGTRACE are removed after the trace data has been written to the database output file.