HP 3000 Manuals HP 3000 Manuals
LINKCONTROL
LINKCONTROL is an MPE XL operating system command. RJE/XL takes
advantage of the LINKCONTROL command to provide the user with link status
and the ability to dynamically enable or disable the trace facility.
LINKCONTROL can provide the user with link status in addition to enabling
or disabling the trace facility. Node Manager (NM) capability is
required to use LINKCONTROL.
LINKCONTROL; STATUS
The following LINKCONTROL command gives you the status on one or more HP
3000 links.
{@ }{, }
LINKCONTROL [LINKNAME=] {linkname }{;STATUS= }
{A[LL] }
{C[ONF[IGURATION]]}
{L[INK[STATE] }
{S[TAT[ISTICS]] }
{D[IAG[STATS]] }
{R[ESET] }
linkname is required unless @ is specified. The status value may be
specified by preceding it with a comma or as a keyword by preceding it
with a semicolon and the keyword STATUS= .
If no status is specified, the default is STATUS=ALL.
Parameters
LINKNAME= The name of an active data communications link.
@ All active linknames. If specified without any other
parameters, then STATUS=LINKSTATE is assumed.
STATUS = Requests status information about the link. If STATUS
is not specified, STATUS=ALL is assumed.
ALL Prints configuration information followed by link
statistics information.
CONFIGURATION Prints configuration information associated with this
link.
LINKSTATE Prints linkstate information.
STATISTICS Prints various link statistics, including accumulated
link level error statistics.
DIAGSTATS Prints linkstate information followed by diagnostic type
link statistics.
RESET Resets accumulated link statistic counters to zero.
LINKCONTROL; TRACE=ON
The LINKCONTROL; TRACE=ON command turns link level tracing on for the
specified link.
{@ }
LINKCONTROL [LINKNAME=] {linkname };TRACE=ON
[DATA][,bufsize][,tracefilename][,{PARTIAL }]
[,{FULL }]
Parameters
LINKNAME= The keyword that precedes the name of an active data
communications link.
@ All active linknames.
DATA Not used by RJE/XL.
bufsize Size in Kbytes of the trace buffer area in memory.
This area is used to buffer trace data before it can
be written to disk. Allowable values are 1 to 16.
The default value is 5.
tracefilename The actual file designator of a disk file to which
the trace will be written. If not specified, a file
with the name NMTCnnnn.PUB.SYS will be supplied
automatically, where nnnn varies from 0 to 9999. If
file name is specified without group or account
names, the user's current group and account names
will be used.
PARTIAL Traces all read, write, control, status, and
exception requests. Only the first 16 bytes of data
are traced for reads or writes.
FULL Traces all read, write, control, status, and
exception requests. All of the data field is traced.
PARTIAL is the default.
LINKCONTROL; TRACE=OFF
The LINKCONTROL; TRACE=OFF command turns off link level tracing for the
specified link.
{@ }
LINKCONTROL [LINKNAME=] {linkname };TRACE=OFF
Parameters
LINKNAME= The keyword that precedes the name of an active data
communications link.
@ All active linknames.
LINKCONTROL Functions
LINKCONTROL STATUS prints configuration and link level statistics
information about the specified active link. LINKCONTROL TRACE manages
link level tracing for the specified link. Either LINKCONTROL STATUS or
LINKCONTROL TRACE may be specified, but not both.
The communication link must have been initiated before you can issue the
LINKCONTROL TRACE=ON command. LINKCONTROL TRACE=ON activates link level
tracing. The trace file is circular, independent of the wrap parameter,
so that its size determines the latest entries recorded.
The link trace activated by LINKCONTROL is similar to that activated
through RJLINE in that both can be formatted with NMDUMP. The linkcontrol
command can be used to deactivate link tracing enabled by either method.
Tracing for RJE/XL and the BSC link cannot be activated through NMMGR.
LINKCONTROL Command Examples
The following examples show different uses of the LINKCONTROL command and
its parameters. The following command returns all status on the link
named RJE28:
LINKCONTROL RJE28;STATUS=ALL
The following command does the same as the previous command, but the
default of STATUS=ALL is assumed:
LINKCONTROL RJE28
The following command resets the link named RJE28:
LINKCONTROL RJE28, RESET
The following command activates link level tracing and sets a buffer size
of 8 kilobytes:
LINKCONTROL RJE28;TRACE=ON, 8
The following command turns tracing off:
LINKCONTROL RJE28;TRACE=OFF