End Performance Trace (ENDPFRTRC)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The End Performance Trace (ENDPFRTRC) command will stop the collection of performance trace data in the QPM_STRPFRTRC trace table and optionally write performance trace data to a data base file. The QPM_STRPFRTRC trace table will be deleted whether or not the data is written to a data base file.

This command is intended to be used to end a performance trace started via the Start Performance Trace (STRPFRTRC) command. However, it will end and try to process any active trace in the QPM_STRPFRTRC trace table.

Restrictions:

  1. This command is shipped with public *EXCLUDE authority.
  2. The following user profiles have private authorities to use the command:
    • QSRV
Top

Parameters

Keyword Description Choices Notes
DMPTRC Dump the trace *NO, *YES Optional, Positional 1
MBR Member Name Optional
LIB Library Name, QPFRDATA Optional
TEXT Text 'description' Character value, *BLANK Optional
Top

Dump the trace (DMPTRC)

Specifies whether the trace data is to be dumped to the performance database file QAPMDMPT. If the data is not dumped, it will be lost when the trace table is deleted.

*YES
The trace data, if any, is dumped.
*NO
The trace data is not dumped.
Top

Member (MBR)

Specifies the member within the QAPMDMPT database file where the trace table data is to be dumped. A value must be specified for this parameter if *YES is specified for the Dump the trace (DMPTRC) parameter.

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

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 to locate the database file for trace data.
name
Specify the name of the library to be searched.
Top

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

Examples

Example 1: Ending Performance Trace 

ENDPFRTRC   DMPTRC(*YES)  MBR(MYDATA)

In this example, the current trace is ended, the data is written to member MYDATA of file QAPMDMPT in library QPFRDATA, and the trace table is deleted, releasing the storage used by the trace.

Top

Error messages

*ESCAPE Messages

Refer to the TRCINT and DMPTRC commands for messages.

Top