DSLINE



DSLINE

     Defines the attributes of a remote environment with NS3000/XL.
     (CM)

SYNTAX

            [[]             ]
DSLINE [[][=]][;dslineoption]...
[[] ]

PARAMETERS

        The environment id is a character string that
represents a specific session on a remote node. The
environment name itself may optionally be qualified
[.[.]]. Each portion of
the string may have a maximum of 16 alphanumeric
characters, of which the first must be alphabetic.
The characters "-" and "_" are also allowed. The
default and names are those
specified for your local node when it was configured as
part of the NS network.

For ARPA domain names, the environment ID has syntax
label[.label[...]. The label must follow the syntax for
ARPANET host names. The invID for ARPA domain names
will not be fully qualified.

An can be a generic environment id representing
a set of environments. A generic environment id can
include the MPE/iX wildcard 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 are 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 either the specified (which then
becomes an environment id) or, if no is
specified, the environment specified by the last DSLINE
or REMOTE command.

If the communications link to the remote system is an NS
link, is the name assigned to the remote node
when it was configured into NS network. This name may
optionally be qualified in the form [. [.]]. The default and
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.

If a customer uses ARPA domain names, then the node name
syntax will be label[.label][...]. The label must follow
the syntax for ARPANET host names.

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.

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.

An option applicable to Network Service environments
only.

Any of the following options may be used.

QUIET Ensures that no logon message is displayed when you
log on to the remote environment, no logoff message is
displayed when you log off, no environment messages are
displayed when you log off, and no environment messages
are displayed when a DSLINE command is executed.

COMP Enables or disables data compression to the remote
or environment. The compression affects VT, RFA, NFT, and
NOCOMP PTOP transmissions if the link between nodes is a DS-
compatible link, or NFT only if the link is an NS link.
If data compression is in effect, sequences of repeated
characters (such as blanks) are translated into a more
compact form before transfer. They are decompressed
after arrival at their destination. The default is
NOCOMP.

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.

SERVICES Requests that the status of the services available on a
remote environment be displayed.

PROMPT= Specifies a prompt for the remote environment.
This can be used to distinguish one remote environment from
another. The prompt string can be 1-8 characters long,
optionally surrounded by quotation marks. All characters are
allowed, but if the string contains a semicolon or the ASCII
value representing a , 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, if
the environment name has fewer than seven letters, the whole
environment name terminated by #. If you specify PROMPT= without
a prompt string, the prompt becomes the normal local prompt from
the remote operating system.

The prompt specified with PROMPT= may be overridden by a prompt
specified with the SETVAR command (SETVAR HPPROMPT) on a remote
MPE/XL based system.

LOGON= Specifies a logon sequence for the remote system
which can be used by NFT, RFA, and RPM to create a temporary
session on the remote node. The logon sequence must include all
necessary passwords, and must be delimited by quotation marks if
it contains characters that might cause the system to incorrectly
interpret the logon string.

TRACE= 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 parameters are

{[ON][,][,file][,recs][,maxdata][,TRANS]}
{[OFF][,service]}

NOTE A comma MUST precede a parameter whenever (a) that
parameter is included or (b) that parameter is omitted and any
OTHER parameter which follows is included.

The parameter can be VT, RFA, RDBA, NFT,
RPM, PTOP, or ALL. This parameter enables you to
activate or deactivate tracing for one or all Network
Services. The other parameters have the following
meanings

The name of a new or existing MPE 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.

The number of records allotted to a new trace
file. DEFAULT 1024.

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 internal
messages.

OPERATION

     The DSLINE command defines the attributes of a remote environment.
     These attributes are used when you log on to the remote node by
     issuing a REMOTE HELLO command or when NFT, RFA, or RPM creates a
     temporary remote session with the logon sequence specified in the
     DSLINE logon option.  The connection is not established until you
     first use a network service (for example, when you issue a REMOTE
     HELLO).

     In order to establish a remote environment, you must equate an
     environment id with the actual node name or 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.  If you are connected to the remote node by an NS
     link, 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 node name, environment id,
     and environment number are all omitted, 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 below.)

     After a DSLINE command has been executed, a message is printed
     which identifies all the affected environment(s).  For each
     environment, this message identifies the assigned environment
     number (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, and 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 since no new environment (with new default attributes) is
     being defined.



EXAMPLE(S)

DSLINE SHAKESPEARE                            {default domain and   }
ENVIRONMENT 1 SHAKESPEARE.DCL.IND             {organization         }

DSLINE S2=SHAKESPEARE;PROMPT=S2>              {second session on    }
ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND  {same remote node     }

DSLINE HAMLET;TRACE=ON,ALL                    {traces NS activity   }
TRACE FILE FOR ALL SERVICES TO HAMLET.DCL.IND IS HAMLET.PUB.DSUSER
ENVIRONMENT 3 HAMLET.DCL.IND

DSLINE S@;LOGON=MGR.DSUSER                    {sets logon for       }
ENVIRONMENT 1 SHAKESPEARE.DCL.IND             {multiple environments}
ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND
GENERIC ENVIRONMENT S@.DCL.IND

DSLINE S2;SHOW                                {displays environment }
ENVIRONMENT #   2                             {information          }
ENVIRONMENT ID  S2.DCL.IND
NODE NAME       SHAKESPEARE.DCL.IND
LOGON           MGR.DSUSER
LOGGED ON       NO
PROMPT          S2>
ESTABLISHED BY  DSLINE

SERVICES


OPTIONS

DSLINE @                                     {lists all environments}
ENVIRONMENT 1 SHAKESPEARE.DCL.IND            {within default domain }
ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND {and organization      }
ENVIRONMENT 3 HAMLET.DCL.IND
GENERIC ENVIRONMENT S@.DCL.IND

DSLINE                                       {returns default       }
ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND {environment           }

DSLINE @;CLOSE                               {deletes environment   }
ENVIRONMENT 1 SHAKESPEARE.DCL.IND            {ids and numbers and   }
ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND {closes trace files    }
ENVIRONMENT 3 HAMLET.DCL.IND
TRACE FILE FOR ALL SERVICES TO HAMLET.DCL.IND IS TRHAMLET.PUB.DSUSER

DSLINE @

NO ENVIRONMENTS

GENERIC ENVIRONMENT S@.DCL.IND

DSLINE S@;RESET {resets defaults for }
GENERIC ENVIRONMENT S@.DCL.IND {generic environment id}