% Librarian I01-42.5ATTACH CREATE2DEFINE=DELETEDEXITE2HELPOverviewFRECALLH`REFRESHISCROLLKFSETSHOWjSPAWN ZERO_COUNTERS  1 Overview@ LATCP allows you to control the LAT software on a node and to@ obtain information from it. For example, you can use LATCP to@ create services on the local node, to associate a port on theC local node with a service or device on a remote terminal server,A and to display information about services offered on the local) node or on other nodes in the network.B When you use LATCP commands to change LAT characteristics (such@ as creating a servi ce and associating a port with a service),= the changes take effect immediately. However, when the LATA port driver stops, these characteristics are lost. If you want> these characteristics to be present the next time you start> the LAT port driver, edit LAT$SYSTARTUP.COM by modifying or= adding commands to set these characteristics. Then, invoke0 LAT$STARTUP.COM to start the LAT port driver. Format RUN SYS$SYSTEM:LATCPA To invoke LATCP, enter RUN SYS$SYSTEM:LATCP at the DCL command? prompt. At the LATCP> prompt, you can enter any of the LATCP commands.B To exit from LATCP, enter the EXIT command at the LATCP> prompt or press Ctrl/Z.D You can also execute a single LATCP command by using a DCL string; assignment statement, as shown in the following example: $ LCP :== $LATCP $ LCP SET NODE/STATE=ONB LATCP executes the SET NODE command and returns control to DCL. ww 1 ATTACH? Transfers control from your current process to the specifiedA process. The LATCP ATTACH command is similar to the DCL ATTACHA command. For example, from the DCL command level you can enterD the DCL SPAWN command to create a LATCP subprocess without ending@ your DCL session, execute several LATCP commands at the LATCP8 prompt, then use the ATTACH command to return to DCL. Format ATTACH [process-name] 2 Parameter process-nameB Specifies the name of a paren t process or spawned subprocess toC which control passes. The process must already exist, be part ofD your current job, and share the same input stream as your current process.B Process names can contain from 1 to 15 alphanumeric characters.A If a connection to the specified process cannot be made, LATCP displays an error message.A If you specify the /PID qualifier, do not use the process name> parameter. If you omit the /PID qualifier, you must use the process n ame parameter.9 To display processes, use the DCL SHOW SYSTEM command. 2 Qualifier /PID /PID=pidA Specifies the process identification (PID) of the process thatC will have terminal control. When you specify a PID, you can omitB the leading zeros. If you specify a PID, do not use the processB name parameter. If you omit the PID qualifier, you must use the process name parameter. 2 Example $ SET PROCESS/NAME="TOP_LEVEL" $ SPAWN RUN SYS$SYS TEM:LATCP LATCP> SHOW NODE/ALL . . . LATCP> ATTACH "TOP_LEVEL" $> In this example, the user enters the DCL SPAWN command toC create a LATCP subprocess and uses LATCP to display the statusA of all nodes known to the local node. After using LATCP, the@ user enters the ATTACH command to return to the DCL command level. ww 1 CREATE 2 LINKD Creates the LAT data links, which are connections to LAN devices,A  such as Ethernet or FDDI (fiber distributed data interconnect)B controllers, that you want your node to use. You must have OPER! privilege to use this command. Format CREATE LINK link-name 3 Parameter link-nameC Specifies a name for a LAT data link. A link name can have up to> 16 ASCII characters. The characters allowed are as follows:, o Alphanumeric characters: A-Z, a-z, 0-9C o A subset of the international character set: ASCII codes 192 - 253A o Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore (_)> You can create a maximum of eight links on your local node.B Use the SHOW LINK command for a list of the link names that are defined for your node. 3 Qualifiers /DECNET /DECNET /NODECNET= Directs LAT protocol to use the DECnet data link address (A /DECNET) or the hardware address (/NODECNET) when starting theA LAN contr oller. If you do not specify the /DECNET or /NODECNET? qualifier, the default is that the LAT protocol will use the DECnet data link address.B Note that if you enter the CREATE LINK command with the /DECNET; qualifier and receive an error message indicating a "badA parameter value," it means the SCSSYSTEMID system parameter isB set to an illegal value. To change the value of this parameter, use the following formula: (1024 * a) + nD In the formula, a is the DE Cnet area and n is the DECnet computerB number. If the value is outside the range of 1025 to 65535, the LAT protocol cannot start.C When you use the /NODECNET qualifier, the LAN device driver code0 determines which address to use. For example:D o If SCSSYSTEMID is set to 0 but DECnet is already running on anD Ethernet controller, the LAN device code allows LAT to use the1 same address as DECnet (AA-00-04-00-xx-xx).C o If SCSSYSTEMID is set to 0 and DECnet is n ot running, the 08-C 00-2B-xx-xx-xx address is used (a different address format is; used depending on the vendor of your LAN controller).C o If the setting for SCSSYSTEMID is the same as the DECnet nodeB number and DECnet is not running, the LAN device code forces/ LAT to use the AA-00-04-00-xx-xx address.B If DECnet is configured on the system (or if the system is part? of a cluster), SCSSYSTEMID may contain a nonzero value. ThisB is a problem only when the system has 2 or more LAN controllers% connected to the same logical LAN.< For example, if your system has an FDDI controller and an? Ethernet controller, your site may be configured so that the= FDDI ring attached to the FDDI controller and the Ethernet? segment attached to the Ethernet controller are bridged by aB 10/100 LAN bridge (FDDI-to-Ethernet). In this configuration, it2 is impossible to run LAT over both controllers.@ In such a configuration, you must run L AT and DECnet over theA same controller if SCSSYSTEMID is not 0. If you fail to do so,? DECnet starts first, which in turn causes the LAT startup on@ the other controller to fail. This failure occurs because LATA startup tries to use the AA-00-04-00-xx-xx address (the DECnet? LAN address) but is prevented from doing so by the data link? layer. The LAT startup fails because DECnet is already using? this address on a different controller. (In a single logical> LAN, all data link addresses must be unique. In this setup,B both controllers try to use the same address, which is then not unique.)@ The following command (which creates the LAT link) also fails; because the LAN driver tries to use the address based on SCSSYSTEMID:* LATCP> CREATE LINK LAT$LINK_2 /NODECNET< If SCSSYSTEMID is set to 0, configuring LAT and DECnet on; different controllers is possible. However, in a cluster/ environment, SCSSYSTEMID cannot be set to 0. /DEVICE /DEVICE=device-nameD Specifies the LAN controller device name for a LAT data link (forC example, XEB0:). Only one LAT data link can be associated with aC LAN controller. If you enter the CREATE LINK command without theD /DEVICE qualifier, LATCP attempts to find an available controller: by using a list of possible LAT data link device names.A VSI advises that you specify a default device name by defining the LAT$DEVICE logical name. /LOG /LOG /NOLOG= Specifies whether LATCP displays a message confirming thatA the link was created. If you do not specify the /LOG or /NOLOG? qualifier, the default is that no message will be displayed. /STATE /STATE=optionB Specifies whether the link will be available for use. STATE can have two options:B ON Specifies that the created link will be available for use' with the LAT protocol running.B OFF Specifies that the created link will not be available for use.D If you do not specify the /STATE=option qualifier, the default is8 that the created link will be available for use (ON). 3 Example5 LATCP> CREATE LINK NETWORK_A /DEVICE=XEB0: /STATE=ON@ The CREATE LINK command in this example creates an Ethernet? link named NETWORK_A. It specifies the Ethernet controllerC device XEB0 for that link. The link will be available for use. 2 PORTA Creates a logical port on your local node that connects with aB remote device on a terminal server. Alternatively, this commandA creates a logical port on your local node that connects with aD specific service. The service can be offered by a terminal serverA or associated with one or more dedicated ports on a remote LAT service node.4 You must have OPER privilege to use this command. Format CREATE PORT [port-name] 3 Parameter port-nameA Specifies the port name in the form LTAn:, where n is a unique> number from 1 through 9999. If the port you specify already5 exists, LATCP returns the following error message:6 %LAT-W-CMDERROR, error reported by command executor$ -SYSTEM-F-DUPLNAM, duplicate name< If you do not specify the port name, you must specify the /LOGICAL qualifier.& NOTES/ When creating a port, note the following:; o VSI recommends that you assign a logical name when> creating a port, instead of specifying a specific LTA device.> o You cannot use the CREATE PORT and SET PORT commands,? along with the DCL command SET TERMINAL, to change the? characteristics of a DECserver port unless there is an3 existing LAT connection to that DECserver. 3 Qualifiers /APPLICATION? Specifies that a logical port on your node is an applicationB port. It can be used to connect to a remote device (typically aB printer) on a terminal server or to a dedicated port on another LAT service node.> If you do not specify a port type, the default port type is APPLICATION.& NOTE< By default, LATCP creates application LAT devices with> the HANGUP terminal characteristic. However, if you want= to apply the NOHANGUP characteristic to application LAT? devices, you can do so by entering specific LATCP and DCL commands. For example: $ LCP :== $LATCP $ LCP CREATE PORT LTA1234Q $ LCP SET PORT LTA1234 /APPLICATION /NODE=terminal_server /PORT=server_port1 $ SET TERMINAL LTA1234 /PERMANENT /NOHANGUP> Note that you can insert the SET TERMINAL command in the? SYS$MANAGER:LAT$SYSTARTUP.COM file (enter the command forA each LAT device that requires the NOHANGUP characteristic). /DEDICATED@ Specifies that a logical port on your local node is dedicatedA to an application service. When users on a terminal server (or> on another node that supports outgoing connections) request? a connection to this service name, they are connected to theD dedicated port. See the OpenVMS I/O User's Reference Manual for a5 description of programming an application service.> After creating a dedicated port on a node, use the SET PORT2 /SERVICE command to map this port to a service. /LIMITEDA Specifies that a logical port on your local node is limited to@ a service in th e same way a port created using the /DEDICATEDC qualifier is dedicated to an application service. The differenceC is that ports created using the /LIMITED qualifier are under theA control of the system login image (LOGINOUT.EXE) instead of anD application program (a user who connects to a limited service andB is assigned to a limited port receives the "Username:" prompt).@ Using the /LIMITED qualifier, you can create a limited numberB of ports and map them to a specific service offered by the hostA system. If users are logged in to all of the limited ports for? the service, no more connections are allowed to that service> (terminal server users receive a "service in use" message). /LOG /LOG /NOLOG= Specifies whether LATCP displays a message confirming thatA the port was created. If you do not specify the /LOG or /NOLOG? qualifier, the default is that no message will be displayed. /LOGICAL< /LOGICAL=(NAME=logical-name[,TABLE=table][,MODE=mode])D Specifies a logical name to be associated with the actual name ofB the created port. You must specify a logical name if you do not specify a port name.& NOTEB If you have sufficient privileges to create a port, but lackA the privilege to assign a logical name, the port will still be created.= You can specify one of the following options for the TABLE keyword:? GROUP Places t he logical name in the group logical name@ table. You must have GRPNAM or SYSPRV privilege toE place the logical name in the group logical name table.A JOB Places the logical name in the jobwide logical name table.A PROCESS Places the logical name in the process logical name) table. This is the default.@ SYSTEM Places the logical name in the system logical name@ table. You must have SYSNAM or SYSPRV priv ilege to< place a name in the system logical name table.B You can also specify the name of a specific table. For example,B you could specify LNM$PROCESS, which would be the equivalent of specifying PROCESS.$ Options for the MODE keyword are:D EXECUTIVE Creates an executive mode logical name. You must haveC SYSNAM privilege to create an executive mode logical name.6 SUPERVISOR Creates a supervisor mode logical name.0 USER ! Creates a user mode logical name.A The access mode associated with the logical name is determinedC by maximizing the access mode of the caller with the access modeC specified by the MODE keyword: the mode with the lower privilege is used.A You cannot specify an access mode with a privilege higher thanB that of the table containing the logical name. However, if yourB process has SYSNAM privilege, then the specified access mode isD associated with the logical name re"gardless of the access mode of the caller.A If you omit the MODE keyword, the access mode of the caller is$ associated with the logical name.< You can also create the port as a limited port, using the /LIMITED qualifier. 3 Examples+ 1.LATCP> CREATE PORT LTA22: /APPLICATIONC The CREATE PORT command in this example creates an applicationD port named LTA22: on a service node. You can associate the portC with a specific printer on a terminal server (u #se the SET PORTA /NODE /PORT command) or with a set of printers on a terminalB server (use the SET PORT /NODE /SERVICE command). Or, you canA associate the port with a dedicated port on a remote serviceA node. In this case, use the SET PORT /NODE /SERVICE command,B where the /SERVICE qualifier specifies an application serviceA associated with a dedicated port on the remote node. See the' examples for the SET PORT command.) 2.LATCP> CREATE PORT LTA21: /DEDI $CATED? The CREATE PORT command in this example creates the LTA21:< port. It will be used as a dedicated port that offers a@ specific service rather than a general timesharing service.+ 3.LATCP> CREATE PORT /LOG /APPLICATION -F _LATCP> /LOGICAL=(NAME=MAIL_PORT, TABLE=PROCESS, MODE=SUPERVISOR)C The CREATE PORT command in this example creates an application? port. It assigns the name of the new port to the specified: logical name (MAIL_PORT). The logical i %s created as aB supervisor mode logical name in the LNM$PROCESS_TABLE logical7 name table. LATCP displays a confirmation message. 4.$ LCP :== $LATCP* $ LCP CREATE SERVICE/LIMITED ONLY_ONE' $ LCP CREATE PORT/LIMITED LTA1234:. $ LCP SET PORT LTA1234: /SERVICE=ONLY_ONEB This series of commands creates a limited service that allows@ only one user to log in to the system through that service.B 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 SERVICED Creates a service on a service node. You must have OPER privilege to use this command. Format# CREATE SERVICE [service-name] 3 Parameter service-nameB Specifies a LAT service name. By defa'ult, a service name is the@ name of the local node you defined with the SET NODE command.C The service name can be from 1 to 16 ASCII characters in length.) The characters allowed are as follows:, o Alphanumeric characters: A-Z, a-z, 0-9C o A subset of the international character set: ASCII codes 192- 253A o Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore (_) 3 Qualifiers /APPLICATIONC Specifies that (the created service is an application service. AnC application service offers a specific application on the serviceC node rather than a general interactive service. You can define aB dedicated port for the service by using the CREATE PORT and SET PORT commands. /IDENTIFICATION/ /IDENTIFICATION[="identification-string"]@ Describes and identifies a service. Service nodes include theA identification string in service announcements. A service nodeC announces i )ts 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 includesD this identification string. By default, the identification string$ is a translation of SYS$ANNOUNCE.9 You cannot specify more than 64 ASCII characters in anA identification string (a SYS$ANNOUNCE longer than that will be? truncated to the first 64 characters). Enclose the string in quotation m*arks ("). /LIMITEDA Specifies that the service is a limited service, using devicesB assigned the limited characteristic and associated with (mappedB to) this limited service. This qualifier is used in conjunction4 with the SET PORT /LIMITED command (see example). /LOG /LOG /NOLOGA Specifies whether LATCP displays a message confirming that the@ service was created. If you do not specify the /LOG or /NOLOG? qualifier, the default is that no messa+ge will be displayed. /STATIC_RATING /STATIC_RATING=rating /NOSTATIC_RATINGA Enables or disables dynamic service ratings. A dynamic service@ rating means that a LAT algorithm calculates the availabilityC of a service dynamically, based on the overall level of activity@ of the node that offers the service and the amount of memory.D When a terminal server or node requests a connection to a service? that is offered on two or more service nodes, the requestin ,gB node selects the service node with the highest (most favorable)C 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.D However, when necessary, you can use the /STATIC_RATING qualifier? to disable dynamic service ratings so that you can specify aB static (fixed) rating. That static rating value does not change1 until the dynamic service r -ating is reenabled.A Use the static rating to direct users away from or toward yourB node temporarily. Static ratings range from 0 to 255. Specify aC low value to make the local service node less likely to be used;B 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_B 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 areC available for the service. For example, if a limited service hasA 50% of its ports available, the dynamic service rating will beC scaled, halved, and then added to 105. When ports are available,1 the rating will always be above the value 105.B When all ports for a limited or application service are in use,@ the r /ating 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 andB available ports that the service offers, while at the same timeA taking into account the availability of the node (which is the0 factor used to calculate the dynamic rating).C If your system is licensed for 0a specific number of units (whereC only a fixed number of users can log in to the system regardlessD of how the login limit is set), then all dynamic ratings become 0B when all OpenVMS license units have been consumed. (This forcesD all node service ratings to the lowest possible value when logins? are not possible because all OpenVMS license units have been consumed.)9 Note as well that the LAT software transmits a serviceD announcement message when a user logs in to o1r out of the system.= This allows the system to more quickly provide informationB about service rating changes that result from a login or logout operation. 3 Examples2 1.LATCP> CREATE SERVICE/STATIC_RATING=195 SALESC The CREATE SERVICE command in this example creates the serviceB SALES on a service node. This command assigns a static rating@ of 195 so terminal servers (and nodes that support outgoing@ connections) can assess the availability of service2s on the node./ 2.LATCP> CREATE SERVICE/APPLICATION GRAPHICSA This command creates the service GRAPHICS on the local node.@ Use the CREATE PORT/DEDICATED and SET PORT/SERVICE=GRAPHICSA commands to create a port that is dedicated to this service. 3.$ LCP :== $LATCP* $ LCP CREATE SERVICE/LIMITED ONLY_ONE' $ LCP CREATE PORT/LIMITED LTA1234:. $ LCP SET PORT LTA1234: /SERVICE=ONLY_ONEB This series of commands creates a limited service that allows3@ only one user to log in to the system through that service.B 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. wwL 1 DEFINE 2 /KEYC Assigns a command string to a function key. For examp4le, you can8 assign the LATCP SHOW NODE command to a function key. Format, DEFINE/KEY key-name equivalence-string 3 Parameters key-nameB Specifies the name of the function key that you want to define." Valid key names are as follows: LK201/LK401= Key Name Keyboards VT100-Type VT52-Type8 PF1 PF1 PF1 Blue7 PF2 PF2 PF2 Red9 PF3 5 PF3 PF3 Black' PF4 PF4 PF4> KP0-KP9 Keypad 0-9 Keypad 0-9 Keypad 0-91 PERIOD Keypad period (.) Keypad period' (.)0 COMMA Keypad comma (,) Keypad comma' (,)0 MINUS Keypad minus (-) Keypad minus' (-)9 Enter Enter Enter Enter5 FIND 6Find - -5 INSERT_HERE Insert Here - -5 REMOVE Remove - -5 SELECT Select - -5 PREV_SCREEN Prev Screen - - (LK201) Prev (LK401)5 NEXT_SCREEN Next Screen - - (LK201) Next (LK401)5 HELP Help - -5 DO Do7 - -5 F6-F20 F6-F20 - - equivalence-string= Specifies the command string that you want assigned to the= function key. To preserve spaces and lowercase characters,/ enclose the string in quotation marks (" "). 3 Qualifiers /ECHO /ECHO /NOECHO> Specifies whether LATCP displays the command string on yourA screen when you press the key. If you do not specify the /ECHO? o8r /NOECHO qualifier, the default is that the command stringB will be displayed. You cannot use /NOECHO with the /NOTERMINATE qualifier. /IF_STATE /IF_STATE=state-name> Specifies the state that must be set (for example, the GOLD9 state) for the key definition to work. Lets you assign@ alternative meanings to keys when the specified state is set.B See the discussion of the /SET_STATE qualifier. If you omit theD /IF_STATE qualifier, LATCP uses the current state9. The state nameC is an alphanumeric string. States are established with the /SET_ STATE qualifier. /LOCK_STATE /LOCK_STATE /NOLOCK_STATEB Specifies that the state set by the /SET_STATE qualifier remainC in effect until explicitly changed. If you use the /NOLOCK_STATE@ qualifier, the state set by /SET_STATE remains in effect onlyB for the next definable key that you press or for the next read-B terminating character (such as Return or Ctrl/Z) that y:ou type.@ You can specify the /LOCK_STATE qualifier only with the /SET_< STATE qualifier. If you do not specify the /LOCK_STATE orD /NOLOCK_STATE qualifier, the default is that the state set by theC /SET_STATE qualifier remains in effect until explicitly changed. /LOG /LOG /NOLOGA Specifies whether LATCP displays a message confirming that theA command was executed. If you do not specify the /LOG or /NOLOG? qualifier, the default is that no message wil;l be displayed. /SET_STATE /SET_STATE=state-nameB Causes the specified state to be set when you press the definedC key. The state name can be any alphanumeric string (for example,; GOLD). Use the DEFINE/KEY/IF_STATE=state-name command toC associate new meanings for keys when the specified state is set.. See the example for the DEFINE/KEY command.C If you omit the /SET_STATE qualifier, the current state that was locked remains in effect. /TERMINATE< /TERMINATE /NOTERMINATE: Specifies whether the command string will be terminated> (processed) when you press the function key. The default is@ /NOTERMINATE, which allows you to press other keys before theC command string is processed. Pressing Return has the same effect as using /TERMINATE.B The /NOTERMINATE qualifier allows you to create key definitionsD that insert text into command lines, after prompts, or into other text that you are typing. =3 Example? LATCP> DEFINE/KEY PF4 "SHOW NODE " /NOTERMINATE/SET_STATE=GOLD5 LATCP> DEFINE/KEY PF4 "/ALL"/IF_STATE=GOLD/TERMINATEB The first DEFINE/KEY command in this example assigns the SHOW? NODE command to function key PF4. To process the SHOW NODE@ command, you must press Return after pressing PF4. Note theD space after the word NODE in the first DEFINE/KEY command. ThisC space allows you to enter a node name after pressing PF4. WhenA you press Return, the S>HOW NODE command is processed. If theA space is omitted, LATCP does not recognize the command (SHOWB NODE). The state is set to GOLD; that state will be in effect% for the next key that you press.A The second DEFINE/KEY command defines the use of the PF4 keyD when the keypad is in the GOLD state. When you press PF4 twice,, the SHOW NODE/ALL command is processed. wwL 1 DELETE 2 LINKC Deletes a logical link from a node. You mus?t have OPER privilege to use this command. Format DELETE LINK link-name 3 Parameter link-name: Specifies the name of the link that you want to delete.= Use the SHOW LINK command for a list of the links that are defined for your node. 3 Qualifiers /LOG /LOG /NOLOG= Specifies whether LATCP displays a message confirming thatA the link was deleted. If you do not specify the /LOG or /NOLOG? qualifier, the de@fault is that no message will be displayed. 3 Example" LATCP> DELETE LINK NETWORK_A /LOG= The DELETE LINK command in this example deletes the linkB NETWORK_A. The link was created with the CREATE LINK command. 2 PORTC Deletes a logical port from a node. You must have OPER privilege to use this command. Format DELETE PORT port-name 3 Parameter port-nameC Specifies the name of the application port or the dedicated portD A that you want to delete. An application port connects to a remoteD device on a terminal server, whereas a dedicated port connects to a special service.D Use the SHOW PORT command for a list of the application ports andB the dedicated ports that are defined for your service node. YouA cannot use the DELETE PORT command to delete an interactive or forward LAT port. 3 Qualifiers /LOG /LOG /NOLOG= Specifies whether LATCP displays a message confBirming thatA the port was deleted. If you do not specify the /LOG or /NOLOG? qualifier, the default is that no message will be displayed. 3 Example LATCP> DELETE PORT LTA27:? The DELETE PORT command in this example deletes the LTA27:@ application port. The port was created with the CREATE PORT command. 2 QUEUE_ENTRY? Deletes an incoming queued request, or entry, from the local node. Format' DELETE QUEUE_ENTRY queue-entry-id C 3 Parameter queue-entry-idD Specifies the identification number (ID) of the queued entry that you want to delete.> Use the SHOW QUEUE_ENTRY command to view the list of queued entries and their IDs. 3 Example LATCP> DELETE QUEUE_ENTRY 0056C The DELETE QUEUE_ENTRY command deletes the queued request with an ID of 0056. 2 SERVICEA Deletes a service that your service node currently offers. You0 must have OPER privilege to use this comm"Dand. Format! DELETE SERVICE service-name 3 Parameter service-name> Specifies the name of the service, as displayed by the SHOW SERVICE command. 3 Qualifiers /LOG /LOG /NOLOGA Specifies whether LATCP displays a message confirming that the@ service was deleted. If you do not specify the /LOG or /NOLOG? qualifier, the default is that no message will be displayed. 3 Example LATCP> DELETE SERVICE SALES; E The DELETE SERVICE command in this example removes theC service SALES from your service node. The service is no longer available to server users. wws1 EXITB Stops execution of LATCP and returns control to the DCL command8 level. You can also enter Ctrl/Z at any time to exit. Format EXIT 2 Parameters None. 2 Example LATCP> EXITA The EXIT command in this example exits the LATCP program and. returns cFontrol to the DCL command level. wws1 HELPA Provides online help information for using the LATCP commands. Format HELP [command-name...] 2 Parameter command-nameD The name of a LATCP command or LATCP command and command keyword.B If you enter the HELP command with a command name only, such asA HELP SET, LATCP displays a list of all of the command keywords used with the SET command. 2 Example LATCP> HELP SET PGORT: In this example, the HELP SET PORT command produces a> description of the SET PORT command and shows the command format. wws 1 RECALLC Displays previously entered LATCP commands on the screen so that you can execute them again. Format RECALL [command-specifier] 2 Parameter command-specifierD Specifies the number or the first several characters of the LATCPB command you want to recall. Command numbers cHan range from 1 to5 20. The most recently entered command is number 1.C Use the /ALL qualifier to display all the commands in the RECALLD buffer, along with their command number so that you can determine5 the number of the command that you want to recall.D If you do not include the command specifier or the /ALL qualifier< when entering the RECALL command, LATCP displays the last command. 2 Qualifiers /ALL> Specifies that LATCP display all the commandsI in the RECALL5 buffer. LATCP displays the number of each command. 2 Examples 1.LATCP> RECALL 2C In this example, the RECALL command recalls the second-to-last command you entered. 2.LATCP> RECALL SET= In this example, the RECALL command recalls the last SET command you entered. wws 1 REFRESHB Refreshes the display screen so that any output from some otherB source (such as a broadcast message) is erased from the s'Jcreen. Format REFRESH 2 Example LATCP> REFRESHB In this example, the REFRESH command refreshes the display on your screen. wws 1 SCROLL? Allows you to retrieve information that has scrolled off the screen, either up or down. Format SCROLL 2 Parameters None. 2 Qualifiers /DOWN /DOWN[=value]< Scrolls the LATCP screen display down the number of linesB indicated bKy the specified value. For convenience, you can alsoD use the Next (or Next Screen) key on your keyboard to scroll down= 15 lines (instead of entering the SCROLL/DOWN=15 command).9 If you do not specify a value, the default value is 1. /UP /UP[=value]D Scrolls the LATCP screen display up the number of lines indicated@ by the specified value. For convenience, you can also use theC Prev (or Prev Screen) key on your keyboard to scroll up 15 lines2 (instead ofL entering the SCROLL/UP=15 command).9 If you do not specify a value, the default value is 1. 2 Example LATCP> SCROLL /UP=5B The SCROLL command in this example allows you to scroll up toC view five lines of screen display that has previously scrolled off the viewing area. wws1 SET 2 LINKD Changes the characteristics of LAT data links. You must have OPER! privilege to use this command. Format SET LINK link-Mname 3 Parameter link-nameB Specifies the name for a LAT data link. A link name can have upA to 16 ASCII characters. The characters allowed are as follows:, o Alphanumeric characters: A-Z, a-z, 0-9C o A subset of the international character set: ASCII codes 192- 253A o Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore (_)D The SHOW LINK command displays the names of the links defined for a node. N3 Qualifiers /LOG /LOG /NOLOGA Specifies whether LATCP displays a message confirming that theB link's characteristics were modified. If you do not specify theC /LOG or /NOLOG qualifier, the default is that no message will be displayed. /STATE /STATE=optionB Specifies availability of the link for use. The two options for STATE are:B ON Specifies that the link will be available for use with% the LAT protocol runOning.B OFF Specifies that the link will not be available for use.D If you do not specify the /STATE=option qualifier, the default is( that the link will be available (ON). 3 Example) LATCP> SET LINK NETWORK_A /LOG /STATE=ON@ The SET LINK command in this example directs LATCP to start< the controller for link NETWORK_A and then to display a confirmation message. 2 NODEA Specifies the LAT characteristics of your local node. You must+ have OPPER privilege to use this command. Format SET NODE [node-name] 3 Parameter node-nameB Specifies a node name for your local node. By default, the nodeA name is the translation of SYS$NODE. A LAT node name should be? the same as the DECnet node name. If the node is not running< DECnet but will be in the future, VSI recommends that youA define SYS$NODE and use it for both DECnet and LAT node names.< A LAT node name can be from 1 to 16 ASCII charactQers. The% characters allowed are as follows:, o Alphanumeric characters: A-Z, a-z, 0-9C o A subset of the international character set: ASCII codes 192- 253A o Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore (_) 3 Qualifiers /ANNOUNCEMENTS /ANNOUNCEMENTS /NOANNOUNCEMENTS? Allows you to control whether your OpenVMS system multicasts information to the network.A If you specify /NOANNOUNC REMENTS, LAT service announcements are@ disabled on the local node. Remote nodes must rely on the LATB service responder feature in the LAT protocol V5.2 or higher to< connect to the local node. Therefore, VSI recommends that@ you use this qualifier only in a networking environment where> newer model terminal servers and hosts are present (all LATA hosts, terminal servers, and PCs are running LAT protocol V5.2 or higher).> If you specify /NOANNOUNCEMENTS in an environment wShere LATA protocol V5.1 is present, those LAT protocol V5.1 systems (forB example, DECserver 100, 200, and 500 systems) will be unable toD connect to any of the systems that have LAT service announcements disabled. /CIRCUIT_TIMER /CIRCUIT_TIMER[=msecs]= Allows you to control the interval in milliseconds (msecs)C between messages sent from the local node to other service nodesC or terminal servers while connections to those nodes are active.C Use this qual Tifier only if your node allows outgoing connections5 (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).C A low value for the interval decreases the response time for theB port but increases the demand on service nodes. Set the circuit* timer in the range of 10 to 1000 msecs.= The default value of 80 msecs gives a generally acceptable@ response time while creating a moderately low overhead on theA service nodes. You cannot change this parameter when active or! pending LUAT connections exist. /CONNECTIONS /CONNECTIONS=optionC Allows you to specify the type of connections permissible on the4 local node. The four options for CONNECTIONS are:? INCOMING_ Specifies that the local node permit incoming# ONLY connections only.? OUTGOING_ Specifies that the local node permit outgoing@ ONLY connections only. Specify this on systems thatD can tolerate the overhead associated with outgoing V: connections, such as standalone systems.D BOTH Specifies that the local node permit both incomingC and outgoing connections. Specify this on systems@ that can tolerate the overhead associated withC outgoing connections, such as standalone systems.= NONE Specifies that the local node disallow both4 incoming and outgoing connections.? If you do not specify the /CONNECTIONS=optionW qualifier, theB default is that the node will permit incoming connections only. /CPU_RATING /CPU_RATING=cpu-power /NOCPU_RATINGB The /CPU_RATING qualifier assigns your local node a rating thatD represents the power of your node's CPU (central processing unit)@ relative to other CPUs in the LAN. The value of cpu-power canC range from 1 (for a CPU with the lowest power) to 100 (for a CPU with the highest power).D When a terminal server or node requ Xests a connection to a serviceB that is offered on the local node and one or more other service? nodes, the requesting node selects the service node with the@ highest (most favorable) service rating, based on the overall< level of activity of the node that offers the service and> the amount of memory. This selection process is called load balancing.< You can influence the rating for services on your node byC specifying a value for the /CPU_RATING qualifier. If you specifyY> a high value for cpu-power, the LAT driver will calculate aD relatively high service rating for services on your node (serviceD ratings as high as 255 are possible). If you specify a low value,@ the LAT driver will calculate relatively low service ratings;@ connections will most likely be made to the same service that@ is offered on other nodes. In either case, the LAT driver canB calculate a greater range of values for dynamic service ratingsC (the entire range from 0 to 255Z). Consequently, the ratings will@ more accurately reflect the availability of the service node.D If you do not specify either the /CPU_RATING=cpu-power or /NOCPU_C RATING qualifier, the default is that no CPU rating will be used( A value of 0 indicates no CPU rating. /DEVICE_SEED /DEVICE_SEED[=value]B Sets the default starting number (within a range from 1 through> 9999) for the unit numbers that will be assigned to new LTAC devices. Note that when ports are [ created by assigning a channel@ to LTA0: with the $ASSIGN system service, the channel numbers fall in this same range.= The default device seed value is approximately half of the@ maximum unit number (which you set by using the /UNIT_NUMBER_? MAXIMUM qualifier). Interactive LAT ports, and those createdB with the CREATE PORT/LOGICAL command, are assigned unit numbers@ beginning with the specified device seed value and continuingA up to the maximum unit number. When the m\aximum unit number is? reached, the port is assigned the next available unit number0 beginning at the bottom of the range (LTA1:).; Note that each time you specify the /UNIT_NUMBER_MAXIMUMB qualifier, the device seed value is reset to approximately half. of the newly specified maximum unit number. /FORWARD_SESSION_LIMIT$ /FORWARD_SESSION_LIMIT[=value]B Controls the number of sessions (a value within a range from 16C through 255) allowed on each outgoing conne ]ction. By default, 16C sessions are allowed on an outgoing connection, which means thatD 16 individual processes can direct the DCL command, SET HOST/LAT, to the same remote node.= You must increase the value for the /FORWARD_SESSION_LIMIT9 qualifier if a user on your system enters the command,B SET HOST/LAT, and receives an error message indicating that the? session limit for the LAT circuit has been reached ( %LAT-F-@ VCSESLIM). Note, however, that you can change thi^s value only when no connections exist. /GROUPS /GROUPS=option[,...]= Gives the listed groups access to services offered on yourC local node or prevents the listed groups from accessing services= offered on your local node, depending on the options used.@ A network manager organizes terminal server nodes into groupsC based on the number of terminal server nodes in the LAT network.D Groups subdivide the LAT network, limiting the number of terminal; ser _ver nodes that can connect with a given service node.@ As manay as 256 groups, numbered 0 through 255, can be in the? LAT network. By default, all terminal server nodes and nodesB supporting outgoing connections belong to group 0. If you enterB one group code, you can omit the parentheses. Use the SHOW NODEB command for a list of the groups enabled for your service node.= The /GROUPS qualifier has several options. For each option5 described, you can specify more than one gr`oup by:& o Listing them separated by commas o Specifying a range The available options are:D ENABLE=group- Gives the listed groups access to your service code[,...] node.? DISABLE=group- Prevents the listed groups from accessingC code[,...] your service node. The listed groups had beenA enabled previously for access to your node.@ ENABLE=group- This option lets you enable certain groupsC code[,...], a and disable other groups in one command line:@ DISABLE=group- gives access to the groups listed with the? code[,...] ENABLE option and removes access from theD groups listed with the DISABLE option. EncloseA both ENABLE and DISABLE in parentheses; for6 example, /GROUP=(ENABLE=(10,12),& DISABLE=(1-30)). /IDENTIFICATION/ /IDENTIFICATION[="identification-string"]= Describes b and identifies a node. Service nodes include theA identification string in service announcements. A service nodeC 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 includesD this identification string. By default, the identification string& is the translation of SYS$ANNOUNCE.9 You cannot specify more than 64 ASCII characters in anA identificcation string (a SYS$ANNOUNCE longer than that will be? truncated to the first 64 characters). Enclose the string in quotation marks (" "). /KEEPALIVE_TIMER /KEEPALIVE_TIMER[=secs]> Allows you to control the maximum interval between idle runD messages sent by your local node to another service node to whichA it has a LAT connection. The interval is in seconds. Your node@ sends these messages when no other traffic is being generated= over the virtual circuit. d If the service node acknowledges@ these messages, your node will continue to monitor the statusC of the circuit. If your node does not receive acknowledgment, it& responds as if the circuit is down.C Use this qualifier only if your node allows outgoing connections5 (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).9 The default value is 20. VSI recommends this value for> normal LAN environments. For a heavily loaded LAN, considerA using a higher value. Set the timer ien the range of 10 to 255.@ For applications that require quick notification and possibleD failover of a service node failure, use a lower value. You cannot< change this value if active or pending connections exist. /LARGE_BUFFER /LARGE_BUFFER /NOLARGE_BUFFERD Allows you to control whether the LAT software uses large buffers= while managing communications between OpenVMS systems (the default).A If you must use the /NOLARGE_BUFFER qualifier (for exam fple, toA limit packet sizes to be no larger than the Ethernet maximum),9 VSI recommends that you specify this command after all> logical LAT links have been created and before the LAT node> has been turned on. For example, note following commands in LAT$SYSTARTUP.COM: $!: $! Create each logical LAT link with a unique name and2 $! unique LAN address (forced with /NODECNET). $!3 $ LCP CREATE LINK FDDI_1 /DEVICE=FCA0 /NODECNET3 $ LCP CREATE LINK FDDI_2 /DEgVICE=FCB0 /NODECNET $!3 $! Don't use large buffer support (force packet3 $! sizes to be no larger than what Ethernet can $! support). $!" $ LCP SET NODE /NOLARGE_BUFFER $! $! Turn on the LAT protocol. $! $ LCP SET NODE /STATE=ON /LOG /LOG /NOLOGA Specifies whether LATCP displays a message confirming that theB node's characteristics were modified. If you do not specify theC /LOG or /NOLOG qualifier, the default is thath no message will be displayed. /MULTICAST_TIMER /MULTICAST_TIMER[=secs]B Specifies the time, in seconds, between multicast messages sent@ by a service node. A multicast message announces the servicesB offered by a service node. The minimum value is 10 seconds; the3 maximum is 180 seconds. The default value is 60. /NODE_LIMIT /NODE_LIMIT=value /NONODE_LIMIT: Specifies the maximum number of service nodes that your= local node can st iore in its service and node database. Use? this qualifier only if your node allows outgoing connections5 (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).> When the database reaches the node limit, no more nodes are> added to the database when your local node receives serviceC announcement messages. You can ensure that the node limit is notA reached by using the /USER_GROUPS qualifier to restrict access= from the local node to other service nodes on the network.A If jyou do not specify either the /NODE_LIMIT=value or /NONODE_C LIMIT qualifier, the default is no limit. A value of 0 indicates no limit. /QUEUE_LIMIT /QUEUE_LIMIT=value? Allows you to set a limit on the number of entries (incomingC LAT connections only, not outgoing printer connections) that areB queued on the system. The queue limit value can range from 0 toD 200, with a default of 24. A value of 0 indicates that no queuing is allowed. /RETRANSMIT_LI kMIT /RETRANSMIT_LIMIT[=count]8 Specifies the number of times your local node repeatsC transmission of a message to a service node after a transmission? fails. If the transmission is still unsuccessful after these@ attempts, the virtual circuit between your local node and theC service node terminates, along with all sessions associated with the virtual circuit.C Use this qualifier only if your node allows outgoing connections5 (/CONNECTIONS=OUTGOING_ONLY or l/CONNECTIONS=BOTH).B Specify a value in the range of 4 to 120. The default is 8. TheA value you choose depends on the type of physical link used forA your network, as well as the amount of traffic on the network.D See your network manager for a suggested value. You cannot change5 this value if active or pending connections exist. /SERVICE_RESPONDER /SERVICE_RESPONDER /NOSERVICE_RESPONDERB Specifies whether your system responds to special LAT multicastC m messages that request service information. Some terminal serversB do not have their own service and node database. When a user onA such a terminal server requests a connection to a service, theA server sends a LAT multicast message requesting names of nodesB that offer the requested service. Service responder nodes reply" with the requested information.A If you specify /SERVICE_RESPONDER, your system responds to the> special LAT multicast messages. (If you specify /NOSERV nICE_> RESPONDER, your system does not respond to those messages.): VSI recommends that you set up only one or two nodes in@ the LAN as service responder nodes. The nodes should have theB largest databases in the LAN. Use this option only if your node= allows outgoing connections (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).9 If you do not specify either the /SERVICE_RESPONDER orB /NOSERVICE_RESPONDER qualifier, the default is that your system: will not respond to tohe special LAT multicast messages. /SESSION_LIMIT /SESSION_LIMIT=option? Specifies the maximum number of simultaneous sessions across@ all local-access ports. This limit does not affect the use of? dedicated and application ports. It affects interactive port> creation only, limiting the amount of resources consumed by+ interactive users creating new sessions.4 The options for the /SESSION_LIMIT qualifier are:B INCOMING=value Sets the session plimit for incomingB connections only. The default is no4 limit (a value of 0).B OUTGOING=value Sets the session limit for outgoingB connections only. The default is no4 limit (a value of 0).? INCOMING=value,OUTGOING=valuSets the limit for both outgoing@ and incoming connections. Enclose? both option qs in parentheses; forD example, /SESSION_LIMIT=(INCOMING=20,, OUTGOING=25).C o A high limit allows users to have more sessions but increases, memory utilization on your local node.A o A low limit decreases memory utilization on your local node8 but limits user access to services on the network.? If the limit is reached, interactive users cannot create newC sessions. In this case, increase the session limirt or disconnect1 any connections that are no longer being used.C Specify a value in the range of 0 to 255. Specifying 0 leaves noB limit on the number of sessions that can be created. To prevent? sessions from being created, use the /CONNECTIONS qualifier.B Not specify the /SESSION_LIMIT qualifier causes no limit on theA number of incoming and outgoing sessions. This is the default. /STATE /STATE=optionC Specifies whether LAT connections are allowed. Th se three options for STATE are:B ON Starts the LAT port driver (and LAT protocol software) on your node.> VSI strongly recommends that the LATCP command SETC NODE/STATE=ON be executed before any LTA application orC dedicated ports are created (use the format provided in@ SYS$MANAGER:LAT$SYSTARTUP.TEMPLATE) for two reasons:@ o It ensures that LTDRIVER will delete any leftoverC LTA devices tha tt have a reference count of 0 and are@ explicitly marked for deletion (using the $DASSGN? system service or the LATCP DELETE PORT command,@ for example). Because every LATCP management portA (LATCP$MGMT_PORT) that was created by the previousD LATCP invocation is deleted, no conflicts result withC the LAT application ports or newly created dedicated ports.D o The deletion of lef utover LTA devices with a referenceD count of 0 minimizes the use of nonpaged pool memory.D OFF Stops the LAT port driver (and LAT protocol software) onD your node. Any existing LAT connections are aborted. AnyB characteristics that you changed or set with LATCP are lost.@ To start the LAT protocol on your node again, invoke? LAT$STARTUP.COM. The LAT characteristics defined in/ LAT$SYSTARTUP.COM will t vake effect.C SHUT Specifies that new LAT connections cannot be created onC your local node, but existing connections may continue.B The LAT protocol continues running only until the lastB active session disconnects, (after which LTDRIVER willD stop). At that time, your node changes to the OFF state.' CAUTION? If you stop the LAT software by specifying either the SET< NODE/STATE=OFF or SET NODE/SwTATE=SHUT command, the LATB print symbiont (LATSYM) will shut down all print queues that> it is processing. The system will then generate an OPCOM? message indicating that the print queues are stopped. You/ must manually restart those print queues.D If you do not specify the /STATE=option qualifier, the default isB that the LAT port driver and LAT protocol software on your node will be started (ON). /UNIT_NUMBER_MAXIMUM /UNIT_NUMBER_MAXIMUM=value xC Specifies the maximum unit number for a LAT device. For example,? if you specify 140, then LTA140: will be the device with the> highest unit number. Specify a value that is high enough toB accommodate all devices that may be in use simultaneously. WhenB the number of devices in use exceeds the value you specify, theA system gives certain LAT devices unit numbers that exceed your maximum. Note the following as well:B o When LATCP reaches the maximum unit number, yit will continue@ to implicitly create LTA devices beginning with the lowest available unit number.B o You cannot use the System Generation (SYSGEN) utility to set/ the maximum unit number for a LAT device.D The range of maximum unit numbers is 99 through 9999. The defaultD is 9999. Note that each time you specify the /UNIT_NUMBER_MAXIMUMA qualifier, the LTA device seed value is reset to approximately3 half of the newly specified maximum unit number. /U zSER_GROUPS /USER_GROUPS=option[,...]A Restricts access (from the local node) to service nodes in theC network that belong to the specified groups. Your local node canB access only those service nodes associated with the user groupsA specified. The /USER_GROUPS qualifier also serves to limit theB number of nodes stored in your node's node database. (The localA node only stores information about the nodes and services thatD belong to at least one of the specified use{r groups.) By default,+ all LAT service nodes belong to group 0.C This qualifier affects your local node when outgoing connectionsA are enabled (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).C Use the SHOW NODE command for a list of the user groups (service! groups) enabled for your node.B The /USER_GROUPS qualifier has several options. For each option@ described here, you can use two ways to specify more than one group:# o List them separated by commas | o Specify a range? ENABLE=group- Gives your node access to the listed user code[,...] groups.B DISABLE=group- Prevents your node from accessing the listed< code[,...] groups. The listed groups were enabled! previously.@ ENABLE=group- This option lets you enable certain groups= code[,...], and disable other groups in one command@ DISABLE=group- line: gives your node access to the groups@ code[,...] } listed with the ENABLE option and prevents@ your node from accessing the groups listedB with the DISABLE option. Enclose both ENABLE> and DISABLE in parentheses; for example,- /GROUP=(ENABLE=(10,12),& DISABLE=(1-30)). 3 Examples> 1.LATCP> SET NODE DUKE /IDENT="NODE DUKE, SALES VMSCLUSTER"B The SET NODE command in this example specifies node name DUKE? for your ~local node. The identification string "NODE DUKE,3 SALES VMSCLUSTER" is multicast from node DUKE.) 2.LATCP> SET NODE /MULTICAST_TIMER=50-2 _LATCP> /GROUPS=(ENABLE=(1-3,8,11),DISABLE=5)@ The SET NODE command in this example causes your local node< to send multicast messages every 50 seconds to announceB DUKE's services to terminal servers. The command also enables@ groups 1, 2, 3, 8, and 11 for access to the local node, andC it disables group 5 from accessin g the local node. Group 5 had been previously enabled.' 3.LATCP> SET NODE /CONNECTIONS=BOTH-9 _LATCP> /USER_GROUPS=(ENABLE=(24,121-127),DISABLE=0)A The SET NODE command in this example sets up your local nodeC to allow both incoming and outgoing connections. Users on your@ local node can access those service nodes belonging to user? groups 24 and 121 through 127. Users cannot access service nodes in user group 0.< 4.LATCP> SET NODE /CIRCUIT_TIME R=80 /KEEPALIVE_TIMER=20 -5 _LATCP> /RETRANSMIT_LIMIT=20 /CONNECTIONS=BOTH -? _LATCP> /MULTICAST_TIMER=60 /GROUPS=(DISABLE=0,ENABLE=73-)4 _LATCP> /SESSION_LIMIT=(OUTGOING=10,INCOMING=0)C The SET NODE command in this example sets many characteristics at once for node DUKE. 2 PORTA Associates a logical port on the local node with a remote port> on a terminal server that supports a device. Alternatively,A it associates a logical port on the local node with a specific> service. The service can be offered by a terminal server or> associated with one or more dedicated ports on a remote LAT service node.4 You must have OPER privilege to use this command. Format SET PORT port-name 3 Parameter port-nameB Specifies the name of the port. A port name must be in the form9 LTAn:, where n is a unique number from 1 through 9999.& NOTE; You cannot use the CREATE PORT and SET PORT commands,< along with the DCL command SET TERMINAL, to change the< characteristics of a DECserver port unless there is an0 existing LAT connection to that DECserver. 3 Qualifiers /APPLICATIONB Specifies that a port on the local node is an application port,= logically associated with a port on a terminal server or aB dedicated port on another LAT service node. The terminal server? port supports a device (for example, a printer). If the portB is used to support a printer, the print queue is established in@ a startup command procedure. See the OpenVMS System Manager's? Manual for a description of configuring remote printers on a terminal server.> If you do not specify a port type, the default port type is APPLICATION. /DEDICATED@ Specifies that a logical port on your local node is dedicatedC to an application service. The /DEDICATED qualifier requires the /SERVICE qualifier.? To set up an application service for a logical port on a LAT service node:9 1. Create the service by specifying the CREATE SERVICE@ /APPLICATION command and then define the dedicated port byC specifying the CREATE PORT/DEDICATED command. You can include* these commands in LAT$SYSTARTUP.COM.B 2. Associate the dedicated ports with the service by specifying- the SET PORT/DEDICATED/SERVICE command.A 3. Start the application program. Within the program, allocate< dedicated ports with the same name as those defined in LAT$SYSTARTUP.COM. /LIMITEDA Specifies that a logical port on your local node is limited to@ a service in the same way a port created using the /DEDICATEDC qualifier is dedicated to an application service. The differenceC is that ports created using the /LIMITED qualifier are under theA control of the system login image (LOGINOUT.EXE) instead of anD application program (a user who connects to a limited service andB is assigned to a limited port receives the "Username:" prompt).@ Using the /LIMITED qualifier, you can create a limited numberB of ports and map them to a specific service offered by the hostA system. If users are logged in to all of the limited ports for? the service, no more connections are allowed to that service> (terminal server users receive a "service in use" message). /LOG /LOG /NOLOGA Specifies whether LATCP displays a message confirming that theB port's characteristics were modified. If you do not specify theC /LOG or /NOLOG qualifier, the default is that no message will be displayed. /NODE /NODE=remote-node-nameA Specifies the name of a terminal server (or a remote node thatA supports outgoing connections) to be logically associated withC the specified application port on your node. The server supports@ a remote device. Note that you can set up an application portB on your local node and associate the port with a dedicated portC on a remote LAT service node. The remote port is dedicated to an application service. /PASSWORD /PASSWORD=remote-passwordB Specifies the password required to access a remote service that? is logically associated with the specified application port. /PORT /PORT=remote-port-nameB Specifies the name of the remote port on a terminal server thatC supports a remote device, or specifies the name of a remote portD dedicated to an application service on a remote LAT service node.C In either case, the remote port is logically associated with the1 specified application port on your local node. /QUEUED /QUEUED /NOQUEUEDD Specifies queued or nonqueued access to the server port. A queued= or nonqueued request is accepted by a terminal server if aA remote port is free. If the remote port is busy and queuing isD enabled on the terminal server, then the server queues the remoteC request. If you do not want your remote requests to be queued on! the server, specify /NOQUEUED.C Not specifying either the /QUEUED or /NOQUEUED qualifier results< in queued access to the server port. This is the default. /SERVICE /SERVICE=service-name% Specifies either of the following:A o The name of the remote service offered at a terminal serverA port that will be associated with the specified application+ port (/APPLICATION) on the local nodeB o A service name for an application program being offered on a7 dedicated port (/DEDICATED) on a LAT service node@ To specify the name of a remote service offered at a terminalC server port, use the /NODE and /SERVICE qualifiers. To specify aD 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 andD /SERVICE qualifiers. (The service must have been created with theB 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 Examples@ 1.LATCP> SET PORT LTA22: /APPLICATION /NODE=TS33EW /PORT=LN02@ The SET PORT command in this example sets u p port LTA22: asB an application port to be associated with the port named LN02A on the terminal server named TS33EW. This command associatesC port LTA22: with a specific printer on the server. In the nextB example, the SET PORT command associates a port with a set ofD printers (designated by the service name PRINTER) on a terminal server.E 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 aA terminal server. The command associates the application portB LTA19: with the service PRINTER on terminal server TLAT1. The@ service PRINTER can be associated with one or more ports onD TLAT1. The /QUEUED qualifier specifies that the server offeringC the service PRINTER can queue the remote connection request ifC all ports offering the service are in use. See the descriptionC of print op erations in the OpenVMS System Manager's Manual for, information on setting up print queues.8 3.LATCP> SET PORT LTA21: /DEDICATED /SERVICE=GRAPHICS< The SET PORT command in this example specifies that theA application port LTA21: on the local service node offers theC service GRAPHICS to users on terminal servers or on nodes thatC support outgoing connections. GRAPHICS is a particular utility or application program.8 4.LATCP> SET PORT MAIL_PORT /SERVICE=MA IL/NODE=RMNODEC 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 inA 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_ONEB This series of commands, which includes the SET PORT command,B creates a limited service that allows only one user to log in@ to the system through that service. When a user connects toA service ONLY_ONE by responding to the terminal server promptB  (Local>), the user is assigned port LTA1234 and then prompted? for the user name. Any user who attempts to connect to theA 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-nameB Specifies the service whose characteristics are to be modified.@ If a service name is omitted, the default service name is theD 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 applicationC service offers a specific application on the service node ratherD 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 /NOCONNECTIONSC 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".5 By default, a service accepts incoming connections (/CONNECTIONS). /IDENTIFICATION/ /IDENTIFICATION[="identification-string"]@ Describes and identifies a service. Service nodes include theA identification string in service announcements. A service nodeC 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 ofA SYS$ANNOUNCE. A service node announces its services at regular3 intervals established with the SET NODE command.9 You cannot specify more than 64 ASCII characters in anA identification string (a SYS$ANNOUNCE longer than that will be? truncated to the first 64 characters). Enclose the string in quotation marks (" "). /LIMITEDA Specifies that the service is a limited service, using devicesB assigned the limited characteristic and associated with (mappedB to) this limited service. This qualifier is used in conjunction4 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 queuedD connections when all ports are busy (the default). If you specifyD /NOQUEUED, incoming connections will be rejected if all ports are busy. /STATIC_RATING /STATIC_RATING=rating /NOSTATIC_RATINGA Enables or disables dynamic service ratings. A dynamic service@ rating means that a LAT algorithm calculates the availabilityC of a service dynamically, based on the overall level of activity@ of the node that offers the service and the amount of memory.D When a terminal server or node requests a c onnection to a service? that is offered on two or more service nodes, the requestingB node selects the service node with the highest (most favorable)C 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.D However, when necessary, you can use the /STATIC_RATING qualifier? to disable dynamic service ratings so that you can specify aB static (f ixed) rating. That static rating value does not change1 until the dynamic service rating is reenabled.A Use the static rating to direct users away from or toward yourB node temporarily. Static ratings range from 0 to 255. Specify aC low value to make the local service node less likely to be used;B 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_B RATING qualifier, the default is th at 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 serviceD 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.B 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 andB available ports that the service offers, while at the same timeA taking into account the availability of the node (which is th e0 factor used to calculate the dynamic rating).C If your system is licensed for a specific number of units (whereC only a fixed number of users can log in to the system regardlessD of how the login limit is set), then all dynamic ratings become 0B when all OpenVMS license units have been consumed. (This forcesD all node service ratings to the lowest possible value when logins? are not possible because all OpenVMS license units have been consumed.)9 Note as well that the LAT software transmits a serviceD announcement message when a user logs in to or out of the system.= This allows the system to more quickly provide informationB about service rating changes that result from a login or logout operation. 3 ExamplesG 1.LATCP> SET SERVICE SALES /IDENT="SALES FORCE TIMESHARING SERVICES"< The SET SERVICE command in this example specifies a newC identification string, "SALES FORCE TIMESHARING SERVICES", forA 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 theA system through that service. When a user connects to serviceC ONLY_ONE by responding to the terminal server prompt (Local>),@ the user is assigned port LTA1234 and then prompted for theD 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. ww1 SHOW 2 LINKD Displays the status and LAT characteristics of links on the local node. Format SHOW LINK [link-name] 3 Parameter link-nameB Specifies the name for a LAT data link. A link name can have up to 16 ASCII characters.@ If you do not specify a link name, LATCP displays information2 about all links currently defined for the node. 3 Qualifiers /BRIEF> Displays the device name and state of the link. This is the default display. /COUNTERS> Displays the device counters kept for the link. The numbersB displayed represent the values recorded since the last time theD counters were reset (when the node first started or when the ZERO COUNTERS command was used).@ Do not use the /BRIEF or /FULL qualifier with this qualifier.@ Counters Common to CSMA/CD and FDDI Links lists and describes; counters common to both CSMA/CD (carrier sense, multipleA access with collision detect) and FDDI (fiber distributed data interface) links.4 Table 1 Counters Common to CSMA/CD and FDDI Links! Counter DescriptionD Messages received The total number of messages received over the link.< Multicast The total number of multicast messages- messages received received over the link.> Bytes received The total number of bytes of information- received over the link.B Multicast bytes The total number of multicast bytes received$ received over the link.D System buffer The total number of times no system buffer was6 unavailable available for an incoming frame.; Unrecogni zed The total number of times a frame was@ destination discarded because there was no portal with? the protocol enabled. This count includesD frames received for the physical address only.@ Messages sent The total number of messages sent over the link.A Multicast The total number of multicast messages sent$ messages sent over the link.C Bytes sent The total number of bytes of i nformation sent$ over the link.< Multicast bytes The total number of bytes of multicast2 sent messages sent over the link.B User buffer The total number of times no user buffer wasA unavailable available for an incoming frame that passed$ all filtering.B Data overrun The total number of bytes lost on the link'sC device because the local node's input buffersC we re full. A nonzero value can indicate noisyA lines, a bad device, a busy or poorly tunedA system (not enough resources allocated), orC a hardware problem with another device on the% LAN connection.< Receive Errors Common to CSMA/CD and FDDI Links lists andB describes receive errors common to both CSMA/CD and FDDI links.? These errors, which are included in the display generated by@ the SHOW LINK /COUNTERS command, are represented by flags that# indicate the error has occurred.: Table 2 Receive Errors Common to CSMA/CD and FDDI Links! Flag Description6 Block check error CRC error in packet(s) received.: Framing error Received frame(s) ended incorrectly.B Frame too long Frame(s) received longer than length limits.= Frame status CRC error on ring noticed by local FDDI* error station (FDDI only).9 Frame length Frame length too short (FDDI only). error= Transmit Errors Common to CSMA/CD and FDDI Links lists andC describes transmit errors common to both CSMA/CD and FDDI links.? These errors, which are included in the display generated by@ the SHOW LINK/COUNTERS command, are represented by flags that# indicate the error has occurred.; Table 3 Transmit Errors Common to CSMA/CD and FDDI Links! Flag Description= Excessive Frame(s) failed to transmit because the@ collisions collision limit of 16 was reached (CSMA/CD only).D Carrier check Indicates transceiver problem or short circuit failures in cable.- Short circuit Short circuit in cable., Open circuit Open circuit in cable.A Frame too long Frame(s) too long. Indicates a transmissionC problem in one of the portals using the link.? Remote failure to A remote station failed to defer frame(s)B defer transmission. Could indicate a misconfigured network.; Transmit underrun Transmission of a frame was too slow.< Indicates a hardware controller error.2 Transmit failure Frame(s) failed to transmit.A CSMA/CD Counters lists and describes link counters specific to CSMA/CD only. Table 4 CSMA/CD Counters! Counter Description> Transmit CDC The total number of carrier detect checkD failure errors, that is, the number of times the localA node failed to detect that another Ethernet? station was already transmitting when the4 local node began transmitting.@ Messages Single collision-The total number of timesA transmitted: a frame was successfully transmitted on theD second attempt after a normal collision on the$ first attempt.B Multiple collision-The total number of timesA a frame was successfully transmitted on theD third or later attempt after normal collisions+ on previous attempts.B Initially deferred-The total number of times> a frame transmission was deferred on itsD first attempt. This counter is used to measure= Ethernet contention with no collisions.C FDDI Counters lists and describes link counters specific to FDDI only. Table 5 FDDI Counters% Counter Description: Ring initializations The total number of times a ring? initiated reinitialization was initiated by the link.: Ring initializations The total number of times a ring@ received reinitialization was initiated by some% other link.C Directed beac ons The number of times the link detected theB received directed beacon process. Each invocationC of the directed beacon process is counted$ only once.9 Connections completed The number of times the station7 successfully connected to the' concentrator.C Duplicate tokens The number of times a duplicate token was/ detected detected on the link .= Ring purge errors The number of times the ring purgerB received a token while still in the ring& purge state.C LCT rejects Link Confidence Test rejects. Indicates aD problem with communication between station+ and concentrator.< Elasticity buffer Elasticity buffer function errors.@ errors Indicates a station on the ring with a: transmit clock out of tolerance.C MAC error count The number of times the MAC (Media Access? Control) changed the E indicator in a, frame from R to S.B Traces initiated The number of times the PC-trace process4 was initiated by the link.D Traces received The number of times the link was requested: to perform the PC-trace process.= Ring beacons Th e number of times the ring beacon< initiated process was initiated by the link.D Link errors The number of times the Link Error Monitor? (LEM) detected an error in a received: message. Slow counts are normal.D Duplicate address The number of times the link address was a$ test failures duplicate.= FCI strip errors The number of times a Frame ContentD Independent St rip operation was terminated0 by receipt of a token.B LEM rejects The number of times excessive LEM errors+ were encountered.@ MAC frame count The total number of frames (other than3 tokens) seen by the link.B MAC lost count The total number of times a frame (otherB than a token) was improperly terminated. /FULLD Displays the device name, state, and datalink address of the link7 and indicates whether the DECnet address is enabled. 3 Examples$ 1.LATCP> SHOW LINK/FULL NETWORK_AA The SHOW LINK command in this example produces the following1 display of information about link NETWORK_A:F Link Name: NETWORK_A Datalink Address: 08-00-2B-10-12-E3= Device Name: _ESA7: DECnet Address: Disabled Link State: On> The display in this example gives the device name of link@ NETWORK_A and the device's hardware address. The link is in the On state. 2 NODE9 Displays the status and LAT characteristics of a node. Format SHOW NODE [node-name] 3 Parameter node-name: Specifies the name of the node for which information is? displayed. If you do not specify a node name, LATCP displays$ information about the local node.= You can also specify any valid wildcard for this parameter@ For example, the SHOW NODE A* command displays the status and= characteristics of all nodes that begin with the letter A. 3 Qualifiers /ALLA Displays information about all nodes known to your local node.; When you use this qualifier, specify the /FULL or /BRIEF? qualifier as well. If you do not specify either the /FULL or> /BRIEF qualifier, the default display will contain the nodeA status and identification string (the display generated by the /BRIEF qualifier). /BRIEFB Displays the node status and identification string. This is the5 default display if you specify the /ALL qualifier. /COUNTERSD Displays the counters kept for the node. Do not use the /BRIEF orC /FULL qualifier with this qualifier. LAT Node Counters lists and< describes the counters displayed with SHOW NODE/COUNTERS. Table 6 LAT Node Counters! Counter DescriptionB Messages received The total number of LAT messages received byB the local node. If you specify a remote nodeC with the SHOW NODE command, the number of LAT> messages received from that remote node.B Messages The total number of LAT messages transmitted@ transmitted by the local node. If you specify a remoteD node with the SHOW NODE command, the number ofC LAT messages transmitted to that remote node.C Slots received The total number of LAT slots rece ived by theC local node. If you specify a remote node with@ the SHOW NODE command, the number of slotsA received from that remote node. A slot is a? message segment that contains information8 corresponding to a single session.B Slots transmitted The total number of LAT slots transmitted byB the local node. If you specify a remote node? with t he SHOW NODE command, the number of< slots transmitted to that remote node.B Bytes received The total number of bytes of LAT informationB received by the local node. If you specify aA remote node with the SHOW NODE command, the? number of bytes received from that remote node.B Bytes transmitted The total number of bytes of LAT informationC transmitted by t he local node. If you specifyC a remote node with the SHOW NODE command, the@ number of bytes transmitted to that remote node.= Multicast bytes The total number of LAT multicast bytes1 received received by the local node.B Multicast bytes The total number of LAT multicast bytes sent( sent by the local node.@ Multicast The total number of LAT multicast messages1 messages rece ived received by the local node.@ Multicast The total number of LAT multicast messages- messages sent sent by the local node.= No transmit The total number of times no buffer wasC buffer available on the local node for transmission.B Multicast The total number of times LTDRIVER failed toB messages lost process an inbound multicast message because> of failed communication with the LATACP.B Multicast send The total number of times LTDRIVER failed to@ failures send a multicast message because of failed4 communication with the LATACP.? Controller errors The total number of times LTDRIVER failedB to communicate with the data link controller driver.7 Last controller The most recent controller error. error; Multiple node The total number of times that a node> addresses announced itself with a physical address7 different from that in a previous# announcement.< Duplicates The total number of duplicate messages@ received received by the local node. If you specifyC a remote node with the SHOW NODE command, the@ number of duplicate messages received fromC that remote node. This counter can indicate a& system slowdown.? Messages The total number of LAT messages that the@ retransmitted local node retransmitted because they were> not acknowledged by terminal servers (orB nodes that support outgoing connections). IfB you specify a remote node with the SHOW NODEC command, the number of messages retransmitted* to that remote node.A Illegal messages The total number of invalidly formatted LATA received messages received by the local node. If you> specify a remote node with the SHOW NODE@ command, the number of invalidly formatted@ messages the local node received from thatD remote node. Illegal messages are grouped intoA several types of protocol errors, which are6 listed at the end of this table.A Illegal slots The total number of invalidly form atted LAT> received slots received by the local node. If you> specify a remote node with the SHOW NODE@ command, the number of invalidly formattedD slots the local node received from that remote node.= Solicitations The total number of times a remote nodeD accepted accepted solicitations from the local node. IfB you specify a remote node with the SHOW NODE C command, the number of accepted solicitations* by that remote node.= Solicitations The total number of times a remote nodeC rejected rejected solicitation from the local node. IfB you specify a remote node with the SHOW NODEC command, the number of rejected solicitations* by that remote node.D Solicitation The total number of times solicitations by the6 f ailures local node received no response.D Transmit errors The total number of times the data link failed0 to transmit a LAT message.5 Last transmit The most recent transmit error. error@ Virtual circuit The total number of times a LAT circuit toA timeouts another node timed out, indicating that the@ remote node failed to send a valid messageA in the required time span. If you specify aA remote node with the SHOW NODE command, theC number of times the local node timed out from7 a connection to that remote node.> Discarded output The total number of data bytes that were< bytes discarded because of an overflow of an> internal buffer before the data could be. output to an LTA device.B User data lost The total number of times LTDRIVER failed to@ allocate resources to buffer session data.C User data is lost and the session is stopped.@ Resource errors The number of times LTDRIVER was unable to0 allocate system resources.> Incoming solicits The total number of times the local node> accepted accepted solicitations from other nodes.> Incoming solicits The total number of times the local node> rejected rejected solicitations from other nodes.B The protocol errors that are counted as illegal messages are as@ follows. These protocol error messages are displayed if their+ associated counter is greater than zero:# o Invalid message type received$ o Invalid start message received7 o Invalid sequence number received in start message o Zero-node index received% o Node circuit index out of range# o Node circuit sequence invalid( o Node circuit index no longer valid o Circuit was forced to halt o Invalid server slot index o Invalid node slot index3 o Invalid credit field or too many credits used' o Repeat creation of slot by server, o Repeat disconnection of slot by master /FULLB Displays the node's status, identification string, LAT protocolA version, and the values of the node's characteristics. This is: the default except when you specify the /ALL qualifier. /STATUS> Displays statistical information for parameters such as theC number of active circuits, sessions, and incoming queue entries.? For each parameter, the display shows the current value, the9 highest value recorded, and the maximum value allowed.@ Note that you can specify the /STATUS qualifier with the SHOW@ NODE command to display information about the local node onlyB (for example, the command SHOW NODE /STATUS FOREIGN_NODE is not supported). 3 Examples 1.LATCP> SHOW NODE/FULLA The SHOW NODE comma nd in this example produces the following1 display of information about the local node:G Node Name: LTC LAT Protocol Version: 5.2 Node State: On1 Node Ident: LTC - Engineering DevelopmentG Incoming Connections: Enabled Incoming Session Limit: NoneG Outgoing Connections: Enabled Outgoing Session Limit: None& Service Responder: DisabledG Circuit Timer (msec): 80 Keepalive Timer (sec): 20G Retransmit Limit (msg): 20 Node Limit (nodes): NoneG Multicast Timer (sec): 20 CPU Rating: 8& Maximum Unit Number: 9999 User Groups: 43, 73F Service Groups: 7-9,13,23,40,43,45,66,72-73,89,120-127,248-255: Service Name Status Rating Identification- LTVMS Available 31 D .@ This display indicates that the local node LTC is in the On= state, which means LA T connections can be created on the? node. LTC is running Version 5.2. of the LAT protocol. TheC identification of the node is "LTC - Engineering Development".> Because this is the local node, the display does not give> the address of a LAN device. Use the SHOW LINK command toA find addresses of devices on the local node. The display forA the status of remote nodes, as shown in Example 2, gives the# Ethernet address of that node.D Both incoming and outgo ing connections can be made on node LTC,C the number of sessions is unlimited. The display indicates theD values of various timers and lists the groups that are enabled.B Users on the local node can access service nodes belonging toD user groups 43 and 73. Locally offered services can be accessed5 by nodes belonging to the service groups listed.@ The display indicates that the CPU rating of the local nodeA is 8. The display shows that the node offers a service named< LTVMS. This service is available and its rating is 31 D; (dynamic). (An S would indicate the rating is static.) 2.LATCP> SHOW NODE/FULL RWWUPA The SHOW NODE command in this example produces the following) display about the remote node RWWUP:E Node Name: RWWUP LAT Protocol Version: 5.2E Node State: Reachable Address: AA-00-04-00-11-10 Node Ident: .% Incoming Connections: Enabled& Circu it Timer (msec): 80& Multicast Timer (sec): 20A Service Groups: 7, 13, 42-43, 45, 66, 70-72, 75-82, 88-89: Service Name Status Rating Identification- NAC Available 28 .- SYSMGR Available 28 .C This display indicates that remote node RWWUP is reachable andC runs Version 5.2 of the LAT protocol. The display includes theA Ethernet address of node RWWUP. Because incoming connections= are enabled, you can connect to a service on node RWWUP,A provided that your node belongs to one of the service groups listed in the display.= Node RWWUP offers two services: NAC and SYSMGR. Both are available. 3.LATCP> SHOW NODE/ALL/BRIEFA The SHOW NODE command in this example produces the following5 display about all nodes known to the local node:2 Node Name Status IdentificationG --------- ----------- -------- ---------------------------G ABLAN Reachable Unauthorized access is prohibited.& ASKWEN Reachable .D CHUNK Reachable A member of the MAIN VMScluster . . .A UTOO On Can be healthy at the Center/ VULCUN Reachable Beam me up) ZENX Reachable ZENX? The SHOW NODE command in this example indicates the statusB  (whether a node is reachable) and identification of all nodesA known to the local node. Note also that the display includesD the status of the local node UTOO. The status can be either On,! Off, or Shut. Here it is On. 4.$ LCP :== $LATCP $ LCP SHOW NODE /STATUSA The SHOW NODE /STATUS in this example produces the following display:I Node Name: NODE1 LAT Protocol Version: 5.2 Node State: On Node Ident: Te st system= Current Highest Maximum= ------- ------- -------= Active Circuits: 1 2 1023= Connected Sessions: 1 6 260865= Incoming Queue Entries: 0 0 24= Outgoing Queue Entries: 0 1 32767= Unprocessed Announcements: 0 7 500= Unprocessed Solicits: 0  2 250= Local Services: 1 2 255= Available Services: 188 194 N/A= Reachable Nodes: 166 172 N/A) Discarded Nodes: 0 2 PORTD Displays the status and LAT characteristics of ports on the local node. Format SHOW PORT [port-name] 3 Parameter port-name: Specifies the name of the port for which information is> displayed. If you do not specify a port name, the SHOW PORT@ command displays the characteristics for all LTAn: ports on a node.8 Do not use the /APPLICATION, /DEDICATED, /FORWARD, or5 /INTERACTIVE qualifiers with a specific port name.@ In addition do not use the /LIMITED qualifier with a specific port name. 3 Qualifiers /APPLICATION0 Generates a display of all application ports. /BRIEFC Displays port type, port status, and the remote node name, port,C and service associated with the port. This is the default if you9 do not specify a port name with the SHOW PORT command. /COUNTERSD Displays the counters kept for the port. Do not use the /BRIEF or( /FULL qualifiers with this qualifier. /DEDICATED. Generates a display of all dedicated ports. /FORWARDD Generates a display of all LAT ports used for either outgoing LAT1 connections or local LAT management functions. /FULL& Displays the following information: o Port type o Port statusC o Target port name, node name, and service name associated with the portB o Remote node name, port, and service associated with the port) if a connection is currently activeB For more information, see the description of the SHOW PORT/FULL example. /INTERACTIVE9 Generates a display of all LAT ports used for incoming interactive connections. /LIMITED? Generates a display of all limited LTA devices on the systemD (previously established with the CREATE PORT /LIMITED or SET PORT /LIMITED command). 3 Examples 1.LATCP> SHOW PORT /FULLA The SHOW PORT command in this example produces the followingB type of display. The display reflects the characteristics set= by the command examples given with the SET PORT command.E Local Port Name: _LTA16: Local Port Type: Forward" Local Port State: Inactive Connected Link:@ Target Port Name: Actual Port Name:@ Target Node Name: LATCP$MGMT_PORT Actual Node Name:C Target Service Name: Actual Service Name:E --------------------------------------------------------------E Local Port Name: _LTA17: Local Port Type: Interactive Local Port State: Active" Connected Link: LAT$LINK; Target Port Name: Actual Port Name: PORT_ 1D Target Node Name: Actual Node Name: MY_DS200_SERVER6 Target Service Name: Actual Service Name:E --------------------------------------------------------------E Local Port Name: _LTA19: Local Port Type: Application (Queued) Local Port State: Active" Connected Link: LAT$LINK9 Target Port Name: Actual Port Name:C Target Node Name: TLAT1 Actual Node Name: TLAT1E Target Service Nam e: PRINTER Actual Service Name: PRINTERE --------------------------------------------------------------E Local Port Name: _LTA21: Local Port Type: Dedicated" Local Port State: Inactive Connected Link:@ Target Port Name: Actual Port Name:@ Target Node Name: Actual Node Name:C Target Service Name: GRAPHICS Actual Service Name:E --------------------------------------- -----------------------E Local Port Name: _LTA22: Local Port Type: Application (Queued) Local Port State: Active" Connected Link: LAT$LINKD Target Port Name: LN02 Actual Port Name: LN02E Target Node Name: TS33EW Actual Node Name: TS33EW? Target Service Name: Actual Service Name:E --------------------------------------------------------------@ The display in this example shows information about all theD ports on the local node. The display shows information for each of the four types of ports:@ o Forward: a port used for outgoing LAT connections or for@ executing local management functions and LATCP commands.A Port LTA16: is a forward port. The display shows that theD port is currently inactive-no current LAT connection exists.D The target node name of LATCP$MGMT_PORT indicates that LATCP@ is using this port to execute the LA TCP commands enteredC by the user. If the display listed a node and service name,A it would mean that the port is being used for an outgoing connection.B o Interactive: a port created as a result of an incoming LAT@ connection request from another node or terminal server.D Port LTA17: is an interactive port connected with port PORT_1 1 on the terminal server MY_DS200_SERVER.= o Application: a port used for solicited connections toA devices on terminal servers or to application services on? remote LAT service nodes. Port LTA22: is an applicationB port. The port maps to port LN02 (a printer) on a terminalD server node TS33EW. The display indicates that server TS33EWC queues connection requests from the local node. Port LTA19:A is also an application port. The port maps to the service) PRINTER on terminal server TLAT1.C o Dedicated: a port dedicated to a local app lication service.9 Port LTA21: is dedicated to the service GRAPHICS.? The target port name, target node name, and target serviceA name are the names specified with the SET PORT command. They> are passed to the remote node or terminal server when the connection request is made.D The actual port name, actual node name, and actual service nameB are the names returned by the remote node when it accepts the? connection request. They may differ from the corresponding> target names (specified with the SET PORT command) if theD remote node translates the names. For example, terminal serversD that accept connections to LAT service names usually return theD name of the port to which the connection was actually directed.$ 2.LATCP> SHOW PORT LTA1 /COUNTERS? The SHOW PORT /COUNTERS command in this example produces a@ display that lists counter information for the LTA1 device. Port Name: _LTA1:. Secon ds Since Zeroed: 66G Remote Accesses: 0 Framing Errors: 0G Local Accesses: 0 Parity Errors: 0G Bytes Transmitted: 0 Data Overruns: 0G Bytes Received: 0 Password Failures: 0. Solicitations Accepted: 1. Solicitations Rejected: 1. Incoming Solicits Accepted: 0. Incoming Solicits Rejected: 0. Last disconnect reason code: 18= (%LAT-F-LRJDELETED, queue entry deleted by server) 2 QUEUE_ENTRYA Displays information about requests, or entries, queued on the local node. Format' SHOW QUEUE_ENTRY [queue-entry-id] 3 Parameter queue-entry-id? Specifies the identification number (ID) of the queued entry> for which information is displayed. If you do not specify aA value for this parameter, informati!on about all queued entries is displayed. 3 Qualifiers /BRIEF? Displays the following information about the queued entries: o Position o Entry ID o Source node o Service o Port name! (This is the default display.) /FULLD In addition to the information displayed by the /BRIEF qualifier,B the /FULL qualifier provides the following information for each node: o Node queue position o Service queue position o Node address o Soliciting Link 3 Examples 1.LATCP> SHOW QUEUE_ENTRY> The SHOW QUEUE_ENTRY command in this example produces the following type of display.H Position Entry ID Source Node Service Port NameH -------- -------- ---------------- ---------------- ---------8 1 79EC NODE1 LAT_LIMITED8 2 7AEC NODE2 LAT_LIMITED8 3 7CEC NODE3  LAT_LIMITED! 2.LATCP> SHOW QUEUE_ENTRY/FULLC The SHOW QUEUE_ENTRY/FULL command in this example produces the following type of display.= Entry ID: 7AEC Remote Node: NODE1I Node Queue Position: 1 Address: 08-00-2B-0A-A0-A0% Service Queue Position: 1 Target Port:$ Target Service: LAT_LIMITED! Soliciting Link: LAT$LINKJ -------------------------------------------------------------------= Entry ID: 7CEC Remote Node: NODE2I Node Queue Position: 2 Address: AA-00-04-00-37-DD% Service Queue Position: 2 Target Port:$ Target Service: LAT_LIMITED! Soliciting Link: LAT$LINK 2 SERVICED Displays the status and LAT characteristics of LAT services known to the local node. Format! SHOW SERVICE [service-name] 3 Parameters service-nameB Specifies the name of the service for which information will beB displayed. If you do not specify a service name, LATCP displays4 information about all services known to the node.B You can also specify any valid wildcard for this parameter. ForB example, the SHOW SERVICE LAT_* command displays the status andC characteristics of all services that begin with the LAT_ prefix. 3 Qualifiers /BRIEF@ Displays the status and identification string of the service.  /COUNTERSD Displays the counters kept for the service. Do not use the /BRIEFD or /FULL qualifier with this qualifier. The following table lists and describes the counters: Counter Description Remote Counters= Connections The total number of times the local node@ attempted attempted to connect to the service offered& on a remote node.= Connections The total number of times the local nodeB completed s uccessfully connected to the service offered& on a remote node. Local Counters= Connections The total number of times the local node@ accepted accepted a connection request from a remote7 node to a locally offered service.= Connections The total number of times the local node@ rejected rejected a connection request from a remote7 node to a locally offered service.@ Password  The total number of connect requests to the@ failures service which were rejected due to password& violation errors. /FULLC Displays the status, identification string, and type of service,A and the values set for service characteristics. This qualifier= also displays the status of all service nodes offering the service. /LOCAL@ Displays information about services offered by the local nodeB only. You can use this qualifier with the /BRIEF, /COUNTERS, or /FULL qualifier. 3 Examples$ 1.LATCP> SHOW SERVICE NODE1 /FULLD The SHOW SERVICE command in this example produces the following@ display of information about service NODE1. This service is offered by the local node.B Service Name: NODE1 Service Type: GeneralB Service Status: Available Connections: Enabled> Service Password: Enabled Queueing: N/A, Service Ident : NODE1 - Test system? Node Name Status Rating Identification2 LAV On 31 D .2 LATP Reachable 48 .2 LITTN Reachable 37 .2 LTDRV Reachable 82 .C The display in this example indicates that the locally offered@ service NODE1 is available and its service type is general,B meaning that it is a general timesharing service (in contrastD to a dedicated application service). The display also lists theC status of all the nodes that offer the service. The local node@ is LAV. The status of the local node can be either On, Off,C or Shut. Here node LAV's status is On. The status of the otherB nodes indicates whether they are reachable. The display lists@ the ratings of each service node, indicating their relativeB capacity to accept new connections. The D next to the locally@ offered service indicates that node LAV computes its ratingD dynamically. An S would indicate that the node's rating was set. permanently by the node's system manager.$ 2.LATCP> SHOW SERVICE OFFICE/FULLD The SHOW SERVICE command in this example produces the following> display of information about the service OFFICE, which is offered by a remote node: Service Name: OFFICE! Service Status: Available Service Ident: .? Node Name Status Rating Identification2 BURGIL Reachable 121 .2 DARWIN Reachable 43 .> The display in this example indicates that the service is? available. The display also indicates the status and otherC information about the nodes that offer the service, BURGIL and DARWIN. ww.1 SPAWN= Creates a subprocess, enabling you to execute DCL commandsB without terminating your LATCP session. The LATCP SPAWN command' is similar to the DCL SPAWN command.D To return to your LATCP session, either log out of the subprocessD by entering the DCL LOGOUT command, or use the DCL ATTACH command8 to attach your terminal to the process running LATCP. Format SPAWN [DCL-command] 2 Parameter DCL-command? Specifies a DCL command. If you specify a DCL command, LATCPA executes the command in a subprocess. Control returns to LATCP# when the DCL command terminates.B If you do not specify a DCL command, LATCP creates a subprocessC and you can then enter DCL commands. You can continue your LATCPC session by logging out of the spawned subprocess or by attaching5 to the parent process with the DCL ATTACH command. 2 Example LATCP> SPAWN $B The SPAWN command in this example creates a subprocess at DCLD level. You can now enter DCL commands. Log out or enter the DCL2 ATTACH command to return to the LATCP prompt. ww.1 ZERO_COUNTERS@ Resets the link, node, and service counters maintained by the@ local node. You must have OPER privilege to use this command. Format ZERO COUNTERS 2 Qualifiers /LOG /LOG /NOLOGA Specifies whether LATCP displays a message confirming that the@ counters were reset. If you do not specify the /LOG or /NOLOG? qualifier, the default is that no message will be displayed. /LINK /LINK[=link-name]= Specifies the link (on your local node) for which you wantB counters reset. If you do not specify a link name, LATCP zeroes" counters for the link LAT$LINK. /NODE /NODE[=node-name]B Specifies the node for which you want counters reset. If you doD not specify a node name, LATCP zeroes the counters for your local node. /PORT /PORT=port-name= Specifies the port (on your local node) for which you want counters reset. /SERVICE /SERVICE=service-name@ Specifies the service (on your local node) for which you want counters reset. 2 Example" LATCP> ZERO COUNTERS/SERVICE=LTVM# LATCP> SHOW SERVICE LTVM /COUNTERS Service Name: LTVM Seconds Since Zeroed: 9; Connections Attempted: 0 Connections Accepted: 0; Connections Completed: 0 Connections Rejected: 0B The ZERO COUNTERS command in this example resets the countersD kept for service LTVM. The display produced by the SHOW SERVICEC command shows how the ZERO COUNTERS command reset the counters to zero.ww