Order Number: AA-PQQGG-TE

This manual describes the commands used for configuring and managing the DIGITAL TCP/IP Services for OpenVMS product.

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, DIGITAL, DIGITAL UNIX, LAT, OpenVMS, OpenVMS, OpenVMS Cluster, PATHWORKS, POLYCENTER, VAX, VAX DOCUMENT, VAXcluster, VMS, and the DIGITAL 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 of UNIX System Laboratories, Inc., a wholly-owned subsidiary of Novell, Inc.

All other trademarks and registered trademarks are the property of their respective holders.

ZK6527

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 describes the DIGITAL TCP/IP Services for OpenVMS management commands. Use it in conjunction with the DIGITAL TCP/IP Services for OpenVMS Management manual, which describes the management tasks.

Intended Audience

This manual is for experienced OpenVMS and/or UNIX system managers and assumes a working knowledge of TCP/IP networking, TCP/IP terminology, and some familiarity with the DIGITAL TCP/IP Services for OpenVMS product.

If you are not familiar with the DIGITAL TCP/IP Services for OpenVMS product, please review the DIGITAL TCP/IP Services for OpenVMS Concepts and Planning before using this manual to configure and manage TCP/IP components.

New and Changed Features

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. ¹

Other new features include:

• Dynamic Host Configuration Protocol (DHCP) that allows the system manager to provide dynamic allocation of IP addresses from a single OpenVMS host.
• Gateway routing daemon (GATED) server and a comprehensive suite of interior and exterior routing protocols that offer advanced routing options.
• Classless Inter-domain routing (CIDR) which allows networks to be built with variable-length subnetworks
• PathMTU discovery, a mechanism that allows an IP host to determine the most efficient packet size for use on a particular path between the source to the destination host.
• UNIX management utilities to assist with the management of OpenVMS systems in a mixed UNIX and OpenVMS environment.
• New implementations of NTP, SNMP, and BIND.
• Improved online help and a new message database for use with the OpenVMS Help Message utility (MSGHLP).

Changes to this document include:

• New commands to support GATED routing: START ROUTING /GATED and SET GATED
• A new command to convert existing UCX BIND configurations to BIND 8.1 format CONVERT/CONFIGURATION BIND
• The removal of several obsolete commands and command/qualifier pairs. See the DIGITAL TCP/IP Services for OpenVMS Release Notes for a complete list of obsolete commands.

Document Structure

This manual contains two chapters.

• Chapter 1 introduces the management control program.
• Chapter 2 provides command descriptions for each management command.

Related Documentation

Table 1 lists the documents available with this version of DIGITAL TCP/IP Services for OpenVMS.

Table 1 DIGITAL TCP/IP Services for OpenVMS Documentation

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 Sun 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.

Terminology

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:

• Registered product facility code
• Management command prompt
• All messages, examples, and banners
• All product file names and databases
• All logical names, except those retained for compatibility
• All associated product documentation

DIGITAL TCP/IP Services for OpenVMS is used to describe both:

• DIGITAL TCP/IP Services for OpenVMS Alpha
• DIGITAL TCP/IP Services for OpenVMS VAX

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.

Acronyms

For a complete list of acronyms used throughout this and other manuals in the DIGITAL TCP/IP Services for OpenVMS documentation set, see DIGITAL TCP/IP Services for OpenVMS Management guide.

Conventions

All IP addresses in this book represent fictitious addresses. The following conventions apply to this book.

Convention	Meaning
UPPERCASE SPECIAL TEXT	Indicates OpenVMS system output or user input.
lowercase special text	Indicates UNIX system output or user input, commands, options, files, directories, utilities, hosts, and users.
italic text	Indicates a variable.
bold text	Indicates a new term defined in the text.
[ ]	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 bars (|). Unless otherwise instructed, use a space to separate these elements when using them with commands.

Reader's Comments

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
Mail	Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

How to Order Additional Documentation

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). <RECTO_HEAD>(CANCEL_H) <VERSO_HEAD>(CANCEL_H)

DIGITAL TCP/IP Services for OpenVMS software provides a management command interface you use to configure, reconfigure, and manage the software. These commands let you perform the following tasks:

• Modify parameters, usually to tune performance
• Configure customer-developed services
• Enable components that you originally opted not to run
• Disable running components
• Monitor the software
• Customize a site-specific startup file

To start the management control program, type TCPIP at the OpenVMS prompt.

$ TCPIP

At the TCPIP> prompt, enter the commands described in this manual or display online help. Type EXIT to exit the management control program or Ctrl/C to abort a command.

Help is also available at the OpenVMS prompt by entering HELP TCPIP_SERVICES.

Table 1-1 describes the guidelines you should follow when entering management control program commands.

Table 1-1 Command Guidelines

