NSCONTROL



NSCONTROL

     Controls the Network Service subsystem.  (CM)

SYNTAX


NSCONTROL function[;function]...

function may be

START[=service[,service]...]

STOP[=service[,service]...]

ABORT

AUTOLOGON[={ON }[,ALL] ]
{OFF}[,service[,service]...]

LOADKEYS

{ALL }
{ON } {RPM } {,LOW }
LOG={OFF}[,{ENV }[{,HIGH}]]
{DSDAD }
{DSSERVER}
{VTSERVER}

SERVER={servername}[,minservers][,maxservers]
{ALL }

STATUS[=USERS|SERVICES|SERVERS|SUMMARY|ALL[,...]]

VERSION[=MOD]

PARAMETERS


START[=service[,service]...]...

Starts Network Services that are installed on your system.
By default, all installed services are started. Optionally
you may specify one or more specific services to be started.
Possible specific services include:

LOOPBACK Enables remote users to run loopback diagnostic
programs that connect to the local node.

The following services are available if you have the
NS/3000 product installed:

NFT Enables remote users to transfer files to or from the
local node using the DSCOPY command and intrinsic.

NFTL Enables local users to transfer files to or from
remote nodes using the DSCOPY command and intrinsic.

NSSTAT Enables remote users to use the NSSTATUS intrinsic
and DSLINE;SERVICES command to retrieve NS information
from the local node.

NSSTATL Enables local users to use the NSSTATUS intrinsic
and DSLINE;SERVICES command to retrieve NS information
from the local and remote nodes.

PTOP Enables remote users to create and communicate with
PTOP slave processes on the local node. The VT
service must also be started. PTOP can be used only
by HPDESK.

PTOPL Enables local users to create and communicate with
PTOP slave processes on remote nodes. The VTL service
must also be started. PTOPL can be used only by HPDESK.

RFA Enables remote users to access files and data bases
on the local node.

RFAL Enables local users to access files and data bases on
remote nodes.

RPM Enables remote users to create and kill processes on
the local node using the Remote Process Management
(RPM) service.

RPML Enables local users to create and kill processes on
the local and remote nodes using the Remote Process
Management (RPM) service.

VT Enables remote users to logon to the local node
using HP's TCP message mode.

VTA Enables remote users to logon to the local node
using TCP stream mode.

VTL Enables local users to log onto remote nodes using
the REMOTE HELLO command.

VTR Enables remote users to access local terminals
using the Virtual Terminal service.

VTRL Enables local users to access terminals on remote
nodes using the Virtual Terminal service.

There may be additional services that can be enabled if
other network products, such as Personal Productivity
Center, are installed. Refer to that network product's
documentation to obtain the appropriate service names.

STOP[=service[,service]...]...

Stops Network Services, although existing users of the
service(s) can continue until they terminate their use.
By default, all installed services are stopped. Optionally
you may specify one or more specific services to be
stopped. Possible services include any of the same service
names that you are allowed to specify for the START
parameter described above.

ABORT Immediately terminates all the servers and services.

AUTOLOGON[={ON }[,ALL] ]
{OFF}[,service[,service]...]

Enables or disables the autologon feature of the NFT,
RFA and/or RPM services. Default: ON,ALL.

LOADKEYS Loads the Network Service command keywords while NS/3000
is active.

{ALL }
{ON } {RPM } {,LOW }
LOG={OFF}[,{ENV }[{,HIGH}]]
{DSDAD }
{DSSERVER}
{VTSERVER}

ON Enables detailed event logging of the specified module.

OFF Disables detailed event logging of the specified module.

For each Network Service software module, two levels of
event logging are provided. These are HIGH, which logs
all events, and LOW, the default, which logs a subset of
the events, as specified below.

ALL LOW Logs LOW events for all modules.
HIGH Logs HIGH events for all modules.

RPM LOW Logs RPMCREATE and RPMKILL requests.
HIGH Same as LOW.

ENV LOW Logs environment information from DSLINE and
REMOTE HELLO commands.
HIGH Same as LOW, plus environment table locking and
use counts.

DSDAD LOW Logs creation and deletion of sockets, ports,
and server processes.
HIGH Same as LOW, plus all received service requests
and internal messages between DSDAD and server
processes.

DSSERVER LOW Logs internal initialization messages
between DSDAD and DSSERVER processes.
HIGH Same as LOW, plus all received messages from
other processes.

VTSERVER LOW Logs internal initialization messages
between DSDAD and VTSERVER processes.
HIGH Same as LOW, plus all received messages from
other processes.

SERVER={servername}[,minservers][,maxservers]
{ALL }

Dynamically alters the minimum or maximum number of
servers. By default applies to all servers. Optionally
you may specify one or more specific servernames.
Possible servernames and their default minserver and maxserver
values are:

LOOPBACK For the Loopback Service. Default minserver,maxserver
values are 0,300.

