NET/MASTER Management Services (MS) Command Reference Manual

LBANNER
ROUTE
NonStop NET/MASTER MS Commands
2–306 115412 Tandem Computers Incorporated
ROUTE The ROUTE command sends a command string to a remote NonStop NET/MASTER
MS or SOLVE management services system for execution. The command sends a
command string using Remote Operator Control (ROC). This NonStop
NET/MASTER MS service allows users to log on from a local NonStop NET/MASTER
MS system to a remote NonStop NET/MASTER MS or SOLVE management services
system, remotely execute commands, and receive the results at the local NonStop
NET/MASTER MS system.
To send a command string, your user ID definition record at your local system must
authorize you to log on to remote systems in general, and you must have a user ID
definition record at the remote system to which you want to send the command string
that specifically authorizes you to log on. These authorities are defined in your user
ID definition record on your local system as “Logon to remote system” and in your
user ID definition record on a remote system as “Logon from remote system.” When
you log on to a remote system, the authority and privileges assigned to you are taken
from your user ID definition record at the remote system.
ROUTE link-name command-string
link-name
specifies the link name of the remote system to which the command string is to be
sent. The link name is defined in the LINK DEFINE command. The link name can
be from 1 through 12 characters long and can include any displayable characters.
Alphabetic characters are not case-sensitive.
command-string
specifies the command string to send to the remote system. You can send more
than one command in the command string if you concatenate them using two
semicolons (;;).
Considerations
The default authority level of this command is 0.
You can enter this command from any NCL procedure, including the INIT NCL
procedure, by using either the CMD core statement or the INTCMD verb.
If you issue a ROUTE command to a remote NonStop NET/MASTER MS or
SOLVE management services system before issuing a SIGNON link-name
command, the ROUTE command issues an implicit SIGNON link-name command.
This logs you on automatically if the link is active. If the link is not active when
the ROUTE command is entered, the ROUTE command is rejected; it is not
queued. When implicitly logging on to a remote system, your user ID and
password at both systems must be identical. You can use the SIGNON link-name
command to explicitly log on to a remote system.