Creates a logical port on your local node that connects with a
remote device on a terminal server. Alternatively, this command
creates a logical port on your local node that connects 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
CREATE PORT [port-name]
1 – Parameter
port-name
Specifies the port name in the form LTAn:, where n is a unique
number from 1 through 9999. If the port you specify already
exists, LATCP returns the following error message:
%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 an
existing LAT connection to that DECserver.
2 – Qualifiers
2.1 /APPLICATION
Specifies that a logical port on your node is an application
port. It can be used to connect to a remote device (typically a
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 LTA1234
$ LCP SET PORT LTA1234 /APPLICATION /NODE=terminal_server /PORT=server_port
$ 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 for
each LAT device that requires the NOHANGUP characteristic).
2.2 /DEDICATED
Specifies that a logical port on your local node is dedicated
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 the
dedicated port. See the OpenVMS I/O User's Reference Manual for a
description of programming an application service.
After creating a dedicated port on a node, use the SET PORT
/SERVICE command to map this port to a service.
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 was created. If you do not specify the /LOG or /NOLOG
qualifier, the default is that no message will be displayed.
2.5 /LOGICAL
/LOGICAL=(NAME=logical-name[,TABLE=table][,MODE=mode])
Specifies a logical name to be associated with the actual name of
the created port. You must specify a logical name if you do not
specify a port name.
NOTE
If you have sufficient privileges to create a port, but lack
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 the logical name in the group logical name
table. You must have GRPNAM or SYSPRV privilege to
place the logical name in the group logical name table.
JOB Places the logical name in the jobwide logical name
table.
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 privilege to
place a name in the system logical name table.
You can also specify the name of a specific table. For example,
you could specify LNM$PROCESS, which would be the equivalent of
specifying PROCESS.
Options for the MODE keyword are:
EXECUTIVE Creates an executive mode logical name. You must have
SYSNAM privilege to create an executive mode logical
name.
SUPERVISOR Creates a supervisor mode logical name.
USER Creates a user mode logical name.
The access mode associated with the logical name is determined
by maximizing the access mode of the caller with the access mode
specified by the MODE keyword: the mode with the lower privilege
is used.
You cannot specify an access mode with a privilege higher than
that of the table containing the logical name. However, if your
process has SYSNAM privilege, then the specified access mode is
associated with the logical name regardless of the access mode of
the caller.
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: /APPLICATION
The CREATE PORT command in this example creates an application
port named LTA22: on a service node. You can associate the port
with a specific printer on a terminal server (use the SET PORT
/NODE /PORT command) or with a set of printers on a terminal
server (use the SET PORT /NODE /SERVICE command). Or, you can
associate the port with a dedicated port on a remote service
node. In this case, use the SET PORT /NODE /SERVICE command,
where the /SERVICE qualifier specifies an application service
associated with a dedicated port on the remote node. See the
examples for the SET PORT command.
2.LATCP> CREATE PORT LTA21: /DEDICATED
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 -
_LATCP> /LOGICAL=(NAME=MAIL_PORT, TABLE=PROCESS, MODE=SUPERVISOR)
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 is created as a
supervisor mode logical name in the LNM$PROCESS_TABLE logical
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_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.