HPlogo NS 3000/iX Operations and Maintenance Reference Manual > Chapter 7 Commands

NETCONTROL

MPE documents

Complete PDF
Table of Contents
Index

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 "The NETCONTROL Entities".

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 "The NETCONTROL Entities".

Notice that the first seven entities are composed of groups of modules. For example, let us look at the third entity, labeled 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 "The NETCONTROL Entities", 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.

Figure 7-1 The NETCONTROL Entities

[The NETCONTROL Entities]

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 NS 3000/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 NS 3000/iX Services, enter

:NSCONTROL STOP

To stop all networks, tracing, and the entire transport, enter

:NETCONTROL STOP



LINKCONTROL

NETCONTROL ADDLINK