HP TCP/IP Services for OpenVMS

User's Guide

Order Number: AA--PC27L--TE

September 2003

This manual explains the user services available with the TCP/IP Services product.

Revision Information: This manual supersedes the Compaq TCP/IP Services for OpenVMS User's Guide, Version 5.3.

Software Version: HP TCP/IP Services for OpenVMS Version 5.4

Operating System: HP OpenVMS Alpha Versions 7.3-1 and 7.3-2

Hewlett-Packard Company Palo Alto, California

UNIX® is a registered trademark of The Open Group.

Microsoft® is a US registered trademark of Microsoft Corporation.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Proprietary computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

ZK6525

The HP TCP/IP Services for OpenVMS documentation is available on CD-ROM.

This document was prepared using DECdocument, Version V3.3-1e.

Contents Index

Preface

The HP TCP/IP Services for OpenVMS product is the HP implementation of the TCP/IP networking protocol suite and internet services for OpenVMS Alpha and OpenVMS VAX systems.

TCP/IP Services 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 TCP/IP Services 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.

See the HP TCP/IP Services for OpenVMS Installation and Configuration manual for information about installing, configuring, and starting this product.

Intended Audience

This manual is for OpenVMS users who want to communicate with remote hosts on a private internet or on the worldwide Internet.

Document Structure

This manual contains following chapters:

Chapter 1 introduces the services included in the TCP/IP Services product and explains how to enter command lines to use these services.
Chapter 2 explains how to use FTP and provides FTP command descriptions.
Chapter 3 explains how to use Remote Copy, Remote Login, Remote Shell, and Remote Execute and provides command descriptions.
Chapter 4 explains how to use TELNET and IBM 3270 model terminal emulation (TN3270, using TELNET) and provides command descriptions.
Chapter 5 explains how to use SMTP to send and receive electronic mail.
Chapter 6 explains how to use LPR/LPD for remote printing and provides command descriptions.
Chapter 7 explains how to use the FINGER utility to display information about users on a remote or local host.

**Table 1 TCP/IP Services Documentation**
Manual	Contents
Compaq TCP/IP Services for OpenVMS Concepts and Planning	This manual provides conceptual information about TCP/IP networking on OpenVMS systems, including general planning issues to consider before configuring your system to use the TCP/IP Services software. This manual also describes the manuals in the TCP/IP Services documentation set and provides a glossary of terms and acronyms for the TCP/IP Services software product.
HP TCP/IP Services for OpenVMS Release Notes	The release notes provide version-specific information that supersedes the information in the documentation set. The features, restrictions, and corrections in this version of the software are described in the release notes. Always read the release notes before installing the software.
HP TCP/IP Services for OpenVMS Installation and Configuration	This manual explains how to install and configure the TCP/IP Services product.
HP TCP/IP Services for OpenVMS User's Guide	This manual describes how to use the applications available with TCP/IP Services such as remote file operations, email, TELNET, TN3270, and network printing.
HP TCP/IP Services for OpenVMS Management	This manual describes how to configure and manage the TCP/IP Services product.
HP TCP/IP Services for OpenVMS Management Command Reference	This manual describes the TCP/IP Services management commands.
HP TCP/IP Services for OpenVMS Management Command Quick Reference Card	This reference card lists the TCP/IP management commands by component and describes the purpose of each command.
HP TCP/IP Services for OpenVMS UNIX Command Equivalents Reference Card	This reference card contains information about commonly performed network management tasks and their corresponding TCP/IP management and Tru64 UNIX command formats.
Compaq 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.
Compaq TCP/IP Services for OpenVMS Sockets API and System Services Programming	This manual describes how to use the Sockets API and OpenVMS system services to develop network applications.
Compaq TCP/IP Services for OpenVMS SNMP Programming and Reference	This manual describes the Simple Network Management Protocol (SNMP) and the SNMP application programming interface (eSNMP). It describes the subagents provided with the TCP/IP Services, utilities provided for managing subagents, and how to build your own subagents.
HP TCP/IP Services for OpenVMS Tuning and Troubleshooting	This manual provides information about how to isolate the causes of network problems and how to tune the TCP/IP Services software for the best performance.
HP TCP/IP Services for OpenVMS Guide to IPv6	This manual describes the IPv6 environment, the roles of systems in this environment, the types and function of the different IPv6 addresses, and how to configure TCP/IP Services to access the IPv6 network.
HP TCP/IP Services for OpenVMS Guide to SSH	This manual describes how to configure, set up, use, and manage the SSH for OpenVMS software.

Reader's Comments

HP welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet openvmsdoc@hp.com

