HP OpenVMS Systems Documentation

HP OpenVMS System Management Utilities Reference Manual

This command creates the service GRAPHICS on the local node. Use the CREATE PORT/DEDICATED and SET PORT/SERVICE=GRAPHICS commands to create a port that is dedicated to this service.

$ LCP :== $LATCP
$ LCP CREATE SERVICE/LIMITED ONLY_ONE
$ LCP CREATE PORT/LIMITED LTA1234:
$ LCP SET PORT LTA1234: /SERVICE=ONLY_ONE
      

This series of commands creates a limited service that allows only one user to log in to the system through that service. When a user connects to service ONLY_ONE by responding to the terminal server prompt (Local>), the user is assigned port LTA1234 and then prompted for the user name. Any user who attempts to connect to the same service while LTA1234 has a user logged in receives the "service in use" message.

Assigns a command string to a function key. For example, you can assign the LATCP command SHOW NODE to a function key.

Format

DEFINE/KEY key-name equivalence-string

Parameters

key-name

Specifies the name of the function key that you want to define. Valid key names are as follows:

Key Name	LK201/LK401 Keyboards	VT100-Type	VT52-Type
PF1	PF1	PF1	Blue
PF2	PF2	PF2	Red
PF3	PF3	PF3	Black
PF4	PF4	PF4
KP0-KP9	Keypad 0-9	Keypad 0-9	Keypad 0-9
PERIOD	Keypad period (.)	Keypad period (.)
COMMA	Keypad comma (,)	Keypad comma (,)
MINUS	Keypad minus (-)	Keypad minus (-)
Enter	Enter	Enter	Enter
FIND	Find	--	--
INSERT_HERE	Insert Here	--	--
REMOVE	Remove	--	--
SELECT	Select	--	--
PREV_SCREEN	Prev Screen (LK201) Prev (LK401)	--	--
NEXT_SCREEN	Next Screen (LK201) Next (LK401)	--	--
HELP	Help	--	--
DO	Do	--	--
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 (" ").

Qualifiers

/ECHO

/NOECHO

Specifies whether LATCP displays the command string on your screen when you press the key. If you do not specify the /ECHO or /NOECHO qualifier, the default is that the command string will be displayed. You cannot use /NOECHO with the /NOTERMINATE qualifier.

/IF_STATE=state-name

Specifies the state that must be set (for example, the GOLD state) for the key definition to work. Lets you assign alternative meanings to keys when the specified state is set. See the discussion of the /SET_STATE qualifier. If you omit the /IF_STATE qualifier, LATCP uses the current state. The state name is an alphanumeric string. States are established with the /SET_STATE qualifier.

/LOCK_STATE

/NOLOCK_STATE

Specifies that the state set by the /SET_STATE qualifier remain in effect until explicitly changed. If you use the /NOLOCK_STATE qualifier, the state set by /SET_STATE remains in effect only for the next definable key that you press or for the next read-terminating character (such as Return or Ctrl/Z) that you type.

You can specify the /LOCK_STATE qualifier only with the /SET_STATE qualifier. If you do not specify the /LOCK_STATE or /NOLOCK_STATE qualifier, the default is that the state set by the /SET_STATE qualifier remains in effect until explicitly changed.

/LOG

/NOLOG (default)

Specifies whether 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.

/SET_STATE=state-name

Causes the specified state to be set when you press the defined key. The state name can be any alphanumeric string (for example, GOLD). Use the DEFINE/KEY/IF_STATE=state-name command to associate new meanings for keys when the specified state is set. See the example for the DEFINE/KEY command.

If you omit the /SET_STATE qualifier, the current state that was locked remains in effect.

/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 the command string is processed. Pressing Return has the same effect as using /TERMINATE.

The /NOTERMINATE qualifier allows you to create key definitions that insert text into command lines, after prompts, or into other text that you are typing.

Description

