LATCP CREATE — VMS 5.4-3
Additional information available:
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
Additional information available:
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
Additional information available:
/DECNET
/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.
/DEVICE
/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
/LOG
/NOLOG
Specifies whether LATCP displays a message confirming that the
link was created. /NOLOG is the default.
/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. This is the default.
OFF Specifies that the created link will not be available
for use.
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 an error message. If you do not specify the port name, you must specify the /LOGICAL qualifier.
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. 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.
/LOG
/LOG
/NOLOG
Specifies whether LATCP displays a message confirming that the
port was created. The default is /NOLOG.
/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.
SUPERVISORCreates 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 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.
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 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[="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
/LOG
/NOLOG
Specifies whether LATCP displays a message confirming that the
service was created. The default is /NOLOG.
/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.
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.