Postal Mail Hewlett-Packard Company
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

How to Order Additional Documentation

For information about how to order additional documentation, visit the following World Wide Web address:

http://www.hp.com/go/openvms/doc/order

Conventions

The name TCP/IP Services means both:

HP TCP/IP Services for OpenVMS Alpha
HP TCP/IP Services for OpenVMS VAX

The name UNIX refers to the Tru64 UNIX operating system.

All IP addresses are fictitious.

The following conventions are used in this manual.

Ctrl/ x A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.

PF1 x A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button.

[Return] In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.)
In the HTML version of this document, this convention appears as brackets, rather than a box.

... A horizontal ellipsis in examples indicates one of the following possibilities:

Additional optional arguments in a statement have been omitted.
The preceding item or items can be repeated one or more times.
Additional parameters, values, or other information can be entered.

.
.
. A vertical ellipsis indicates the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.

( ) In command format descriptions, parentheses indicate that you must enclose choices in parentheses if you specify more than one.

[ ] In command format descriptions, brackets indicate optional choices. You can choose one or more items or no items. Do not type the brackets on the command line. However, you must include the brackets in the syntax for OpenVMS directory specifications and for a substring specification in an assignment statement.

| In command format descriptions, vertical bars separate choices within brackets or braces. Within brackets, the choices are optional; within braces, at least one choice is required. Do not type the vertical bars on the command line.

{ } In command format descriptions, braces indicate required choices; you must choose at least one of the items listed. Do not type the braces on the command line.

bold type Bold type represents the introduction of a new term. It also represents the name of an argument, an attribute, or a reason.

italic type Italic type indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).

UPPERCASE TYPE Uppercase type indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.

Example This typeface indicates code examples, command examples, and interactive screen displays. In text, this type also identifies URLs, UNIX commands and pathnames, PC-based commands and folders, and certain elements of the C programming language.

- A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.

numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.

Chapter 1
Getting Started

TCP/IP is an open communications standard that enables any connected host to communicate with any other connected host. The TCP/IP Services software is the HP OpenVMS implementation of industry-standard TCP/IP networking protocols.

The TCP/IP Services software allows you to communicate and share resources with remote OpenVMS systems, UNIX systems, and other systems that support the TCP/IP protocol suite.

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:

Table 1-1 TCP/IP Components
Remote Computing

FINGER Display information about users logged in to a remote host, such as their login user names or programs they are using.

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.

RMT/RCD Access magnetic tape and CD drives on a remote host as though they are available locally.

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.

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 the following command:
$ TELNET

File Transfer

FTP Create, delete, and copy files and directories between hosts. To start an FTP session, enter the following command:
$ FTP

TFTP Transfer files using the UDP protocol and no authentication. Typically used during the bootstrap process of diskless systems.

Resource Sharing

LPD/LPR Print files on remote and local hosts.

NFS Authenticate requests and provide access to remote files.

TELNETSYM Print files on remote hosts using the TELNET protocol.

Electronic Mail

IMAP View, move, copy, and delete electronic mail from your PC, and in conjunction with SMTP, create and send mail.

POP Send and receive electronic mail from your PC.

SMTP Send and receive electronic mail from remote hosts.

Programming Utilities

MIBCOMP Compile SNMP subagent source files in ASN.1 format.

RPCGEN Create programming skeletons that implement the RPC mechanism.

Network Services

BIND Name and address resolution service to distribute and manage host information.

BOOTP Answer bootstrap requests from remote devices.

DHCP Configure and maintain your IP address space including the temporary assignment of IP addresses.

Management commands Manage your TCP/IP environment. To start the management control program, enter the following command:
$ TCPIP

For online descriptions of the management commands, enter the following command:
$ TCPIP HELP

NSLOOKUP Determine if your local name server is running correctly or retrieve information from remote servers.

NTP Synchronize time between hosts.

PPP Connect a node to a network using IP or other supported network protocols.

SLIP, CSLIP Connect a node to a network over a serial connection using IP.

SNMP Monitor and manage network devices from across an internetwork.

TCPDUMP Analyze dumps and capture packets.

TCPTRACE Trace packets going in and out of the system.

