 |
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.
#3 |
$ 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.
DEFINE/KEY
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.
DELETE LINK
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.
DELETE PORT
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.
DELETE QUEUE_ENTRY
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.
DELETE SERVICE
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.
EXIT
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
This command exits the LATCP program and returns control to the DCL
command level.
HELP
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
This command produces a description of the SET PORT command and shows
the command format.
RECALL
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
This command recalls the second-to-last command you entered.
This command recalls the last SET command you entered.
REFRESH
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
This command refreshes the display on your screen.
SCROLL
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
This command scrolls up to view five lines of screen display that has
previously scrolled off the viewing area.
SET LINK
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.
SET NODE
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.
|