Delete Trace (DLTTRC)

The Delete Trace Data (DLTTRC) command deletes trace data that was stored in a set of database files by the ENDTRC (End Trace) command.

Restrictions:

• To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service trace function of IBM i through System i 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.
• To use this command, you must have authority to the library and the database files within that library where the trace data is stored.

Parameters

Data member (DTAMBR)

Specifies the database file member that contains the trace data that you want to delete. The member name will be the same as the trace session identifier specified on the Start Trace (STRTRC) and End Trace (ENDTRC) commands. The member name is the same for each of the physical files that contain the trace data.

This is a required parameter.

name

Specify the name of the database file member that contains the trace data.

Data library (DTALIB)

r Specifies the library that contains the set of database files where the collected trace data is stored.

*CURLIB

The trace data is deleted from files in the current library for the job. If no library is specified as the current library for the job, QGPL is used.

name

Specify the name of the library that contains the trace data files.

Examples

DLTTRC   DTAMBR(MYTRACE)  DTALIB(MYTRCLIB)

This command removes the database file members for files in library MYTRCLIB which contain trace data associated for trace session MYTRACE.

Error messages

*ESCAPE Messages

CPC3925

&1 members removed, &2 members not removed.

CPF39CE

Error occurred during processing of the DLTTRC command.

CPF98A2

Not authorized to &1 command or API.