 |
» |
|
|
|
Activates or deactivates link level tracing on a specified
communications link. Provides link transmission error statistics
and/or configuration information. Syntax | |
[A(ll) ]
[C(onfiguration)]
LINKCONTROL linkname {;STATUS=} [L(inkstate) ]
{, } [S(tat)istics)) ]
[D(iag(stats)) ]
[R(eset) ] |
[,DATA ]
[ON] [,ALL ]
LINKCONTROL Linkname;TRACE=[OFF] [,PARTIAL][,buffsize][,tracefile]
[,FULL ] |
Use | |
Available In Session? YES |
Parameters | |
- linkname
The configured name of an active data communications
link. Only the link name specified in the LINK portion of the configuration
file (@LINK.linkname)
is valid. The character @ may be
used to signify all active links. (Partial wildcards, such as PSI@,
are not allowed, however.) - STATUS
Requests status information about the link. May
not be used with the TRACE
option. For all options, displays the linkname, linktype, and additional
information as follows: - ALL
Prints the information displayed by the LINKSTATE,
CONFIGURATION, and STATISTICS
parameters. These parameters are described more fully later in this
section. Additional information about the LINKCONTROL
command and its parameters can be found in Appendix A “LINKCONTROL Command” - CONFIGURATION
Prints the information displayed by the LINKSTATE
parameter along with link configuration information for the link.
The link configuration data consists mainly of the configuration
information that was input for this link during NMMGR configuration.
The fields that are displayed by this parameter are described in
Appendix A “LINKCONTROL Command” - LINKSTATE
Prints link status information, including the link
name, link type, and the current status of the link. - DIAGSTATS
Prints the information displayed by the LINKSTATE,
CONFIGURATION,
and STATISTICS
parameters along with additional diagnostic statistics. - STATISTICS
Prints the information displayed by the LINKSTATE
command and link statistics, including accumulated error information.
This includes such information as the number of data bytes sent
and received, and the number of frames sent and received. The fields
that are displayed by this parameter are described in Appendix A “LINKCONTROL Command” - RESET
Resets the accumulated data and link statistics
that are displayed by the previously described parameters to 0.
Displays the same fields that are displayed by the STATISTICS
parameter.
The STATUS
and TRACE parameters
are mutually exclusive and may not be specified together in a LINKCONTROL
command. - TRACE
Activates link-level tracing. Only one active trace
is allowed per link. If a trace is already active, issuing the command
a second time will result in a TRACE REQUEST FAILED error message
(NMERR 182). If TRACE
is specified, either ON
or OFF must also
be specified. - ON
Turns link level tracing on. - OFF
Turns link level tracing off. Any subsequent subparameters
are checked for syntax but are otherwise ignored. - DATA
(LAN and token ring links only) Traces all read
and write requests. If neither DATA
nor ALL is specified,
DATA is the default. - ALL
(LAN and token ring links only) Traces all read,
write, control, status, and exception requests. - PARTIAL
(Point-to-Point only) Trace all read, write, control,
status, and exception requests. Only the first 16 bytes of data
are traced for reads or writes. - FULL
(Point-to-Point only) Traces the full data field
for all read, write, control, status, and exception requests. If
neither PARTIAL
nor FULL is specified,
PARTIAL is the
default. - buffsize
The trace buffer size in memory, in kilobytes. This
area is used to buffer trace data before it is written to disk.
Allowable values are from 1 to 16. - tracefile
Actual file designator of the disk file where the
trace is to be written. If not specified, the trace will automatically
be written to a file with the name NMTCnnnn.PUB.SYS,
where nnnn is a value between 0000 and
9999. If the filename is specified without group or account names,
the current group and account names are used.
TRACE may
not be specified in a LINKCONTROL
command also containing STATUS.
Discussion | |
The LINKCONTROL command
returns link statistics and configuration information or activates
or deactivates link level tracing on the specified link. The NMCONFIG.PUB.SYS
and the link must be active for this command to be operative. If a trace option that is inapplicable for a certain link
is specified for that link, then the default for that link type
will be used. The LINKCONTROL command
does not work on an X.25 link because the link is in the DTC. For
equivalent functionality, use the OpenView DTC Manager for PC-based
X.25 links or TermDSM for host-based X.25 links. Example 1: | |
LINKCONTROL SYSLINK, ALL
Linkname: SYSLINK Linktype: IEEE8023 Linkstate: CONNECTED
Physical Path: 4.3
Inbound Buffer Size: 1536
Inbound Number of Buffers: 64
Inbound Buffers Available: 56
Current Station Address: 08-00-09-00-EE-8C
Default Station Address: 08-00-09-00-EE-8C
Current Receive Filter: bad(0) multi(1) broad(1) any(0)
Current Multicast Addresses:
09-00-09-00-00-01
Transmits no error 19231 Receives no error 2493981
Transmits error 0 Receives error 16
Out of Tx bufs 0 Out of Rx bufs 2
Transmits deferred 370 Carrier losses 0
Transmits 1 retry 16 Reflectometer 0
Transmits 1 retry 15 CRC errors 12
Transmits 16 collisions 0 Whole byte errors 11
Transmits late collision 0 Size range errors 0
802 chip restarts 0 Frame losses 10
Heartbeat losses 0 |
Example 2: | |
:LINKCONTROL SYSLINK;TRACE=ON,DATA,8
Trace has been successfully enabled for SYSLINK.
The trace file, for SYSLINK, is NMTC0006.PUB.SYS.
:LINKCONTROL SYSLINK;TRACE=OFF
Trace has been successfully disabled for SYSLINK. |
|
