Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

LINK

PORT

SERVICE

Parameter

Qualifiers

Example

/DECNET

/DEVICE

/LOG

/STATE

Parameter

Qualifiers

Examples

/APPLICATION

/DEDICATED

/LOG

/LOGICAL

Parameter

Qualifiers

Examples

/APPLICATION

/IDENTIFICATION

/LOG

/STATIC_RATING

LATCP CREATE — VMS 5.5

Additional information available:

LINKPORTSERVICE

LINK

   Creates the LAT data links, which are connections to LAN devices
   such as Ethernet or FDDI (fiber distributed data interconnect)
   controllers, that you want your VMS node to use. You must have
   OPER privilege to use this command.

   Format

     CREATE LINK  link-name

Additional information available:

ParameterQualifiersExample

Parameter

link-name
   Specifies a name for a LAT data 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

Additional information available:

/DECNET/DEVICE/LOG/STATE

/DECNET

      /DECNET
      /NODECNET

   Directs LAT protocol to use the DECnet data link address (
   /DECNET) or the hardware address (/NODECNET) when starting the
   LAN controller. If you do not specify the /DECNET or /NODECNET
   qualifier, the default is that the LAT protocol will use the
   DECnet data link address.

/DEVICE

      /DEVICE=device-name

   Specifies the LAN controller device name for a LAT data link (for
   example, XEB0:). Only one LAT data link can be associated with a
   LAN 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 LAT data link device names. Digital
   advises that you specify a default device name by defining the
   LAT$DEVICE logical name.

/LOG

      /LOG
      /NOLOG

   Specifies whether LATCP displays a message confirming that
   the link was created. If you do not specify the /LOG or /NOLOG
   qualifier, the default is that no message will be displayed.

/STATE

      /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.

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

   If you do not specify the /STATE=option qualifier, the default is
   that the created link will be available for use (ON).

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.

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]

Additional information available:

ParameterQualifiersExamples

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 the following error message:

     %LAT-W-CMDERROR, error reported by command executor
     -SYSTEM-F-DUPLNAM, duplicate name

   If you do not specify the port name, you must specify the /LOGICAL
   qualifier. Digital recommends that you assign a logical name when
   creating a port instead of specifying a specific LTA device.

Qualifiers

Additional information available:

/APPLICATION/DEDICATED/LOG/LOGICAL

/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. If you do not specify either the
   /APPLICATION or /DEDICATED qualifier, the default port type is
   APPLICATION.

/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. If you do not
   specify either /DEDICATED or /APPLICATION, the default port type
   will be APPLICATION.

/LOG

      /LOG
      /NOLOG

   Specifies whether LATCP displays a message confirming that
   the port was created. If you do not specify the /LOG or /NOLOG
   qualifier, the default is that no message will be displayed.

/LOGICAL

      /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.

   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.

   SUPERVISOR  Creates a supervisor mode logical name. This is the
               default.

   USER        Creates a user mode logical name.

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 LTA21:
     port. It will be used as a dedicated port that offers a
     specific service rather than a general VMS timesharing service.


   3.  LATCP> CREATE PORT /LOG /APPLICATION -
       _LATCP> /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.

SERVICE

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

   Format

     CREATE SERVICE  [service-name]

Additional information available:

ParameterQualifiersExamples

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

Additional information available:

/APPLICATION/IDENTIFICATION/LOG/STATIC_RATING

/APPLICATION

   Specifies that the created service is an application service. An
   application service offers a specific application on the service
   node rather than a general interactive VMS service. Define a
   dedicated port for the service by using the CREATE PORT and SET
   PORT commands.

/IDENTIFICATION

      /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. Entering the LATCP SHOW NODE command or the
   DECserver SHOW NODE command generates a display that includes 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

      /LOG
      /NOLOG

   Specifies whether LATCP displays a message confirming that the
   service was created. If you do not specify the /LOG or /NOLOG
   qualifier, the default is that no message will be displayed.

/STATIC_RATING

      /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 used;
   specify a high value to make the local service node more likely to
   be used.

   If you do not specify either the /STATIC_RATING or /NOSTATIC_
   RATING qualifier, the default is that the LAT software uses the
   dynamic service rating.

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 (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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026