DSLINE Command [ Using NS3000/XL Network Services ] MPE/iX 5.0 Documentation
Using NS3000/XL Network Services
DSLINE Command
Defines the attributes of a remote environment.
Syntax
_________________________________________________________________________
| |
| [envID ] |
| DSLINE [ [envID=]nodename][;SERVICES][;DSLINEoption]...|
| [#Lenvnum ] |
_________________________________________________________________________
Use
Click here to view figure.
Parameters
envID
An environment ID--that is, a character string representing a specific
session on a remote node. The environment ID itself may optionally be
qualified as follows:
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 is
configured.
For some dslineoptions, an envID can be a generic environment ID
representing a set of environments. A generic environment ID can include
the MPE wild card characters@, #, and ?. @ stands for zero or more
alphanumeric characters, # for one numeric character, and ? for one
alphanumeric character. The attributes specified for a generic
environment ID will be used as defaults for all matching environments,
including environments defined later from the same local session, unless
overridden in a later DSLINE command. These defaults can be reset by the
RESET option, which is described below.
Default: the specified nodename (which then becomes an environment ID)
or, if nodename is omitted as well, the environment specified by the last
DSLINE or REMOTE command.
nodename
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
An environment number representing a specific session on a remote node.
This is the number of the environment in the message printed out
following a prior DSLINE command.
SERVICES
Lists the status of the services on the node (local or remote) indicated
by the environment ID.
DSLINEoption
One of the options described in the following paragraphs.
QUIET
Specifies that no logon message be displayed when you log on to the
remote environment, no logoff message be displayed when you log off, and
no environment messages be displayed when a DSLINE command is executed.
COMP or NOCOMP (default is NOCOMP)
Enables or disables data compression to the remote environment. The
compression only affects NFT and RFA transmissions. If data compression
is in effect, sequences of repeated characters (such as blanks) are
translated into more compact form before transfer. They are decompressed
after arrival at their destination. For a discussion of RFA compression,
refer to "RFA Compression" in chapter 3. This option may also be used
with the DSCOPY command as explained in Chapter 5.
CLOSE
Deletes the environment ID(s) associated with the remote environment(s).
This option must be used without any other option .
RESET
Clears all information associated with a generic environment ID. This
option must be used without any other option.
SHOW
Requests that the attributes of a remote environment (individual or
generic) be displayed.
PROMPT=promptstring
Specifies a prompt for the remote environment. This can be used to
distinguish one remote environment from another. The prompt string can
be 1 to 8 characters long, optionally surrounded by quotation marks. All
characters are allowed, but if the string contains a semicolon the string
must be in quotes: for example, "MY;NODE ". You can also use quotation
marks to include a blank at the end of a prompt string. Default: the
first seven letters of the (unqualified) environment name (or the whole
environment name if shorter) terminated by #. If PROMPT= is specified
without a prompt string, the prompt becomes the normal local prompt from
the remote operating system for instance, a colon (:).
If the remote system is an MPE XL based system, then you can also specify
its prompt by using the SETVAR HPPROMPT command as explained in the MPE
XL Commands Reference Manual. If you specify that the prompt be anything
other than a colon, then that specification will override any prompt
created by the DSLINE option described here. The SETVAR HPPROMPT will be
temporarily overridden if you leave the remote session and then return to
it--after a REMOTE command, the prompt will remind you which system you
are on--after you type a carriage return, the prompt will return to the
one you set with SETVAR HPPROMPT. For an example, refer to the discussion
under the REMOTE command.
LOGON=logonsequence
Specifies a logon sequence for the remote system, which can be used by
NFT and RPM in order to create a temporary session on the remote node.
(See the NFT and RPM chapters of this manual for a discussion of when
this logon will take effect.) The logon sequence must include all
necessary passwords. It must be delimited by quotation marks if it
contains characters which might cause it to be parsed incorrectly by the
remote system.
TRACE= traceoptions
Enables or disables tracing to the remote environment. You can trace the
messages sent by any network service (VT, NFT, etc.) between your local
session and the remote environment.
The trace records the actual message traffic for each intrinsic call or
interactive request, including both network service headers and
user-supplied data. You can also trace Transport Layer protocol activity
supporting this Network Service traffic.
Other levels of tracing are available through Network InterProcess
Communication and Node Management Services. The specific traceoptions
parameters are:
{[ [ON][,service][,file][,recs][,maxdata],TRANS]}
{[ [OFF][,service] ]}
The service parameter can be: VT, RFA, DRDBA, NFT, RPM, or ALL. Through
these choices, you can activate or deactivate tracing for one or all
Network Services. The other parameters have the following meanings:
* file: The name of a new or existing MPE XL file in which the trace
is to be stored. If this parameter is omitted, the trace information
is sent to a default file named TRxxxxxx, where TR is followed by the
six leading characters of the remote environment ID.
* recs: The number of records allotted to a new trace file. Default:
1024.
* maxdata: The maximum amount of data to be traced on an individual
send or receive request, a value from 0 to 8000 bytes. Default:
2000 bytes.
* TRANS : Requests tracing of Transport Layer protocol activity,
specifically headers and port messages.
For further information on tracing, see the NS3000/XL Operations and
Maintenance Reference Manual.
NOTE The following dslineoptions are obsolete and are ignored in all
cases (if used, a warning message is printed): EXCLUSIVE,
FROMADDR=, FROMADR=, LINEBUF=, LOCID=, NOQUEUE, OPEN, PHNUM=,
QUEUE, REMID, SELECT=, TOADDR=, and TOADR=.
Description
The DSLINE command defines the attributes of a remote environment. These
attributes are used when you log on to the remote node via a REMOTE HELLO
command or when NFT or RPM creates a temporary remote session with the
logon sequence specified in the DSLINE LOGON option. In order to
establish a remote environment, you must either equate an environment ID
with the actual node name, or else use the node name by itself, in which
case the node name becomes the environment ID. The environment ID then
represents a specific session on the remote node. You can use different
environment IDs to represent different sessions on the same node.
Subsequent DSLINE commands can use an individual or generic environment
ID or an environment number to identify the remote environment(s). If
you omit the nodename, envID, and envnum, the default is the last
environment referenced by a DSLINE or REMOTE command. (If this command
uses a generic environment ID, the new default environment becomes the
last individual environment listed in the environment message then
displayed. See the examples that follow.)
After a DSLINE command has been executed, a message is printed that
identifies all the affected environments. This message includes, for
each environment, the environment number assigned (in order of
environments defined), the fully qualified environment ID, and the fully
qualified node name (if different from the environment ID). If the
command specifies attributes for a generic environment ID, the generic
environment ID is listed separately in the returned message, identified
by the words GENERIC ENVIRONMENT. (Generic environments are given a
separate number in the sequence of environments, but this number is not
listed.) If the command uses a generic environment ID but does not
specify attributes, a separate generic environment is not listed. The
reason for this is that no new environment (with new default attributes)
is being defined.
Examples
In the following examples, the input is typed at the MPE XL prompt, and
user input is underlined for clarity.
DSLINE ATHENA
ENVIRONMENT 1: ATHENA.DCL.IND
**default domain (DCL) and organization (IND)**
DSLINE A2=ATHENA;PROMPT=A2
ENVIRONMENT 2: A2.DCL.IND=ATHENA.DCL.IND
**2nd environment referencing same node**
DSLINE APOLLO;TRACE=ON,ALL
ENVIRONMENT 3:APOLLO.DCL.IND
**traces all NS activity to remote environment**
DSLINE A@;LOGON=MGR.NSUSER
ENVIRONMENT 1: ATHENA.DCL.IND
ENVIRONMENT 2: A2.DCL.IND=ATHENA.DCL.IND
GENERIC ENVIRONMENT: A @.DCL.IND
**sets logon for multiple environments**
DSLINE A2;SHOW
**environment information**
ENVIRONMENT # : 2
ENVIRONMENT ID : A2.DCL.IND
NODE NAME : ATHENA.DCL.IND
LOGON : MGR.NSUSER
LOGGED ON : NO
PROMPT : A2
ESTABLISHED BY : DSLINE
SERVICES :
OPTIONS :
DSLINE ACCTNG; SERVICES
**returns a list of services from node ACCTNG**
SERVICE TYPE STARTED SERVER DESCRIPTION
RPM REMOTE YES DSSERVER INCOMING RPM
RPML LOCAL YES DSSERVER OUTGOING RPM
RFA REMOTE YES DSSERVER INCOMING RFA
RFA LLOCAL YES DSSERVER OUTGOING RFA
DSLINE @
**lists all environments within default domain and organization**
ENVIRONMENT 1: ATHENA.DCL.IND
ENVIRONMENT 2: A2.DCL.IND=ATHENA.DCL.IND
ENVIRONMENT 3: APOLLO.DCL.IND
GENERIC ENVIRONMENT A@.DCL.IND
**last environment becomes default**
DSLINE **returns default environment**
ENVIRONMENT 3: APOLLO.DCL.IND
DSLINE @;CLOSE
**deletes environment IDs and numbers**
ENVIRONMENT 1: ATHENA.DCL.IND
ENVIRONMENT 2: A2.DCL.IND=ATHENA.DCL.IND
ENVIRONMENT 3: APOLLO.DCL.IND
DSLINE @
NO ENVIRONMENTS
GENERIC ENVIRONMENT A@.DCL.IND
DSLINE A@;RESET
**resets defaults for generic environment ID**
MPE/iX 5.0 Documentation
HP 3000 Manuals