HP 3000 Manuals HP 3000 Manuals
LINKCONTROL
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
In Job? YES
In Break? YES
Programmatically? YES
Breakable? YES
Capabilities? NM
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
disc. Allowable values are
from 1 to 16.
tracefile Actual file designator of the
disc 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.