**Table 1-1 TCP/IP Components**
Remote Computing
FINGER	Display information about users logged in to a remote host, such as their login user names or programs they are using.
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.
RMT/RCD	Access magnetic tape and CD drives on a remote host as though they are available locally.
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.
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 the following command: $ TELNET
File Transfer
FTP	Create, delete, and copy files and directories between hosts. To start an FTP session, enter the following command: $ FTP
TFTP	Transfer files using the UDP protocol and no authentication. Typically used during the bootstrap process of diskless systems.
Resource Sharing
LPD/LPR	Print files on remote and local hosts.
NFS	Authenticate requests and provide access to remote files.
TELNETSYM	Print files on remote hosts using the TELNET protocol.
Electronic Mail
IMAP	View, move, copy, and delete electronic mail from your PC, and in conjunction with SMTP, create and send mail.
POP	Send and receive electronic mail from your PC.
SMTP	Send and receive electronic mail from remote hosts.
Programming Utilities
MIBCOMP	Compile SNMP subagent source files in ASN.1 format.
RPCGEN	Create programming skeletons that implement the RPC mechanism.
Network Services
BIND	Name and address resolution service to distribute and manage host information.
BOOTP	Answer bootstrap requests from remote devices.
DHCP	Configure and maintain your IP address space including the temporary assignment of IP addresses.
Management commands	Manage your TCP/IP environment. To start the management control program, enter the following command: $ TCPIP For online descriptions of the management commands, enter the following command: $ TCPIP HELP
NSLOOKUP	Determine if your local name server is running correctly or retrieve information from remote servers.
NTP	Synchronize time between hosts.
PPP	Connect a node to a network using IP or other supported network protocols.
SLIP, CSLIP	Connect a node to a network over a serial connection using IP.
SNMP	Monitor and manage network devices from across an internetwork.
TCPDUMP	Analyze dumps and capture packets.
TCPTRACE	Trace packets going in and out of the system.

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 the HP TCP/IP Services for OpenVMS Management guide and the HP TCP/IP Services for OpenVMS Management Command Reference manual.

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 Should You Use?

Some of the TCP/IP Services components provide similar capabilities. Table 1-2 helps you determine the best component to use for your specific needs and indicates where to look for information about that component.

Table 1-2 Components to Use for Specific Tasks
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.10, Section 2.11

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.5, Section 2.7

Copy files between two remote hosts. RCP Section 3.8

Perform fast file transfers between two OpenVMS hosts. FTP Section 2.8.5

Copy files to and from a remote UNIX system, preserving RMS file attributes. FTP Section 2.8.6

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. MAIL Chapter 5

Send and receive OpenVMS mail, at your PC. MAIL, POP, IMAP Section 5.12

**Table 1-2 Components to Use for Specific Tasks**
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.10, Section 2.11
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.5, Section 2.7
Copy files between two remote hosts.	RCP	Section 3.8
Perform fast file transfers between two OpenVMS hosts.	FTP	Section 2.8.5
Copy files to and from a remote UNIX system, preserving RMS file attributes.	FTP	Section 2.8.6
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.	MAIL	Chapter 5
Send and receive OpenVMS mail, at your PC.	MAIL, POP, IMAP	Section 5.12

+This command must be entered at the remote UNIX host. A queue on your local OpenVMS system must be set up by the system manager to receive the UNIX print jobs. The queue must be identifiable by the UNIX system.
++Issuing the /PASSWORD qualifier with the RSH command invokes the REXEC facility, which sends the password to the specified remote host.

Contents

Index

Internet	openvmsdoc@hp.com
Postal Mail	Hewlett-Packard Company OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

Ctrl/ x	A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
PF1 x	A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button.
`[Return]`	In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets, rather than a box.
...	A horizontal ellipsis in examples indicates one of the following possibilities: Additional optional arguments in a statement have been omitted. The preceding item or items can be repeated one or more times. Additional parameters, values, or other information can be entered.
. . .	A vertical ellipsis indicates the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
( )	In command format descriptions, parentheses indicate that you must enclose choices in parentheses if you specify more than one.
[ ]	In command format descriptions, brackets indicate optional choices. You can choose one or more items or no items. Do not type the brackets on the command line. However, you must include the brackets in the syntax for OpenVMS directory specifications and for a substring specification in an assignment statement.
\|	In command format descriptions, vertical bars separate choices within brackets or braces. Within brackets, the choices are optional; within braces, at least one choice is required. Do not type the vertical bars on the command line.
{ }	In command format descriptions, braces indicate required choices; you must choose at least one of the items listed. Do not type the braces on the command line.
bold type	Bold type represents the introduction of a new term. It also represents the name of an argument, an attribute, or a reason.
italic type	Italic type indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).
UPPERCASE TYPE	Uppercase type indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
`Example`	This typeface indicates code examples, command examples, and interactive screen displays. In text, this type also identifies URLs, UNIX commands and pathnames, PC-based commands and folders, and certain elements of the C programming language.
-	A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers	All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.