/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 an application service on a remote LAT service node.
In either case, the remote port is logically associated with the
specified application port on your local node.
3.2.8 /QUEUED
/QUEUED
/NOQUEUED
Specifies queued or nonqueued access to the server port. 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.
Not specifying either the /QUEUED or /NOQUEUED qualifier results
in queued access to the server port. This is the default.
3.2.9 /SERVICE
/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 /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
/SERVICE qualifiers. (The service must have been created with the
CREATE SERVICE command.) Assign only one service to a dedicated
port, but note that several ports can have the same service
assigned.
You can also set up the port as a limited port, using the
/LIMITED qualifier.
3.3 – 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
printers (designated by the service name PRINTER) on a terminal
server.
2.LATCP> SET PORT LTA19: /APP /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 OpenVMS System Manager's Manual 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 service node offers the
service GRAPHICS to users on terminal servers or on nodes that
support outgoing connections. GRAPHICS is a particular utility
or application program.
4.LATCP> SET PORT MAIL_PORT /SERVICE=MAIL/NODE=RMNODE
The SET PORT command in this example associates the port whose
logical name is MAIL_PORT with the dedicated service MAIL
on remote node RMNODE. 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 name
could also have been created with an OpenVMS DCL ASSIGN or
DEFINE command. On node RMNODE, a port must be dedicated to
the service MAIL by using the SET PORT port-name /DEDICATED
/SERVICE=MAIL command.
5.$ LCP :== $LATCP
$ LCP CREATE SERVICE/LIMITED ONLY_ONE
$ LCP CREATE PORT/LIMITED LTA1234:
$ LCP SET PORT LTA1234: /SERVICE=ONLY_ONE
This series of commands, which includes the SET PORT command,
creates a limited service that allows only one user to log in
to the system through that service. When a user connects to
service ONLY_ONE by responding to the terminal server prompt
(Local>), the user is assigned port LTA1234 and then prompted
for the user name. Any user who attempts to connect to the
same service while LTA1234 has a user logged in receives the
"service in use" message.
4 – SERVICE
Dynamically changes the characteristics of a locally offered
service. You must have OPER privilege to use this command.
Format
SET SERVICE [service-name]
4.1 – 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 by using the SET NODE command.
4.2 – Qualifiers
4.2.1 /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 by using the CREATE PORT and SET PORT
commands.
4.2.2 /CONNECTIONS
/CONNECTIONS
/NOCONNECTIONS
Specifies whether a service offered by an OpenVMS system accepts
incoming connections. If you use the /NOCONNECTIONS qualifier
to disable incoming connections, users cannot connect to that
service and receive instead the error message "service is
disabled".
By default, a service accepts incoming connections
(/CONNECTIONS).
4.2.3 /IDENTIFICATION
/IDENTIFICATION[="identification-string"]
Describes and identifies a service. Service nodes include the
identification string in service announcements. A 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 the translation of
SYS$ANNOUNCE. A service node announces its services at regular
intervals established with the SET NODE command.
You cannot specify more than 64 ASCII characters in an
identification string (a SYS$ANNOUNCE longer than that will be
truncated to the first 64 characters). Enclose the string in
quotation marks (" ").
4.2.4 /LIMITED
Specifies that the service is a limited service, using devices
assigned the limited characteristic and associated with (mapped
to) this limited service. This qualifier is used in conjunction
with the SET PORT /LIMITED command (see example).
4.2.5 /LOG
/LOG
/NOLOG
Specifies whether or not LATCP displays a message confirming
that the command was executed. If you do not specify the /LOG
or /NOLOG qualifier, the default is that no message will be
displayed.
4.2.6 /QUEUED
/QUEUED
/NOQUEUED
Specifies whether a locally offered limited (/LIMITED) or
application (/DEDICATED) service is allowed to have queued
connections when all ports are busy (the default). If you specify
/NOQUEUED, incoming connections will be rejected if all ports are
busy.
4.2.7 /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 and the amount of memory.
When a terminal server or 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.
However, when necessary, you can use the /STATIC_RATING qualifier
to disable dynamic service ratings so that you can specify a
static (fixed) rating. That static rating value does not change
until the dynamic service rating is reenabled.
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.
Limited and application services do not rely exclusively on
the dynamically calculated service rating. Instead, they use
a portion of the dynamic rating based on how many ports are
available for the service. For example, if a limited service
has 50 percent of its ports available, the dynamic service rating
will be scaled, halved, and then added to 105. When ports are
available, the rating will always be above the value 105.
When all ports for a limited or application service are in use,
the rating will be based on the scaled dynamic rating and the
number of free queue slots on the local node. The rating will
always be less then 90.
This rating procedure for limited and application services
follows the terminal server rating algorithm for services and
available ports that the service offers, while at the same time
taking into account the availability of the node (which is the
factor used to calculate the dynamic rating).
If your system is licensed for a specific number of units (where
only a fixed number of users can log in to the system regardless
of how the login limit is set), then all dynamic ratings become 0
when all OpenVMS license units have been consumed. (This forces
all node service ratings to the lowest possible value when logins
are not possible because all OpenVMS license units have been
consumed.)
Note as well that the LAT software transmits a service
announcement message when a user logs in to or out of the system.
This allows the system to more quickly provide information
about service rating changes that result from a login or logout
operation.
4.3 – Examples
1.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 service node.
2.$ LCP :== $LATCP
$ LCP SET SERVICE/LIMITED ONLY_ONE
$ LCP CREATE PORT/LIMITED LTA1234:
$ LCP SET PORT LTA1234: /SERVICE=ONLY_ONE
This series of commands changes an existing service to a
limited service that allows only one user to log in to the
system through that service. When a user connects to service
ONLY_ONE by responding to the terminal server prompt (Local>),
the user is assigned port LTA1234 and then prompted for the
user name. Any user who attempts to connect to the same service
while LTA1234 has a user logged in receives the "service in
use" message.