The DEFINE/KEY command assigns a command string to a function key so that when you press that key, the command is executed.

Example

LATCP> DEFINE/KEY PF4 "SHOW NODE " /NOTERMINATE/SET_STATE=GOLD
LATCP> DEFINE/KEY PF4 "/ALL"/IF_STATE=GOLD/TERMINATE
      

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 the space after the word NODE in the first DEFINE/KEY command. This space allows you to enter a node name after pressing PF4. When you press Return, the SHOW NODE command is processed. If the space is omitted, LATCP does not recognize the command (SHOW NODE). The state is set to GOLD; that state will be in effect for the next key that you press.

The second DEFINE/KEY command defines the use of the PF4 key when the keypad is in the GOLD state. When you press PF4 twice, the SHOW NODE/ALL command is processed.

Deletes a logical link from a node. You must have OPER privilege to use this command.

Format

DELETE LINK link-name

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.

Qualifiers

/LOG

/NOLOG (default)

Specifies whether LATCP displays a message confirming that the link was deleted. If you do not specify the /LOG or /NOLOG qualifier, the default is that no message will be displayed.

Description

The DELETE LINK command stops any active sessions on the link and then deletes the link from your node.

Example

LATCP> DELETE LINK NETWORK_A /LOG
      

This command deletes the link NETWORK_A. The link was created with the CREATE LINK command.

Deletes a logical port from a node. You must have OPER privilege to use this command.

Format

DELETE PORT port-name

Parameter

port-name

Specifies the name of the application port or the dedicated port that you want to delete. An application port connects to a remote device on a terminal server, whereas a dedicated port connects to a special service.

Use the SHOW PORT command for a list of the application ports and the dedicated ports that are defined for your service node. You cannot use the DELETE PORT command to delete an interactive or forward LAT port.

Qualifiers

/LOG

/NOLOG (default)

Specifies whether LATCP displays a message confirming that the port was deleted. If you do not specify the /LOG or /NOLOG qualifier, the default is that no message will be displayed.

Description

The DELETE PORT command stops any active session on the port and then deletes the port from your service node.

Example

LATCP> DELETE PORT LTA27:
      

This command deletes the LTA27: application port. The port was created with the CREATE PORT command.

Deletes an incoming queued request, or entry, from the local node.

Format

DELETE QUEUE_ENTRY queue-entry-id

Parameter

queue-entry-id

Specifies the identification number (ID) of the queued entry that you want to delete.

Description

The DELETE QUEUE_ENTRY deletes an incoming queued request, or entry, from the local node. Use the SHOW QUEUE_ENTRY command to view the list of queued entries and their IDs.

Example

LATCP> DELETE QUEUE_ENTRY 0056
      

This command deletes the queued request with an ID of 0056.

Deletes a service that your service node currently offers. You must have OPER privilege to use this command.

Format

DELETE SERVICE service-name

Parameter

service-name

Specifies the name of the service, as displayed by the SHOW SERVICE command.

Qualifiers

/LOG

/NOLOG (default)

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.

Description

The DELETE SERVICE command removes a service from a service node. The service is no longer available to terminal server users and is no longer multicast in the configuration messages sent by your service node. Existing connections to the service node are not affected.

Example

LATCP> DELETE SERVICE SALES
      

This command removes the service SALES from your service node. The service is no longer available to server users.

Stops execution of LATCP and returns control to the DCL command level. You can also enter Ctrl/Z at any time to exit.

Format

EXIT

Parameters

None.

Example

LATCP> EXIT
      

This command exits the LATCP program and returns control to the DCL command level.

Provides online help information for using the LATCP commands.

Format

HELP [command-name...]

Parameter

command-name

The name of a LATCP command or LATCP command and command keyword. If you enter the HELP command with a command name only, such as HELP SET, LATCP displays a list of all of the command keywords used with the SET command.

Description

