LATCP SET — VMS 5.0
Controls node counters and node, service, and link characteristics.
Format:
SET option
Additional information available:
COUNTERS
Allows you to test the performance of your service node over a period
of time. Once the counters for your LAT service node are set to
zero, you can observe information that accumulates over the specific
period by using the LATCP SHOW COUNTERS/NODE command.
You cannot use this command to set device counters or server counters
to zero.
Format:
SET COUNTERS
Additional information available:
/ZERO
/ZERO Resets your service node counters to zero.
LINK
Changes the Ethernet link characteristics.
Format:
SET LINK link-name
Specifies the name for the Ethernet link. The link name can have up
to 31 ASCII characters. The link must have been previously created
with the CREATE LINK command. Use SHOW CHARACTERISTICS to look at
all of the links defined for your service node.
Additional information available:
/DECNET/DEVICE/DISABLE/ENABLE/LOG
/DECNET
/DECNET (D) /NODECNET Specifies that the extended DECnet address should be used when starting the Ethernet controller. If /NODECNET is specified, the controller's hardware address is used as the device's physical address. See the START NODE /DECNET command for more information.
/DEVICE
/DEVICE=device-name Specifies the Ethernet controller device name that you are assigning to the Ethernet link. You cannot change the controller for a link that is active. Only one Ethernet link can be associated with an Ethernet controller.
/DISABLE
/DISABLE=group-list Removes previously enabled groups associated with the link. When you enter a group list, enclose the list in parenthesis, and use commas (,) to separate individual groups.
/ENABLE
/ENABLE=group-list Specifies additional groups that you want enabled for the link. There are 256 groups, numbered from 0 through 255. When you enter a group list, enclose the list in parenthesis, and use commas (,) to separate individual groups. You can change groups for an active link.
/LOG
/LOG (D) /NOLOG Specifies whether your link characteristics are displayed when this command is executed.
NODE
Defines the LAT node characteristics for your service node.
Any characteristics that you omit are not changed from their previous
settings.
Because LATCP commands change characteristics dynamically, you can
use SET NODE prior to the LAT port driver activation or at any time
when the LAT port driver is active.
Format:
SET NODE node-name
Additional information available:
/DISABLE/ENABLE/IDENTIFICATION/LOG/MULTICAST_TIMER
Parameters
node-name Specifies the name for your service node. You can use up to 16 of the following keyboard characters: A TO Z a to z 0 to 9 $ - . The node name should be the same as the DECnet node name. The DECnet node name must be unique within the same logical Ethernet as well as within the entire DECnet network. The default is the translation of the logical name SYS$NODE.
/DISABLE
/DISABLE=group-list Removes previously enabled groups from your service node. There are 256 groups, numbered from 0 through 255. When you enter a group list, enclose the list in parenthesis, and use commas (,) to separate individual groups. Use the SHOW CHARACTERISTICS command to look at the groups that are enabled for your service node.
/ENABLE
/ENABLE=group-list Specifies that your service node can access the specified groups. This list can consists of up to 256 groups, numbered from 0 through 255. When you enter a group list, enclose the list in parenthesis, and use commas (,) to separate individual groups. The default is group 0 /ENABLED. The groups that you enable with this command apply to all of the links with no groups enabled on your service node. Use the SHOW CHARACTERISTICS command to look at the groups that are enabled for your service node.
/IDENTIFICATION
/IDENTIFICATION="identification-string"
Specifies a description for your service node. The string is
advertised to servers in the multicast messages sent by your service
node. Enclose the string in quotation marks (""). The string can
have up to 64 ASCII characters and cannot begin with an ampersand
(&). Nonprintable characters are translated as spaces. The default
is the translation of the SYS$ANNOUNCE logical name.
/LOG
/LOG (D) /NOLOG Specifies whether your service node characteristics are displayed when this command is executed.
/MULTICAST_TIMER
/MULTICAST_TIMER=seconds Specifies the time, in seconds, between the multicast messages for service announcements. The minimum value is 10 seconds; the maximum value is 255 seconds. The default is 60 seconds.
PORT
(1) Logically associates (maps) a previously created applications
port on your service node with a port on a server, or (2) specifies
that a particular service on the service node is offered on a
dedicated port on that service node.
Format:
SET PORT port-name
Additional information available:
/APPLICATION/DEDICATED/LINK/LOG/NODE
/PORT/QUEUED/SERVICE
Parameters
port-name Specifies the name of the applications or dedicated port. Specify the port name in the form LTAn:, where n is a unique number from 1 through 9999. The port must have been previously created with CREATE PORT.
/APPLICATION
/APPLICATION Specifies that the port on your service node functions as an applications port. If neither /APPLICATION nor /DEDICATED is given, the default is /APPLICATION.
/DEDICATED
/DEDICATED Maps the dedicated port to a service name for an application program. Use /SERVICE with /DEDICATED to specify the service name. You cannot use any of the other qualifiers with /DEDICATED. The port must have been created previously with CREATE PORT /DEDICATED. When a server user requests the service name, that user is connected to the dedicated port if the application has assigned a channel to the port.
/LINK
/LINK=link-name Specifies the name of the link on which you want the connection to be attempted. The link that you specify must have been created previously with the CREATE LINK command. Use SHOW CHARACTERISTICS for a list of the links defined for your node. If you do not specify a link name for an application port, the connection to the remote node will be attempted using the default link LAT$LINK.
/LOG
/LOG (D) /NOLOG Specifies whether the characteristics of the ports on your service node are displayed when this command is executed.
/NODE
/NODE=remote-node-name Specifies the name of the remote node (server) to be logically associated with the applications port on your service node. To map the applications port you must specify the applications port name and the remote node (server) name, plus one or both of the following: o Server port name (/PORT=remote-port-name) o Remote service name (/SERVICE=service-name) You can get these names from the server manager or with the server local mode commands.
/PORT
/PORT=remote-port-name Specifies the name of the port on a server that you want to associate (map) with the applications port on your service node. To map the applications port you must specify the applications port name and the remote node (server) name, plus one or both of the following: o Server port name (/PORT=remote-port-name) o Remote service name (/SERVICE=service-name) You can get these names from the server manager or with the server local mode commands.
/QUEUED
/QUEUED (D) /NOQUEUED Specifies queued or nonqueued access to the server port. A queued or nonqueued request is accepted by the server if the remote port is free. If the remote port is busy, and queueing is in effect for the applications port, and queuing is enabled on the server, then a request is queued on the server. If you do not want your remote requests to be queued on the server, specify /NOQUEUED; however, do not specify /NOQUEUED for a port that you want accessed by the LATSYM print symbiont.
/SERVICE
/SERVICE=service-name Specifies either (1)the name of the remote service offered at the server port that is to be associated with the applications port, or (2)the service name for an application program being offered on a dedicated port on your service node. To specify the name of the remote service offered at the server port, use the /NODE and the /SERVICE qualifiers. To specify a particular port for a service, use the /NODE, /PORT, and /SERVICE qualifiers. You must get these names from the server manager. To name a service for a particular applications program to be offered on a dedicated port on your service node, use the /DEDICATED and the /SERVICE qualifiers. The service must have been previously created with the CREATE SERVICE command. You must use this qualifier if you use the /DEDICATED qualifier.
SERVICE
Dynamically changes service characteristics for your service node.
Format:
SET SERVICE service-name
Specifies the name of the service whose characteristics you want to
change. The service must have been created previously with the
CREATE SERVICE command. The default service name is the translation
of the SYS$NODE logical name.
Additional information available:
/IDENTIFICATION/LINK/LOG/STATIC_RATING
/IDENTIFICATION
/IDENTIFICATION="identification-string"
Specifies a description for the service. The string is advertised to
servers in the multicast messages sent by your service node. Enclose
the string in quotation marks (""). The string can have up to 64
ASCII characters and cannot begin with an ampersand (&).
Nonprintable characters are translated as spaces. The default is the
translation of the SYS$ANNOUNCE logical name.
/LINK
/LINK=link-name Specifies the name of the link(s) on which you want the service offered. The link(s) that you specify must have been created previously with the CREATE LINK command. Use SHOW CHARACTERISTICS for a list of the links defined for your node. If you do not specify a link name for a service, that service is offered on all of the active Ethernet links. You can offer all of your services on all of the links.
/LOG
/LOG (D) /NOLOG Specifies whether the node characteristics are displayed when this command is executed.
/STATIC_RATING
/STATIC_RATING=rating /NOSTATIC_RATING (D) Disables dynamic rating and specifies a static rating when you omit NO. Disables static rating and starts dynamic rating when you include NO. The dynamic service rating is usually adequate for efficient load balancing on the LAT network. You can use the static rating to direct terminal server users temporarily away from or towards a particular node.