Guideline	Description
Abbreviating Keywords	Abbreviate command keywords to the fewest number of characters, usually four, that identify the command.
Using Quotation Marks	On command lines, enclose the following in quotation marks ( " " ): Lowercase and mixed-case names to be stored in a database with the exact case preserved. Directory and file specifications with a slash ( / ). Consider these examples: TCPIP> MAP "/usr/songbirds/canary" CANARY$DUA2: TCPIP> ADD PROXY COUSINS /GID=10 /UID=40 /NFS=OUTGOING - _TCPIP> /HOST=("raven","crow","rook","daw","magpie") TCPIP> SET HOST "eaglet" /ADDRESS = 128.33.22.1 TCPIP> SHOW HOST EAGLET
Entering Host Names and IP Addresses	To specify a host or network on a command line, you can enter either the host's name or the host's IP address.
File and Directory Names	When you specify OpenVMS files, follow all OpenVMS file specification rules. Likewise, when you specify UNIX files, follow all UNIX file specification rules.
Multiple Values	To specify multiple host names, addresses, or options for parameters and qualifiers, be sure to separate elements with commas and enclose the entire list in parentheses. Wildcards are valid unless otherwise stated. A space between multiple elements is optional unless otherwise stated. For example, /qualifier=(option_a:value1,option_b:value2,value3) is the same as /qualifier=(option_a=value1),(option_b=value2,value3)
Number Values	Unless otherwise stated, all shown values are decimal.
Address Formats	Some commands require that you specify one of the following kinds of addresses: IP Ethernet FDDI Token Ring Hardware Be sure to use the appropriate format. The examples below illustrate an IP address, a hardware address, and an Ethernet address. TCPIP> SET HOST CROW /ADDRESS=1.2.3.4 TCPIP> SET BOOTP MACAW - _TCPIP>/HARDWARE=ADDRESS=08-dd-ff-2a-23-21 TCPIP> SET ARP AA-BB-04-05-06-07 CONDOR
UNIX commands	Follow UNIX syntax and case rules when entering UNIX commands at the TCPIP> prompt. For example, enter: TCPIP> ifconfig options not TCPIP> IFCONFIG options
Using Wildcards	If you specify a wildcard on a command line, you will be asked for confirmation before the command executes. Change this default behavior with the /NOCONFIRM qualifier. For example: TCPIP> REMOVE PROXY GRACKLE /GID=* /UID=130 VMS User_name Type User_ID Group_ID Host_name GRACKLE N 269 48 MAPLE Remove? [N]: Most SHOW commands default values to *. DELETE commands require that you supply a parameter.
Valid Values	Most management commands accept any number value you might enter. Specify values appropriate to your environment.

1.1.1 Setting Configuration Parameters

For some components, you can enter information only in a permanent database and, for others, only in dynamic memory. In addition, DIGITAL TCP/IP Services for OpenVMS can store parameter settings and other configuration information for some of the software in both locations. Table 1-2 shows the SET commands that affect only one or the other.

Table 1-2 Setting Configuration Parameters

Modify Permanent Database Files	Modify Dynamic Memory
SET BOOTP	SET ARP
SET CONFIGURATION	SET COMMUNICATION
SET HOST	SET INTERFACE
SET MX_RECORDS	SET NAME_SERVICE
SET NETWORK	SET NFS_SERVER
SET CONTAINER	SET PROTOCOL
SET SERVICE

The SET ROUTE command works on both the permanent and dynamic routing databases.

1.1.2 Modifying Parameters

Unlike the other databases, which have similar objects, the configuration database holds diverse initialization information for various DIGITAL TCP/IP Services for OpenVMS components.

All the initialization information is node-specific except for TIME and SNMP. This information is identified by the SYSGEN parameter SCSNODE. If you change your node's name after you configure DIGITAL TCP/IP Services for OpenVMS, the startup information, by default, will not be seen by the startup procedure or by the management software.

To see the configuration that is paired to the original node name, use the /ON qualifier, which is available with all the configuration commands. To copy node-specific startup information from one node to another, use the COPY CONFIGURATION command.

The following commands modify the configuration database:

• SET CONFIGURATION BIND
• SET CONFIGURATION COMMUNICATION
• SET CONFIGURATION ENABLE SERVICE
• SET CONFIGURATION INTERFACE
• SET CONFIGURATION NAME_SERVICE
• SET CONFIGURATION PROTOCOL
• SET CONFIGURATION SMTP
• SET CONFIGURATION SNMP
• SET CONFIGURATION START ROUTING
• SET CONFIGURATION TIME

The CREATE commands create the following kinds of files:

• Database files
  Compaq strongly recommends that you run the DIGITAL TCP/IP Services for OpenVMS configuration procedure instead of manually creating databases. See DIGITAL TCP/IP Services for OpenVMS Installation and Configuration for instructions.
  Use the following commands to create database files:
  • CREATE BOOTP
  • CREATE CONFIGURATION
  • CREATE EXPORT
  • CREATE HOST
  • CREATE NETWORK
  • CREATE PROXY
  • CREATE ROUTE
  • CREATE SERVICE
• UNIX style container directories
  These directories are used by the NFS server software. Create and delete container directories and files with the following commands:
  • CREATE CONTAINER, DELETE CONTAINER
  • CREATE DIRECTORY, REMOVE DIRECTORY, REMOVE FILE