This chapter describes the Network Terminal Device Control Program (NTYCP) commands you can use to create terminal devices.
To invoke NTYCP as an OpenVMS "foreign" command:
$ NTYCP := $MULTINET:NTYCP
To invoke NTYCP interactively:
$ RUN
MULTINET:NTYCP
NTYCP> CREATE PORT NTYnnnn /NODE=host-name
/PORT=port-number
NTYCP> EXIT
To set up the terminal characteristics:
$ SET TERMINAL NTYnnn:/PERMANENT/NOBROADCAST/NOTYPEAHEAD/NOWRAP
To set up spooling:
$ SET DEVICE/SPOOLED=(queue-name,SYS$SYSDEVICE:) NTYnnnn:
To initialize and start the queue:
$ INITIALIZE/QUEUE/ON=NTYnnnn: queue-name /PROCESSOR=MULTINET_NTYSMB/START
This example shows how to set up a print queue connected to an HP LaserJet printer with a JetDirect card:
$ NTYCP :=
$MULTINET:NTYCP
$ NTYCP CREATE PORT NTY1001/NODE=hp-laserjet/PORT=9100
%NTYCP-S-CREPORT, device _NTY1001: created to host 192.1.1.5, port 9100
$ SET TERMINAL/PERMANENT
NTY1001:/NOBROADCAST/NOTYPEAHEAD/NOWRAP
$ INITIALIZE/QUEUE/ON=NTY1001:
HP_LASERJET/PROCESSOR=MULTINET_NTYSMB/START
The below table lists the NTYCP commands.
|
NTYCP Command |
Description |
|
CREATE PORT |
Creates a new network terminal port device. |
|
DELETE PORT |
Deletes an NTY device created by the CREATE_PORT command. |
|
EXIT |
Exits from NTYCP to DCL command mode. |
|
HELP |
Displays help text about NTYCP commands. |
|
MODIFY PORT |
Modifies (changes) an existing network terminal port device. |
Creates a new network terminal port device. The device links the VMS terminal driver to a TCP/IP network connection directed to the destination address specified by the /HOST qualifier and the /PORT or /SERVICE qualifier.
You can use network terminal (NTY) devices with the MULTINET_NTYSMB print symbiont to provide VMS print queue support for network-connect printers. You can also use them with user-written applications that need a simple terminal-style I/O interface to a remote terminal, plotter, etc.
CREATE PORT device-name
|
Command Qualifiers |
Defaults |
|
/[NO]LOG |
/LOG |
device-name
Name of the NTY port device to be created. If specified, the device name must be of the form NTYn, where n is a device unit number, which must be in the range 1-9999. The specified device must not already exist. If omitted, the next available unit number will be used.
/LOG
/NOLOG
Controls whether a log message is generated on successful completion of the command. The default is /LOG.
/LOGICAL=(logical-name-options...)
Causes NTYCP to create a logical name for the created NTY device. This qualifier takes one or more of the keyword options specified in the below table. If you specify multiple options, separate them by commas. You must have access to the specified logical name table and sufficient privilege to create the logical name.
|
Keyword |
Description |
|
NAME=logical-name |
The logical name to be created. You must specify this option if you use /LOGICAL. |
|
TABLE=table-name |
Specifies the logical name table in which the logical name should be created. This can be the actual name of a table, or one of the key-words PROCESS, GROUP, SYSTEM. The default is TABLE=PROCESS. |
|
MODE=mode-name |
Specifies the access mode in which the logical name should be created. The keywords are EXECUTIVE, SUPERVISOR, USER. The default is MODE=SUPERVISOR. |
/NODE=node-name-or-address
Specifies the name or numeric IP address of the remote node. You must specify this qualifier.
If you specify a node name, it is translated into an IP address. Only one IP address may be configured per NTY device. If the destination system is a host with multiple IP addresses, and not all addresses are directly reachable from your local system, you should specify the IP address numerically to ensure that a reachable address is configured.
/PORT=port-number
Specifies a TCP port number on the remote node to which the connection will be made. You must specify either the /PORT qualifier or the /SERVICE qualifier with the command.
/SERVICE=service-name
Specifies the name of a TCP service that translates to a port number to which the connection will be made. You may specify any TCP service name present in the local hosts/services table. You must specify either the /PORT qualifier or the /SERVICE qualifier with the command.
Deletes an NTY device created by the NTYCP CREATE PORT command.
DELETE PORT device-name
|
Command Qualifiers |
Defaults |
|
/[NO]LOG |
/LOG |
device-name
Name of the NTY port device to be deleted.
/LOG
/NOLOG
Controls whether a log message is generated on successful completion of the command. The default is /LOG.
Causes NTYCP to exit back to DCL command mode.
EXIT
Displays help text about NTYCP commands.
HELP [topic]
topic
A command name or other topic in the NTYCP help library. If omitted, a list of topics displays.
Modifies (changes) an existing network terminal port device. The device links the VMS terminal driver to a TCP/IP network connection directed to the destination address specified by the /HOST qualifier and the /PORT or /SERVICE qualifier.
MODIFY_PORT device-name
|
Command Qualifiers |
Defaults |
|
/[NO]LOG /LOGICAL=(logical-name-options...) /NODE=node-name-or-address /PORT=port-number /SERVICE=service-name |
/LOG |
modify-object
Name of the NTY object to be modified (changed).
port-name
Name of the NTY port device to be modified (changed).
/LOG
/NOLOG
Controls whether a log message is generated on successful completion of the command. The default is /LOG.
/LOGICAL=(logical-name-options...)
This is the logical name for the NTY device you want to modify. This qualifier takes one or more of the keyword options specified in the below table. If you specify multiple options, separate them by commas. You must have access to the specified logical name table and sufficient privilege to modify the logical name.
|
Keyword |
Description |
|
NAME=logical-name |
The logical name to be created. You must specify this option if you use /LOGICAL. |
|
TABLE=table-name |
Specifies the logical name table in which the logical name should be created. This can be the actual name of a table, or one of the keywords PROCESS, GROUP, SYSTEM. The default is TABLE=PROCESS. |
|
MODE=mode-name |
Specifies the access mode in which the logical name should be created. The keywords are EXECUTIVE, SUPERVISOR, USER. The default is MODE=SUPERVISOR. |
/NODE=node-name-or-address
Specifies the name or numeric IP address of the remote node. You must specify this qualifier.
If you specify a node name, it is translated into an IP address. Only one IP address may be configured per NTY device. If the destination system is a host with multiple IP addresses, and not all addresses are directly reachable from your local system, you should specify the IP address numerically to ensure that a reachable address is configured.
/PORT=port-number
Specifies a TCP port number on the remote node to which the connection will be made. You must specify either the /PORT qualifier or the /SERVICE qualifier with the command.
/SERVICE=service-name
Specifies the name of a TCP service that translates to a port number to which the connection will be made. You may specify any TCP service name present in the local hosts/services table. You must specify either the /PORT qualifier or the /SERVICE qualifier with the command.