1 Entering_Commands To start the management control program, type TCPIP at the DCL prompt. For example: $ TCPIP TCPIP> At the TCPIP> prompt, you can enter commands described in this manual or display online help. Type EXIT to exit the management control program, or press Ctrl/C to abort a command. Help is also available at the DCL prompt by typing HELP TCPIP_ SERVICES. $ HELP TCPIP_SERVICES NOTE The word command refers to commands for the TCP/IP Services software. DCL commands and UNIX commands are explicitly identified. Management Command Guidelines provides guidelines for using management control program commands. 2 Management_Command_Guidelines Table 1 Management Command Guidelines Element Guideline Address formats Some commands require that you specify one of the following kinds of addresses: o IP o Ethernet o FDDI o Token Ring o Hardware Be sure to use the appropriate format. The following examples illustrate an IP address, an Ethernet address, and a hardware address, respectively. TCPIP> SET HOST CROW /ADDRESS=1.2.3.4 TCPIP> SET ARP AA-BB-04-05-06-07 CONDOR TCPIP> SET BOOTP MACAW /HARDWARE=ADDRESS=08-dd-ff-2a-23-21 Default Refers to the command's behavior if optional qualifiers are omitted. File and When you specify OpenVMS files, follow all directory names OpenVMS file specification rules. Likewise, when you specify UNIX files, follow all UNIX file specification rules. Service names To specify a lowercase or mixed-case service name, enclose it in quotation marks. Service names are limited to 16 characters. Use only the following characters in a service name: o Uppercase and lowercase alphabetic characters o Numerals o Dollar sign ($) o Underscore (_) Do not define a service name equivalent to one of the TCP/IP Services for OpenVMS components (for example, do not define a service name BIND or TCPIP$BIND). In addition, the service name CUSTOMER_SERVICE is reserved by HP. Host names and IP To specify a host or network name on a command addresses line, you can enter either the host's name or the host's IP address. Keywords You can abbreviate commands to the fewest number of characters, usually four, that identify the command. The following command lines, for example, have identical meanings: TCPIP> SH SE NFS/FU/PER TCPIP> SHOW SERVICE NFS /FULL /PERMANENT Command examples shown in this manual are expressed using full command and qualifier names for clarity. 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, the following qualifiers are the same: /qualifier=(option_a:value1,option_b:value2,value3) /qualifier=(option_a=value1),(option_b=value2,value3) Wildcards are valid unless otherwise stated. A space between multiple elements is optional unless otherwise stated. Numeric values Unless otherwise stated, all numeric values are decimal. Values are indicated by either a preceding equals sign (=) or a colon (:). For example: TCPIP> SET NAME_SERVICE /SERVER:(SORA,JACANA,PARROT) - _TCPIP> /ACCEPT:(HOSTS:JACANA,JAY,JUNCO,999.20.40.3) Quotation marks In command lines, enclose the following in quotation marks: o Lowercase and mixed-case names to be stored in a database with the exact case preserved o Directory and file specifications containing a slash (/) o Uppercase options specified with UNIX commands Consider these examples: 1. To specify a path, enclose it in quotation marks: TCPIP> MAP "/usr/songbirds/canary" CANARY$DUA2: 2. To specify host names using lowercase letters when you create a proxy entry in the database: TCPIP> ADD PROXY COUSINS /GID=10 /UID=40 - _TCPIP> /HOST=("raven","crow","rook","daw") Note the use of the DCL command-line continuation character ( - ) that allows you to continue a long command on the next line. 3. To specify a lowercase host name when adding the host to the hosts database, use these commands: TCPIP> SET HOST "eaglet" /ADDRESS = 128.33.22.1 TCPIP> SHOW HOST EAGLET Note that DCL interprets all input as uppercase unless you enclose it in quotation marks. Therefore, you must use quotation marks to enter the host name in lowercase in the hosts database. To display information about a host, you can enter either uppercase or lowercase characters. 4. When entering a lowercase or mixed-case service name in a command, enclose it in quotations marks. For example: TCPIP> SET SERVICE "hello" ... 5. When entering an option in uppercase in a UNIX command, enclose the option in quotation marks. For example: TCPIP> sysconfig "-Q" inet UNIX commands Follow UNIX syntax and case rules when entering UNIX commands at the DCL and TCPIP> prompts. For example, enter the ifconfig command in lowercase letters: TCPIP> ifconfig options When entering UNIX commands at the DCL or TCPIP> prompt, enclose uppercase options in quotation marks. For example: $ TCPIP> sysconfig "-Q" inet You can abbreviate commands, as shown in the following example. The abbreviation must be unique through the first four characters. TCPIP> ifco options If the abbreviation entered is not unique, an error message will advise you to supply more characters. In the following example, the SYSCONFIG command cannot be abbreviated because of the SYSCONFIGDB command. TCPIP> sysc -q %CLI-W-ABVERB, ambiguous command verb - supply more characters Wildcards If you specify a wildcard (an asterisk [*]) on a command line, you are asked for confirmation before the command executes. For example: TCPIP> REMOVE PROXY * VMS User_name Type User_ID Group_ID Host_name GRACKLE N 269 48 MAPLE Remove? [N]: To change this default behavior (so that you are not asked to confirm), use the /NOCONFIRM qualifier with the command. 2 Setting_Parameters Some commands allow you to enter information in the database; others modify only the run-time parameters. SET Commands shows the SET commands that affect one or the other. Table 2 SET Commands 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 ROUTE SET ROUTE SET SERVICE Note that the SET ROUTE command affects both the permanent and dynamic routing databases. 2 Modifying_the_Configuration_Database Unlike the other databases, which have similar objects, the configuration database holds diverse initialization information for various TCP/IP Services components. The following commands modify the configuration database: o SET CONFIGURATION BIND o SET CONFIGURATION COMMUNICATION o SET CONFIGURATION ENABLE SERVICE o SET CONFIGURATION INTERFACE o SET CONFIGURATION NAME_SERVICE o SET CONFIGURATION PROTOCOL o SET CONFIGURATION SMTP o SET CONFIGURATION SNMP o SET CONFIGURATION START ROUTING o SET CONFIGURATION TIME 2 Creating_and_Deleting_Files The CREATE commands create the following kinds of files: o Database files HP strongly recommends that you use the TCP/IP Services configuration procedure (TCPIP$CONFIG) instead of manually creating databases. Refer to the HP TCP/IP Services for OpenVMS Installation and Configuration guide for instructions. Use the following commands to create database files: - CREATE BOOTP - CREATE CONFIGURATION - CREATE EXPORT - CREATE HOST - CREATE NETWORK - CREATE PROXY - CREATE ROUTE o UNIX container directories These directories are used by the NFS server software. Use the following commands to create and delete container directories and files: - CREATE CONTAINER - DELETE CONTAINER - CREATE DIRECTORY - REMOVE DIRECTORY - REMOVE FILE 2 Adding_and_Deleting_Records To add and delete records from the TCP/IP Services databases, use the CONVERT, ADD, and REMOVE management commands. Use the following commands to add records to and delete records from the proxy and export databases: o ADD EXPORT o REMOVE EXPORT o ADD PROXY o REMOVE PROXY You cannot modify information that you enter into databases. Instead, delete the record with the REMOVE command and then issue a new ADD command. TCP/IP Services provides the following kinds of CONVERT management commands: o CONVERT/CONFIGURATION BIND Converts BIND configuration information to BIND Version 8.1 format. o CONVERT/VMS Populates an existing database with entries from a UNIX database file. o CONVERT/UNIX Reads a TCP/IP Services database and converts the information to a UNIX-formatted (sequential) database file. For example, CONVERT/UNIX HOST reads the hosts database and converts the records into a UNIX-formatted /etc/hosts file. 2 Starting_and_Stopping_Software You can start and stop software components interactively by using the following commands: o START MAIL o START ROUTING o STOP ROUTING For example: TCPIP> START ROUTING /SUPPLY For the server components that are started by the auxiliary server upon an incoming client request, the ENABLE SERVICE command tells the the auxiliary server to listen for requests and act upon them. The DISABLE SERVICE command tells the auxiliary server to stop listening for incoming requests. Use the following commands to set components to start when TCP/IP Services starts. The permanent configuration is stored in the configuration database. o SET CONFIGURATION ENABLE SERVICE o SET CONFIGURATION ENABLE NOSERVICE o SET CONFIGURATION START ROUTING o SET CONFIGURATION START NOROUTING 2 Validating_Data_Integrity Use the following commands to verify the integrity of TCP/IP Services files: o ANALYZE CONTAINER o ANALYZE MAIL o ANALYZE SERVICE 2 Managing_NFS The NFS server requires the following management commands: o MAP o SET CONFIGURATION MAP o SHOW MAP o SHOW CONFIGURATION MAP o UNMAP o SET CONFIGURATION NOMAP o SET NFS_SERVER o SHOW NFS_SERVER o CREATE EXPORT o ADD EXPORT o REMOVE EXPORT o SET EXPORT o SHOW EXPORT o CREATE PROXY o CONVERT/VMS PROXY o ADD PROXY o REMOVE PROXY o SHOW PROXY 2 Using_NFS The TCP/IP Services software includes commands for using NFS. Use the following commands to view container file systems and to copy files to and from them: o CREATE DIRECTORY o DIRECTORY o REMOVE DIRECTORY o REMOVE FILE o CREATE CONTAINER o DELETE CONTAINER o EXPORT o IMPORT For using the NFS client (working with files that reside on remote hosts), TCP/IP Services software provides the following commands: o MOUNT o SHOW MOUNT o DISMOUNT 2 Displaying_Information The SHOW and LIST commands display configuration, status, and performance information.