ENDCMNTRC (End Communications Trace)

ENDCMNTRC Command syntax diagram

 

Purpose

The End Communications Trace (ENDCMNTRC) command ends the trace running on the specified line, network interface, or network server description.

 

Restrictions

  1. The user must have *USE authority for the line, network interface, or network server to be traced.
  2. To use this command have *SERVICE special authority, or be authorized to the Service Trace function of Operating System/400 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.
  3. This command is shipped with public *EXCLUDE authority.
  4. The following user profiles have authority to this command:

    • QSECOFR
    • QSRV

 

Required Parameters

CFGOBJ
Specifies the name of the configuration object being traced. The object is either a line description, a network interface description, or a network server description.
CFGTYPE
Specifies the type of configuration description being traced.

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

Example for ENDCMNTRC

ENDCMNTRC  CFGOBJ(*QESLINE)  CFGTYPE(*LIN)

This command ends the communications trace of line description QESLINE.

Error messages for ENDCMNTRC

*ESCAPE Messages

CPF26AE
Network server description &1 not found.
CPF2601
Line description &1 not found.
CPF2634
Not authorized to object &1.
CPF39AE
Trace already ended.
CPF39AF
Trace is ending - please wait
CPF39A7
Trace storage not available in communications processor
CPF39A8
Not authorized to communications trace service tool
CPF39A9
Error occurred during communications trace function
CPF39BD
Network interface description &1 not found
CPF39B0
No communications traces exist.
CPF39B1
Trace &1 type &2 does not exist
CPF39B6
Communications trace function cannot be performed
CPF39C3
Trace &1 type &2 cannot be ended.