The HELP command is an online reference for LATCP commands. After you view an initial help display, press Return. The help display stops and the LATCP prompt is displayed. If you do not specify a command name, the HELP command displays general information about the commands for which help is available. Supplying a command name obtains syntax information for that command.

Example

LATCP> HELP SET PORT
      

This command produces a description of the SET PORT command and shows the command format.

Displays previously entered LATCP commands on the screen so that you can execute them again.

Format

RECALL [command-specifier]

Parameter

command-specifier

Specifies the number or the first several characters of the LATCP command you want to recall. Command numbers can range from 1 to 20. The most recently entered command is number 1.

Use the /ALL qualifier to display all the commands in the RECALL buffer, along with their command number so that you can determine the number of the command that you want to recall.

If you do not include the command specifier or the /ALL qualifier when entering the RECALL command, LATCP displays the last command.

Qualifiers

/ALL

Specifies that LATCP display all the commands in the RECALL buffer. LATCP displays the number of each command.

Description

When you enter a LATCP command, LATCP stores it in a RECALL buffer for later use with the RECALL command. The RECALL command itself is never stored in the RECALL buffer.

When you use the RECALL command, LATCP displays the recalled command but does not process it. If you want the command processed as it appears, press Return. You can use the command line editing facility to make minor changes in the command line and then press Return to process the revised version of the command.

Examples

LATCP> RECALL 2
      

This command recalls the second-to-last command you entered.

LATCP> RECALL SET
      

This command recalls the last SET command you entered.

Refreshes the display screen so that any output from some other source (such as a broadcast message) is erased from the screen.

Format

REFRESH

Parameters

None.

Description

Use the REFRESH command to refresh your display screen after output from other sources has overwritten the display screen. For example, if a broadcast message from a terminal server user is displayed on your screen, use the REFRESH screen to erase the broadcast message from the display. By default, you can refresh your screen by pressing Ctrl/W at the LATCP prompt.

Example

LATCP> REFRESH
      

This command refreshes the display on your screen.

Retrieves information that has scrolled off the screen, either up or down.

Format

SCROLL

Parameters

None.

Qualifiers

/DOWN[=value]

Scrolls the LATCP screen display down the number of lines indicated by the specified value. For convenience, you can also use the Next (or Next Screen) key on your keyboard to scroll down 15 lines (instead of entering the SCROLL/DOWN=15 command).

If you do not specify a value, the default value is 1.

/UP[=value]

Scrolls the LATCP screen display up the number of lines indicated by the specified value. For convenience, you can also use the Prev (or Prev Screen) key on your keyboard to scroll up 15 lines (instead of entering the SCROLL/UP=15 command).

If you do not specify a value, the default value is 1.

Description

The SCROLL command allows you to retrieve information that has scrolled off the screen (either up or down). The command works only after a LATCP SHOW command has produced output that scrolled off the screen display area. Each subsequent SHOW command erases the previous output area such that the SCROLL command retrieves the screen display produced by the last executed SHOW command.

Example

LATCP> SCROLL /UP=5
      

This command scrolls up to view five lines of screen display that has previously scrolled off the viewing area.

Changes the characteristics of LAT data links. You must have OPER privilege to use this command.

Format

SET LINK link-name

Parameter

link-name

Specifies the name for a LAT data link. A link name can have up to 16 ASCII characters. The characters allowed are as follows:

• Alphanumeric characters: A--Z, a--z, 0--9
• A subset of the international character set: ASCII codes 192--253
• Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore (_)

The SHOW LINK command displays the names of the links defined for a node.

Qualifiers

/LOG

/NOLOG (default)

Specifies whether LATCP displays a message confirming that the link's characteristics were modified. If you do not specify the /LOG or /NOLOG qualifier, the default is that no message will be displayed.

/STATE=option

Specifies availability of the link for use. The two options for STATE are:

ON	Specifies that the link will be available for use with the LAT protocol running.
OFF	Specifies that the link will not be available for use.

