NSCONTROL START
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index |
Syntax
NSCONTROL START[=service[,service]...]
Parameters
- START[=services]
Enables the Network Services (VT, Reverse VT, NFT, RFA, RDBA, RPM, LOOPBACK, and NSSTAT). The first START creates the Network Services control process, called DSDAD. The optional service list (services) allows you to select which of the services are enabled for local or remote use.
Default (if the service list is omitted): enables all services for both local and remote use.
The services which allow users on remote nodes to use resources on the local node are as follows:
- LOOPBACK
Allows remote users to use the loopback diagnostic server on the local node.
- NFT
Allows remote users to transfer files to or from the local node using the DSCOPY command and intrinsic.
- NSSTAT
Allows remote users to use the NSSTATUS intrinsic to retrieve network services information from the local node.
- RFA
Allows remote users to access files on the local node, using the RFA and RDBA services.
- RPM
Allows remote users to create and kill processes on the local node using the Remote Process Management service.
- VT
Allows remote users to logon to a session on the local node.
- VTR
Allows remote users to access local terminals using the Reverse VT service.
- VTA
Allows 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
Allows local users to transfer files to or from remote nodes using the DSCOPY command and intrinsics.
- NSSTATL
Allows local users to use the NSSTATUS intrinsic to retrieve network services information from the local and remote nodes.
- RFAL
Allows local users to open and access files and databases on remote nodes, using the RFA and RDBA services.
- RPML
Allows local users to create and kill processes on the local and remote nodes using the RPM service.
- VTL
Allows local users to log onto remote nodes using the REMOTE HELLO command.
- VTRL
Allows local users to access terminals on remote nodes using the Reverse VT service.
Discussion
If you issue an NSCONTROL START without specifying a service list, the default is to start all services. You use the service list if you wish to select which services to start, and whether local or remote users are allowed to use the services. To allow remote users to use VT, VTR, VTA, NFT, RFA/RDBA, NSSTAT, LOOPBACK, and RPM on your local node, you must START the appropriate remote services. Additionally, if you wish to allow local users to use VT, NFT, RFA/RDBA, RPM, and NSSTAT to remote nodes, you must START the appropriate local services. You must issue the NETCONTROL START command before the NSCONTROL START command. This is because the Network Services depend on the network transport subsystem. Refer to the NETCONTROL START command for more information.
Example 1
Example 1 shows the command sequence necessary to start the Network Services. Enter the NETCONTROL START command to initiate the network transport before the NSCONTROL START command, as shown in the example. Issuing the NSCONTROL START creates the DSDAD process and starts all the user services. To successfully initialize a node, the commands must be issued in the order specified. At least one of the required NETCONTROL START commands must be issued first, before the NSCONTROL START command.
:NETCONTROL START;NET=LAN1 :NSCONTROL START
Example 2
For security reasons, the node manager for this node has decided to restrict the Network Services to outgoing only. The command shown in example 2 enables users on the local node to use resources on remote nodes. The reverse is not true. Users on remote nodes are not allowed to logon or use any of the services on the local node. The status display shows all the local services enabled and all the remote services disabled.
:NSCONTROL START=VTL,VTRL,NFTL,RFAL,RPML VTL NETWORK SERVICE STARTED. VTRL NETWORK SERVICE STARTED. NFTL NETWORK SERVICE STARTED. RFAL NETWORK SERVICE STARTED. RPML NETWORK SERVICE STARTED. :NSCONTROL STATUS=SERVICES SERVICE TYPE STARTED SERVER DESCRIPTION VTA REMOTE NO VTSERVER INCOMING STREAM MODE VIRTUAL TERMINAL NSSTATL LOCAL NO NSSTATUS OUTGOING NSSTATUS SERVICE NSSTAT REMOTE NO NSSTATUS INCOMING NSSTATUS SERVICE LOOPBACK REMOTE NO LOOPBACK INCOMING LOOPBACK SERVICE RPML LOCAL YES DSSERVER OUTGOING REMOTE PROCESS MANAGEMENT RPM REMOTE NO DSSERVER INCOMING REMOTE PROCESS MANAGEMENT PTOPL LOCAL NO DSSERVER OUTGOING PROGRAM-TO-PROGRAM COMMUNICATION PTOP REMOTE NO DSSERVER INCOMING PROGRAM-TO-PROGRAM COMMUNICATION RFAL LOCAL YES DSSERVER OUTGOING REMOTE FILE ACCESS RFA REMOTE NO RASERVER INCOMING REMOTE FILE ACCESS NFTL LOCAL YES NFT OUTGOING NETWORK FILE TRANSFER NFT REMOTE NO NFT INCOMING NETWORK FILE TRANSFER VTRL LOCAL YES VTSERVER OUTGOING REVERSE VIRTUAL TERMINAL VTR REMOTE NO VTSERVER INCOMING REVERSE VIRTUAL TERMINAL VTL LOCAL YES VTSERVER OUTGOING VIRTUAL TERMINAL VT REMOTE NO VTSERVER INCOMING VIRTUAL TERMINAL
Example 3
The network transport must be initialized before you can issue the NSCONTROL START command. If not, the error messages shown in example 3 are displayed.
:NSCONTROL START TRANSPORT NOT INITIALIZED (DSERR 644) INVALID CONTROL OPTION (CIERR 5062)
|
NSCONTROL SERVER |
NSCONTROL STATUS |