REMOTE


REMOTE/REMOTE HELLO

     Switches control to the Command Interpreter of the remote system,
once an environment has been established on a remote node. (CM)

SYNTAX {* REMOTE *}

REMOTE [envid] [command]
[envnum]

Allows commands to be executed in a remote environment.

SYNTAX {* REMOTE HELLO *}

[ {envid} ]
REMOTE [envinfo]logon [;DSLINE={[envid=]nodename}]
[ {envnum} ]

[envid ]
envinfo may be = [[envid=]nodename]
[envnum ]

Creates a session on a remote node.



PARAMETERS {* REMOTE *}

envid The environment id represents an established session on
the remote node. This environment id may be an actual node
name. The default environment is the one most recently
referenced in a DSLINE or REMOTE command.

envnum The number of the environment assigned when the environment
was defined. This environment number is listed in the
message returned after a DSLINE command.

command A command which is to be executed in the remote environment;
for example an MPE command to be executed on a remote HP 3000.

PARAMETERS {* REMOTE HELLO *}

envid An environment id, a character string that represents a
specific session on a remote node. The environment name it-
self may be qualified envname[.domain[.organization]].
Each portion of the string may have a maximum of 16
alphanumeric characters, beginning with a letter. The
characters "-" and "_" are also allowed. The default
DOMAIN and ORGANIZATION names are those specified for
your local node when it was configured as part of the NS network.

If the ENVID is not equated with a node name, it must refer
to a predefined environment. If it is equated to a node
name, it then represents a session on that node. If the
NODENAME is used by itself, it then is its own environment
id, representing a particular session on that node.
If ENVID, NODENAME, and ENVNUM are all omitted in the
beginning of the command line (before HELLO), the
environment information must be given in the DSLINE=
option of the command line or the default environment will
be assumed. The default environment for a REMOTE command
is the one most recently referenced in a DSLINE or REMOTE command.

nodename If the communications link to the remote system is an NS
link, nodename is the name assigned to the remote node
when it was configured into the NS network. This name may
optionally be qualified in the form NODE[.DOMAIN[.ORGANIZATION]].
 The default DOMAIN and ORGANIZATION are those of the local node.
 Each portion of this string may have a maximum of 16 alphanumeric
 characters, of which the first must be alphabetic.
 The characters "-" and "_" are also allowed.
 An environment id may be equated with this node name, or the
 node name (if used alone) may become its own environment id.
 In either case the environment id then represents a specific
 remote session on this node.
DEFAULT The environment specified by the last DSLINE or REMOTE command.

envnum The number of the environment assigned when the environment
was defined. This is the environment number that is
displayed after a DSLINE command is issued.

logon A valid logon sequence for the remote node, in the form
 HELLO ACCOUNT.USER[,GROUP].

DSLINE= Defines an environment if one is not specified immediately
after REMOTE. The parameters are used in the same way as
they are after REMOTE (or as they are used in a DSLINE command).



OPERATION {* REMOTE *}

REMOTE allows you to issue commands in a remote environment once
that environment is established on the remote node. The local
terminal appears to be directly connected to the remote machine.

The REMOTE command enables you to specify one of several remote
environments. If your local system is connected to a remote node
by means of an NS link, you can have several remote sessions on
that node at the same time; each session must have a unique
environment id.

REMOTE commands without <envid> or <envnum> assume the default
environment, the one most recently referenced.

For sessions accessed over NS links, you can configure your own
remote prompt (1-8 characters) by using the DSLINE ;PROMPT=
option. In order to receive the normal prompt for the remote
system (""), you must specify PROMPT= without a prompt string in
the DSLINE command. Otherwise, the default prompt will be the
ENVID#, where ENVID is the first seven characters of the environment id.

OPERATION {* REMOTE HELLO *}

The REMOTE HELLO command creates a session on a remote node. If
the remote environment (session) is not already defined by a
previous DSLINE (or REMOTE) command, you can specify environment
information in the following ways

o include environment information in the "DSLINE=" portion of the
remote command.

o include environment information immediately after REMOTE on the
same command line.

The default environment is the one most recently referenced by a
REMOTE or DSLINE command.

If a REMOTE HELLO is issued for an environment on which
you have already established a session, the existing
session is terminated and a new one is created (according
to the new user information).



EXAMPLE(S){REMOTE}

REMOTE LISTF {default environment}

REMOTE {default environment}
ENV1# LISTF {executed in the remote environment}
{remote prompt is "env1#"}

DSLINE SHAKESPEARE;PROMPT=SHAKE> {user-defined prompt}
REMOTE {default environment on node SHAKESPEARE}
SHAKE>HELLO MGR.NSUSER

EXAMPLE(S) {REMOTE HELLO}

DSLINE ULYSSES
REMOTE HELLO JAMES.JOYCE

or

REMOTE FINNEGANSWAKE HELLO JAMES.JOYCE
REMOTE {default environment}