The Check Communications Trace (CHKCMNTRC) command returns the communications trace status for a specific line, a network interface description, a network server description, or for all of the traces of a specific type that exist on the system. The status is returned through a message.

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.
• The following user profiles have authority to this command:
  • QSECOFR
  • QSRV

Parameters

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

Top

Configuration object (CFGOBJ)

Specifies the name of the configuration description to check. The configuration description is either a line description or a network interface description.

This is a required parameter.

*ALL

The communications trace status is returned for all of the traces of a specific type.

name

Specify the name of the configuration description to be checked.

Type (CFGTYPE)

Specifies the object type of the configuration description to check.

This is a required parameter.

*LIN

Status for lines is shown.

*NWI

Status for network interfaces is shown.

*NWS

Status for network servers is shown.

Examples

Example 1: Checking All Traces

CHKCMNTRC   CFGOBJ(*ALL)  CFGTYPE(*NWI)

This command shows the communications trace status of all network interface traces.

Example 2: Checking An Individual Trace

CHKCMNTRC   CFGOBJ(QESLINE)  CFGTYPE(*LIN)

This command shows the communications trace status of line QESLINE.

Error messages

*ESCAPE Messages

CPF39A7

Trace storage not available in communications processor

CPF39A8

Not authorized to communications trace service tool

CPF39A9

Error occurred during communications trace function

CPF39BE

No communications traces of type &1 exist

CPF39B0

No communications traces exist.

CPF39B1

Trace &1 type &2 does not exist

CPF39B6

Communications trace function cannot be performed

CPF98A2

Not authorized to &1 command.