NSSTATUS For the NSSTAT service (NSSTATUS intrinsic and
DSLINE; SERVICES command). Default minserver,
maxserver values are 0,300.

VTSERVER For VT and Reverse VT. Default minserver,maxserver
values are 0,300.

The following servers are available if you have the
NS/3000 product installed:

NFT For NFT (DSCOPY). Default minserver,maxserver
values are 0,300.

DSSERVER For RFA, RDBA, PTOP and RPM. Default minserver,
maxserver values are 0,300.

There may be additional servers to control if
other network products, such as Personal Productivity
Center, are installed. Refer to that network product's
documentation to obtain the appropriate server names.

minservers The minimum number of servers which must
be available at all times. Available servers which
are not in active use are kept in reserve until a
service request is received. If necessary,
additional servers are created immediately to fit
the new minimum specified. Valid range: 0..1250;
however, see note below. Default for all current
servers is 0.

maxservers The maximum number of servers of this type
allowed to be active at one time. If necessary,
reserved servers are terminated to
fit the new maximum. Valid range: 0..32767;
however, see note below. Default varies by server.

NOTE: The total number of all active servers may not
exceed 1250. The sum of all minservers must always be
1250 or less. You may specify a number greater than
1250 as one or more maxservers values, but there will
never be more than a total of 1250 servers of all kinds
at any one time.

STATUS[=USERS|SERVICES|SERVERS|SUMMARY|ALL[,...]]

Displays current status information about NS3000/XL
Services. The STATUS parameter can be unqualified,
or can be keyword equated to one or more of the
following values:

USERS Display the jobs and sessions on this node
that are using Network Services.

SERVICES Display information about the services.

SERVERS Display information about the servers.

SUMMARY Display a summary of information about
services, servers, and users.

ALL Same as specifying SERVICES, SERVERS and
USERS. (DEFAULT)

VERSION[=MOD]

Displays the overall version of the NS/3000 software.
If qualified with the MOD keyword, also displays the
version of each of the Network Services software modules.

OPERATION


NSCONTROL START

   Starts the Network Services subsystem.

NSCONTROL STOP

   Stops the Network Services subsystem.  STOP executes a "graceful"
shutdown of Network Services. Existing users may continue using
the Network Services until they complete their NS activity, but
new users are prevented from using the services. When all users
have finished using the NS subsystem, the subsystem will stop entirely.

NSCONTROL ABORT

   Immediately terminates all the servers and services of the
Network Services. Note that STOP is the normal way to shutdown
Network Services. The ABORT function should only be used in
abnormal situations.

NSCONTROL AUTOLOGON

   Enables or disables the autologon feature of the NFT, RFA
and RPM services. When disabled, remote users are required
to establish a regular session via VT and REMOTE HELLO before
they can use NFT, RFA or RPM on this system. This is useful if
you wish to force all remote users to execute a logon
security UDC before they access anything on this system.
When NS is first started, this feature is ENABLED.

NSCONTROL LOADKEYS

   Loads the Network Services command keywords from the
ASCAT.NET.SYS catalog. You need to use this command only
if the catalog is modified, such as for localization.

NSCONTROL LOG

   Enables or disables detailed event logging for the Network Service.

NSCONTROL SERVER

   Alters the characteristics of the Network Service processes.

NSCONTROL STATUS

   Displays information about the Network Services.

NSCONTROL VERSION

   Displays the overall version of the Network Services subsystem,
and optionally the version of each of its modules.

EXAMPLE(S)

Start the transport subsystem on the "LAN1" and "WIDE" networks, then
start all of the NS network services:

  NETCONTROL START;NET=LAN1
  NETCONTROL START;NET=WIDE
  NSCONTROL START

Stop all Network Services, while letting existing users continue
their work:

  NSCONTROL STOP

Stop the VT and Reverse VT services only.  Let all other started
services remain available:

  NSCONTROL STOP=VT,VTR

Enable logging of information from DSLINE and REMOTE HELLO
commands, and service requests received by the DSDAD process:

  NSCONTROL LOG=ON,ENV,LOW;LOG=ON,DSDAD,HIGH

Set the minimum number of running DSSERVER processes to 2 and
the maximum to 10:

  NSCONTROL SERVER=DSSERVER,2,10

Show the status of Network Services:

  NSCONTROL STATUS=SERVICES

  SERVICE   TYPE    SERVER    DESCRIPTION

  RPM       REMOTE  DSSERVER  INCOMING REMOTE PROCESS MANAGEMENT
  VTL       LOCAL   VTSERVER  OUTGOING VIRTUAL TERMINAL
  VT        REMOTE  VTSERVER  INCOMING VIRTUAL TERMINAL
   .
   .
   .

Display the overall version and product number of the Network
Services subsystem:

  NSCONTROL VERSION

  Network Services overall subsystem version:   B.00.10
  NS3000/XL SERVICES:   36920B