LATCP CREATE — VMS 5.5-2H4
Additional information available:
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:
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
/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:
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:
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.