Order Number: AA-PC27J-TE
This book explains the user services available with DIGITAL TCP/IP Services for OpenVMS software.
Revision Information: This is a revised manual.
Operating Systems:
OpenVMS Alpha Versions 7.1, 7.2
OpenVMS VAX Versions 7.1, 7.2
Software Version: DIGITAL TCP/IP Services for OpenVMS Version 5.0
Compaq Computer Corporation Houston, Texas
Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.
Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor.
Compaq conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community.
© Compaq Computer Corporation 1999. All rights reserved.
The following are trademarks of Compaq Computer Corporation: Alpha, Compaq, DECnet, DIGITAL, DIGITAL UNIX, LAT, OpenVMS, PATHWORKS, POLYCENTER, VAX, VAX DOCUMENT, VAXcluster, VMS, and the Compaq logo.
The following are third-party trademarks:
JOIN is a trademark of Competitive Automation, Inc.
MS-DOS is a registered trademark of Microsoft Corporation.
OSF/1 is a registered trademark of Open Software Foundation, Inc.
PostScript is a registered trademark of Adobe Systems, Inc.
Sun, NFS, and PC-NFS are registered trademarks of Sun Microsystems, Inc.
UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd.
All other trademarks and registered trademarks are the property of their respective holders.
ZK6525
This document is available on CD-ROM.
This document was prepared using VAX DOCUMENT, Version V3.2n.
| Contents | Index |
The DIGITAL TCP/IP Services for OpenVMS product is Compaq's implementation of the TCP/IP networking protocol suite and internet services for OpenVMS Alpha and OpenVMS VAX systems.
A layered software product, DIGITAL TCP/IP Services for OpenVMS provides a comprehensive suite of functions and applications that support industry-standard protocols for heterogeneous network communications and resource sharing.
This manual explains how to use the user utilities and commands provided with the DIGITAL TCP/IP Services for OpenVMS product. It assumes that these services have been installed and configured on your OpenVMS system and that you have a basic understanding of the OpenVMS operating system.
This manual is for OpenVMS users who want to communicate with remote hosts on a private internet or on the worldwide Internet.
DIGITAL TCP/IP Services for OpenVMS Version 5.0 provides a new kernel based on the IPv4 kernel ported from DIGITAL UNIX Version 4.0D. 1
Other new features include:
Changes to this document include:
1 This kernel is based on Berkeley Software Distribution (BSD) Versions 4.3 and 4.4, and from Compaq Computer Corporation. |
This manual contains seven chapters.
Table 1 lists the manuals available with this version of DIGITAL TCP/IP Services for OpenVMS.
| Manual | Contents |
|---|---|
| DIGITAL TCP/IP Services for OpenVMS Release Notes |
This text file describes new features and changes to the software
including installation, upgrade, configuration, and compatibility
information. These notes also describe new and existing software
problems and restrictions, and software and documentation corrections.
Print this text file at the beginning of the installation procedure and read it before you install DIGITAL TCP/IP Services for OpenVMS. |
| DIGITAL TCP/IP Services for OpenVMS Installation and Configuration | This manual explains how to install and configure the DIGITAL TCP/IP Services for OpenVMS layered application product. |
| DIGITAL TCP/IP Services for OpenVMS User's Guide | This manual describes how to use the applications available with DIGITAL TCP/IP Services for OpenVMS such as remote file operations, e-mail, TELNET, TN3270, and network printing. This manual also explains how to use these services to communicate with systems on private internets or on the worldwide Internet. |
| DIGITAL TCP/IP Services for OpenVMS Management |
This manual describes how to configure and manage the DIGITAL TCP/IP
Services for OpenVMS product.
Use this manual with the DIGITAL TCP/IP Services for OpenVMS Management Command Reference manual. |
| DIGITAL TCP/IP Services for OpenVMS Management Command Reference |
This manual describes the DIGITAL TCP/IP Services for OpenVMS
management commands.
Use this manual with the DIGITAL TCP/IP Services for OpenVMS Management manual. |
| DIGITAL TCP/IP Services for OpenVMS ONC RPC Programming | This manual presents an overview of high-level programming using open network computing remote procedure calls (ONC RPC). This manual also describes the RPC programming interface and how to use the RPCGEN protocol compiler to create applications. |
| DIGITAL TCP/IP Services for OpenVMS System Services and C Socket Programming | This manual describes how to use the OpenVMS system services and C Socket programming interfaces to develop network-based applications. |
| DIGITAL TCP/IP Services for OpenVMS eSNMP Programming and Reference | This manual describes the Extensible Simple Network Management Protocol (eSNMP), the eSNMP application programming interface (API), and how to build additional subagents to manage vendor-specific equipment. |
For additional information about the DIGITAL TCP/IP Services for OpenVMS products and services, access the DIGITAL OpenVMS World Wide Web site at the following URL:
http://www.openvms.digital.com |
You might find the Internetworking with TCP/IP: Principles, Protocols, and Architecture by Douglas Comer useful if you are looking for a comprehensive overview of the TCP/IP protocol suite.
DIGITAL TCP/IP Services for OpenVMS Version 5.0 completes the change initiated several releases ago when the product name changed from "ULTRIX Connection (UCX)" to "DIGITAL TCP/IP Services for OpenVMS." To complete this change, the identifier "UCX" is replaced with "TCPIP" in the following cases:
DIGITAL TCP/IP Services for OpenVMS is used to mean both:
The auxiliary server is the DIGITAL TCP/IP Services for OpenVMS implementation of the UNIX internet daemon (inetd).
NFS is the DIGITAL TCP/IP Services for OpenVMS implementation of the NFS protocols, including the NFS server, the NFS client, and PC-NFS.
TN3270 means the TELNET client software that emulates IBM 3270 model terminals.
The term UNIX refers to the DIGITAL UNIX operating system. DIGITAL UNIX is fully compatible with Version 4.3 and Version 4.4 of the Berkeley Software Distribution (BSD).
Host and node both mean a system connected to an internet.
The term Internet refers to the global interconnection of networks, as defined by RFC 1208, which consists of large networks using TCP/IP to provide universal connectivity, reaching the Defense Advanced Projects Research Internet, MILNET, NSFnet, CERN, and many worldwide universities, government research labs, military installations, and business enterprises.
The term internet refers to private interconnected networks that use TCP/IP to connect together and function as one, virtual network.
The following acronyms are frequently used in this manual:
| BIND | Berkeley Internet Name Domain |
| FTP | File Transfer Protocol |
| LPD | Line Printer Daemon Protocol |
| LPR | Line Printer Protocol |
| RCP | Remote Copy |
| REXEC | Remote Executive |
| RFC | Request for Comments |
| RLOGIN | Remote Login |
| RSH | Remote Shell |
| SMTP | Simple Mail Transfer Protocol |
| TCP/IP | Transmission Control Protocol/Internet Protocol |
All IP addresses in this manual represent fictitious addresses. The following conventions apply to this manual.
| Convention | Meaning |
|---|---|
| UPPERCASE TEXT | Indicates names of OpenVMS and DIGITAL TCP/IP Services for OpenVMS commands, options, utilities, files, directories, hosts, and users. |
| lowercase special type | Indicates UNIX system output or user input, commands, options, files, directories, utilities, hosts, and users. |
| bold text | Indicates a new term. |
| italic text | Indicates a variable. |
| [Return] | Indicates that you press the Return key. |
| [Ctrl/] x | Indicates that you press the Control key while you press the key noted by x. |
| [ ] | In command format descriptions, indicates the enclosed element is optional. You can enter as many as you want. |
| { } | In command format descriptions, indicates you must enter at least one listed element. For readability, each element is either listed on a separate line or separated by vertical bars (|). Unless otherwise instructed, use a space to separate these elements when using them with commands. |
| ... | Horizontal ellipsis points in examples indicate additional optional arguments have been omitted. |
|
.
. . |
Vertical ellipsis points indicate omission of items from a code example or display example; the items are omitted because they are not important to the topic being discussed. |
Compaq welcomes your comments on this manual.
Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:
| Internet | openvmsdoc@zko.mts.dec.com |
| Fax | 603 884-0120, Attention: OSSG Documentation, ZKO3-4/U08 |
|
Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 |
Visit the OpenVMS Documentation World Wide Web site at the following URL to learn how to order additional documentation:
http://www.openvms.digital.com:81/ |
If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825).
TCP/IP is an open communications standard that enables any connected host to communicate with any other connected host. The DIGITAL TCP/IP Services for OpenVMS product is Compaq's implementation of TCP/IP for the OpenVMS operating system.
The DIGITAL TCP/IP Services for OpenVMS software allows you to communicate and share resources with remote OpenVMS systems, UNIX systems, and other systems that support the TCP/IP protocol suite and Sun Microsystems' Network File System (NFS).
The product consists of a number of components that implement various TCP/IP protocols. These components provide remote computing, file transfer, resource sharing, electronic mail, and network services as follows:
| Remote Computing | |
|---|---|
| TELNET |
Log in to a remote host in a network using various options to customize
the session, control output from the remote host, and negotiate
compatibility differences. To start a TELNET session, enter:
$ TELNET |
| RCP | Copy files between the local host and a remote host or between two remote hosts. Requests are authenticated on the remote host or hosts using the user name supplied by RCP. |
| RLOGIN | Connect to a remote host, which starts an interactive login session. Requests are authenticated on the remote host using the user name supplied by RLOGIN. |
| RSH | Connect to a remote host, which executes the command you specify. Requests are authenticated on the remote host using the user name supplied to RSH. |
| RSH/PASSWORD | Use the REXEC facility to connect to the remote host, which executes the command you specify. Requests are authenticated on the remote host using the user name and password supplied by RSH. |
| RMT/RCD | Access magnetic tape and CD drives on a remote host as though they are available locally. |
| Finger | Display information about users logged in to a remote host, such as their login user names or programs they are using. |
| File Transfer | |
| FTP |
Create, delete, and copy files and directories between hosts. To start
an FTP session, enter:
$ FTP |
| TFTP | Download and transfer files. |
| Resource Sharing | |
| LPD/LPR | Print files on remote and local hosts. |
| TELNETSYM | Print files on remote hosts using the TELNET protocol. |
| NFS | Authenticate requests and provide access to remote files. |
| SMTP | Send and receive electronic mail from remote hosts. |
| POP | Send and receive electronic mail from your PC. |
| Network Services | |
| BIND | Name and address resolution service to distribute and manage host information. |
| SNMP | Monitor and manage network devices from across an internetwork. |
| NTP | Synchronize time between hosts. |
| BOOTP | Answer bootstrap requests from remote devices. |
| DHCP | Configure and maintain your IP address space including the temporary assignment of IP addresses. |
| SLIP, CSLIP | Connect a node to a network over a serial connection using IP. |
| PPP | Connect a node to a network using IP or other supported network protocols. |
| Management commands |
Manage your TCP/IP environment. To start the management control
program, enter:
$ TCPIP For online descriptions of the management commands, enter: $ TCPIP HELP |
| TCPTRACE | Trace packets going in and out of the system. |
| NSLOOKUP | Determine if your local name server is running correctly or retrieve information from remote servers. |
Your particular installation may include some or all of the above components. For information about the components available to you, see your system or network manager.
System or network managers are generally authorized to install, configure, and manage the various TCP/IP components on your system. And, as such, many of the TCP/IP components are used primarily by system or network managers and are seldom needed by TCP/IP users. You can find the details of system management components and commands in DIGITAL TCP/IP Services for OpenVMS Management and DIGITAL TCP/IP Services for OpenVMS Management Command Reference.
If you are a TCP/IP user and want to manipulate files on remote
systems, send and receive electronic mail, log in to remote systems, or
enter commands remotely, this user guide provides the information and
commands you need.
1.1 Which Service Do You Use?
Some of the DIGITAL TCP/IP Services for OpenVMS components provide similar capabilities. Table 1-1 helps you determine the best facility to use for your specific needs and indicates where to look for information about that facility.
| To obtain user information, if you need to... | Use... | Refer to... |
|---|---|---|
| Get information about users logged in to a remote host, such as their login user names, current program being used, and last login. | Finger | Section 7.3 |
| Get information about users logged in to your OpenVMS Cluster. | Finger | Section 7.3 |
| To copy files, if you need to... | Use... | Refer to... |
| Perform other operations on the files, such as deleting, renaming, appending, and viewing files. | FTP | Section 2.9, Section 2.11, Section 2.10 |
| Copy multiple files to or from one or more unrelated directories on the remote host. | FTP | Section 2.3.1, Section 2.6, Section 2.8 |
| Copy every file and subdirectory in a directory on a host, preserving the directory hierarchy. | RCP | Section 3.4 |
| Create or delete directories, and display the contents of directories. | FTP | Section 2.7, Section 2.5 |
| Copy files between two remote hosts. | RCP | Section 3.8 |
| Perform fast file transfers between two OpenVMS hosts. | FTP | Section 2.8.4 |
| Copy files to and from a remote UNIX system, preserving RMS file attributes. | FTP | Section 2.8.5 |
| Copy files, preserving the protection mode and modification date. | RCP | Section 3.8 |
| Copy and work with files using DECnet file specifications. | FTP | Section 2.15 |
| To print files, if you need to... | Use... | Refer to... |
| Send local files to a remote host printer or print queue, using the OpenVMS printing options such as customizing the printed page with special print forms and specifying the number of copies to print. | DCL PRINT | Section 6.1 |
| Display the status of remote print queue jobs and cancel print jobs in that queue. | LPQ, LPRM | Section 6.2, Section 6.3 |
| Send remote UNIX files to a local print queue. | lpr+ | Section 6.4 |
| To log in to remote accounts, if you need to... | Use... | Refer to... |
| Log in to a remote host that runs Remote (R) protocols. | RLOGIN | Section 3.5 |
| Log in to a remote host, using many options to customize the session, control output from the remote host, and negotiate compatibility differences. | TELNET | Section 4.10 |
| Establish multiple, simultaneous login connections with one or more hosts, and toggle between the sessions. | TELNET | Section 4.9 |
| Log in using IBM 3270 Information System (IDS) terminal emulation with a host that uses IBM 3270 model terminals. | TN3270 | Section 4.12 |
| To enter remote commands, if you need to... | Use... | Refer to... |
| Enter a command on a remote host, including a command that invokes a remote shell script or command procedure, with any output displayed at your terminal. | RSH, REXEC | Section 3.6, Section 3.7 |
| Enter a command, without specifying user authentication information, on a remote host that has authentication files. | RSH | Section 3.6 |
| Enter a command and password to a host that does not have authentication files for you. | RSH/PASSWORD++ | Section 3.7 |
| To send and receive mail, if you need to... | Use... | Refer to... |
| Send mail to, and receive mail from, a remote host using SMTP. | Chapter 5 | |
| Send and receive OpenVMS mail, at your PC. | MAIL, POP | Section 5.10 |
| Next | Contents | Index |