REMOTE HELLO Command [ Using NS3000/XL Network Services ] MPE/iX 5.0 Documentation
Using NS3000/XL Network Services
REMOTE HELLO Command
Creates a session on a remote node.
Syntax
__________________________________________________________________________________
| |
| [:envID ] [ {envID }]|
| REMOTE [:[envID=]nodename ]logon [;DSLINE={[envID=]nodename }]|
| [envnum ] [ {#Lenvnum }] |
__________________________________________________________________________________
Use
Parameters
envID
An environment ID--that is, a character string representing a specific
session on a remote node. The environment name itself may optionally be
qualified: envname[.domain[.organization]].| Each portion of the string
may have a maximum of 16 alphanumeric characters (including underscores
and hyphens), of which the first must be alphabetic. The default domain
and organization names are those specified for your local node when it
was configured as part of its NS3000/XL network.
If the envID is not equated with a node name, it must refer to a
previously defined 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 becomes 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 at the end 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
The nodename is the name assigned to the remote node when it is
configured into the NS3000/XL 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 (including
underscores and hyphens), of which the first must be alphabetic.
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 listed in the message that appears after a
DSLINE command. Note that when envnum is specified immediately after
REMOTE, envnum is specified without the #L prefix.
logon
A valid logon sequence for the remote node, in the form HELLO
user.account[,group]. For information on additional MPE logon parameters
and options, please see the MPE XL Commands Reference Manual.
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).
Description
The REMOTE HELLO command creates a session on a remote node. If the
remote environment (session) has already been defined in a previous
DSLINE (or REMOTE) command, the environment ID or number may be used by
itself to designate the environment. Otherwise, an environment ID may be
equated to an actual node name or the node name may be used by itself as
its own environment ID. The environment information may be given
immediately after the REMOTE or after DSLINE=. If the environment
information is given in both places, the specification following REMOTE
takes precedence. If no environment information appears in either place,
the default environment assumed is the one most recently referenced by a
REMOTE or DSLINE command. If you issue a REMOTE HELLO command for an
environment that you are already logged on to, the existing remote
session will be terminated and a new one will be created (according to
the new user information). This is similar to what happens when you
issue a new HELLO command within a local session. If you want a second
concurrent session on the same node, you can designate a new environment
ID for this node, either in a DSLINE command or in a REMOTE HELLO
command.
NOTE Before you can create a remote session on another node in an
NS3000/XL network, your system operator must have issued the
following two console commands: NETCONTROL to open the
communications links to the remote node, and NSCONTROL to enable
Virtual Terminal service. These commands must be issued before any
network service can function between the local and remote nodes.
See the NS3000/XL Operations and Maintenance Reference Manual.
Examples of REMOTE HELLO
The following examples show you the different ways that you can use the
REMOTE HELLO command. The input is typed at the MPE XL prompt, and user
input is underlined for clarity.
1. Method 1 shows that the REMOTE HELLO command (without environment
information) may appear after a DSLINE command that provides the
environment information.
Method 1
:DSLINE EINSTEIN
ENVIRONMENT 1: EINSTEIN.DCL.IND
:REMOTE HELLO NSUSER.NSACCT
HP3000 / MPE XL A.01.00 FRI, MAY 1, 1987, 4:13 PM
**default environment**
2. Method 2 shows that the environment information may be included in
the DSLINE= portion of the REMOTE HELLO command.
Method 2
:REMOTE HELLO NSUSER.NSACCT;DSLINE=E2=EINSTEIN
HP3000 / MPE XL A.01.00 FRI, MAY 1, 1987, 4:14 PM
ENVIRONMENT 2: E2.DCL.IND=EINSTEIN.DCL.IND
3. Method 3 shows that the environment information may appear
immediately after REMOTE on the same command line.
Method 3
:REMOTE:CHEKHOV
CHEKHOV#HELLO ANTON.PLAYS
HP3000 / MPE XL A.01.00 FRI, MAY 1, 1987, 4:26 PM
or
:REMOTE:CHEKHOV HELLO ANTON.PLAYS
HP3000 / MPE XL A.01.00 FRI, MAY 1, 1987, 4:26 PM
ENVIRONMENT 3: CHEKHOV.DCL.IND
:REMOTE
**allows use of environment**
4. The REMOTE HELLO command may be issued in two parts, with the
HELLO portion following the remote prompt which is returned. The
environment specification may appear in a previous DSLINE command,
as in method 1, or immediately after the REMOTE, as in method 3.
The DSLINE= option is not legal in this case, since the DSLINE=
parameter must follow the HELLO in the REMOTE command line.
5. Methods 4a and 4b show two different ways of accessing the same
node. The DSLINE CURIE command sets the attributes of node CURIE
for both Method 4a and Method 4b. The PROMPT=>>> part of the
command shows the effect of setting the prompt on the remote node.
Method 4a shows that the REMOTE and HELLO commands can be on
separate lines. Method 4b shows that the environment ID is set
equal to the node name in order to create a new session. A fifth
environment is created. Upon returning to the local system, a
status line displays the environment information.
Methods 4a and 4b
:DSLINE CURIE;PROMPT=>>
ENVIRONMENT 4: CURIE.DCL.IND
**DSLINE for Methods 4a and 4b**
Method 4a
:REMOTE
>>HELLO NSUSER.NSACCT
HP3000 / MPE XL A.01.00 FRI, MAY 1, 1987, 4:51 PM
**default environment**
or
Method 4b
:REMOTE:MARIE=CURIE
**creates a new session**
MARIE#HELLO NEWUSER.NEWACCT
HP3000 / MPE XL G.OO.OO FRI, MAY 1, 1987, 4:54 PM
MARIE#:
ENVIRONMENT 5: MARIE.DCL.IND=CURIE.DCL.IND
MPE/iX 5.0 Documentation