DSLINE

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


DSLINE


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

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}

Back to Main Index