Dynamically changes the characteristics of a locally offered
service. You must have OPER privilege to use this command.
Format
SET SERVICE [service-name]
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.
2 – Qualifiers
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.
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).
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 (" ").
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).
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.
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.
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.
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.