HP 3000 Manuals HP 3000 Manuals
NETCONTROL
Command used to initialize, terminate, and control the operation of the
network transport.
Syntax
{function}[;function]
NETCONTROL {entity }[;entity ]
Use
Available In Session? YES
In Job? YES
In Break? NO
Programmatically? YES
Breakable? NO
Capabilities? NM
Parameters
function Only one of each type of function is recommended on
a command line. Refer to function descriptions on
the following pages. The functions are:
ADDLINK TRACEOFF
DELLINK TRACEON
START UPDATE
STATUS VERSION
STOP
Only one of each type of function (START, TRACE,
etc.) is recommended on a command line. For
example, the command:
:NETCONTROL TRACEON=HDM;START;TRACEON=HD;NET=LAN1
is not recommended because TRACEON appears twice
and also appears with START.
entity One or more of the entities defined for NETCONTROL.
The keywords for these entities are shown in figure
7-1.
NET Specifies a group entity that consists of a network
interface which is not a gateway half, and all the
protocol modules that are configured for that
network interface. Not all functions may be
applied as a group; see the individual command
functions for details.
GATE Specifies a group entity that consists of a
configured gateway half network interface, and all
the protocol modules that are configured for that
network interface. Not all functions may be
applied as a group; see the individual command
functions for details. NOTE: this keyword cannot
be used to select true "gateways" as configured in
the INTERNET subtree under a network interface.
PROT Specifies a particular general protocol module or a
particular network interface protocol module upon
which a function will act.
NI Specifies a particular network interface upon which
a function will act. Usually used in conjunction
with the PROT= keyword to access a particular
network interface protocol. See the individual
command functions for details.
Discussion
The NETCONTROL command is composed of functions (START, STOP, STATUS,
etc.) to be executed against one or more entities shown in figure 7-1.
Notice that the first seven entities are composed of groups of modules.
For example, let us look at the third entity, labelled 3. This entity,
NET=niName where niName is the configured LAN niName, combines the
network interface (NI) configured for any LAN link and the protocols
configured for that NI, which can include IP, ARP, and Probe.
The remaining three entities, numbers 8-10 in figure 7-1, allow exact
specification of one and only one module of the network transport. This
is especially useful when troubleshooting. Refer to NETCONTROL STATUS
and NETCONTROL TRACE for more information.
For information on how the entities are affected by a particular
function, refer to the command page for that function.
Example
This example illustrates how each NETCONTROL command is used. See
individual commands for further details and examples.
To check the level of transport software installed, enter
:NETCONTROL VERSION
To start a transport having a LAN network named "LAN1" plus a loopback
network named "LOOP" and a router network named "ROUTER1", having links
"PSI40" and "PSI48" under it, enter
:NETCONTROL START; NET=LAN1
:NETCONTROL START; NET=ROUTER1
:NETCONTROL START; NET=LOOP
To then enable the NS3000/iX Services (DSCOPY, etc.), enter
:NSCONTROL START
To now take down the "PSI40" link on the "ROUTER1" network because
someone wants to use that link for RJE/iX access, (the other link "PSI48"
is still available to the router), enter
:NETCONTROL DELLINK=PSI40; NET=ROUTER1
To check if the PROBE protocol is running on the "LAN1" network, enter
:NETCONTROL STATUS=ALL; NI=LAN1; PROT=PROBE
To bring the PSI link "PSI40" back online after RJE/iX users have
finished with it, enter
:NETCONTROL ADDLINK=PSI40; NET=ROUTER1
To update the "ROUTER1" network with new node mappings added to the
NMCONFIG file without stopping that network, enter
:NETCONTROL UPDATE=MAPPING; NET=ROUTER1
To start TCP message and data tracing for all networks (since TCP is a
general protocol), enter
:NETCONTROL TRACEON=MHD; PROT=TCP
To stop the NS3000/iX Services, enter
:NSCONTROL STOP
To stop all networks, tracing, and the entire transport, enter
:NETCONTROL STOP
![[]](../../pic3k/M013751/FFN33c50.gif)
1 General Transport: Control Process (CP) and the general protocols
(TCP, PXP, UDP, IPU)
2 NET = niName (Loopback - includes NI and IP)
3 NET = niName (LAN - includes NI, IP, ARP, and PROBE)
4 NET = niName (Token Ring or FDDI - includes NI, IP, and ARP)
5 NET = niName (X.25 - includes NI, IP, and X.25)
6 NET = niName (point-to-point - includes NI, IP, and Dial)
7 GATE = gateName (Gateway Half - includes NI, IP, and Dial)
8 PROT = gprot (One of TCP, PXP, UDP, or IPU)
9 NI = niName (loopback, LAN, Token Ring, FDDI, gateway half, X.25, or
point-to-point)
10 NI = niName;PROT = niProt (IP only for loopback;IP, ARP, or PROBE for
LAN; IP or ARP for Token Ring or FDDI; IP or Dial for gateway half and
point-to-point; IP or X.25 for X.25)
Figure 7-1. The NETCONTROL Entities