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