Associates a logical port on the local node with a remote port
on a terminal server that supports a device. Alternatively,
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.
You must have OPER privilege to use this command.
Format
SET PORT port-name
1 – Parameter
port-name
Specifies the name of the port. A port name must be in the form
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 an
existing LAT connection to that DECserver.
2 – Qualifiers
2.1 /APPLICATION
Specifies that a port on the local node is an application port,
logically associated with a port on a terminal server or a
dedicated port on another LAT service node. The terminal server
port supports a device (for example, a printer). If the port
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.
2.2 /DEDICATED
Specifies that a logical port on your local node is dedicated
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:
1. Create the service by specifying the CREATE SERVICE
/APPLICATION command and then define the dedicated port by
specifying the CREATE PORT/DEDICATED command. You can include
these commands in LAT$SYSTARTUP.COM.
2. Associate the dedicated ports with the service by specifying
the SET PORT/DEDICATED/SERVICE command.
3. Start the application program. Within the program, allocate
dedicated ports with the same name as those defined in
LAT$SYSTARTUP.COM.
2.3 /LIMITED
Specifies that a logical port on your local node is limited to
a service in the same way a port created using the /DEDICATED
qualifier is dedicated to an application service. The difference
is that ports created using the /LIMITED qualifier are under the
control of the system login image (LOGINOUT.EXE) instead of an
application program (a user who connects to a limited service and
is assigned to a limited port receives the "Username:" prompt).
Using the /LIMITED qualifier, you can create a limited number
of ports and map them to a specific service offered by the host
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).
2.4 /LOG
/LOG
/NOLOG
Specifies whether LATCP displays a message confirming that the
port's characteristics were modified. If you do not specify the
/LOG or /NOLOG qualifier, the default is that no message will be
displayed.
2.5 /NODE
/NODE=remote-node-name
Specifies the name of a terminal server (or a remote node that
supports outgoing connections) to be logically associated with
the specified application port on your node. The server supports
a remote device. Note that you can set up an application port
on your local node and associate the port with a dedicated port
on a remote LAT service node. The remote port is dedicated to an
application service.
2.6 /PASSWORD
/PASSWORD=remote-password
Specifies the password required to access a remote service that
is logically associated with the specified application port.
2.7 /PORT
/PORT=remote-port-name
Specifies the name of the remote port on a terminal server that
supports a remote device, or specifies the name of a remote port
dedicated to an application service on a remote LAT service node.
In either case, the remote port is logically associated with the
specified application port on your local node.
2.8 /QUEUED
/QUEUED
/NOQUEUED
Specifies queued or nonqueued access to the server port. A queued
or nonqueued request is accepted by a terminal server if a
remote port is free. If the remote port is busy and queuing is
enabled on the terminal server, then the server queues the remote
request. If you do not want your remote requests to be queued on
the server, specify /NOQUEUED.
Not specifying either the /QUEUED or /NOQUEUED qualifier results
in queued access to the server port. This is the default.
2.9 /SERVICE
/SERVICE=service-name
Specifies either of the following:
o The name of the remote service offered at a terminal server
port that will be associated with the specified application
port (/APPLICATION) on the local node
o A service name for an application program being offered on a
dedicated port (/DEDICATED) on a LAT service node
To specify the name of a remote service offered at a terminal
server port, use the /NODE and /SERVICE qualifiers. To specify a
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 and
/SERVICE qualifiers. (The service must have been created with the
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 up port LTA22: as
an application port to be associated with the port named LN02
on the terminal server named TS33EW. This command associates
port LTA22: with a specific printer on the server. In the next
example, the SET PORT command associates a port with a set of
printers (designated by the service name PRINTER) on a terminal
server.
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 a
terminal server. The command associates the application port
LTA19: with the service PRINTER on terminal server TLAT1. The
service PRINTER can be associated with one or more ports on
TLAT1. The /QUEUED qualifier specifies that the server offering
the service PRINTER can queue the remote connection request if
all ports offering the service are in use. See the description
of print operations in the OpenVMS System Manager's Manual for
information on setting up print queues.
3.LATCP> SET PORT LTA21: /DEDICATED /SERVICE=GRAPHICS
The SET PORT command in this example specifies that the
application port LTA21: on the local service node offers the
service GRAPHICS to users on terminal servers or on nodes that
support outgoing connections. GRAPHICS is a particular utility
or application program.
4.LATCP> SET PORT MAIL_PORT /SERVICE=MAIL/NODE=RMNODE
The SET PORT command in this example associates the port whose
logical name is MAIL_PORT with the dedicated service MAIL
on remote node RMNODE. The port logically named MAIL_PORT
was created with the CREATE PORT command (see Example 3 in
the discussion of the CREATE PORT command). The logical name
could also have been created with an OpenVMS DCL ASSIGN or
DEFINE command. On node RMNODE, a port must be dedicated to
the service MAIL by using the SET PORT port-name /DEDICATED
/SERVICE=MAIL command.
5.$ LCP :== $LATCP
$ LCP CREATE SERVICE/LIMITED ONLY_ONE
$ LCP CREATE PORT/LIMITED LTA1234:
$ LCP SET PORT LTA1234: /SERVICE=ONLY_ONE
This series of commands, which includes the SET PORT command,
creates a limited service that allows only one user to log in
to the system through that service. When a user connects to
service ONLY_ONE by responding to the terminal server prompt
(Local>), the user is assigned port LTA1234 and then prompted
for the user name. Any user who attempts to connect to the
same service while LTA1234 has a user logged in receives the
"service in use" message.