NSCONTROL STOP [ NS3000/iX Operations & Maintenance Reference Manual ] MPE/iX 5.0 Documentation
NS3000/iX Operations & Maintenance Reference Manual
NSCONTROL STOP
Terminates Network Services subsystem.
Syntax
NSCONTROL STOP[=service[,service]...]
Parameters
STOP=services Terminates the Network Services subsystem. STOP
executes a "graceful" shutdown of Network Services.
Existing users of the service can continue until they
complete their NS activity, but new users are
prevented from using the services. The optional
service list (services) allows you to select which of
the services are disabled for local or remote use.
When all Network Services are stopped, the DSDAD
process will terminate.
Default (if the service list is omitted): terminates
all services for both local and remote use.
The services list is the same as for the START
function, except that the specified services are
stopped, not started.
Specifying the following services prevents users on
remote nodes from using resources on the local node:
LOOPBACK Prevents remote users from using
the loopback diagnostic server on
the local node.
NFT Prevents remote users from
transferring files to or from the
local node using the DSCOPY
command and intrinsic.
NSSTAT Prevents remote users from using
the NSSTATUS intrinsic to
retrieve network services
information from the local node.
RFA Prevents remote users from
accessing files on the local
node.
RPM Prevents remote users from
creating and killing processes on
the local node using the Remote
Process Management service.
VT Prevents remote users from
logging onto the local node using
the REMOTE HELLO command.
VTR Prevents remote users from
accessing local terminals using
the Reverse VT service.
VTA Prevents remote users who are
running the Virtual Terminal
service over TCP implementations
which only support the ARPA
standard stream mode flow control
mechanisms to log onto the local
node.
Specifying the following services prevents users on
the local node from using resources on remote nodes:
NFTL Prevents local users from
transferring files to or from
remote nodes using the DSCOPY
command and intrinsics.
NSSTATL Prevents local users from using
the NSSTATUS intrinsic to
retrieve network services
information from the local and
remote nodes.
RFAL Prevents local users from opening
and accessing files and databases
on remote nodes using the RFA and
RDBA services.
RPML Prevents local users from
creating and killing processes on
the local and remote nodes using
the RPM service.
VTL Prevents local users from logging
onto remote nodes using the
REMOTE HELLO command.
VTRL Prevents local users from
accessing terminals on remote
nodes using the Reverse VT
service.
Discussion
NSCONTROL STOP is the normal way to shut down the Network Services. It
allows existing users to continue using the services until they finish
their tasks, but prevents any new users from using the services. The
ABORT function, on the other hand, immediately terminates all the
services and all the server processes. Anyone using a service will find
their task (DSCOPY, for example) immediately terminated. See the
discussion of NSCONTROL ABORT.
Example 1
Example 1 shows NSCONTROL STOP without the service list. All Network
Services are stopped. Any active servers are allowed to continue until
finished with the current task, at which point they are terminated. No
new service requests are accepted. When all the servers and services are
stopped, the DSDAD process terminates. In the example, an NSCONTROL
ABORT command is issued after the NSCONTROL STOP command to make sure all
Network Services activity is stopped.
:NSCONTROL STOP {users and servers allowed to finish}
:NSCONTROL ABORT {terminates all network services activity}
:NETCONTROL STOP {terminates all network transport activity}
Example 2
The NSCONTROL STOP=VT,VTA,VTR command shown in the example below stops
the VT, VTA, and Reverse VT services. This prevents remote users from
logging on to the local node using REMOTE HELLO and from opening local
terminals using Reverse VT. If there are any other active Network
Services, they remain available.
:NSCONTROL STOP=VT,VTA,VTR
MPE/iX 5.0 Documentation