DLTTRC (Delete Trace Data)

DLTTRC Command syntax diagram

 

Purpose

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

1. To use this command 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 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.
2. To use this command have authority to the library and the database files within that library where the trace data is stored.

 

Required Parameters

DTAMBR

Specifies the member name for 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.

member-name: Specify the member name for the trace to delete.

 

Optional Parameters

DTALIB

Specifies the name of 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.

library-name: Specify the library that contains the trace data files.

Example for DLTTRC

DLTTRC DTAMBR(MYTRACE) DTALIB(MYTRCLIB)

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

Error messages for DLTTRC

*ESCAPE Messages

CPC3925

&1 members removed, &2 members not removed.

CPF39CE

Error occurred during processing of the DLTTRC command.