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

Keyword	Description	Choices	Notes
DTAMBR	Data member	Name	Optional, Positional 1
DTALIB	Data library	Name, *CURLIB	Optional

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)

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.