End Communications Trace (ENDCMNTRC)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The End Communications Trace (ENDCMNTRC) command ends the trace running on the specified line, network interface, or network server description.
Restrictions:
- You must have use (*USE) authority to the line, network interface or network server to be traced.
- You must have service (*SERVICE) special authority, or be authorized to the Service trace function of IBM i through System i 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 being traced. The object is either a line description, or a network interface description, or a network server description.
This is a required parameter.
- name
- Specify the name of the configuration object for which communications tracing is to be ended.
| Top |
Type (CFGTYPE)
Specifies the type of configuration description being 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
ENDCMNTRC CFGOBJ(*QESLINE) CFGTYPE(*LIN)
This command ends the communications trace of line description QESLINE.
| Top |
Error messages
*ESCAPE Messages
- CPF2601
- Line description &1 not found.
- CPF2634
- Not authorized to object &1.
- CPF26AE
- Network server description &1 not found.
- 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.
- CPF98A2
- Not authorized to &1 command or API.
| Top |