NSCONTROL STOP
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index |
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.
- 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 change 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 following example 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
|
NSCONTROL STATUS |
NSCONTROL VERSION |