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.
1 – 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.
3 – 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
4 – 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
5 – 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.
6 – 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
7 – 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
8 – 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
9 – 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
10 – Displaying Information
The SHOW and LIST commands display configuration, status, and
performance information.