Delete Communications Trace (DLTCMNTRC)

Where allowed to run: All environments (*ALL) Threadsafe: No

Parameters Examples Error messages

The Delete Communications Trace (DLTCMNTRC) command deletes the communications trace for the specified line, a network interface description, or a network server description. The communications trace can be deleted after the trace has ended.

Restrictions:

• To use this command, 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.

• The following user profiles have authority to this command:

  • QSECOFR

  • QSRV

Top

---

 

Parameters

Keyword	Description	Choices	Notes
CFGOBJ	Configuration object	Name	Required, Positional 1
CFGTYPE	Type	*LIN, *NWI, *NWS	Required, Positional 2

Top

 

Configuration object (CFGOBJ)

Specifies the configuration object for which collected trace information is to be deleted.

This is a required parameter.

name

Specify the name of the configuration object for which trace information is to be deleted.

Top

 

Type (CFGTYPE)

Specifies the type of configuration description that was traced.

This is a required parameter.

*LIN

The type of configuration object is a line description.

*NWI

The type of configuration object is a network interface description.

*NWS

The type of configuration object is a network server description.

Top

---

 

Examples

 DLTCMNTRC   CFGOBJ(*QESLINE)  CFGTYPE(*NWI)

This command deletes the communications trace data for line description QESLINE.

Top

---

 

Error messages

*ESCAPE Messages

CPF2634

Not authorized to object &1.

CPF39A7

Trace storage not available in communications processor

CPF39A8

Not authorized to communications trace service tool

CPF39A9

Error occurred during communications trace function

CPF39B0

No communications traces exist.

CPF39B1

Trace &1 type &2 does not exist

CPF39B2

Trace data for &1 type &2 cannot be deleted

CPF39B6

Communications trace function cannot be performed

CPF98A2

Not authorized to &1 command.

Top