LATCP$HELP.HLB  —  SET  SERVICE  Qualifiers

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

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

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.

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.

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.
Close Help