If you do not specify the /STATE=option qualifier, the default is that the link will be available (ON).

Description

The SET LINK command changes the characteristics for a LAT data link, which must have been created previously in one of the following ways:

• Interactively entering the CREATE LINK command
• Using the SET NODE/STATE=ON command to create a default link named LAT$LINK (if no other links are created when that command executes)
• Running a program that creates links

Example

LATCP> SET LINK NETWORK_A /LOG /STATE=ON
      

This command directs LATCP to start the controller for link NETWORK_A and then to display a confirmation message.

Specifies the LAT characteristics of your local node. You must have OPER privilege to use this command.

Format

SET NODE [node-name]

Parameter

node-name

Specifies a node name for your local node. By default, the node 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, HP recommends that you define SYS$NODE and use it for both DECnet and LAT node names.

A LAT node name can be from 1 to 16 ASCII characters. The characters allowed are as follows:

• Alphanumeric characters: A--Z, a--z, 0--9
• A subset of the international character set: ASCII codes 192--253
• Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore (_)

Qualifiers

/ANNOUNCEMENTS

/NOANNOUNCEMENTS

Controls whether your OpenVMS system multicasts information to the network.

If you specify /NOANNOUNCEMENTS, LAT service announcements are disabled on the local node. Remote nodes must rely on the LAT service responder feature in the LAT protocol Version 5.2 or higher to connect to the local node. Therefore, HP recommends that you use this qualifier only in a networking environment where newer model terminal servers and hosts are present (all LAT hosts, terminal servers, and PCs are running LAT protocol Version 5.2 or higher).

If you specify /NOANNOUNCEMENTS in an environment where LAT protocol Version 5.1 is present, those LAT protocol Version 5.1 systems (for example, DECserver 100, 200, and 500 systems) will be unable to connect to any of the systems that have LAT service announcements disabled.

/CIRCUIT_TIMER[=msecs]

Controls the interval in milliseconds (msecs) between messages sent from the local node to other service nodes or terminal servers while connections to those nodes are active. Use this qualifier only if your node allows outgoing connections (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH).

A low value for the interval decreases the response time for the 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 the service nodes. You cannot change this parameter when active or pending LAT connections exist.

/CONNECTIONS=option

Specifies the type of connections permissible on the local node. The four options for CONNECTIONS are:

INCOMING_ONLY	Specifies that the local node permit incoming connections only.
OUTGOING_ONLY	Specifies that the local node permit outgoing connections only. Specify this on systems that can tolerate the overhead associated with outgoing connections, such as standalone systems.
BOTH	Specifies that the local node permit both incoming and outgoing connections. Specify this on systems that can tolerate the overhead associated with outgoing connections, such as standalone systems.
NONE	Specifies that the local node disallow both incoming and outgoing connections.

If you do not specify the /CONNECTIONS=option qualifier, the default is that the node will permit incoming connections only.

/CPU_RATING=cpu-power

/NOCPU_RATING

The /CPU_RATING qualifier assigns your local node a rating that represents the power of your node's CPU (central processing unit) relative to other CPUs in the LAN. The value of cpu-power can range from 1 (for a CPU with the lowest power) to 100 (for a CPU with the highest power).

When a terminal server or node requests a connection to a service 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 by specifying a value for the /CPU_RATING qualifier. If you specify a high value for cpu-power, the LAT driver will calculate a relatively high service rating for services on your node (service 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 can calculate a greater range of values for dynamic service ratings (the entire range from 0 to 255). Consequently, the ratings will more accurately reflect the availability of the service node.

If you do not specify either the /CPU_RATING=cpu-power or /NOCPU_RATING qualifier, the default is that no CPU rating will be used A value of 0 indicates no CPU rating.

/DEVICE_SEED[=value]

Sets the default starting number (within a range from 1 to 9999) for the unit numbers that will be assigned to new LTA 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.

---

Previous

Next

Contents

Index