 















          VMS LAT Control Program (LATCP)
          Manual




          This document describes the LAT Control Program
          (LATCP).




          Revision/Update Information:  This manual supersedes
                                        the VMS LAT Control
                                        Program (LATCP) Manual,
                                        Version 5.0.

          SOFTWARE VERSION:             VMS Version 5.4-1











          digital equipment corporation
          maynard, massachusetts

 







          __________
          The information in this document is subject to change
          without notice and should not be construed as a
          commitment by Digital Equipment Corporation. Digital
          Equipment Corporation assumes no responsibility for
          any errors that may appear in this document.

          The software described in this document is furnished
          under a license and may be used or copied only in
          accordance with the terms of such license.

          No responsibility is assumed for the use or
          reliability of software on equipment that is not
          supplied by Digital Equipment Corporation or its
          affiliated companies.

          Restricted Rights: Use, duplication, or disclosure
          by the U.S. Government is subject to restrictions as
          set forth in subparagraph (c)(1)(ii)  of the Rights in
          Technical Data and Computer Software clause at DFARS
          252.227-7013.

          __________
           Digital Equipment Corporation February 1991.

          All Rights Reserved.
          Printed in U.S.A.

          __________
          The postpaid Reader's Comments forms at the end of
          this document request your critical evaluation to
          assist in preparing future documentation.

          The following are trademarks of Digital Equipment
          Corporation:

          CDA           DEQNA         MicroVAX      VAX RMS
          DDIF          Desktop-VMS   PrintServer   VAXserver
                                      40
          DEC           DIGITAL       Q-bus         VAXstation
          DECdtm        GIGI          ReGIS         VMS
          DECnet        HSC           ULTRIX        VT
          DECUS         LiveLink      UNIBUS        XUI
          DECwindows    LN03          VAX
          DECwriter     MASSBUS       VAXcluster    DIGITAL

          The following are third-party trademarks:

          PostScript is a registered trademark of Adobe Systems,
          Inc.
                                                          ZK-4546

 





          __________________________________________________________________

          Production Note

          This book was produced with the VAX DOCUMENT
          electronic publishing system, a software tool
          developed and sold by Digital. In this system, writers
          use an ASCII text editor to create source files
          containing text and English-like code; this code
          labels the structural elements of the document, such
          as chapters, paragraphs, and tables. The VAX DOCUMENT
          software, which runs on the VMS operating system,
          interprets the code to format the text, generate a
          table of contents and index, and paginate the entire
          document. Writers can print the document on the
          terminal or line printer, or they can use Digital-
          supported devices, such as the LN03 laser printer
          and PostScript printers (PrintServer 40 or LN03R
          ScriptPrinter), to produce a typeset-quality copy
          containing integrated graphics.

 






          _______________________________________________________

          Contents

                _________________________________________________
                PREFACE                                       vii

          _______________________________________________________
          LATCP Description                                 LAT-1

                _________________________________________________
                1        INVOKING AND EXITING LATCP         LAT-4

                _________________________________________________
                2        UTILITY COMMANDS                   LAT-4

                _________________________________________________
                3        LATCP HELP FACILITY                LAT-7

          _______________________________________________________
          LATCP Usage Summary                               LAT-8

          _______________________________________________________
          LATCP Commands                                   LAT-10

                                ATTACH             LAT-11

                                CREATE LINK        LAT-14

                                CREATE PORT        LAT-17

                                CREATE SERVICE     LAT-21

                                DEFINE/KEY         LAT-25

                                DELETE LINK        LAT-30

                                DELETE PORT        LAT-32

                                DELETE SERVICE     LAT-34

                                EXIT               LAT-36

                                HELP               LAT-37

                                RECALL             LAT-39

                                REFRESH            LAT-41

                                SET LINK           LAT-42

                                SET NODE           LAT-44

                                SET PORT           LAT-58

                                                                v

 


          Contents



                                SET SERVICE        LAT-63

                                SHOW LINK          LAT-66

                                SHOW NODE          LAT-72

                                SHOW PORT          LAT-84

                                SHOW SERVICE       LAT-89

                                SPAWN              LAT-93

                                ZERO COUNTERS      LAT-95

          _______________________________________________________
          APPENDIX A  SAMPLE LAT$SYSTARTUP.COM COMMAND
                      PROCEDURES                              A-1

                _________________________________________________
                A.1      INVOKING LAT$SYSTARTUP.COM           A-1

                _________________________________________________
                A.2      LAT$SYSTARTUP.COM AS SUPPLIED BY
                         DIGITAL                              A-5

                _________________________________________________
                A.3      A SAMPLE EDITED VERSION OF
                         LAT$SYSTARTUP.COM                   A-10

          _______________________________________________________
          APPENDIX B  LATCP COMMAND SUMMARY                   B-1

                _________________________________________________
                B.1      INVOKING AND EXITING LATCP           B-1

                _________________________________________________
                B.2      LATCP COMMAND SUMMARY                B-1




          vi

 


                                                         Contents



          _______________________________________________________
          INDEX


          _______________________________________________________
          EXAMPLES

                A-1    The LAT$SYSTARTUP.COM Supplied
                       by Digital                             A-6

                A-2    An Edited LAT$SYSTARTUP.COM           A-11

          _______________________________________________________
          TABLES

                LAT-1  Summary of LATCP Commands            LAT-4

                LAT-2  LAT Node Counters                   LAT-73

                B-1    LATCP Commands and Qualifiers          B-2





















                                                              vii

 





          _______________________________________________________

          Preface

          __________________________________________________________________

          Intended Audience

          This manual is for VMS system managers.

          __________________________________________________________________

          Document Structure

          This document consists of the following parts:

          o  Description-Provides a brief description of the LAT
             Control Program Utility (LATCP), which is used to
             configure and control the LAT protocol on VMS host
             systems.

          o  Usage Summary-Outlines the following LATCP
             information:

                -Invoking the utility
                -Exiting from the utility
                -Restrictions or privileges required

          o  Commands-Describes LATCP commands, including
             format, parameters, and examples.

          This document also contains the following appendixes:

          o  Appendix A-Describes the LAT$CONFIG.COM and
             LAT$STARTUP.COM command procedures.

          o  Appendix B-Contains a summary of all LATCP commands
             and qualifiers.




                                                              vii

 


          Preface


          __________________________________________________________________

          Associated Documents

          For an overview of the LAT protocol and information on
          starting a VMS service node, see Guide to Setting Up a
          VMS System.

          For information on setting up queues to support remote
          printers on terminal servers, see Guide to Maintaining
          a VMS System.

          For complete information on the LAT architecture
          supported on Digital Terminal Servers, see LAT Network
          Concepts. The guide provides information on LAT
          network concepts, network configurations, network
          performance, and network troubleshooting. LAT Network
          Concepts is provided with Digital Terminal Servers and
          can be optionally ordered with the VMS documentation
          set.

          For a description of the usage and syntax of all
          terminal server commands and a description of error
          messages, see Terminal Server Commands and Messages.

          For a discussion of setting up, managing, monitoring,
          and troubleshooting the various types of terminal
          servers, see the product specific management and
          operations guides for terminal server products.

          __________________________________________________________________

          Conventions

          The following conventions are used in this manual:

          Ctrl/x                A sequence such as Ctrl/x
                                indicates that you must hold
                                down the key labeled Ctrl while
                                you press another key or a
                                pointing device button.

          viii

 


                                                          Preface




          PF1 x                 A sequence such as PF1 x
                                indicates that you must first
                                press and release the key
                                labeled PF1, then press and
                                release another key or a
                                pointing device button.

          <Return>              In examples, a key name is shown
                                enclosed in a box to indicate
                                that you press a key on the
                                keyboard. (In text, a key name
                                is not enclosed in a box.)

           . . .                In examples, a horizontal
                                ellipsis indicates one of the
                                following possibilities:

                                o  Additional optional arguments
                                   in a statement have been
                                   omitted.

                                o  The preceding item or items
                                   can be repeated one or more
                                   times.

                                o  Additional parameters,
                                   values, or other information
                                   can be entered.

                                A vertical ellipsis indicates
              .                 the omission of items from a
              .                 code example or command format;
              .                 the items are omitted because
                                they are not important to the
                                topic being discussed.





                                                               ix

 


          Preface




          ()                    In format descriptions,
                                parentheses indicate that, if
                                you choose more than one option,
                                you must enclose the choices in
                                parentheses.

          []                    In format descriptions, brackets
                                indicate that whatever is
                                enclosed within the brackets is
                                optional; you can select none,
                                one, or all of the choices.
                                (Brackets are not, however,
                                optional in the syntax of
                                a directory name in a file
                                specification or in the syntax
                                of a substring specification in
                                an assignment statement.)

          {}                    In format descriptions, braces
                                surround a required choice of
                                options; you must choose one of
                                the options listed.

          red ink               Red ink indicates information
                                that you must enter from the
                                keyboard or a screen object that
                                you must choose or click on.

                                For online versions of the book,
                                user input is shown in bold.










          x

 


                                                          Preface




          boldface text         Boldface text represents the
                                introduction of a new term or
                                the name of an argument, an
                                attribute, or a reason.

                                Boldface text is also used
                                to show user input in online
                                versions of the book.

          italic text           Italic text represents
                                information that can vary in
                                system messages (for example,
                                Internal error number).

          UPPERCASE TEXT        Uppercase letters indicate that
                                you must enter a command (for
                                example, enter OPEN/READ), or
                                they indicate the name of a
                                routine, the name of a file, the
                                name of a file protection code,
                                or the abbreviation for a system
                                privilege.

          -                     Hyphens in coding examples
                                indicate that additional
                                arguments to the request are
                                provided on the line that
                                follows.

          numbers               Unless otherwise noted, all
                                numbers in the text are assumed
                                to be decimal. Nondecimal
                                radixes-binary, octal, or
                                hexadecimal-are explicitly
                                indicated.





                                                               xi

 





          _______________________________________________________

          LATCP Description

          The LAT Control Program (LATCP) is a utility program
          used for configuring and controlling the LAT driver
          on VMS systems. The LAT driver implements the LAT
          protocol. With LATCP, you can set up a VMS system as
          a service node: a LAT system that offers one or more
          resources (services) for access by users on other
          systems in the local area network (LAN).

          A LAT service often consists of all the resources
          of a computer system. It can also be a specific
          resource on a computer system such as an application
          program. You can set up your VMS system as a general
          timesharing service, meaning that all of its resources
          are available to users in the LAN, or you can restrict
          access to a specific service (application program)
          on the system. The Guide to Setting Up a VMS System
          and the VMS I/O User's Reference Volume outline the
          procedure you use to set up access to a dedicated
          application program.

          In addition to being able to set up a VMS system to
          allow users on other systems to access its services,
          you can also set up the system to allow its users to
          access services on other systems in the LAN. In this
          case, the VMS system can act like a terminal server.
          It can manage multiple user sessions simultaneously
          for connections to services on other nodes.

          You can set up a VMS system to support:

          o  Incoming access only

          o  Outgoing access only

          o  Both incoming and outgoing access

          You can also set up your system so that it supports
          neither incoming nor outgoing access.

                                                            LAT-1

 


          LATCP Description



          When you set up your VMS system to support outgoing
          access, the LAT software manages a database of
          LAT services and nodes. The software builds the
          database when you enable outgoing access on your
          node. (The software begins to collect LAT service
          announcements (multicast messages sent by LAT service
          nodes) and builds the database based on these service
          announcements.) You can use LATCP to display the
          services and nodes in this database and to control
          the size of the database. Allow outgoing access on
          systems that can tolerate the additional overhead,
          such as standalone systems.

          Use LATCP to do the following:

          o  Specify operational characteristics for your VMS
             node and its services

          o  Start and stop the LAT port driver (LTDRIVER)

          o  Display status of LAT services and service nodes in
             the network

          o  Display status of links created on your LAT node

          o  Display status for your LAT node

          o  Show and zero LAT counters

          o  Recall previously-entered LATCP commands so that
             you can execute them again without having to retype
             them

          o  Create subprocesses so that you can execute DCL
             commands without exiting from LATCP

          With the LAT protocol, you can set up logical ports
          on the local node so that users can access printers
          and other asynchronous devices that are connected
          to LAT terminal servers or service nodes on the LAN.
          The remote devices must be configured appropriately.
          See the Guide to Setting Up a VMS System and the
          Guide to Maintaining a VMS System for information
          on configuring remote devices on LAT.

          LAT-2

 


                                                LATCP Description



          The LAT protocol software is started on a VMS system
          by the SYS$STARTUP:LAT$STARTUP.COM command procedure,
          which is invoked by the SYS$MANAGER:SYSTARTUP_V5.COM
          command procedure. LAT$STARTUP.COM is supplied by
          Digital, and must not be edited. Appendix A explains
          how to invoke LAT$STARTUP.COM as part of your site-
          specific startup procedure, SYSTARTUP_V5.COM.

          In turn, LAT$STARTUP.COM invokes
          SYS$STARTUP:LAT$CONFIG.COM, which loads the LAT
          port driver (LTDRIVER) and creates the LAT ancillary
          control process (LATACP). LAT$CONFIG.COM is supplied
          by Digital and must not be edited.

          After invoking LAT$CONFIG, LAT$STARTUP invokes
          SYS$MANAGER:LAT$SYSTARTUP.COM which configures
          your system as a LAT service node. Digital
          supplies a template version of this file, named
          LAT$SYSTARTUP.TEMPLATE. You can modify LAT$SYSTARTUP
          to define site-specific LAT characteristics for your
          VMS node.

          When you invoke LATCP and use LATCP commands
          (such as CREATE and SET) to add or change certain
          characteristics, these characteristics are not saved
          permanently. They stay in effect until the LAT port
          driver stops running. The next time you start the
          LAT port driver by invoking LAT$STARTUP.COM, the
          characteristics defined in LAT$SYSTARTUP.COM take
          effect again. If you want the added or changed
          characteristics to be in effect the next time you
          start the LAT port driver, edit LAT$SYSTARTUP.COM
          appropriately, then invoke LAT$STARTUP.COM. Appendix A
          shows the contents of LAT$SYSTARTUP.COM, as supplied
          by Digital, and an edited version of that file.

          The remainder of this section covers the following
          topics describing LATCP:

          o  Invoking and exiting LATCP

          o  LATCP commands

                                                            LAT-3

 


          LATCP Description



          o  LATCP HELP Facility

          __________________________________________________________________

   1      Invoking and Exiting LATCP

          Enter the following command to invoke LATCP:

               $ RUN SYS$SYSTEM:LATCP
               LATCP>

          At the LATCP> prompt, you can enter LATCP commands.
          To exit LATCP, type EXIT or press CTRL/Z at the LATCP>
          prompt.

          You can also execute a single LATCP command by using
          a DCL string assignment statement, as shown in the
          following example:

               $ LATCP :== $LATCP
               $ LATCP SET NODE/STATE=ON

          LATCP executes the SET NODE command and returns
          control to DCL.

          __________________________________________________________________

   2      Utility Commands

          Table LAT-1 summarizes the LATCP commands. Appendix B
          contains a summary of the commands and qualifiers.

          Table_LAT-1__Summary_of_LATCP_Commands_________________

          Command_________________Function_______________________

          ATTACH                  Transfers control from
                                  your current process to the
                                  specified process.

          CREATE LINK             Creates Ethernet links.
          _______________________________________________________
                                         (continued on next page)

          LAT-4

 


                                                LATCP Description



          Table_LAT-1_(Cont.)__Summary_of_LATCP_Commands_________

          Command_________________Function_______________________

          CREATE PORT             Creates an application port or
                                  dedicated port.

          CREATE SERVICE          Creates a service on a VMS
                                  service node.

          DEFINE/KEY              Assigns a command-string to a
                                  function key on your keypad.

          DELETE LINK             Deletes an Ethernet link from
                                  a VMS node.

          DELETE PORT             Deletes an application port or
                                  dedicated port.

          DELETE SERVICE          Deletes a service on a VMS
                                  service node.

          EXIT                    Returns the user to DCL
                                  command level.

          HELP                    Displays help text for LATCP
                                  commands.

          RECALL                  Recalls LATCP commands that
                                  you entered previously so that
                                  you can execute them again.
          _______________________________________________________
                                         (continued on next page)








                                                            LAT-5

 


          LATCP Description



          Table_LAT-1_(Cont.)__Summary_of_LATCP_Commands_________

          Command_________________Function_______________________

          REFRESH                 Refreshes your display screen;
                                  for example, after your
                                  display has been overwritten
                                  by output from some other
                                  source.

          SET LINK                Modifies characteristics of
                                  Ethernet links.

          SET NODE                Specifies LAT characteristics
                                  for a VMS node.

          SET PORT                Maps a logical port on a VMS
                                  node to either a remote device
                                  on a terminal server or a
                                  special application service on
                                  a remote LAT service node.

          SET SERVICE             Changes service
                                  characteristics.

          SHOW LINK               Displays the characteristics
                                  of links on your VMS node.

          SHOW NODE               Displays the characteristics
                                  of VMS nodes.

          SHOW PORT               Displays port characteristics.
          _______________________________________________________
                                         (continued on next page)







          LAT-6

 


                                                LATCP Description



          Table_LAT-1_(Cont.)__Summary_of_LATCP_Commands_________

          Command_________________Function_______________________

          SHOW SERVICE            Displays characteristics of
                                  LAT services known to your VMS
                                  node.

          SPAWN                   Creates a subprocess.

          ZERO COUNTERS           Resets the node counters,
                                  service counters, and link
                                  counters maintained by your
          ________________________VMS_node.______________________


          __________________________________________________________________

   3      LATCP HELP Facility

          LATCP provides a HELP Facility that contains
          information about each LATCP command, its parameters
          and qualifiers, and examples of its use. Refer to the
          HELP command description for more information about
          the LATCP HELP Facility.
















                                                            LAT-7

 





          _______________________________________________________

          LATCP Usage Summary


          The LAT Control Program (LATCP) allows you to control
          the LAT port driver (LTDRIVER) on a VMS node and to
          obtain information from it. For example, you can use
          LATCP to create services on the local VMS node, to
          associate a port on the local VMS node with a service
          or device on a remote terminal server, and to display
          information about services offered on the local node
          or on other nodes in the network.

          When you use LATCP commands to change LAT
          characteristics (such as creating a service and
          associating a port with a service), the changes take
          effect immediately. However, when the LAT port driver
          stops, these characteristics are lost. If you want
          these characteristics to be in effect the next time
          you start the LAT port driver, edit LAT$SYSTARTUP.COM
          by modifying or adding commands to set these
          characteristics. Then, invoke LAT$STARTUP.COM to start
          the LAT port driver, as explained in Appendix A.

          _______________________________________________________

          FORMAT

          RUN SYS$SYSTEM:LATCP

          _______________________________________________________
          Command Qualifiers     Defaults

          None.                  None.

          Parameters

          None.

          _______________________________________________________

          usage summary
          To invoke LATCP, enter RUN SYS$SYSTEM:LATCP at the DCL
          command prompt. At the LATCP> prompt, you can enter
          any of the LATCP commands described in the following

          LAT-8

 


                                               LATCP Usage Summary



          section. These commands follow the standard rules
          of command line syntax as specified in the VMS DCL
          Concepts Manual.

          To exit from LATCP, enter the LATCP EXIT command at
          the LATCP> prompt or press CTRL/Z.



































                                                            LAT-9

 


          LATCP Usage Summary


          _______________________________________________________

          LATCP COMMANDS

          This section describes the following LATCP commands
          and provides examples of their use. Appendix B
          contains a summary of the commands and their
          qualifiers.

             ATTACH
             CREATE LINK
             CREATE PORT
             CREATE SERVICE
             DEFINE/KEY
             DELETE LINK
             DELETE PORT
             DELETE SERVICE
             EXIT
             HELP
             RECALL
             REFRESH
             SET LINK
             SET NODE
             SET PORT
             SET SERVICE
             SHOW LINK
             SHOW NODE
             SHOW PORT
             SHOW SERVICE
             SPAWN
             ZERO COUNTERS











          LAT-10

 


                                                            LATCP
                                                           ATTACH


          _______________________________________________________

          ATTACH

          Transfers control from your current process to the
          specified process. The LATCP ATTACH command is similar
          to the DCL ATTACH command. For example, from the DCL
          command level you can enter the DCL SPAWN command
          to create a LATCP subprocess without ending your DCL
          session, execute several LATCP commands at the LATCP
          prompt, then use the ATTACH command to return to DCL.

          _______________________________________________________

          FORMAT

          ATTACH  [process-name]

          _______________________________________________________

          PARAMETER
          process-name
          Specifies the name of a parent process or spawned
          subprocess to which control passes. The process must
          already exist, be part of your current job, and share
          the same input stream as your current process.

          Process names can contain from 1 to 15 alphanumeric
          characters. If a connection to the specified process
          cannot be made, LATCP displays an error message.

          If you specify the /PID qualifier, do not use
          the process name parameter. If you omit the /PID
          qualifier, you must use the process name parameter.

          To display processes, use the DCL SHOW SYSTEM command.

          _______________________________________________________

          QUALIFIERS
          /PID=pid
          Specifies the process identification (PID) of the
          process that will have terminal control. When you

                                                           LAT-11

 


          LATCP
          ATTACH


          specify a PID, you can omit the leading zeros. If you
          specify a PID, do not use the process name parameter.
          If you omit the PID qualifier, you must use the
          process name parameter.

          _______________________________________________________

          DESCRIPTION
          The ATTACH command allows you to connect your input
          stream to another process. You can use ATTACH to
          change control from one process to another. For
          example, you can use ATTACH to change control from
          LATCP to the DCL command level (see the following
          example). While using the DCL command level, LATCP
          remains in a hibernation state until you use ATTACH to
          return to it.

          You cannot use this command if you are logged into a
          captive account. (A captive account is an account set
          up to restrict user access to the system. You cannot
          access the DCL command level from a captive account.)
          You cannot specify both a process name and the /PID
          qualifier.

          _______________________________________________________

          EXAMPLE

          $ SET PROCESS/NAME="TOP_LEVEL"
          $ SPAWN RUN SYS$SYSTEM:LATCP
          LATCP> SHOW NODE/ALL
             .
             .
             .
          LATCP> ATTACH "TOP_LEVEL"
          $

          In this example, the user enters the DCL SPAWN command
          to create a LATCP subprocess and uses LATCP to display
          the status of all nodes known to the local node. After

          LAT-12

 


                                                            LATCP
                                                           ATTACH


          using LATCP, the user enters the ATTACH command to
          return to the DCL command level.







































                                                           LAT-13

 


          LATCP
          CREATE LINK


          _______________________________________________________

          CREATE LINK

          Creates the Ethernet links that you want your VMS
          node to use. You must have OPER privilege to use this
          command.

          _______________________________________________________

          FORMAT

          CREATE LINK  link-name

          _______________________________________________________

          PARAMETER
          link-name
          Specifies a name for an Ethernet link. A link name can
          have up to 16 ASCII characters. The characters allowed
          are as follows:

          o  Alphanumeric characters: A-Z, a-z, 0-9

          o  A subset of the international character set: ASCII
             codes 192-253

          o  Punctuation characters: dollar sign ($), hyphen
             (-), period (.), and underscore (_)

          You can create a maximum of eight links on your local
          node. Use the SHOW LINK command for a list of the link
          names that are defined for your node.

          _______________________________________________________

          QUALIFIERS
          /DECNET
          /NODECNET
          Directs LAT protocol to use the DECnet Ethernet
          address (/DECNET) or the hardware address (/NODECNET)
          when starting the Ethernet controller. The default is
          /DECNET.

          LAT-14

 


                                                            LATCP
                                                      CREATE LINK


          /DEVICE=device-name
          Specifies the Ethernet controller device name for an
          Ethernet link; for example, XEB0:. Only one Ethernet
          link can be associated with an Ethernet controller.
          If you enter the CREATE LINK command without the
          /DEVICE qualifier, LATCP attempts to find an available
          controller by using a list of possible Ethernet device
          names. Digital advises that you specify a default
          device name by defining the LAT$DEVICE logical name.

          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the link was created. /NOLOG is the default.

          /STATE=option
          Specifies whether the link will be available for use.
          There are two options for STATE:

          ON        Specifies that the created link will be
                    available for use with the LAT protocol
                    running. This is the default.

          OFF       Specifies that the created link will not be
                    available for use.

          _______________________________________________________

          DESCRIPTION
          The CREATE LINK command creates an Ethernet link for
          a VMS node and assigns a name to the link. A VMS node
          can have eight Ethernet links. Each link must operate
          on a separate Ethernet controller and have its own
          Ethernet coaxial cable.

          If you do not explicitly create a link with this
          command before entering the SET NODE/STATE=ON command,
          LATCP automatically creates a link for you. LATCP
          names the link LAT$LINK and assigns it to the first
          available Ethernet controller or LAT$DEVICE, if
          defined. To establish additional links, use the CREATE
          LINK command.

                                                           LAT-15

 


          LATCP
          CREATE LINK


          Whenever you create a link, specify the Ethernet
          controller device name.

          Use the SET LINK command to modify link
          characteristics.

          The created link stays in effect until the next time
          you start the LAT driver.

          _______________________________________________________

          EXAMPLE

          LATCP> CREATE LINK NETWORK_A /DEVICE=XEB0: /STATE=ON

          The CREATE LINK command in this example creates an
          Ethernet link named Network_A. It specifies the
          Ethernet controller device XEB0 for that link. The
          link will be available for use.






















          LAT-16

 


                                                            LATCP
                                                      CREATE PORT


          _______________________________________________________

          CREATE PORT

          Creates a logical port on your local VMS node that
          connects with a remote device on a terminal server.
          Alternatively, this command creates a logical port
          on your local VMS node that connects with a specific
          service. The service can be offered by a terminal
          server or associated with one or more dedicated ports
          on a remote LAT service node.

          You must have OPER privilege to use this command.

          _______________________________________________________

          FORMAT

          CREATE PORT  [port-name]

          _______________________________________________________

          PARAMETER
          port-name
          Specifies the port name in the form LTAn:, where n
          is a unique number from 1 through 9999. If the port
          you specify already exists, LATCP returns an error
          message.

          If you do not specify the port name, you must specify
          the /LOGICAL qualifier.

          _______________________________________________________

          QUALIFIERS
          /APPLICATION
          Specifies that a logical port on your VMS node is to
          be an application port. It can be used to connect to
          a remote device (typically a printer) on a terminal
          server or to a dedicated port on another LAT service
          node. The default port type is /APPLICATION.

                                                           LAT-17

 


          LATCP
          CREATE PORT


          /DEDICATED
          Specifies that a logical port on your local VMS node
          is dedicated to an application service. When users
          on a terminal server (or on another VMS node that
          supports outgoing connections) request a connection to
          this service name, they are connected to the dedicated
          port. See the VMS I/O User's Reference Volume for a
          description of programming an application service.

          After creating a dedicated port on a VMS node, use
          the SET PORT /SERVICE command to map this port to a
          service.

          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the port was created. The default is /NOLOG.

          /LOGICAL=(NAME=logical-name[,TABLE=table][,MODE=mode)

          Specifies a logical name to be associated with the
          actual name of the created port. You must specify a
          logical name if you do not specify a port name.

          You can specify one of the following options for the
          TABLE keyword:

          GROUP     Places the logical name in the group logical
                    name table. You must have GRPNAM or SYSPRV
                    privilege to place the logical name in the
                    group logical name table.

          JOB       Places the logical name in the jobwide
                    logical name table.

          PROCESS   Places the logical name in the process
                    logical name table. This is the default.




          LAT-18

 


                                                            LATCP
                                                      CREATE PORT



          SYSTEM    Places the logical name in the system
                    logical name table. You must have SYSNAM
                    or SYSPRV privilege to place a name in the
                    system logical name table.

          You can also specify the name of a specific table. For
          example, you could specify LNM$PROCESS, which would be
          the equivalent of specifying PROCESS.

          There are also several options for the MODE keyword,
          as follows:

          EXECUTIVE Creates an executive mode logical name.
                    You must have SYSNAM privilege to create an
                    executive mode logical name.

          SUPERVISORCreates a supervisor mode logical name. This
                    is the default.

          USER      Creates a user mode logical name.

          _______________________________________________________

          DESCRIPTION
          The CREATE PORT command creates a logical LAT port
          for your local node. You can set up the port as an
          application port that is later mapped to a remote
          printer (or other device) on a server, or you can
          set up the port to be mapped to a dedicated port on a
          remote LAT service node. See Example 1.

          Alternatively, you can set up the port as a dedicated
          port for a special service on a LAT service node. See
          Example 2.

          After creating a port, use the SET PORT command
          to associate (map) the port with a queue or a
          service. (See the discussion that follows Example 1.)
          Ordinarily, you create and set ports in the LAT site-
          specific startup procedure, LAT$SYSTARTUP.COM. See
          Appendix A for more details.

                                                           LAT-19

 


          LATCP
          CREATE PORT


          _______________________________________________________

          EXAMPLES

          1   LATCP> CREATE PORT LTA22: /APPLICATION

          The CREATE PORT command in this example creates an
          application port named LTA22: on a VMS service node.
          You can associate the port with a specific printer
          on a terminal server (use the SET PORT /NODE /PORT
          command) or with a set of printers on a terminal
          server (use the SET PORT /NODE /SERVICE command.
          Or, you can associate the port with a dedicated port
          on a remote VMS service node. In this case, use the
          SET PORT /NODE /SERVICE command, where the /SERVICE
          qualifier specifies an application service associated
          with a dedicated port on the remote node. See the
          examples for the SET PORT command.



          2   LATCP> CREATE PORT LTA21: /DEDICATED

          The CREATE PORT command in this example creates the
          port LTA21:. It will be used as a dedicated port
          that offers a specific service rather than all the
          resources of the service node.

          3   LATCP> CREATE PORT /LOG /APPLICATION /LOGICAL=(NAME=MAIL_PORT,
              TABLE=PROCESS, MODE=SUPERVISOR)


          The CREATE PORT command in this example creates an
          application port. It assigns the name of the new port
          to the specified logical name (MAIL_PORT). The logical
          is created as a supervisor mode logical name in the
          LNM$PROCESS_TABLE logical name table. LATCP displays a
          confirmation message.



          LAT-20

 


                                                            LATCP
                                                   CREATE SERVICE


          _______________________________________________________

          CREATE SERVICE

          Creates a service on a VMS service node. You must have
          OPER privilege to use this command.

          _______________________________________________________

          FORMAT

          CREATE SERVICE  [service-name]

          _______________________________________________________

          PARAMETER
          service-name
          Specifies a LAT service name. By default, a service
          name is the name of the local node you defined with
          the SET NODE command.

          The service name can be from 1 to 16 ASCII characters
          in length. The characters allowed are as follows:

          o  Alphanumeric characters: A-Z, a-z, 0-9

          o  A subset of the international character set: ASCII
             codes 192-253

          o  Punctuation characters: dollar sign ($), hyphen
             (-), period (.), and underscore (_)

          _______________________________________________________

          QUALIFIERS
          /APPLICATION
          Specifies that the created service is an application
          service. An application service offers a specific
          application on the service node rather than all of the
          resources on the service node. Define a dedicated port
          for the service, using the CREATE PORT and SET PORT
          commands.

                                                           LAT-21

 


          LATCP
          CREATE SERVICE


          /IDENTIFICATION[="identification-string"]

          Describes and identifies a VMS service. Service
          nodes include the identification string in service
          announcements. A VMS service node announces its
          services at regular intervals established with the
          SET NODE command. The LATCP SHOW NODE and server SHOW
          NODE displays include this identification string. By
          default, the identification string is a translation of
          SYS$ANNOUNCE.

          An identification string can have up to 64 ASCII
          characters. Enclose the string in quotation marks (").

          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the service was created. The default is /NOLOG.

          /STATIC_RATING=rating
          /NOSTATIC_RATING
          Enables or disables dynamic service ratings. A dynamic
          service rating means that a LAT algorithm calculates
          the availability of a service dynamically, based on
          the overall level of activity of the node that offers
          the service, the amount of memory, and the processor
          type. When a terminal server or VMS node requests a
          connection to a service that is offered on two or more
          service nodes, the requesting node selects the service
          node with the highest (most favorable) service rating.
          This selection process is called load balancing.
          The dynamic service rating, which is the default, is
          usually adequate for efficient load balancing on the
          LAT network.

          When you use the /STATIC_RATING qualifier, you disable
          dynamic service ratings so that you can specify a
          static (fixed) rating. Use the static rating to direct
          users away from or toward your node temporarily.
          Static ratings range from 0 to 255. Specify a low
          value to make the local service node less likely to be

          LAT-22

 


                                                            LATCP
                                                   CREATE SERVICE


          used; specify a high value to make the local service
          node more likely to be used.

          _______________________________________________________

          DESCRIPTION
          The CREATE SERVICE command creates a service that a
          VMS service node offers to terminal servers (and VMS
          nodes that support outgoing connections) on the LAT
          network. The service can be a general timesharing
          service that offers all the resources of the service
          node, or it can be an application service that offers
          a specific application on the service node. To
          create an application service, use the /APPLICATION
          qualifier. In addition, define a dedicated port, using
          the CREATE PORT and SET PORT commands. Most often, a
          system manager creates services in LAT$SYSTARTUP.COM,
          the site-specific LAT configuration procedure. See
          Appendix A for further information on creating an
          application service. The VMS I/O User's Reference
          Volume shows how to program an application service.

          Several service nodes can share one service name.
          A shared service name is especially useful in
          VAXclusters because it allows the cluster to be known
          by a single cluster name. On login, the terminal
          server connects to the least-busy node offering that
          service.

          You can modify the service characteristics with the
          SET SERVICE command.

          _______________________________________________________

          EXAMPLES

          1   LATCP> CREATE SERVICE/STATIC_RATING=195 SALES

          The CREATE SERVICE command in this example creates the
          service "SALES" on a VMS service node. This command
          assigns a static rating of 195 so terminal servers

                                                           LAT-23

 


          LATCP
          CREATE SERVICE


          (and VMS nodes that support outgoing connections) can
          assess the availability of services on the node.


          2   LATCP> CREATE SERVICE/APPLICATION GRAPHICS

          This command creates the service GRAPHICS on the local
          node. Use the CREATE PORT/DEDICATED and SET PORT
          /SERVICE=GRAPHICS commands to create a port that is
          dedicated to this service. Example A-2 in Appendix A
          includes these commands as an example.






























          LAT-24

 


                                                            LATCP
                                                       DEFINE/KEY


          _______________________________________________________

          DEFINE/KEY

          Assigns a command string to a function key. For
          example, you can assign the LATCP SHOW NODE command
          to a function key.

          _______________________________________________________

          FORMAT

          DEFINE/KEY  key-name equivalence-string

          _______________________________________________________

          PARAMETERS
          key-name
          Specifies the name of the function key you want to
          define. Valid key names are as follows:

          _______________________________________________________
          Key-name____________LK201_keyboard___VT100-type_______VT52-tye

          PF1                 PF1              PF1              Blue

          PF2                 PF2              PF2              Red

          PF3                 PF3              PF3              Black

          PF4                 PF4              PF4

          KP0-KP9             Keypad 0-9       Keypad 0-9       Keypad 0-9

          PERIOD              Keypad period    Keypad period
                              (.)              (.)

          COMMA               Keypad comma     Keypad comma
                              (,)              (,)


                                                           LAT-25

 


          LATCP
          DEFINE/KEY

          _______________________________________________________
          Key-name____________LK201_keyboard___VT100-type_______VT52-tye

          MINUS               Keypad minus     Keypad minus
                              (-)              (-)

          ENTER               ENTER            ENTER            ENTER

          FIND                Find

          INSERT_HERE         Insert Here

          REMOVE              Remove

          SELECT              Select

          PREV_SCREEN         Prev Screen

          NEXT_SCREEN         Next Screen

          HELP                Help

          DO                  Do

          F6-F20______________F6-F20_____________________________


          equivalence-string
          Specifies the command string that you want assigned
          to the function key. To preserve spaces and lowercase
          characters, enclose the string in quotation marks.

          _______________________________________________________

          QUALIFIERS
          /ECHO
          /NOECHO
          Specifies whether LATCP displays the command string
          on your screen when you press the key. The default is
          /ECHO. You cannot use /NOECHO with the /NOTERMINATE
          qualifier.

          LAT-26

 


                                                            LATCP
                                                       DEFINE/KEY


          /IF_STATE=state-name
          Specifies the state that must be in effect (for
          example, the GOLD state) for the key definition to
          take effect. Lets you assign alternate meanings to
          keys when the specified state is in effect. See the
          discussion of the /SET_STATE qualifier. If you omit
          the /IF_STATE qualifier, LATCP uses the current state.
          The state name is an alphanumeric string. States are
          established with the /SET_STATE qualifier.

          /LOCK_STATE
          /NOLOCK_STATE
          Specifies that the state set by the /SET_STATE
          qualifier remain in effect until explicitly changed.
          If you use the /NOLOCK_STATE qualifier, the state
          set by /SET_STATE is in effect only for the next
          defineable key that you press or for the next read
          terminating character (such as RETURN or CTRL/Z) that
          you type.

          The default is /NOLOCK_STATE. The /LOCK_STATE
          qualifier can be specified only with the /SET_STATE
          qualifier.

          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the command was executed. The default is /NOLOG.

          /SET_STATE=state-name
          Causes the specified state to be set when you
          press the defined key. The state name can be any
          alphanumeric string (for example, GOLD). Use the
          DEFINE/KEY/IF_STATE=state-name command to associate
          new meanings for keys when the specified state is set.
          See the example for the DEFINE/KEY command.

          If you omit the /SET_STATE qualifier, the current
          state that was locked remains in effect.


                                                           LAT-27

 


          LATCP
          DEFINE/KEY


          /TERMINATE
          /NOTERMINATE
          Specifies whether the command string will be
          terminated (processed) when you press the function
          key. The default is /NOTERMINATE, which allows you
          to press other keys before the command string is
          processed. Pressing RETURN has the same effect as
          using /TERMINATE.

          The /NOTERMINATE qualifier allows you to create key
          definitions that insert text into command lines, after
          prompts, or into other text that you are typing.

          _______________________________________________________

          DESCRIPTION
          The DEFINE/KEY command assigns a command string to
          a function key so that when you press that key, the
          command is executed.

          _______________________________________________________

          EXAMPLE

          LATCP> DEFINE/KEY PF4 "SHOW NODE " /NOTERMINATE/SET_
          STATE=GOLD
          LATCP> DEFINE/KEY PF4 "/ALL"/IF_STATE=GOLD/TERMINATE

          The first DEFINE/KEY command in this example assigns
          the SHOW NODE command to function key PF4. To process
          the SHOW NODE command, you must press RETURN after
          pressing PF4. Note the space after the word NODE in
          the first DEFINE/KEY command. This space allows you
          to enter a node name after pressing PF4. When you
          press RETURN, the SHOW NODE command is processed. If
          the space is omitted, LATCP would not recognize the
          command (SHOW NODE). The state is set to GOLD, to be
          in effect for the next key that you press.



          LAT-28

 


                                                            LATCP
                                                       DEFINE/KEY


          The second DEFINE/KEY command defines the use of the
          PF4 key when the keypad is in the GOLD state. When
          you press PF4 twice, the SHOW NODE/ALL command is
          processed.





































                                                           LAT-29

 


          LATCP
          DELETE LINK


          _______________________________________________________

          DELETE LINK

          Deletes a logical link from a VMS node. You must have
          OPER privilege to use this command.

          _______________________________________________________

          FORMAT

          DELETE LINK  link-name

          _______________________________________________________

          PARAMETER
          link-name
          Specifies the name of the link that you want to
          delete.

          The link must have been created with the CREATE LINK
          command. Use the SHOW LINK command for a list of the
          links that are defined for your node.

          _______________________________________________________

          QUALIFIERS
          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the link was deleted. The default is /NOLOG.

          _______________________________________________________

          DESCRIPTION
          The DELETE LINK command stops any active sessions on
          the link and then deletes this link from your node.




          LAT-30

 


                                                            LATCP
                                                      DELETE LINK


          _______________________________________________________

          EXAMPLE

          LATCP> DELETE LINK NETWORK_A /LOG

          The DELETE LINK command in this example deletes the
          link NETWORK_A. The link was created with the CREATE
          LINK command.
































                                                           LAT-31

 


          LATCP
          DELETE PORT


          _______________________________________________________

          DELETE PORT

          Deletes a logical port from a VMS node. You must have
          OPER privilege to use this command.

          _______________________________________________________

          FORMAT

          DELETE PORT  port-name

          _______________________________________________________

          PARAMETER
          port-name
          Specifies the name of the application port or the
          dedicated port that you want to delete. An application
          port connects to a remote device on a terminal server,
          whereas a dedicated port connects to a special VMS
          service.

          The port must have been created with the CREATE PORT
          command. Use the SHOW PORT command for a list of the
          application ports and the dedicated ports that are
          defined for your service node.

          _______________________________________________________

          QUALIFIERS
          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the port was deleted. The default is /NOLOG.

          _______________________________________________________

          DESCRIPTION
          The DELETE PORT command stops any active session on
          the port and then deletes this port from your service
          node.

          LAT-32

 


                                                            LATCP
                                                      DELETE PORT


          _______________________________________________________

          EXAMPLE

          LATCP> DELETE PORT LTA27:

          The DELETE PORT command in this example deletes the
          application port LTA27:. The port was created with the
          CREATE PORT command.
































                                                           LAT-33

 


          LATCP
          DELETE SERVICE


          _______________________________________________________

          DELETE SERVICE

          Deletes a service that your VMS service node currently
          offers. You must have OPER privilege to use this
          command.

          _______________________________________________________

          FORMAT

          DELETE SERVICE  service-name

          _______________________________________________________

          PARAMETER
          service-name
          Specifies the name of the service, as displayed by the
          SHOW SERVICE command.

          _______________________________________________________

          QUALIFIERS
          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the service was deleted. The default is /NOLOG.

          _______________________________________________________

          DESCRIPTION
          The DELETE SERVICE command removes a service from a
          VMS service node. The service is no longer available
          to terminal server users, and is no longer multicast
          in the configuration messages sent by your service
          node.




          LAT-34

 


                                                            LATCP
                                                   DELETE SERVICE


          _______________________________________________________

          EXAMPLE

          LATCP> DELETE SERVICE SALES

          The DELETE SERVICE command in this example removes the
          service SALES from your service node. The service is
          no longer available to server users.
































                                                           LAT-35

 


          LATCP
          EXIT


          _______________________________________________________

          EXIT

          Stops execution of LATCP and returns control to the
          DCL command level. You can also type CTRL/Z to exit at
          any time.

          _______________________________________________________

          FORMAT

          EXIT

          _______________________________________________________

          PARAMETERS

          None.

          _______________________________________________________

          EXAMPLE

          LATCP> EXIT

          The EXIT command in this example exits the LATCP
          program and returns control to the DCL command level.













          LAT-36

 


                                                            LATCP
                                                             HELP


          _______________________________________________________

          HELP

          Provides online help information for using the LATCP
          commands.

          _______________________________________________________

          FORMAT

          HELP  [command-name]

          _______________________________________________________

          PARAMETER
          command-name
          The name of a LATCP command. If you enter the HELP
          command with a command name only, such as HELP SET,
          LATCP displays a list of all of the command keywords
          used with the SET command.

          _______________________________________________________

          DESCRIPTION
          The HELP command is an online reference for LATCP
          commands. After you view an initial help display,
          press RETURN. The help display stops and the LATCP
          prompt is displayed. If you do not specify a command
          name, the HELP command displays general information
          on the commands for which help is available. Supplying
          a command name obtains syntax information on that
          command.

          _______________________________________________________

          EXAMPLE




                                                           LAT-37

 


          LATCP
          HELP


          LATCP> HELP SET PORT

          In this example, the HELP SET PORT command produces
          a description of the SET PORT command and shows the
          command format.




































          LAT-38

 


                                                            LATCP
                                                           RECALL


          _______________________________________________________

          RECALL

          Displays previously entered LATCP commands on the
          screen so that you can execute them again.

          _______________________________________________________

          FORMAT

          RECALL  [command-specifier]

          _______________________________________________________

          PARAMETER
          command-specifier
          Specifies the number or the first several characters
          of the LATCP command you want to recall. Command
          numbers can range from 1 to 20. The most recently
          entered command is number 1.

          If you do not specify the command specifier, you must
          use the /ALL qualifier. Use the /ALL qualifier to
          display all the commands in the RECALL buffer, along
          with their command number so that you can determine
          the number of the command that you want to recall.

          If you do not specify the command specifier nor the
          /ALL qualifier, LATCP displays the last command.

          _______________________________________________________

          QUALIFIERS
          /ALL
          Specifies that LATCP display all the commands in
          the RECALL buffer. LATCP displays the number of each
          command.



                                                           LAT-39

 


          LATCP
          RECALL

          _______________________________________________________

          DESCRIPTION
          When you enter a LATCP command, LATCP stores it in a
          RECALL buffer for later use with the RECALL command.
          The RECALL command itself is never stored in the
          RECALL buffer.

          When you use the RECALL command, LATCP displays the
          recalled command but does not process it. If you want
          the command processed as it appears, press RETURN.
          You can use the command line editing facility to
          make minor changes in the command line and then press
          RETURN to process the revised version of the command.

          _______________________________________________________

          EXAMPLES

          1   LATCP> RECALL 2

          In this example, the RECALL command recalls the
          second-to-last command you entered.


          2   LATCP> RECALL SET

          In this example, the RECALL command recalls the last
          SET command you entered.













          LAT-40

 


                                                            LATCP
                                                          REFRESH


          _______________________________________________________

          REFRESH

          Refreshes the display screen so that any output from
          some other source (such as a broadcast message from a
          terminal server user) is erased from the screen.

          _______________________________________________________

          FORMAT

          REFRESH

          _______________________________________________________

          DESCRIPTION
          Use the REFRESH command to refresh your display screen
          after output from other sources has overwritten the
          display screen. For example, if a broadcast message
          from a terminal server user displays on your screen,
          use the REFRESH screen to erase the broadcast message
          from the display. By default, you can refresh your
          screen by pressing CTRL/W at the LATCP prompt.

          _______________________________________________________

          EXAMPLE

          LATCP> REFRESH

          In this example, the REFRESH command refreshes the
          display on your screen.








                                                           LAT-41

 


          LATCP
          SET LINK


          _______________________________________________________

          SET LINK

          Changes the characteristics of Ethernet links. You
          must have OPER privilege to use this command.

          _______________________________________________________

          FORMAT

          SET LINK  link-name

          _______________________________________________________

          PARAMETER
          link-name
          Specifies the name for an Ethernet link. A link name
          can have up to 16 ASCII characters. The characters
          allowed are as follows:

          o  Alphanumeric characters: A-Z, a-z, 0-9

          o  A subset of the international character set: ASCII
             codes 192-253

          o  Punctuation characters: dollar sign ($), hyphen
             (-), period (.), and underscore (_)

          The SHOW LINK command displays the names of the links
          defined for a VMS node.

          _______________________________________________________

          COMMAND QUALIFIERS
          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the link's characteristics were modified. The
          default is /NOLOG.

          LAT-42

 


                                                            LATCP
                                                         SET LINK


          /STATE=option
          Specifies availability of the link for use. There are
          two options for STATE:

          ON        Specifies that the link will be available
                    for use with the LAT protocol running. This
                    is the default.

          OFF       Specifies that the link will not be
                    available for use.

          _______________________________________________________

          DESCRIPTION
          The SET LINK command allows you to change the
          characteristics for an Ethernet link. The link must
          have been created with the CREATE LINK command. If no
          links are created when the SET NODE/STATE=ON command
          executes, it creates a default link named LAT$LINK.

          _______________________________________________________

          EXAMPLE

          LATCP> SET LINK NETWORK_A /LOG

          The SET LINK command in this example directs LATCP to
          start the controller for link Network_A and to then
          display a confirmation message.












                                                           LAT-43

 


          LATCP
          SET NODE


          _______________________________________________________

          SET NODE

          Specifies the LAT characteristics of your local
          VMS node. You must have OPER privilege to use this
          command.

          _______________________________________________________

          FORMAT

          SET NODE  [node-name]

          _______________________________________________________

          PARAMETER
          node-name
          Specifies a node name for your local VMS node. By
          default, the node name is the translation of SYS$NODE.
          A LAT node name should be the same as the DECnet node
          name. If the VMS node is not running DECnet but will
          be in the future, it is recommended that you define
          SYS$NODE and use it for both DECnet and LAT node
          names.

          A node name can be from 1 to 16 ASCII characters. The
          characters allowed are as follows:

          o  Alphanumeric characters: A-Z, a-z, 0-9

          o  A subset of the international character set: ASCII
             codes 192-253

          o  Punctuation characters: dollar sign ($), hyphen
             (-), period (.), and underscore (_)

          _______________________________________________________

          QUALIFIERS
          /CIRCUIT_TIMER=msecs
          Allows you to control the interval in milliseconds
          (ms) between messages sent from the local node
          to other service nodes or terminal servers while

          LAT-44

 


                                                            LATCP
                                                         SET NODE


          a connection to those nodes are active. Use this
          qualifier only if your node allows outgoing
          connections (/CONNECTIONS=OUTGOING_ONLY or
          /CONNECTIONS=BOTH).

          A low value for the interval decreases the response
          time for the port but increases the demand on
          service nodes. Set the circuit timer in the range
          of 10 to 1000 milliseconds. The default value of 80
          milliseconds gives a generally acceptable response
          time while creating a moderately low overhead on the
          service nodes. The value for the circuit timer is
          effective only as a multiple of the line clock (the
          power line frequency):

          o  16 2/3 ms per clock tick for 60 hertz

          o  20 ms per clock tick for 50 hertz

          /CONNECTIONS=option
          Allows you to specify the type of connections
          permissable on the local node. There are four options
          for CONNECTIONS:

          INCOMING_ONLY    Specifies that the local node permits
                           incoming connections only.

          OUTGOING_ONLY    Specifies that the local node permits
                           outgoing connections only. Specify
                           this on systems that can tolerate the
                           overhead associated with outgoing
                           connections, such as standalone
                           systems.

          BOTH             Specifies that the local node
                           permit both incoming and outgoing
                           connections. Specify this on systems
                           that can tolerate the overhead
                           associated with outgoing connections,
                           such as standalone systems.

                                                           LAT-45

 


          LATCP
          SET NODE



          NONE             Specifies that the local node
                           disallow both incoming and outgoing
                           connections.

          /CPU_RATING=cpu-power
          /NOCPU_RATING
          The /CPU_RATING qualifier assigns your local VMS node
          a rating that represents the power of your node's CPU
          (central processing unit) relative to other CPUs in
          the LAN. The value of cpu-power can range from 1 (for
          a CPU with the lowest power) to 100 (for a CPU with
          the highest power).

          The local node's LAT driver uses this value to
          calculate the dynamic service rating for each service
          offered on the local node. When a terminal server
          or VMS node requests a connection to a service that
          is offered on the local node and one or more other
          service nodes, the requesting node selects the service
          node with the highest (most favorable) service rating.
          This selection process is called load balancing.

          Specify the /CPU_RATING qualifier to influence the
          service ratings calculated for services on your node.
          If you specify a high value for cpu_power, the LAT
          driver will calculate a relatively high service rating
          for services on your node (service ratings as high
          as 255 are possible). If you specify a low value,
          the LAT driver will calculate relatively low service
          ratings; connections will most likely be made to the
          same service that is offered on other nodes. In either
          case, the LAT driver can calculate a greater range of
          values for dynamic service ratings (the entire range
          from (0 to 255). Consequently, the ratings will more
          accurately reflect the availability of the service
          node.




          LAT-46

 


                                                            LATCP
                                                         SET NODE


          By default, the LAT driver calculates a dynamic rating
          based on the estimated CPU power of the local node.
          So, if you do not modify the default by specifying
          the /CPU_RATING qualifier, or if you specify the
          /NOCPU_RATING qualifier, services offered on the local
          node will generally have lower ratings than services
          offered on nodes having more powerful CPUs. Other
          factors involved in the rating calculation, such as
          available memory and current CPU usage, can further
          reduce the ratings for local services.

          The following example illustrates one of the major
          benefits of using the /CPU_RATING qualifier. If your
          local node has low CPU power (relative to the range
          of CPU powers available with VAX processors) but is
          the most powerful CPU that is usually available, you
          can assign a high value to the /CPU_RATING qualifier.
          Then, higher service ratings will be given to the
          services offered on your node (as high as 255, the
          maximum value for service ratings). For example, if
          your node is one of several VAX 11/780s in a cluster
          which contains only VAX 11/750s and VAX 11/780s,
          assign a high value to the /CPU_RATING qualifier. Then
          the services offered on your node will have higher
          service ratings.

          If you do not specify the /CPU_RATING qualifier in
          the previous example, the service ratings calculated
          for the VAX 11/780 will tend to be low, far below the
          maximum possible value of 255.

          /DEVICE_SEED[=value]
          The /DEVICE_SEED qualifier overrides the default lower
          boundary for new LTA devices. The default is 0, and
          the maximum is 9999.

          By default, if you do not specify a parameter to the
          LATCP CREATE PORT command, LTA device unit numbers for
          LTA ports fall in the following range (starting at the
          lower boundary):

                                                           LAT-47

 


          LATCP
          SET NODE


               ( (MAX unit / 2) - 1 ) < n < ( MAX unit )

          where:

          o  n is the device unit number of the LTA device
             (LTAn:).

          o  MAX unit is the maximum LTA device unit number.
             The default is 9999 (the absolute maximum). You can
             set this value using the the /UNIT_NUMBER_MAXIMUM
             qualifier.

             The channel numbers fall in this same range when
             ports are created by assigning a channel to LTA0:
             with the $ASSIGN system service.

          /GROUPS=option[,...]
          Gives the listed groups access to services offered
          on your local node or prevents the listed groups
          from accessing services offered on your local node,
          depending on the options used.

          A network manager organizes terminal server nodes into
          groups based on the number of terminal server nodes
          in the LAT network. Groups subdivide the LAT network,
          limiting the number of terminal server nodes that can
          connect with a given VMS service node.

          There can be as many as 256 groups, numbered 0 through
          255. By default all terminal server nodes and VMS
          nodes supporting outgoing connections belong to group
          0. If you enter one group code, you can omit the
          parentheses. Use the SHOW NODE command for a list
          of the groups enabled for your service node.

          There are several options for the /GROUPS qualifier.
          For each option described, there are two ways to
          specify more than one group:

          o  List them separated by commas

          o  Specify a range

          LAT-48

 


                                                            LATCP
                                                         SET NODE


          See Example 2 for the SET NODE command.

          ENABLE=group-code[,...]    Gives the listed groups
                                     access to your service
                                     node.

          DISABLE=group-code[,...]   Prevents the listed groups
                                     from accessing your service
                                     node. The listed groups had
                                     been enabled previously for
                                     access to your node.

          ENABLE=group-code[,...],   This option lets you en-
          DISABLE=group-code[,...]   able certain groups and
                                     disable other groups in
                                     one command line: gives ac-
                                     cess to the groups listed
                                     with the ENABLE option,
                                     and removes access from
                                     the groups listed with the
                                     DISABLE option. Enclose
                                     both ENABLE and DISABLE in
                                     parentheses. For example,
                                     /GROUP=(ENABLE=(10,12),DISABLE=(1-
                                     30)).

          /IDENTIFICATION[="identification-string"]
          Describes and identifies a VMS node. Service nodes
          include the identification string in service
          announcements. A VMS service node announces its
          services at regular intervals established with the
          SET NODE command. The LATCP SHOW NODE and server SHOW
          NODE displays include this identification string. By
          default, the identification string is the translation
          of SYS$ANNOUNCE.

          An identification string can have up to 64 ASCII
          characters. Enclose the string in quotation marks (").



                                                           LAT-49

 


          LATCP
          SET NODE


          /KEEPALIVE_TIMER=secs
          Allows you to control the maximum interval between
          idle run messages sent by your local node to another
          service node to which it has a LAT connection. The
          interval is in seconds. Your node sends these messages
          when no other traffic is being generated over the
          virtual circuit. If the service node acknowledges
          these messages, your node will continue to monitor the
          status of the circuit. If your node does not receive
          acknowledgement, it responds as if the circuit is
          down.

          Use this qualifier only if your
          node allows outgoing connections
          (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).

          The default value is 20. Digital recommends this value
          for normal Ethernet environments. For a heavily loaded
          Ethernet, consider using a higher value. Set the
          timer in the range of 1 to 255. For applications that
          require quick notification and possible failover of a
          service node failure, use a lower value.

          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the node's characteristics were modified. The
          default is /NOLOG.

          /MULTICAST_TIMER=secs
          Specifies the time, in seconds, between multicast
          messages sent by a VMS service node. A multicast
          message announces the services offered by a VMS
          service node. The minimum value is 10 seconds; the
          maximum is 255 seconds. The default value is 60.

          /NODE_LIMIT=value
          /NONODE_LIMIT
          Specifies the maximum number of service nodes
          that your local node can store in its service
          and node database. Use this qualifier only

          LAT-50

 


                                                            LATCP
                                                         SET NODE


          if your node allows outgoing connections
          (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).

          When the database reaches the node limit, no more
          nodes are added to the database when your local node
          receives service announcement messages. You can ensure
          that the node limit is not reached by using the /USER_
          GROUPS qualifier to restrict access from the local
          node to other service nodes on the network.

          A value of 0 can also be used to mean no limit.

          /RETRANSMIT_LIMIT=count
          Specifies the number of times your local node repeats
          transmission of a message to a service node after
          a transmission fails. If the transmission is still
          unsuccessful after these attempts, the virtual
          circuit between your local node and the service node
          terminates, along with all sessions associated with
          the virtual circuit.

          Use this qualifier only if your
          node allows outgoing connections
          (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).

          Specify a value in the range of 1 to 255. The default
          is 20. The value you choose depends on the type of
          physical link used for your network, as well as the
          amount of traffic on the network. See your network
          manager for a suggested value.

          /SERVICE_RESPONDER
          /NOSERVICE_RESPONDER
          Specifies whether your VMS system responds to
          special LAT multicast messages that request service
          information. Some terminal servers do not have their
          own service and node database. When a user on such a
          terminal server requests a connection to a service,
          the server sends a LAT multicast message requesting
          names of nodes that offer the requested service.
          Service responder nodes reply with the requested
          information.

                                                           LAT-51

 


          LATCP
          SET NODE


          If you specify /SERVICE_RESPONDER, your system
          responds to the special LAT multicast messages.
          Only one or two nodes in the LAN should be set up
          as service responder nodes. The nodes should have
          the largest databases in the LAN. Use this option
          only if your node allows outgoing connections (
          /CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).

          If you specify /NOSERVICE_RESPONDER, your system does
          not respond to the special LAT multicast messages.
          This is the default.

          /SESSION_LIMIT=option
          Specifies the maximum number of simultaneous sessions
          across all local-access ports. This limit does not
          affect the use of dedicated and application ports.
          It affects interactive port creation only, limiting
          the amount of resources consumed by interactive users
          creating new sessions.

          There are several options for the /SESSION_LIMIT
          qualifier:

          INCOMING=value             Sets the session limit for
                                     incoming connections only.

          OUTGOING=value             Sets the session limit for
                                     outgoing connections only.

          INCOMING=value,OUTGOING=valSets the limit for both
                                     outgoing and incoming
                                     connections. Enclose
                                     this in parentheses.
                                     For example, /SESSION_
                                     LIMIT=(INCOMING=20,
                                     OUTGOING=25)

          o  A high limit allows users to have more sessions but
             increases memory utilization on your local node.


          LAT-52

 


                                                            LATCP
                                                         SET NODE


          o  A low limit decreases memory utilization on your
             local node but limits user access to services on
             the network.

          If the limit is reached, interactive users cannot
          create new sessions. In this case, you need to
          increase the session limit or disconnect any
          connections that are no longer being used.

          Specify a value in the range of 0 to 255. Specifying 0
          leaves no limit on the number of sessions that can be
          created. To prevent sessions from being created, use
          the /CONNECTIONS qualifier.

          /STATE=option
          Specifies whether LAT connections are allowed. There
          are three options for STATE:

          ON        Starts the LAT port driver (and LAT protocol
                    software).

          OFF       Stops the LAT port driver (and LAT protocol
                    software) on your node. Any existing LAT
                    connections are aborted. Any characteristics
                    that you changed or set with LATCP are lost.

                    To start the LAT protocol on your node
                    again, invoke LAT$SYSTARTUP.COM as explained
                    in Appendix A. The LAT characteristics
                    defined in LAT$SYSTARTUP.COM will take
                    effect.

          SHUT      Specifies that new LAT connections cannot
                    be created on your local node, but existing
                    connections may continue. The LAT protocol
                    continues running only until the last active
                    session disconnects. At that time, your node
                    changes to the OFF state.



                                                           LAT-53

 


          LATCP
          SET NODE


          /UNIT_NUMBER_MAXIMUM=value
          Specifies the maximum unit number for a LAT device.
          For example, if you specify 40, then LTA40: will be
          the device with the highest unit number. Specify a
          value that is high enough to accommodate all devices
          that may be in use simultaneously. When the number
          of devices in use exceeds the value you specify, the
          system gives certain LAT devices unit numbers that
          exceed your maximum.

          /USER_GROUPS=option[,...]
          Restricts access (from the local node) to service
          nodes in the network that belong to the specified
          groups. Your local node can access only those service
          nodes associated with the user groups specified. The
          /USER_GROUPS qualifier also serves to limit the number
          of nodes stored in your node's node database. (The
          local node only stores information about the nodes and
          services that belong to at least one of the specified
          user groups.) By default, all LAT service nodes belong
          to group 0.

          This qualifier affects your local node when outgoing
          connections are enabled (/CONNECTIONS=OUTGOING_ONLY or
          /CONNECTIONS=BOTH).

          Use the SHOW NODE command for a list of the user
          groups (service groups) enabled for your node.

          There are several options for the /USER_GROUPS
          qualifier. For each option described here, there are
          two ways to specify more than one group:

          o  List them separated by commas

          o  Specify a range.

          See the example that follows.

          ENABLE=group-code[,...]    Gives your node access to
                                     the listed user groups.

          LAT-54

 


                                                            LATCP
                                                         SET NODE



          DISABLE=group-code[,...]   Prevents your node from
                                     accessing the listed
                                     groups. The listed groups
                                     were enabled previously.

          ENABLE=group-code[,...],   This option lets you en-
          DISABLE=group-code[,...]   able certain groups and
                                     disable other groups in
                                     one command line: gives
                                     your node access to the
                                     groups listed with the EN-
                                     ABLE option, and prevents
                                     your node from accessing
                                     the groups listed with the
                                     DISABLE option. Enclose
                                     both ENABLE and DISABLE in
                                     parentheses. For example,
                                     /GROUP=(ENABLE=(10,12),DISABLE=(1-
                                     30)).

          _______________________________________________________

          DESCRIPTION
          The SET NODE command, which is typically executed
          in the site-specific LAT configuration command
          procedure, LAT$SYSTARTUP.COM, allows you to specify
          such characteristics as:

          o  Node name

          o  Node identification

          o  Service and user groups

          o  Timing of service announcements

          o  The maximum number of LAT sessions allowed
             simultaneously on the node

          o  The maximum number of outgoing sessions and
             incoming interactive sessions

                                                           LAT-55

 


          LATCP
          SET NODE


          Because LATCP commands change characteristics
          dynamically (that is, the commands take effect
          immediately), you can use the SET NODE command any
          time the LAT port driver is active. These changes stay
          in effect until the LAT port driver stops. To make
          sure the changes take effect when you start the LAT
          port driver again, edit LAT$SYSTARTUP.COM to include
          these changes. Start the LAT port driver by invoking
          LAT$SYSTARTUP.COM. See Appendix A. The description of
          a LAT network in the Guide to Setting Up a VMS System
          describes a VMS service node.

          This command must be executed first (after LTDRIVER is
          loaded and the LATACP is started) in order to execute
          other management commands.

          _______________________________________________________

          EXAMPLES

          1   LATCP> SET NODE DUKE /IDENT="NODE DUKE, SALES VAXCLUSTER"

          The SET NODE command in this example specifies node
          name DUKE for your local VMS node. The identification
          string "NODE DUKE, SALES VAXCLUSTER" is multicast from
          node DUKE.

          2   LATCP> SET NODE /MULTICAST_TIMER=50 /GROUPS=(ENABLE=(1-3,8,11),DISABLE=5)

          The SET NODE command in this example causes your local
          node to send multicast messages every 50 seconds to
          announce DUKE's services to terminal servers. The
          command also enables groups 1, 2, 3, 8, and 11 for
          access to the local node, and it disables group 5 from
          accessing the local node. Group 5 had been previously
          enabled.





          LAT-56

 


                                                            LATCP
                                                         SET NODE



          3   LATCP> SET NODE /CONNECTIONS=BOTH /USER_GROUPS=(ENABLE=(24,121-127),DISABLE=0)

          The SET NODE command in this example sets up your
          local node to allow both incoming and outgoing
          connections. Users on your local node can access those
          service nodes belonging to user groups 24 and 121
          through 127. Users cannot access service nodes in user
          group 0.

          4   LATCP> SET NODE /CIRCUIT_TIMER=80 /KEEPALIVE_TIMER=20 -
              _LATCP> /RETRANSMIT_LIMIT=20 /CONNECTIONS=BOTH /MULTICAST_TIMER=60-
              _LATCP> /GROUPS=(DISABLE=0,ENABLE=73) /SESSION_LIMIT=(OUTGOING=10,INCOMING=0)

          The SET NODE command in this example sets many
          characteristics at once for node DUKE.

























                                                           LAT-57

 


          LATCP
          SET PORT


          _______________________________________________________

          SET PORT

          Logically associates a logical port on the local VMS
          node with a remote port on a terminal server that
          supports a device. Alternatively, it associates a
          logical port on the local VMS node with a specific
          service. The service can be offered by a terminal
          server or associated with one or more dedicated ports
          on a remote LAT service node.

          You must have OPER privilege to use this command.

          _______________________________________________________

          FORMAT

          SET PORT  port-name

          _______________________________________________________

          PARAMETER
          port-name
          Specifies the name of the port. A port name must be
          in the form LTAn:, where n is a unique number from 1
          through 9999.

          _______________________________________________________

          QUALIFIERS
          /APPLICATION
          Specifies that a port on the local VMS node is an
          application port, logically associated with a port
          on a terminal server or a dedicated port on another
          LAT service node. The terminal server port supports
          a device, for example, a printer. If the port is used
          to support a printer, the print queue is established
          in a startup command procedure. See the description
          of configuring remote printers on a terminal server in
          the Guide to Maintaining a VMS System.

          LAT-58

 


                                                            LATCP
                                                         SET PORT


          The port must have been created with the CREATE PORT
          command.

          The default port type is /APPLICATION.

          /DEDICATED
          Specifies that a logical port on your local VMS node
          is dedicated to an application service. The /DEDICATED
          qualifier requires the /SERVICE qualifier.

          To set up an application service for a logical port on
          a LAT service node:

          1  Create the service (CREATE SERVICE/APPLICATION)
             and define the dedicated port (CREATE PORT
             /DEDICATED). You can include these commands in
             LAT$SYSTARTUP.COM.

          2  Start the application program. Within the program,
             allocate dedicated ports with the same name as
             those defined in LAT$SYSTARTUP.COM.

          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the port's characteristics were modified. The
          default is /NOLOG.

          /NODE=remote-node-name
          Specifies the name of a terminal server (or a remote
          VMS node that supports outgoing connections) to be
          logically associated with the specified application
          port on your VMS node. The server supports a remote
          device. Note that you can set up an application port
          on your local VMS node and associate the port with
          a dedicated port on a remote LAT service node. The
          remote port is dedicated to an application service.

          /PORT=remote-port-name
          Specifies the name of the remote port on a terminal
          server that supports a remote device, or specifies the
          name of a remote port dedicated to a special service

                                                           LAT-59

 


          LATCP
          SET PORT


          on a remote LAT service node. In either case, the
          remote port is logically associated with the specified
          application port on your local VMS node.

          /QUEUED
          /NOQUEUED
          Specifies queued or nonqueued access to the server
          port. The default is /QUEUED.

          A queued or nonqueued request is accepted by a
          terminal server if a remote port is free. If the
          remote port is busy and queuing is enabled on the
          terminal server, then the server queues the remote
          request. If you do not want your remote requests to be
          queued on the server, specify /NOQUEUED.

          /SERVICE=service-name
          Specifies either of the following:

          o  The name of the remote service offered at a
             terminal server port that will be associated with
             the specified application port (/APPLICATION) on
             the local node

          o  A service name for an application program being
             offered on a dedicated port (/DEDICATED) on a LAT
             service node

          To specify the name of a remote service offered
          at a terminal server port, use the /NODE and the
          /SERVICE qualifiers. To specify a particular port
          for a service, use the /NODE, /PORT, and /SERVICE
          qualifiers. Ask the terminal server manager for these
          names.

          To name a service for a particular application program
          to be offered locally on a dedicated port, use the
          /DEDICATED and the /SERVICE qualifiers. The service
          must have been created with the CREATE SERVICE
          command. Assign only one service to a dedicated port.
          Several ports can have the same service assigned.

          LAT-60

 


                                                            LATCP
                                                         SET PORT

          _______________________________________________________

          DESCRIPTION
          The SET PORT command associates an application port on
          your local VMS node to a port or service on a terminal
          server. When you associate an application port with a
          service on a terminal server, you allow access to any
          of the ports (printers) represented by that service.
          See Example 1 and Example 2. The application port must
          have been created with the CREATE PORT/APPLICATION
          command.

          The SET PORT command also can associate a dedicated
          port on the local node to an application service
          offered locally. The service must already exist. See
          Example 3. Use the /DEDICATED and /SERVICE qualifiers
          with the SET PORT command.

          The SET PORT command also can associate an application
          port on your local VMS node to an application service
          associated with one or more dedicated ports on a
          remote LAT service node. This service is offered to
          users on terminal servers or on VMS nodes that support
          outgoing connections. See Example 4. The dedicated
          port must have been created with the CREATE PORT
          /DEDICATED command.

          _______________________________________________________

          SeeMtheSexamples for the SHOW PORT command for

          displays that reflect the changes made by the
          following SET PORT command examples.

          1   LATCP> SET PORT LTA22: /APPLICATION /NODE=TS33EW /PORT=LN02

          The SET PORT command in this example sets up port
          LTA22: as an application port to be associated with
          the port named LN02 on the terminal server named
          TS33EW. This command associates port LTA22: with a
          specific printer on the server. In the next example,
          the SET PORT command associates a port with a set of

                                                           LAT-61

 


          LATCP
          SET PORT


          printers (designated by the service name PRINTER) on a
          terminal server.


          2   LATCP> SET PORT LTA19: /APPLICATION /NODE=TLAT1 /SERVICE=PRINTER /QUEUED

          The SET PORT command in this example shows how to
          associate a local logical port with a service (several
          printers) on a terminal server. The command associates
          the application port LTA19: with the service PRINTER
          on terminal server TLAT1. The service PRINTER can
          be associated with one or more ports on TLAT1. The
          /QUEUED qualifier specifies that the server offering
          the service PRINTER can queue the remote connection
          request if all ports offering the service are in use.
          See the description of print operations in the Guide
          to Maintaining a VMS System for information on setting
          up print queues.

          3   LATCP> SET PORT LTA21: /DEDICATED /SERVICE=GRAPHICS

          The SET PORT command in this example specifies
          that the application port LTA21: on the local VMS
          service node offers the service GRAPHICS to users
          on terminal servers or on VMS nodes that support
          outgoing connections. GRAPHICS is a particular utility
          or application program.

          4   LATCP> SET PORT MAIL_PORT /SERVICE=MAIL/NODE=BIGVMS

          The SET PORT command in this example associates
          the port whose logical name is MAIL_PORT with the
          dedicated service MAIL on remote node BIGVMS. The
          port logically named MAIL_PORT was created with the
          CREATE PORT command (see Example 3 in the discussion
          of the CREATE PORT command). The logical port could
          also have been created with a VMS DCL ASSIGN or DEFINE
          command. On node BIGVMS, a port must be dedicated
          to the service MAIL by using the SET PORT port-name
          /DEDICATED/SERVICE=MAIL command.

          LAT-62

 


                                                            LATCP
                                                      SET SERVICE


          _______________________________________________________

          SET SERVICE

          Dynamically changes the characteristics of a locally
          offered service. You must have OPER privilege to use
          this command.

          _______________________________________________________

          FORMAT

          SET SERVICE  [service-name]

          _______________________________________________________

          PARAMETER
          service-name
          Specifies the service whose characteristics are to be
          modified. If a service name is omitted, the default
          service name is the name of the local node you defined
          using the SET NODE command.

          _______________________________________________________

          QUALIFIERS
          /APPLICATION
          Sets up the service as an application service. An
          application service offers a specific application
          on the service node rather than all of the resources
          on the service node. Define a dedicated port for the
          service, using the CREATE PORT and SET PORT commands.

          /IDENTIFICATION[="identification-string"]
          Describes and identifies a VMS service. Service
          nodes include the identification string in service
          announcements. A VMS service node announces its
          services at regular intervals established with the
          SET NODE command. The LATCP SHOW NODE and server SHOW
          NODE displays include this identification string.

                                                           LAT-63

 


          LATCP
          SET SERVICE


          By default, the identification string is the
          translation of SYS$ANNOUNCE. A VMS service node
          announces its services at regular intervals
          established with the SET NODE command.

          An identification string can have up to 64 ASCII
          characters. Enclose the string in quotation marks.

          /LOG
          /NOLOG
          Specifies whether or not to display a message
          confirming that the command was executed. The default
          is /NOLOG.

          /STATIC_RATING=rating
          /NOSTATIC_RATING
          Enables or disables dynamic service ratings. The
          default is /NOSTATIC_RATING. A dynamic service rating
          means that a LAT algorithm calculates the availability
          of a service dynamically, based on the overall level
          of activity of the node that offers the service,
          the amount of memory, and the processor type. When
          a terminal server or VMS node requests a connection
          to a service that is offered on two or more service
          nodes, the requesting node selects the service node
          with the highest (most favorable) service rating. This
          selection process is called load balancing.

          When you use the /STATIC_RATING qualifier, you disable
          dynamic service ratings so that you can specify a
          static rating. Use the static rating to direct users
          away from or toward your node temporarily. Static
          ratings range from 0 to 255. Specify a low value to
          make your node less likely to be used; specify a high
          value to make the node more likely to be used.






          LAT-64

 


                                                            LATCP
                                                      SET SERVICE

          _______________________________________________________

          DESCRIPTION
          The SET SERVICE command dynamically changes the
          characteristics of a service that you created with
          the CREATE SERVICE command.

          _______________________________________________________

          EXAMPLE

          LATCP> SET SERVICE SALES /IDENT="SALES FORCE TIMESHARING SERVICES"

          The SET SERVICE command in this example specifies a
          new identification string "SALES FORCE TIMESHARING
          SERVICES" for the service SALES. This string is
          announced with the service SALES in the multicast
          messages sent by a VMS service node.
























                                                           LAT-65

 


          LATCP
          SHOW LINK


          _______________________________________________________

          SHOW LINK

          Displays the status and LAT characteristics of links
          on the local VMS node.

          _______________________________________________________

          FORMAT

          SHOW LINK  [link-name]

          _______________________________________________________

          PARAMETER
          link-name
          Specifies the name for an Ethernet link. A link name
          may have up to 16 ASCII characters.

          If you do not specify a link name, LATCP displays
          information about all links currently defined for the
          VMS node.

          _______________________________________________________

          QUALIFIERS
          /BRIEF
          Displays the device name and state of the link. This
          is the default display.

          /COUNTERS
          Displays the device counters kept for the link. Do
          not use the /BRIEF or /FULL qualifiers with this
          qualifier. The following table lists and describes
          the counters:





          LAT-66

 


                                                            LATCP
                                                        SHOW LINK

          _______________________________________________________
          Counter_________________________Description____________

          Messages received               The total number of
                                          messages received over
                                          the link.

          Multicast messages received     The total number of
                                          multicast messages
                                          received over the
                                          link.

          Bytes received                  The total number of
                                          bytes of information
                                          received.

          Multicast bytes received        The total number
                                          of multicast bytes
                                          received.

          Receive errors                  The total number of
                                          errors occuring while
                                          receiving messages.

          Data overrun                    The total number of
                                          bytes lost on the
                                          link's device because
                                          the local node's
                                          input buffers were
                                          full. A nonzero value
                                          might indicate noisy
                                          lines, a bad device, a
                                          busy or poorly tuned
                                          system (not enough
                                          resources allocated),
                                          or a hardware problem
                                          with another device on
                                          the Ethernet.




                                                           LAT-67

 


          LATCP
          SHOW LINK

          _______________________________________________________
          Counter_________________________Description____________

          User buffer unavailable         The total number of
                                          times the system was
                                          unable to allocate a
                                          buffer in the user's
                                          process space.

          System buffer unavailable       The total number of
                                          times the system was
                                          unable to allocate a
                                          buffer in the system
                                          space.

          Local buffer errors             The total number of
                                          times the local node
                                          did not have a system
                                          buffer available for
                                          the network device
                                          to copy an Ethernet
                                          message into.

                                          A nonzero value
                                          might indicate that
                                          the local node has
                                          too many system
                                          buffers dedicated
                                          to maintaining a large
                                          number of virtual
                                          circuits, sessions,
                                          or queued connections
                                          and not enough for
                                          heavy network traffic
                                          situations.







          LAT-68

 


                                                            LATCP
                                                        SHOW LINK

          _______________________________________________________
          Counter_________________________Description____________

          Transmit CDC failures           The total number of
                                          carrier detect check
                                          errors; that is, the
                                          number of times the
                                          local node failed to
                                          detect that another
                                          Ethernet station was
                                          already transmitting
                                          when the local node
                                          began transmitting.

          Messages sent                   The total number of
                                          messages sent over
                                          the link since the
                                          counters were last
                                          reset.

          Multicast messages sent         The total number of
                                          multicast messages
                                          sent.

          Bytes sent                      The total number of
                                          bytes of information
                                          sent.

          Multicast bytes sent            The total number of
                                          bytes of multicast
                                          message sent.











                                                           LAT-69

 


          LATCP
          SHOW LINK

          _______________________________________________________
          Counter_________________________Description____________

          Transmit errors                 The total number of
                                          times the link device
                                          attempted to transmit
                                          data and encountered
                                          an error while trying
                                          to access the part
                                          of the local node's
                                          memory that contains
                                          the data.

          Messages transmitted:           The total number of
          - single collision              single and multiple
          - multiple collision            collisions occurring
          - initially deferred            during transmission,
                                          and the number of
                                          messages initially
                                          deferred during
          ________________________________transmission.__________


          /FULL
          Displays the device name, state, and datalink address
          of the link and indicates whether the DECnet address
          is enabled.

          _______________________________________________________

          DESCRIPTION
          This command displays information about the specified
          link or all links if you do not specify a link.
          Depending on the qualifier you use with the SHOW LINK
          command, you can display a link's device name, state,
          datalink address, DECnet address or counters.






          LAT-70

 


                                                            LATCP
                                                        SHOW LINK


          _______________________________________________________

          EXAMPLES

          1   LATCP> SHOW LINK/FULL NETWORK_A

          The SHOW LINK command in this example produces the
          following display of information about link NETWORK_A:

                   Link Name:     NETWORK_A               Datalink Address:  08-00-2B-10-12-E3
                   Device Name:   _ESA7:                  DECnet Address:    Disabled
                   Link State:    On

          The display in this example gives the device name of
          link NETWORK_A and the device's hardware address. The
          link is in the On state.


          2   LATCP> SHOW LINK LINK_A/COUNTERS

          The SHOW LINK command in this example produces the
          following display of counters for link LINK_A:

                   Link Name:    LINK_A
                   Device Name:  _ETA6:

                   Seconds Since Zeroed:             6724
                   Messages Received:              184099     Messages Sent:               79922
                   Multicast Msgs Received:        106320     Multicast Msgs Sent:          2975
                   Bytes Received:               41485109     Bytes Sent:                9552010
                   Multicast Bytes Received:     10470760     Multicast Bytes Sent:       246635
                   Receive Errors:                      0     Transmit Errors:                 0
                   Data Overrun:                        0
                   User Buffer Unavailable:             0     Messages Transmitted -
                   System Buffer Unavailable:          19       Single Collision:           1011
                   Local Buffer Errors:                 0       Multiple Collisions:        1510
                   Transmit CDC Failure:                0       Initially Deferred:         4106




                                                           LAT-71

 


          LATCP
          SHOW NODE


          _______________________________________________________

          SHOW NODE

          Displays the status and LAT characteristics of a VMS
          node.

          _______________________________________________________

          FORMAT

          SHOW NODE  [node-name]

          _______________________________________________________

          PARAMETER
          node-name
          Specifies the name of the node for which information
          is displayed. If you do not specify a node name, LATCP
          displays information about the local node.

          _______________________________________________________

          QUALIFIERS
          /ALL
          Displays information about all nodes known to your
          local node. Use the /FULL or /BRIEF qualifier. The
          /BRIEF qualifier is the default.

          /BRIEF
          Displays the node status and identification string.
          This is the default if you specify the /ALL qualifier.

          /COUNTERS
          Displays the counters kept for the node. Do not use
          the /BRIEF or /FULL qualifier with this qualifier.
          The following table lists and describes the counters
          displayed with SHOW NODE/COUNTERS.



          LAT-72

 


                                                            LATCP
                                                        SHOW NODE


          Table_LAT-2__LAT_Node_Counters_________________________

          Counter_____________________Description________________

          Messages received           The total number of LAT
                                      messages successfully
                                      received by the local
                                      node. If you specified a
                                      remote node with the SHOW
                                      NODE command, the number
                                      of messages received from
                                      that remote node.

          Multicast messages          The total number of
          received                    multicast messages
                                      received by the local
                                      node.

          Messages transmitted        The total number of LAT
                                      messages successfully
                                      transmitted by the local
                                      node. If you specified a
                                      remote node with the SHOW
                                      NODE command, the number
                                      of messages transmitted to
                                      the specified remote node.

          Multicast messages          The total number of
          transmitted                 multicast messages
                                      transmitted by the local
                                      node.
          _______________________________________________________
                                         (continued on next page)








                                                           LAT-73

 


          LATCP
          SHOW NODE


          Table_LAT-2_(Cont.)__LAT_Node_Counters_________________

          Counter_____________________Description________________

          Slots received              The total number of
                                      LAT slots received
                                      by the local node. If
                                      you specified a remote
                                      node with the SHOW NODE
                                      command, the number of
                                      slots received from that
                                      remote node. A slot is a
                                      message segment containing
                                      information corresponding
                                      to a single session.

          Slots transmitted           The total number of
                                      LAT slots successfully
                                      transmitted by the local
                                      node. If you specified a
                                      remote node with the SHOW
                                      NODE command, the number
                                      of slots transmitted to
                                      the specified remote node.

          Bytes received              The total number of bytes
                                      received by the local
                                      node. If you specified a
                                      remote node with the SHOW
                                      NODE command, the number
                                      of bytes transmitted to
                                      the specified remote node.
          _______________________________________________________
                                         (continued on next page)







          LAT-74

 


                                                            LATCP
                                                        SHOW NODE


          Table_LAT-2_(Cont.)__LAT_Node_Counters_________________

          Counter_____________________Description________________

          Multicast bytes received    The total number of
                                      multicast bytes received
                                      by the local node.

          Bytes transmitted           The total number of bytes
                                      transmitted by the local
                                      node. If you specified a
                                      remote node with the SHOW
                                      NODE command, the number
                                      of bytes transmitted to
                                      the specified remote node.

          Multicast bytes             The total number
          transmitted                 of multicast bytes
                                      transmitted by the local
                                      node.

          Resource Errors             The number of times memory
                                      was unavailable to perform
                                      an operation. This counter
                                      will be incremented if the
                                      local node is listening
                                      to multicast messages but
                                      does not have enough room
                                      to cache the information
                                      in a multicast message.

          No transmit buffer          The total number of times
                                      no buffer was available
                                      on the local node for
                                      transmission.
          _______________________________________________________
                                         (continued on next page)




                                                           LAT-75

 


          LATCP
          SHOW NODE


          Table_LAT-2_(Cont.)__LAT_Node_Counters_________________

          Counter_____________________Description________________

          Multiple node addresses     The total number of times
                                      that a node announced
                                      itself with a physical
                                      address different from
                                      that in a previous
                                      announcement.

          Duplicates received         The total number of
                                      duplicate messages that
                                      are received by the local
                                      node. If you specify a
                                      remote node with the
                                      SHOW NODE command, this
                                      counter indicates the
                                      number of duplicate
                                      messages received from
                                      that remote node. This
                                      counter can indicate a
                                      system slowdown.
          _______________________________________________________
                                         (continued on next page)
















          LAT-76

 


                                                            LATCP
                                                        SHOW NODE


          Table_LAT-2_(Cont.)__LAT_Node_Counters_________________

          Counter_____________________Description________________

          Messages retransmitted      The total number of LAT
                                      messages that the local
                                      node retransmitted because
                                      they were not acknowledged
                                      by terminal servers (or
                                      VMS nodes that support
                                      outgoing connections).
                                      If you specify a remote
                                      node with the SHOW NODE
                                      command, this counter
                                      indicates the number of
                                      messages retransmitted to
                                      that remote node.

          Illegal messages received   The total number of
                                      invalidly formatted
                                      messages that the local
                                      node received. If you
                                      specified a remote node,
                                      the number of invalidly
                                      formatted messages that
                                      the local node received
                                      from that remote node.
                                      Illegal messages are
                                      grouped into several types
                                      of protocol errors, which
                                      are listed at the end of
                                      this table.
          _______________________________________________________
                                         (continued on next page)







                                                           LAT-77

 


          LATCP
          SHOW NODE


          Table_LAT-2_(Cont.)__LAT_Node_Counters_________________

          Counter_____________________Description________________

          Illegal slots received      The total number of LAT
                                      slots that the local node
                                      received. If you specified
                                      a remote node, the number
                                      of slots that the local
                                      node received from that
                                      remote node.

          Solicitations accepted      The total number of
                                      times the local node has
                                      accepted solicitations
                                      from other nodes. If you
                                      specify a remote node with
                                      the SHOW NODE command,
                                      this counter indicates
                                      the number of times the
                                      local node has accepted
                                      solicitations from that
                                      remote node.

          Solicitations rejected      The total number of
                                      times the local node has
                                      rejected soliciations
                                      from other nodes. If you
                                      specify a remote node with
                                      the SHOW NODE command,
                                      this counter indicates
                                      the number of times the
                                      local node has rejected
                                      solicitations from that
                                      remote node.
          _______________________________________________________
                                         (continued on next page)




          LAT-78

 


                                                            LATCP
                                                        SHOW NODE


          Table_LAT-2_(Cont.)__LAT_Node_Counters_________________

          Counter_____________________Description________________

          Virtual circuit timeouts    The total number of times
                                      a circuit to a another
                                      node timed out, indicating
                                      that the remote node
                                      failed to send a valid
                                      message in the required
                                      time span. If you specify
                                      a remote node with the
                                      SHOW NODE command, this
                                      counter indicates the
                                      number of times the
                                      local node timed out a
                                      connection to that remote
                                      node.

          Discarded output bytes      The total number of data
                                      bytes that were discarded
                                      because of an overflow of
                                      an internal buffer before
                                      the data could be output
          ____________________________to_an_LT_device.___________


          The protocol errors that are counted as illegal
          messages are as follows. These protocol error messages
          are displayed if their associated counter is greater
          than zero.

          o  Invalid message type received

          o  Invalid start message received

          o  Invalid sequence number received in start message

          o  Zero node index received

          o  Node circuit index out of range

          o  Node circuit sequence invalid

                                                           LAT-79

 


          LATCP
          SHOW NODE


          o  Node circuit index no longer valid

          o  Circuit was forced to halt

          o  Invalid server slot index

          o  Invalid node slot index

          o  Invalid credit field or too many credits used

          o  Repeat create of slot by server

          o  Repeat disconnect of slot by server

          /FULL
          Displays the node's status, identification string, LAT
          protocol version, DECnet address, and the values of
          the node's characteristics. This is the default except
          when you specify the /ALL qualifier.

          _______________________________________________________

          DESCRIPTION
          This command displays information about a specified
          node or, if you do not specify a node name, about your
          local node. With the /ALL qualifier, the SHOW NODE
          command displays information about all nodes known
          to your local node. Depending on the qualifiers you
          use, you can display node counters, node status,
          the node identification string, the LAT protocol
          version on the node, and the values set for the node's
          characteristics.

          _______________________________________________________

          EXAMPLES

          1   LATCP> SHOW NODE/FULL

          The SHOW NODE command in this example produces the
          following display of information about the local node:

          LAT-80

 


                                                            LATCP
                                                        SHOW NODE




                   Node Name:   LTC                            LAT Protocol Version:      5.2
                   Node State:  On
                   Node Ident:  LTC - Engineering Development

                   Incoming Connections:  Enabled              Incoming Session Limit:   None
                   Outgoing Connections:  Enabled              Outgoing Session Limit:   None
                   Service Responder:     Disabled

                   Circuit Timer (msec):        80             Keepalive Timer (sec):      20
                   Retransmit Limit (msg):      20             Node Limit (nodes):       None
                   Multicast Timer (sec):       20             CPU Rating:                  8

                   User Groups:     43, 73
                   Service Groups:  7-9, 13, 23, 40, 43, 45, 66, 72-73, 89, 120-127, 248-255

                   Service Name     Status      Rating  Identification
                   LTVMS            Available     31 D  .

          This display indicates that the local node LTC is
          in the On state, which means LAT connections can be
          created on the node. LTC is running Version 5.4-1 of
          the LAT protocol. The identification of the node is
          "LTC - Engineering Development." Because this is the
          local node, the display does not give the address of
          an Ethernet device. Use the SHOW LINK command to find
          addresses of devices on the local node. The display
          for the status of remote nodes, as shown in Example 2,
          gives the Ethernet address of that node.

          Both incoming and outgoing connections can be made
          on node LTC, and there is no limit on the number of
          sessions. The display indicates the values of various
          timers and lists the groups that are enabled. Users
          on the local node can access service nodes belonging
          to user groups 43 and 73. Locally offered services can
          be accessed by nodes belonging to the service groups
          listed.


                                                           LAT-81

 


          LATCP
          SHOW NODE


          The display indicates that the CPU rating of the local
          node is 8. The display shows that the node offers a
          service named LTVMS. This service is available and its
          rating is 31 D (dynamic). (An "S" would indicate the
          rating is static.)



          2   LATCP> SHOW NODE/FULL RWWUP

          The SHOW NODE command in this example produces the
          following display about the remote node RWWUP:

                   Node Name:   RWWUP                          LAT Protocol Version:      5.2
                   Node State:  Reachable                      Address:     AA-00-04-00-11-10
                   Node Ident:  .

                   Incoming Connections:  Enabled

                   Circuit Timer (msec):        80
                   Multicast Timer (sec):       20

                   Service Groups:  7, 13, 42-43, 45, 66, 70-72, 75-82, 88-89

                   Service Name     Status      Rating  Identification
                   NAC              Available     28    .
                   SYSMGR           Available     28    .

          This display indicates that remote node RWWUP is
          reachable and runs version 5.4-1 of the LAT protocol.
          The display includes the Ethernet address of node
          RWWUP. Because incoming connections are enabled, you
          can connect to a service on node RWWUP, provided that
          your node belongs to one of the service groups listed
          in the display.

          Node RWWUP offers two services: NAC and SYSMGR. Both
          are available.



          LAT-82

 


                                                            LATCP
                                                        SHOW NODE



          3   LATCP> SHOW NODE/ALL/BRIEF

          The SHOW NODE command in this example produces the
          following display about all nodes known to the local
          node:


                   Node Name            Status       Identification
                   ----------------     -----------  ----------------------------------------------
                   ABLAN                Reachable     Unauthorized access is prohibited.
                   ASKWEN               Reachable     .
                   CHUNK                Reachable     A member of the MAIN VAXcluster
                             .
                             .
                             .
                   UTOO                 On            Can be healthy at the Center
                   VULCUN               Reachable     Beam me up
                   ZENX                 Reachable     ZENX

          The SHOW NODE command in this example indicates the
          status (reachability) and identification of all nodes
          known to the local node. Notice that the display
          includes the status of the local node, UTOO. The
          status can be either On, Off, or Shut. Here it is On.
















                                                           LAT-83

 


          LATCP
          SHOW PORT


          _______________________________________________________

          SHOW PORT

          Displays the status and LAT characteristics of ports
          on the local VMS node.

          _______________________________________________________

          FORMAT

          SHOW PORT  [port-name]

          _______________________________________________________

          PARAMETER
          port-name
          Specifies the name of the port for which information
          is displayed. If you do not specify a port name, the
          SHOW PORT command displays the characteristics for all
          LTAn: ports on a node.

          Do not use the /APPLICATION, /DEDICATED, /FORWARD, or
          /INTERACTIVE qualifiers with a specific port name.

          _______________________________________________________

          QUALIFIERS
          /APPLICATION
          Generates a display of all application ports.

          /BRIEF
          This displays port type, port status, and the remote
          node name, port, and service associated with the port.
          This is the default if you do not specify a port name
          with the SHOW PORT command.

          /DEDICATED
          Generates a display of all dedicated ports.


          LAT-84

 


                                                            LATCP
                                                        SHOW PORT


          /FORWARD
          Generates a display of all LAT ports used for either
          outgoing LAT connections or local LAT management
          functions.

          /FULL
          This displays the following information. For more
          details, see the discussion for the sample display in
          Example 1 given with the SHOW PORT command.

          o  Port type

          o  Port status

          o  Target port name, node name, and service name
             associated with the port

          o  Remote node name, port, and service associated with
             the port if a connection is currently active

          /INTERACTIVE
          Generates a display of all LAT ports used for incoming
          interactive connections.

          _______________________________________________________

          DESCRIPTION
          If a port is an application port, the display lists
          the remote node name, remote port name, and remote
          service name that you specified in the SET PORT
          command.

          If the port is a dedicated port, the display lists
          the service name that you specified in the SET PORT
          command.

          If LATCP shows the port as "Interactive" in the
          display, a user on a terminal server or on a VMS node
          that supports outgoing LAT connections is currently
          using the port.

          For all ports with active sessions, the remote node
          sends its node name and port name to your local node.
          These names are listed in the display.

                                                           LAT-85

 


          LATCP
          SHOW PORT


          _______________________________________________________

          EXAMPLE

          LATCP> SHOW PORT /FULL

          The SHOW PORT command in this example produces the
          following type of display. The display reflects the
          characteristics set by the command examples given with
          the SET PORT command.

                   Local Port Name:   _LTA16:           Local Port Type:  Forward
                   Local Port State:  Inactive
                   Connected Link:

                    Target Port Name:                      Actual Port Name:
                    Target Node Name:     LATCP$MGMT_PORT  Actual Node Name:
                    Target Service Name:                   Actual Service Name:

                   --------------------------------------------------------------------------------

                   Local Port Name:   _LTA17:           Local Port Type:  Interactive
                   Local Port State:  Active
                   Connected Link:    LAT$LINK

                    Target Port Name:                      Actual Port Name:     PORT_1
                    Target Node Name:                      Actual Node Name:     MY_DS200_SERVER
                    Target Service Name:                   Actual Service Name:

                   --------------------------------------------------------------------------------

                   Local Port Name:   _LTA19:           Local Port Type:  Application (Queued)
                   Local Port State:  Active
                   Connected Link:    LAT$LINK

                    Target Port Name:                      Actual Port Name:
                    Target Node Name:     TLAT1            Actual Node Name:     TLAT1
                    Target Service Name:  PRINTER          Actual Service Name:  PRINTER

                   --------------------------------------------------------------------------------

                   Local Port Name:   _LTA21:           Local Port Type:  Dedicated
                   Local Port State:  Inactive
                   Connected Link:

          LAT-86

 


                                                            LATCP
                                                        SHOW PORT


                    Target Port Name:                      Actual Port Name:
                    Target Node Name:                      Actual Node Name:
                    Target Service Name:  GRAPHICS         Actual Service Name:

                   --------------------------------------------------------------------------------

                   Local Port Name:   _LTA22:           Local Port Type:  Application (Queued)
                   Local Port State:  Active
                   Connected Link:    LAT$LINK

                    Target Port Name:     LN02             Actual Port Name:     LN02
                    Target Node Name:     TS33EW           Actual Node Name:     TS33EW
                    Target Service Name:                   Actual Service Name:

                   --------------------------------------------------------------------------------

          The display in this example shows information about
          all the ports on the local node. There are four types
          of ports. The display shows information for each of
          these types.

          1  Forward: a port used for outgoing LAT connections
             or for executing local management functions and
             LATCP commands. Port LTA16: is a forward port. The
             display shows that the port is currently inactive,
             that is, there is no current LAT connection. The
             target node name of LATCP$MGMT_PORT indicates
             that LATCP is using this port to execute the LATCP
             commands entered by the user. If the display listed
             a node and service name, it would mean that the
             port is being used for an outgoing connection.

          2  Interactive: a port created as a result of an
             incoming LAT connection request from another node
             or terminal server. Port LTA17: is an interactive
             port connected with port PORT_1 on the terminal
             server MY_DS200_SERVER.

          3  Application: a port used for solicited connections
             to devices on terminal servers or to application
             services on remote LAT service nodes. Port LTA22:
             is an application port. The port maps to port LN02
             (a printer) on a terminal server node TS33EW.
             The display indicates that server TS33EW queues

                                                           LAT-87

 


          LATCP
          SHOW PORT


             connection requests from the local node. Port
             LAT19: also is an application port. The port maps
             to the service PRINTER on terminal server TLAT1.

          4  Dedicated: a port dedicated to a local application
             service. Port LTA21: is dedicated to the service
             GRAPHICS.

          The target port name, target node name, and target
          service name are the names specified with the SET
          PORT command. They are passed to the remote node or
          terminal server when the connection request is made.

          The actual port name, actual node name, and actual
          service name are the names returned by the remote
          node when it accepts the the connection request.
          They may differ from the corresponding target names
          (specified with the SET PORT command) if the remote
          node translates the names. For example, terminal
          servers that accept connections to LAT service names
          usually return the name of the port to which the
          connection was actually directed.



















          LAT-88

 


                                                            LATCP
                                                     SHOW SERVICE


          _______________________________________________________

          SHOW SERVICE

          Displays the status and LAT characteristics of LAT
          services known to the local VMS node.

          _______________________________________________________

          FORMAT

          SHOW SERVICE  [service-name]

          _______________________________________________________

          PARAMETERS
          service-name
          Specifies the name of the service for which
          information will be displayed. If you do not specify
          a service name, LATCP displays information about all
          services known to the VMS node.

          _______________________________________________________

          QUALIFIERS
          /BRIEF
          Displays the status and identification string of the
          service.

          /COUNTERS
          Displays the counters kept for the service. Do not use
          the /BRIEF or /FULL qualifiers with this qualifier.
          The following table lists and describes the counters:








                                                           LAT-89

 


          LATCP
          SHOW SERVICE

          _______________________________________________________
          Counter___________________Description__________________

          Remote_Counters________________________________________

          Connections Attempted     The total number of times
                                    the local node attempted
                                    to connect to the service
                                    offered on a remote node.

          Connections Completed     The total number of times
                                    the local node successfully
                                    connected to the service
                                    offered on a remote node.

          _______________________________________________________

          Local_Counters_________________________________________

          Connections Accepted      The total number of times
                                    the local node accepted a
                                    connection request from a
                                    remote node to a locally
                                    offered service.

          Connections Rejected      The total number of times
                                    the local node rejected a
                                    connection request from a
                                    remote node to a locally
          __________________________offered_service._____________

          /FULL
          Displays the status, identification string, and
          type of service, and the values set for service
          characteristics. This qualifier also displays the
          status of all service nodes offering the service.

          /LOCAL
          Displays information about services offered by the
          local VMS node only. You can use this qualifier with
          the /BRIEF, /COUNTERS, or /FULL qualifier.

          LAT-90

 


                                                            LATCP
                                                     SHOW SERVICE

          _______________________________________________________

          DESCRIPTION
          This command displays information about services.
          If you do not specify a service name, the command
          displays information about all services known to your
          local node. If you do not specify a service name but
          specify the /LOCAL qualifier, the command displays
          information about all services offered by your local
          node.

          Depending on whether you use the /BRIEF, /COUNTERS,
          or /FULL qualifier, you can display the status,
          identification string, and type of service, the status
          of all service nodes offering the service, the values
          set for service characteristics, and service counters.

          _______________________________________________________

          EXAMPLES

          1   LATCP> SHOW SERVICE HOMEWK/FULL

          The SHOW SERVICE command in this example produces the
          following display of information about service HOMEWK.
          This service is offered by the local node.

                   Service Name:    HOMEWK                   Service Type:  General
                   Service Status:  Available
                   Service Ident:   .

                   Node Name            Status      Rating   Identification
                   LAV                  On            31 D   .
                   LATP                 Reachable     48     .
                   LITTN                Reachable     37     .
                   LTDRV                Reachable     82     .

          The display in this example indicates that the
          locally offered service HOMEWK is available and its
          service type is General, meaning that it is a general
          timesharing service (in contrast to a dedicated
          application service). The display also lists the
          status of all the nodes that offer the service. The

                                                           LAT-91

 


          LATCP
          SHOW SERVICE


          local node is LAV. The status of the local node can
          be either On, Off, or Shut. Here node LAV's status is
          On. The status of the other nodes indicates whether
          they are reachable. The display lists the ratings of
          each service node, indicating their relative capacity
          to accept new connections. The "D" next to the locally
          offered service indicates that node LAV computes its
          rating dynamically. An "S" would indicate that the
          node's rating was set permanently by the node's system
          manager.



          2   LATCP> SHOW SERVICE OFFICE/FULL

          The SHOW SERVICE command in this example produces the
          following display of information about the service
          OFFICE, which is offered by a remote node:

                   Service Name:    OFFICE
                   Service Status:  Available
                   Service Ident:   .

                   Node Name            Status      Rating   Identification
                   BURGIL               Reachable    121     .
                   DARWIN               Reachable     43     .

          The display in this example indicates that the service
          is available. The display indicates the status and
          other information about the nodes that offer the
          service, nodes BURGIL and DARWIN.










          LAT-92

 


                                                            LATCP
                                                            SPAWN


          _______________________________________________________

          SPAWN

          Creates a subprocess, enabling you to execute DCL
          commands without terminating your LATCP session.
          The LATCP SPAWN command is similar to the DCL SPAWN
          command.

          To return to your LATCP session, either logout of the
          subprocess by entering the DCL LOGOUT command, or use
          the DCL ATTACH command to attach your terminal to the
          process running LATCP.

          _______________________________________________________

          FORMAT

          SPAWN  [DCL-command]

          _______________________________________________________

          PARAMETER
          DCL-command
          Specifies a DCL command. If you specify a DCL command,
          LATCP executes the command in a subprocess. Control
          returns to LATCP when the DCL command terminates.

          If you do not specify a DCL command, LATCP creates a
          subprocess and you can then enter DCL commands. You
          can continue your LATCP session by logging out of
          the spawned subprocess or by attaching to the parent
          process with the DCL ATTACH command.

          _______________________________________________________

          DESCRIPTION
          The SPAWN command acts exactly like the DCL SPAWN
          command. You can enter DCL commands (such as to create
          print queues, change the protection of a device,
          answer mail, and so forth) without ending your LATCP
          session.

                                                           LAT-93

 


          LATCP
          SPAWN


          You can not use this command to gain access to DCL if
          you are running LATCP from a captive account.

          _______________________________________________________

          EXAMPLE

          LATCP> SPAWN
          $

          The SPAWN command in this example creates a subprocess
          at DCL level. You can now enter DCL commands. Log out
          or enter the DCL ATTACH command to return to the LATCP
          prompt.



























          LAT-94

 


                                                            LATCP
                                                    ZERO COUNTERS


          _______________________________________________________

          ZERO COUNTERS

          Resets the link, node, and service counters maintained
          by the local VMS node. You must have OPER privilege to
          use this command.

          _______________________________________________________

          FORMAT

          ZERO COUNTERS

          _______________________________________________________

          COMMAND QUALIFIERS
          /LOG
          /NOLOG
          Specifies whether LATCP displays a message confirming
          that the counters were reset. The default is /NOLOG.

          /LINK[=link-name]
          Specifies the link (on your local node) for which
          you want counters reset. If you do not specify a link
          name, LATCP zeros counters for the link LAT$LINK.

          /NODE[=node-name]
          Specifies the node for which you want counters reset.
          If you do not specify a node name, LATCP zeros the
          counters for your local node.

          /SERVICE=service-name
          Specifies the service (on your local node) for which
          you want counters reset.

          _______________________________________________________

          DESCRIPTION
          This command resets counters. You can specify whether
          you want to reset link, node, or service counters. You
          must specify either /LINK, /NODE, or /SERVICE.

                                                           LAT-95

 


          LATCP
          ZERO COUNTERS


          _______________________________________________________

          EXAMPLE

          LATCP> ZERO COUNTERS/SERVICE=LTVM
          LATCP> SHOW SERVICE LTVM /COUNTERS




                   Service Name:  LTVM

                   Seconds Since Zeroed:          9
                   Connections Attempted:         0    Connections Accepted:          0
                   Connections Completed:         0    Connections Rejected:          0

          The ZERO COUNTERS command in this example resets
          the counters kept for service LTVM. The display
          produced by the SHOW SERVICE command shows how the
          ZERO counters command reset the counters to zero.





















          LAT-96

 






          _______________________________________________________

   A      Sample LAT$SYSTARTUP.COM Command Procedures




          LAT$SYSTARTUP.COM contains LATCP commands that define
          your VMS system's LAT characteristics. Section A.2
          shows the LAT$SYSTARTUP.COM procedure supplied by
          Digital.

          Edit LAT$SYSTARTUP.COM to define LAT characteristics
          special for your node. The characteristics take
          effect the next time the command procedure is
          invoked. Section A.3 includes a sample edited
          LAT$SYSTARTUP.COM.

          __________________________________________________________________

   A.1    Invoking LAT$SYSTARTUP.COM

          Invoke LAT$SYSTARTUP.COM by executing the following
          command to invoke the LAT$STARTUP command procedure:

               $ @SYS$STARTUP:LAT$STARTUP

          LAT$STARTUP first invokes LAT$CONFIG.COM, and
          then invokes LAT$SYSTARTUP.COM. LAT$STARTUP.COM
          and LAT$CONFIG.COM are located in the SYS$STARTUP
          directory. LAT$SYSTARTUP.COM is located in the
          SYS$MANAGER directory.

          To make sure the LAT software is started every time
          you reboot your system, add the command to STARTUP_
          Vx.COM.

          Note: Digital recommends that you invoke
          LAT$STARTUP.COM to invoke LAT$SYSTARTUP. Do not invoke
          LAT$SYSTARTUP directly. LAT$CONFIG must be invoked
          before LAT$SYSTARTUP to load the LAT driver and start
          LATACP.

                                                              A-1

 


          Sample LAT$SYSTARTUP.COM Command Procedures
          A.1 Invoking LAT$SYSTARTUP.COM


          When the command to invoke LAT$STARTUP.COM is
          executed, your local VMS system will be set up as
          a LAT service node that supports only interactive
          terminals. A service is created with the same name and
          identification that are used by the service node. You
          can specify a unique service name and identification
          and several other node and service characteristics
          by appending any of the following arguments to the
          @SYS$STARTUP:LAT$STARTUP command:

               $ @SYS$STARTUP:LAT$STARTUP "P1" "P2" "P3" "P4" "P5"

          The arguments P1 through P5 have the following
          meaning:

          _______________________________________________________
          Format___________________Meaning_______________________

          ______________________P1_Argument______________________

          Service-name             Name of the VMS service. For
                                   clustered VMS service nodes,
                                   use the cluster alias as the
                                   service name. For independent
                                   VMS service nodes, use
                                   the DECnet node name.
                                   SYS$STARTUP:LAT$SYSTARTUP.COM
                                   uses the argument P1 to
                                   assign a service name to the
                                   node (with the LATCP CREATE
                                   SERVICE command).

          _______________________________________________________

          _______________P2_through_P4_Arguments[1]______________

          _______________________________________________________
          [1]Any of these qualifiers can be specified.
          SYS$STARTUP:LAT$SYSTARTUP.COM uses the arguments to
          assign LAT node characteristics (with the LATCP SET
          NODE command).

          A-2

 


                       Sample LAT$SYSTARTUP.COM Command Procedures
                                    A.1 Invoking LAT$SYSTARTUP.COM

          _______________________________________________________
          Format___________________Meaning_______________________

          _______________P2_through_P4_Arguments[1]______________

          /IDENTIFICATION="string" Description of the node
                                   and its services that
                                   is advertised over the
                                   Ethernet. The default is
                                   the string defined by the
                                   logical name SYS$ANNOUNCE.
                                   Make sure you include two
                                   sets of quotes around the
                                   identification string as
                                   in the following example:
                                   /IDENTIFICATION=""Official
                                   system center""

          /GROUPS=(ENABLE=group-   Terminal server groups
          list)                    qualified to establish
                                   connections with the VMS
                                   service node. By default,
                                   Group 0 is enabled.

          /GROUPS=(DISABLE=group-  Removes previously enabled
          list)                    terminal server groups.
                                   If you are specifying the
                                   preceding qualifier to enable
                                   groups, you can combine the
                                   qualifiers into one, as shown
                                   in the example that follows
                                   this table.

          _______________________________________________________
          [1]Any of these qualifiers can be specified.
          SYS$STARTUP:LAT$SYSTARTUP.COM uses the arguments to
          assign LAT node characteristics (with the LATCP SET
          NODE command).




                                                              A-3

 


          Sample LAT$SYSTARTUP.COM Command Procedures
          A.1 Invoking LAT$SYSTARTUP.COM

          _______________________________________________________
          Format___________________Meaning_______________________

          _____________________P5_Argument[2]____________________

          _____________________P5_Argument[2]____________________

          Any qualifiers valid     SYS$STARTUP:LAT$SYSTARTUP.COM
          with the CREATE SERVICE  uses this argument to assign
          command.                 service characteristics with
                                   the LATCP CREATE SERVICE
                                   command. You can specify
                                   the /IDENTIFICATION,
                                   /LOG, and /STATIC_RATING
                                   qualifiers. Specify several
                                   qualifiers as shown in
                                   the following example: "
                                   /IDENTIFICATION=""Official
                                   system node""/STATIC_
                                   RATING=250".
          _______________________________________________________
          [2]P5_is_used_only_if_P1_is_specified._________________

          For example, the following command creates the service
          OFFICE on the VMS service node, MOE:

               $ @SYS$STARTUP:LAT$STARTUP OFFICE -
               _$ /GROUPS=(ENABLE=(1,4-9),DISABLE=0)

          If you want to use remote printers on a terminal
          server or to create dedicated application services
          on your VMS node, you must edit LAT$SYSTARTUP.COM.

          Note: Digital advises that you do not edit
          LAT$CONFIG.COM or LAT$STARTUP.COM. Edit
          LAT$SYSTARTUP.COM only.






          A-4

 


                       Sample LAT$SYSTARTUP.COM Command Procedures
                      A.2 LAT$SYSTARTUP.COM As Supplied by Digital

          __________________________________________________________________

   A.2    LAT$SYSTARTUP.COM As Supplied by Digital

          Example A-1 shows the LAT$SYSTARTUP.COM that Digital
          supplies with your VMS software.




































                                                              A-5

 


          Sample LAT$SYSTARTUP.COM Command Procedures
          A.2 LAT$SYSTARTUP.COM As Supplied by Digital


          Example A-1  The LAT$SYSTARTUP.COM Supplied by Digital
          _______________________________________________________

          $! Copyright (c) 1990 Digital Equipment Corporation.  All rights reserved.
          $!
          $!    LAT$SYSTARTUP.COM -- LAT Startup Commands Specific to Site
          $!
         1
          $!    Use this command procedure to customize the LAT characteristics for
          $!    the local node.  These commands, which should serve as examples,
          $!    will set up a LAT service name SYS$NODE and default identification
          $!    SYS$ANNOUNCE.  The LAT service name and identification will default
          $!    to SYS$NODE and SYS$ANNOUNCE unless you specify a service name and
          $!    identification as arguments to the command line that invokes
          $!    LAT$STARTUP.COM:
          $!                    $ @SYS$STARTUP:LAT$STARTUP
          $!
          $!    You can specify other node and service characteristics (such as group
          $!    codes) as arguments to this command line, as shown below.
          $!
          $!        Argument     Function
          $!        ---------    --------
          $!
          $!           P1        Name of the service to be created.  If not supplied, a
          $!                     service will be created with the same name as the node.
          $!
          $!        P2,P3,P4     Parameters and qualifiers to the SET NODE command.
          $!
          $!           P5        Parameters and qualifiers to the SET SERVICE command.
          $!                     P5 is only used if P1 is specified.  More than one
          $!                     argument may be supplied by enclosing the string in
          $!                     quotes.
          $!
          $!    Example: $ @SYS$STARTUP:LAT$STARTUP HAWK "/IDENTIFICATION=" -
          $!                      """""Development node"""""

          _______________________________________________________
                                         (continued on next page)



          A-6

 


                       Sample LAT$SYSTARTUP.COM Command Procedures
                      A.2 LAT$SYSTARTUP.COM As Supplied by Digital


          Example A-1 (Cont.)  The LAT$SYSTARTUP.COM Supplied by
                               Digital
          _______________________________________________________
          $!
          $!    Please review and edit this file for possible additions and deletions
          $!    that you wish to make.  Future software updates will not overwrite the
          $!    changes made to this file.
          $!
          $ required_privileges = "OPER"
          $ prev_privs = f$setprv(required_privileges)
          $ if .not. f$privilege(required_privileges) then goto no_privileges
          $ lcp := $latcp
          $!
          $! ---------------------  Modify Node Characteristics  ------------------------
          $!
         2 $ lcp set node 'p2' 'p3' 'p4'
          $!
          $! Enable LAT server mode and user groups.

          $!
         3 $! lcp set node /connections=both /user_groups=(enable=(24,121-127),disable=0)
         4 $! lcp set node /connections=both /user_groups=(enable=0-255) /node_limit=50
          $!
          $! Allow incoming connections only
          $!
         5 $! lcp set node /connections=incoming_only /groups=enable=(0-255)
          $!
          $! --------------------  Modify Service Characteristics  ----------------------
          $!
         6 $ if p1 .eqs. ""
          $ then
          $    lcp create service
          $ else
         7 $    lcp create service 'p1' 'p5'
          $ endif
          $! -------------------------  Start LAT Protocol  -----------------------------
          $!
         8 $ lcp set node /state=on

          _______________________________________________________
                                         (continued on next page)

                                                              A-7

 


          Sample LAT$SYSTARTUP.COM Command Procedures
          A.2 LAT$SYSTARTUP.COM As Supplied by Digital


          Example A-1 (Cont.)  The LAT$SYSTARTUP.COM Supplied by
                               Digital
          _______________________________________________________
          $!
          $! -------------------------  Create and Map Ports  ---------------------------
          $!
         9 $! lcp create port lta101: /dedicated
         10$! lcp create port lta102: /application
          $! lcp create port lta103: /application
         11$! lcp create port /nolog/logical=(name=ln03$mgmt, table=system, mode=executive)
          $!
         12$! lcp set port lta101: /dedicated /service=graphics
         13$! lcp set port lta102: /node=server_1 /port=port_1
         14$! lcp set port lta103: /node=server_2 /service=laser
          $! lcp set port ln03$mgmt: /node=server_3 /service=ln03_printers
          $!
          $exit:
          $ prev_privs = f$setprv(prev_privs)
          $ exit
          $!
          $no_privileges:
          $ write sys$output "Insufficient privileges to execute LATCP commands."
          $ write sys$output "Requires ",required_privileges," privileges."
          $_goto_exit____________________________________________

          The following list explains specific sections and
          command lines called out in the procedure.

          1  Callout 1 explains examples of commands used for
             setting up a LAT service.

          2  Sets up the LAT node name for your VMS system. The
             optional arguments P2, P3, and P4 are the unique
             identification string, enabled groups, and disabled
             groups that you can specify with the command
             line that invokes LAT$STARTUP.COM as explained
             in Section A.1.




          A-8

 


                       Sample LAT$SYSTARTUP.COM Command Procedures
                      A.2 LAT$SYSTARTUP.COM As Supplied by Digital


          3  Of this command, and the two that follow, only
             one should be used. Remove the exclamation
             mark (!) that precedes the command you want
             LAT$SYSTARTUP.COM. to process.

             This SET NODE command sets up your VMS node as a
             service node accepting incoming connections and
             allowing outgoing connections. The command also
             specifies that users on your VMS node can access
             service nodes that belong to user groups 24 and 121
             through 127. Users cannot access service nodes that
             belong to user group 0.

          4  This SET NODE command sets up your VMS node as a
             service node accepting incoming connections and
             allowing outgoing connections. The command also
             specifies that users on your VMS node can access
             service nodes that belong to all user groups.
             It also specifies that the service node database
             should have a limit of 50 nodes.

          5  This SET NODE command sets up your VMS node as a
             service node accepting incoming connections only.
             The command also specifies that all groups have
             access to services offered on your VMS node.

          6  If you do not specify a service name in the
             command line that invokes LAT$STARTUP.COM,
             LAT$SYSTARTUP.COM creates a service that takes
             on the name and identification of your VMS node.

          7  If you did specify a service name in the command
             line, LAT$SYSTARTUP.COM creates a service that
             takes on the specified name (argument P1) and any
             other service characteristics you specify (argument
             P5).

          8  This command starts the LAT port driver on your VMS
             node. This allows new LAT connections to be created
             on the node.

                                                              A-9

 


          Sample LAT$SYSTARTUP.COM Command Procedures
          A.2 LAT$SYSTARTUP.COM As Supplied by Digital


          9  This and the next seven commands do not get
             processed by LAT$SYSTARTUP.COM unless you remove
             the preceding exclamation marks (!). This command
             creates a dedicated logical port, LTA101:.

          10 This and the next command create two application
             ports: LTA102: and LTA103:.

          11 This command creates an application port, and
             associates its name with the logical name
             "LN03$MGMT". The logical name is created as an
             executive mode logical in the LNM$SYSTEM_TABLE
             table.

          12 This command specifies that the dedicated port
             LTA101: offers the service GRAPHICS to users of
             terminal servers or users on VMS nodes that support
             outgoing connections.

          13 This command associates application port LTA102:
             with the port named PORT_1 on terminal server
             SERVER_1.

          14 This command associates application port LTA103:
             with the service named LASER on terminal server
             SERVER_2. The service LASER is associated with
             several printer ports on SERVER_2.

          __________________________________________________________________

   A.3    A Sample Edited Version of LAT$SYSTARTUP.COM

          The edited command procedure shown in Example A-2
          sets up new LAT port and service characteristics for
          the VMS node. The edits reflect the changes made with
          several LATCP CREATE and SET command examples shown
          in the command reference section of this book. The
          changes that were made by those LATCP CREATE and SET
          commands stay in effect until the next time the LAT
          port driver is started. By editing LAT$SYSTARTUP.COM
          as shown in Example A-2, the changes you make with
          the CREATE and SET commands take effect whenever
          LAT$STARTUP.COM is invoked.

          A-10

 


                       Sample LAT$SYSTARTUP.COM Command Procedures
                  A.3 A Sample Edited Version of LAT$SYSTARTUP.COM


          Example A-2  An Edited LAT$SYSTARTUP.COM
          _______________________________________________________

          $! Copyright (c) 1990 Digital Equipment Corporation.  All rights reserved.
          $!
          $!    LAT$SYSTARTUP.COM -- LAT Startup Commands Specific to Site
          $!
          $!    Use this command procedure to customize the LAT characteristics for
          $!    the local node.  These commands, which should serve as examples,
          $!    will set up a LAT service name SYS$NODE and default identification
          $!    SYS$ANNOUNCE.  The LAT service name and identification will default
          $!    to SYS$NODE and SYS$ANNOUNCE unless you specify a service name and
          $!    identification as arguments to the command line that invokes
          $!    LAT$STARTUP.COM:
          $!                    $ @SYS$STARTUP:LAT$STARTUP
          $!
          $!    You can specify other node and service characteristics (such as group
          $!    codes) as arguments to this command line, as shown below.
          $!
          $!        Argument     Function
          $!        ---------    --------
          $!
          $!           P1        Name of the service to be created.  If not supplied, a
          $!                     service will be created with the same name as the node.
          $!
          $!        P2,P3,P4     Parameters and qualifiers to the SET NODE command.
          $!
          $!           P5        Parameters and qualifiers to the SET SERVICE command.
          $!                     P5 is only used if P1 is specified.  More than one
          $!                     argument may be supplied by enclosing the string in
          $!                     quotes.
          $!
          $!    Example: $ @SYS$STARTUP:LAT$STARTUP HAWK "/IDENTIFICATION=" -
          $!                      """""Development node"""""
          $!
          $!    Please review and edit this file for possible additions and deletions
          $!    that you wish to make.  Future software updates will not overwrite the
          $!    changes made to this file.
          $!
          $ required_privileges = "OPER"

          ___________________________________________________A-11
                                         (continued on next page)

 


          Sample LAT$SYSTARTUP.COM Command Procedures
          A.3 A Sample Edited Version of LAT$SYSTARTUP.COM


          Example A-2 (Cont.)  An Edited LAT$SYSTARTUP.COM
          _______________________________________________________
          $ prev_privs = f$setprv(required_privileges)
          $ if .not. f$privilege(required_privileges) then goto no_privileges
          $ lcp := $latcp
          $!
          $! ---------------------  Modify Node Characteristics  ------------------------
          $!
          $ lcp set node 'p2' 'p3' 'p4'
          $!
          $! Enable LAT server mode and user groups.
          $!
         1 $ lcp set node /connections=both /user_groups=(enable=(1-3,7,10-20),disable=0)
          $!
          $! --------------------  Modify Service Characteristics  ----------------------
          $!
          $ if p1 .eqs. ""
          $ then
          $    lcp create service
          $ else
          $     lcp create service 'p1' 'p5'
          $ endif

          _______________________________________________________
                                         (continued on next page)
















          A-12

 


                       Sample LAT$SYSTARTUP.COM Command Procedures
                  A.3 A Sample Edited Version of LAT$SYSTARTUP.COM


          Example A-2 (Cont.)  An Edited LAT$SYSTARTUP.COM
          _______________________________________________________
          $!
          $! -------------------------  Start LAT Protocol  -----------------------------
          $!
         2 $ lcp set node /state=on
          $!
          $! -------------------------  Create and Map Ports  ---------------------------
          $!
         3
          $ lcp create service /application graphics
          $ lcp create port lta21: /dedicated
          $ lcp set port lta21: /service=graphics
          $!
         4 $ lcp create port lta22: /application
          $ lcp set port lta22: /node=ts33ew /port=ln02
          $!
         5 $ lcp create port lta19: /application
          $ lcp set port lta19: /node=tlat1 /service=printer

          $!
          $exit:
          $ prev_privs = f$setprv(prev_privs)
          $ exit
          $!
          $no_privileges:
          $ write sys$output "Insufficient privileges to execute LATCP commands."
          $ write sys$output "Requires ",required_privileges," privileges."
          $_goto_exit____________________________________________

          The following list explains several of the edited
          command lines in the procedure.

          1  This command was edited to enable users on the
             local node to access service nodes belonging to
             user groups 1 through 3, 7, and 10 through 20.





                                                             A-13

 


          Sample LAT$SYSTARTUP.COM Command Procedures
          A.3 A Sample Edited Version of LAT$SYSTARTUP.COM


          2  This command starts the LAT port driver on your VMS
             node, allowing new LAT connections to be created
             on the node. The LAT characteristics set in the
             preceding commands will take effect.

          3  These commands create an application service
             (GRAPHICS) on the local node and a port (LTA21:)
             that is dedicated to the service. Remote nodes that
             connect to the service GRAPHICS will get connected
             to this port. The application program should assign
             a channel to this port and prepare to receive and
             transmit data to the remote node through the device
             associated with LTA21:.

          4  The CREATE PORT command creates an application
             device that will support remote printer access.
             The SET PORT command maps the device to a specific
             printer port on terminal server TS33EW.

          5  The CREATE PORT command creates another application
             device that will support remote printer access.
             The SET PORT command maps the device to a service
             (PRINTER) that is associated with several ports on
             terminal server TLAT1.

















          A-14

 






          _______________________________________________________

   B      LATCP Command Summary




          Use this appendix as a quick reference for LATCP
          commands and their qualifiers.

          __________________________________________________________________

   B.1    Invoking and Exiting LATCP

          Enter the following command to invoke LATCP:

               $ RUN SYS$SYSTEM:LATCP
               LATCP>

          At the LATCP> prompt, you can enter LATCP commands.
          To exit LATCP, type EXIT or press CTRL/Z at the LATCP>
          prompt.

          You can also execute a single LATCP command by using
          a DCL string assignment statement, as shown in the
          following example:

               $ LATCP :== $LATCP
               $ LATCP SET NODE/STATE=ON

          LATCP executes the SET NODE command and returns
          control to DCL.

          __________________________________________________________________

   B.2    LATCP Command Summary

          Table B-1 lists the LATCP commands and qualifiers.



                                                              B-1

 


          LATCP Command Summary
          B.2 LATCP Command Summary


          Table_B-1__LATCP_Commands_and_Qualifiers_______________

          Command_________________________Qualifiers_____________    Qualifier Options

          ATTACH [process-name]           /PID=pid

          CREATE LINK link-name           /[NO]DECNET

                                          /DEVICE=device-name

                                          /[NO]LOG

                                          /STATE=option              ON

                                                                     OFF

          CREATE PORT [port-name]         /APPLICATION

                                          /DEDICATED

                                          /[NO]LOG

                                          /LOGICAL=(NAME=logical-
                                          name[,TABLE=table][,MODE=mode)

          CREATE SERVICE [service-name]   /APPLICATION

                                          /IDENTIFICATION[="id-
                                          string"]

                                          /[NO]LOG

                                          /[NO]STATIC_
                                          RATING=rating

          DEFINE/KEY key-name eq-string   /[NO]ECHO
          _______________________________________________________
                                         (continued on next page)



          B-2

 


                                             LATCP Command Summary
                                         B.2 LATCP Command Summary


          Table_B-1_(Cont.)__LATCP_Commands_and_Qualifiers_______

          Command_________________________Qualifiers_____________    Qualifier Options

                                          /IF_STATE=state-name

                                          /[NO]LOCK_STATE

                                          /[NO]LOG

                                          /SET_STATE=state-name

                                          /[NO]TERMINATE

          DELETE LINK link-name           /[NO]LOG

          DELETE PORT port-name           /[NO]LOG

          DELETE SERVICE service-name     /[NO]LOG

          EXIT

          HELP [command-name]

          RECALL [command-specifier]      /ALL

          REFRESH

          SET LINK link-name              /[NO]LOG

                                          /STATE=option              ON

                                                                     OFF

          SET NODE [node-name]            /CIRCUIT_TIMER=msecs
          _______________________________________________________
                                         (continued on next page)




                                                              B-3

 


          LATCP Command Summary
          B.2 LATCP Command Summary


          Table_B-1_(Cont.)__LATCP_Commands_and_Qualifiers_______

          Command_________________________Qualifiers_____________    Qualifier Options

                                          /CONNECTIONS=option        INCOMING_ONLY

                                                                     OUTGOING_ONLY

                                                                     BOTH

                                                                     NONE

                                          /[NO]CPU_RATING=cpu-
                                          power

                                          /DEVICE_SEED[=value]

                                          /GROUPS=option             ENABLE=group-codes

                                                                     DISABLE=group-codes

                                                                     ENABLE=group-
                                                                     codes,DISABLE=group-
                                                                     codes

                                          /IDENTIFICATION[="id-
                                          string"]

                                          /KEEPALIVE_TIMER=secs

                                          [NO]LOG

                                          /MULTICAST_TIMER=secs

                                          /[NO]NODE_LIMIT=value
          _______________________________________________________
                                         (continued on next page)




          B-4

 


                                             LATCP Command Summary
                                         B.2 LATCP Command Summary


          Table_B-1_(Cont.)__LATCP_Commands_and_Qualifiers_______

          Command_________________________Qualifiers_____________    Qualifier Options

                                          /RETRANSMIT_LIMIT=count

                                          /[NO]SERVICE_RESPONDER

                                          SESSION_LIMIT=option       INCOMING=value

                                                                     OUTGOING=value

                                                                     INCOMING=value,OUTGOING=
                                                                     value

                                          /STATE=option              ON

                                                                     OFF

                                                                     SHUT

                                          /UNIT_NUMBER_
                                          MAXIMUM=value

                                          /USER_GROUPS=option        ENABLE=group-codes

                                                                     DISABLE=group-codes

                                                                     ENABLE=group-
                                                                     codes,DISABLE=group-
                                                                     codes

          SET PORT port-name              /APPLICATION

                                          /DEDICATED
          _______________________________________________________
                                         (continued on next page)




                                                              B-5

 


          LATCP Command Summary
          B.2 LATCP Command Summary


          Table_B-1_(Cont.)__LATCP_Commands_and_Qualifiers_______

          Command_________________________Qualifiers_____________    Qualifier Options

                                          /[NO]LOG

                                          /NODE=remote-node-name

                                          /PORT=remote-port-name

                                          /[NO]QUEUED

                                          /SERVICE=service-name

          SET SERVICE [service-name]      /APPLICATION

                                          /IDENTIFICATION[="id-
                                          string"]

                                          [NO]LOG

                                          /[NO]STATIC_
                                          RATING=rating

          SHOW LINK [link-name]           /BRIEF

                                          /COUNTERS[1]

                                          /FULL

          SHOW NODE [node-name]           /ALL

                                          /BRIEF

          _______________________________________________________
          [1]Do not use the /BRIEF or /FULL qualifiers with this
          qualifier.

          _______________________________________________________
                                         (continued on next page)

          B-6

 


                                             LATCP Command Summary
                                         B.2 LATCP Command Summary


          Table_B-1_(Cont.)__LATCP_Commands_and_Qualifiers_______

          Command_________________________Qualifiers_____________    Qualifier Options

                                          /COUNTERS[1]

                                          /FULL

          SHOW PORT [port-name]           /APPLICATION

                                          /BRIEF

                                          /DEDICATED

                                          /FORWARD

                                          /FULL

                                          /INTERACTIVE

          SHOW SERVICE [service-          /BRIEF
          name][2]

                                          /COUNTERS[1]

                                          /FULL

                                          /LOCAL
          _______________________________________________________
          [1]Do not use the /BRIEF or /FULL qualifiers with this
          qualifier.

          [2]If you do not specify a service name, the command
          displays information about all services known to your
          local node. If you do not specify a service name but
          specify the /LOCAL qualifier, the command displays
          information about all services offered by your local
          node.

          _______________________________________________________
                                         (continued on next page)

                                                              B-7

 


          LATCP Command Summary
          B.2 LATCP Command Summary


          Table_B-1_(Cont.)__LATCP_Commands_and_Qualifiers_______

          Command_________________________Qualifiers_____________    Qualifier Options

          SPAWN [DCL-command]

          ZERO COUNTERS[3]                /[NO]LOG

                                          /LINK=[link-name]

                                          /NODE[=node-name]

                                          /SERVICE=service-name
          _______________________________________________________
          [3]You must specify either /LINK, /NODE, or /SERVICE.
          _______________________________________________________

























          B-8

 






          _________________________________________________________________

          Index

          _______________________________
          A                                  Counters (Cont.)

          _______________________________     resetting, LAT-95
          Actual node name, LAT-88           CPU power, LAT-46
          Actual port name, LAT-88           CREATE LINK command, LAT-14
          Actual service name, LAT-88        CREATE PORT command, LAT-17
          Application port, LAT-17,          CREATE SERVICE command, LAT-21
             LAT-58, LAT-60                  Creating a subprocess, LAT-93

            displaying, LAT-84               _______________________________
            mapping, LAT-61                  D
          Application service, LAT-18,       _______________________________
             LAT-21, LAT-59, LAT-63          Database
            defined, LAT-23                   see Service and node database
            setting up, LAT-59               Dedicated port, LAT-18, LAT-59
          Asynchronous device on LAT          displaying, LAT-84
            application ports for,           DEFINE/KEY command, LAT-25
               LAT-17, LAT-58                DELETE LINK command, LAT-30
          ATTACH command, LAT-11             DELETE PORT command, LAT-32

          _______________________________    DELETE SERVICE command, LAT-34

          C                                  Device address

          _______________________________     see Ethernet address
          Circuit timer, LAT-44              Displaying
          Command                             information about services,
            recalling, LAT-39                    LAT-89
            summary, LAT-4                    link characteristics, LAT-70
               including qualifiers, B-1      link counters, LAT-66
          Configuring a printer, LAT-17,      link information, LAT-66
             LAT-58                           node characteristics, LAT-80
          Connections, LAT-53, LAT-90         node counters, LAT-72
            specifying type of, LAT-45        node information, LAT-72
          Counters, LAT-2                     port characteristics, LAT-85
            displaying for links, LAT-66      port information, LAT-84
            displaying for nodes, LAT-72      service characteristics,
            displaying for services,             LAT-90
               LAT-90                         service counters, LAT-90

                                                                    Index-1

 


          Index


                                             _______________________________
          Display screen                     I
            refreshing, LAT-41               _______________________________
          Dynamic service rating,            Incoming LAT connections,
             LAT-22, LAT-64                    LAT-1, LAT-45
            displaying, LAT-82, LAT-92

          _______________________________    _______________________________

          E                                  K
          _______________________________    _______________________________
          Ethernet address, LAT-14           Keepalive timer, LAT-50
            displaying, LAT-81               Key, defining, LAT-25

          Ethernet controller                _______________________________
            address, LAT-14, LAT-81          L
            device name, LAT-15              _______________________________
          Ethernet link                      LAT$CONFIG.COM, LAT-3
            creating, LAT-14                  location, A-1
            modifying characteristics of,    LAT$STARTUP.COM, LAT-3, LAT-55
               LAT-42                         invoking, A-1
            number supported by LAT,          location, A-1
               LAT-15                        LAT$SYSTARTUP.COM, LAT-3, A-1
          EXIT command, LAT-36                example supplied by Digital,

          _______________________________        A-5
          F                                   invoking, A-1
          _______________________________     location, A-1
          Function key, LAT-25               LAT$SYSTARTUP.COM procedure
                                              invok
          _______________________________        example edited, A-10
          G                                  LAT$SYSTARTUP.TEMPLATE, LAT-3
          _______________________________    LATACP, LAT-3
          Groups, LAT-48, LAT-54, LAT-81     LATACP process
                                              creation, LAT-3
          _______________________________    LAT ancillary control process

          H                                    (LATACP), LAT-3
          _______________________________    LAT characteristics
          HELP command, LAT-7, LAT-37         added or changed, LAT-8
                                              modifying in LAT$SYSTARTUP.COM
                                                 , LAT-3
                                              saving, LAT-3

          Index-2

 


                                                                      Index



          LAT characteristics (Cont.)        LAT service (Cont.)

            storing, LAT-8, A-1, A-10         identifier, LAT-22, LAT-49,
          LAT connections, LAT-53,               LAT-63
             LAT-90                           modifying characteristics of,
            specifying type of, LAT-45           LAT-63
          LAT Connections                     naming, LAT-21, LAT-42
            incoming, LAT-1, LAT-45           rating, LAT-22, LAT-64,
            outgoing, LAT-1, LAT-45              LAT-82, LAT-92
          LAT Control Program                 remote printing, LAT-1
            see LATCP                        LAT service and node database
          LATCP                               limiting size of, LAT-50,
            exiting, LAT-4, LAT-36, B-1          LAT-54
            HELP, LAT-7, LAT-37              LAT service announcements,
            invoking, LAT-4, LAT-8, B-1        LAT-2
          LAT device unit number, LAT-54     LAT session limit, LAT-52
          LAT port driver (LTDRIVER),        Link
             LAT-2, LAT-3                     counters, LAT-66
            starting, LAT-3                   creating, LAT-14
          LAT protocol software               deleting, LAT-30
            starting with LAT$STARTUP.COM     displaying characteristics
               , LAT-3, A-1                      of, LAT-70
            starting with SET NODE            displaying information,
               /STATE=ON, LAT-53                 LAT-66
            stopping with SET NODE            modifying characteristics of,
               /STATE=OFF, LAT-53                LAT-42
          LAT service                         naming, LAT-14
            counters, LAT-90                  state, LAT-15
            creating, LAT-21                 Load balancing, LAT-22, LAT-64
            database, LAT-2, LAT-50,          and CPU power, LAT-46
               LAT-54                        LTA device, LAT-47
            dedicated applications, LAT-1    LTDRIVER, LAT-3

            defined, LAT-1                    see LAT port driver
            deleting, LAT-34                 _______________________________
            displaying characteristics
               of, LAT-90                    M
            displaying information,          _______________________________
               LAT-89                        Modifying LAT characteristics
                                              in LAT$SYSTARTUP.COM, LAT-3

                                                                    Index-3

 


          Index



          Multicast messages, LAT-34,        Port (Cont.)
             LAT-67, LAT-69                   deleting, LAT-32
            timer for, LAT-50                 displaying characteristics

          _______________________________        of, LAT-85
          N                                   displaying information,
          _______________________________        LAT-84
          Node                                logical name of, LAT-18
            counters, LAT-72                  modifying characteristics of,
            database, LAT-2, LAT-50,             LAT-58
               LAT-54                         name, LAT-58
            displaying characteristics        outgoing connection, LAT-85
               of, LAT-80                     setting type of, LAT-17
            displaying information,          Printer
               LAT-72                         configuring on a LAT, LAT-17,
            limit, LAT-50                        LAT-58
            modifying characteristics of,    Process
               LAT-44                         transfering control from,
            name, LAT-44                         LAT-11
            state, LAT-53                    Protocol bit mask
                                              error definitions, LAT-79

          _______________________________    _______________________________

          O                                  R
          _______________________________    _______________________________
          Outgoing LAT connections,          RECALL command, LAT-39
             LAT-1, LAT-45                   REFRESH command, LAT-41
          Outgoing port                      Retransmit limit, LAT-51
            displaying, LAT-85
          _______________________________    _______________________________

          P                                  S
          _______________________________    _______________________________
          Port                               Saving characteristics, LAT-3,
            application, LAT-17, LAT-58,       A-1, A-10
               LAT-60, LAT-61, LAT-84        Screen
            characteristics, LAT-84           refreshing, LAT-41
            creating, LAT-17                 Service
            dedicated, LAT-18, LAT-59,        application, LAT-18, LAT-21,
               LAT-84                            LAT-23, LAT-59, LAT-63
                                              counters, LAT-90

          Index-4

 


                                                                      Index



          Service (Cont.)                    SET SERVICE command, LAT-63
            creating, LAT-21                 SHOW LINK command, LAT-66
            database, LAT-2, LAT-50,         SHOW NODE command, LAT-72
               LAT-54                        SHOW PORT command, LAT-84
            defined, LAT-1                   SHOW SERVICE command, LAT-89
            deleting, LAT-34                 Site-specific LAT configura-
            displaying characteristics         tion file
               of, LAT-90                     LAT$SYSTARTUP.COM, LAT-3
            displaying information,          Slots, LAT-74
               LAT-89                        SPAWN command, LAT-93
            general timesharing, LAT-23      Starting the LAT protocol
            identifier, LAT-22, LAT-49,        software
               LAT-63                         with LAT$STARTUP.COM, LAT-3,
            modifying characteristics of,        A-1
               LAT-63                         with SET NODE/STATE=ON
            naming, LAT-21, LAT-42               command, LAT-53
          Service and node database,         Startup
             LAT-2                            editing command procedures,
            limiting size of, LAT-50,            A-4
               LAT-54                         location of command
          Service announcements, LAT-2           procedures, A-1
          Service node, LAT-2                 order of command procedures,
            controlling access to,               A-1
               LAT-48, LAT-54                Static service rating, LAT-22,
            defined, LAT-1                     LAT-64
            deleting a port, LAT-32           displaying, LAT-82, LAT-92
            modifying characteristics of,    Stopping the LAT protocol
               LAT-44, LAT-63                  software
            naming, LAT-60                    with SET NODE/STATE=OFF
            service announcements,               command, LAT-53
               LAT-49, LAT-50                Subprocess

          Service rating, LAT-22,             see Process
             LAT-64, LAT-82, LAT-92          _______________________________
          Service responder, LAT-51
          Session limit, LAT-52              T
          SET LINK command, LAT-42           _______________________________
          SET NODE command, LAT-44           Target node name, LAT-88
          SET PORT command, LAT-58           Target port name, LAT-88


                                                                    Index-5

 


          Index



          Target service name, LAT-88         multicast, LAT-50
          Terminal server                    _______________________________
            VMS, LAT-1
          Timer                              Z
            for circuits, LAT-44             _______________________________
            keepalive, LAT-50                ZERO COUNTERS command, LAT-95



































          Index-6
