HP TCP/IP Services for OpenVMS Management Command Reference Order Number: AA–PQQGJ–TE September 2003 This manual describes the commands used for configuring and managing the HP TCP/IP Services for OpenVMS product. Revision/Update Information: This manual supersedes the Compaq TCP/IP Services for OpenVMS Management Command Reference, Version 5.1. Software Version: HP TCP/IP Services for OpenVMS Version 5.4 Operating Systems: HP OpenVMS Alpha Versions 7.3-1 and 7.
© Copyright 2003 Hewlett-Packard Development Company, L.P. UNIX® is a registered trademark of The Open Group. 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.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii 1 Using TCP/IP Services Management Commands 1.1 1.1.1 1.1.2 1.1.3 1.1.4 1.1.5 1.1.6 1.1.7 1.1.8 1.1.9 1.2 1.2.1 1.2.2 Entering Commands . . . . . . . . . . . . . . . . . . . . Setting Configuration Parameters . . . . . . . Modifying the Configuration Database . . . . Creating and Deleting Files . . . . . . . . . . . . Adding and Deleting Records . . . . . . . . . .
CREATE ROUTE . . . . . . . . . . . . . . . . . . . . . . . DEFINE COMMUNICATION_CONTROLLER DELETE COMMUNICATION_CONTROLLER DELETE CONTAINER . . . . . . . . . . . . . . . . . . DIRECTORY . . . . . . . . . . . . . . . . . . . . . . . . . . DISABLE SERVICE . . . . . . . . . . . . . . . . . . . . . DISCONNECT DEVICE_SOCKET . . . . . . . . . DISMOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . ENABLE SERVICE . . . . . . . . . . . . . . . . . . . . . EXIT . . . . . . . . . . . . . . . . . . . . . . . .
SET SERVICE . . . . . . . . . . . . . . . . . . . . SHOW ARP . . . . . . . . . . . . . . . . . . . . . . SHOW BOOTP . . . . . . . . . . . . . . . . . . . . SHOW COMMUNICATION . . . . . . . . . . SHOW CONFIGURATION . . . . . . . . . . . SHOW CONFIGURATION PROTOCOL SHOW DEVICE_SOCKET . . . . . . . . . . . SHOW EXPORT . . . . . . . . . . . . . . . . . . SHOW HOST . . . . . . . . . . . . . . . . . . . . . SHOW INTERFACE . . . . . . . . . . . . . . . SHOW MAIL . . . . . . . . . . . . . . . . . . . . . SHOW MAP .
Preface The HP TCP/IP Services for OpenVMS product is the HP implementation of the TCP/IP networking protocol suite and internet services for HP OpenVMS Alpha 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 describes the TCP/IP Services management commands.
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.
Table 1 (Cont.) TCP/IP Services Documentation Manual Contents 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.
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. ... x 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.
1 Using TCP/IP Services Management Commands The TCP/IP Services product provides a management command interface you use to configure and manage the software. These commands let you perform the following tasks: • Configure and reconfigure components • Modify parameters of components • Configure customer-developed services • Enable and disable running components • Monitor the running software 1.1 Entering Commands To start the management control program, type TCPIP at the DCL prompt.
Using TCP/IP Services Management Commands 1.1 Entering Commands Table 1–1 Management Command Guidelines Element Guideline 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 following examples illustrate an IP address, an Ethernet address, and a hardware address, respectively. TCPIP> SET HOST CROW /ADDRESS=1.2.3.
Using TCP/IP Services Management Commands 1.1 Entering Commands Table 1–1 (Cont.) Management Command Guidelines Element Guideline 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.
Using TCP/IP Services Management Commands 1.1 Entering Commands Table 1–1 (Cont.) Management Command Guidelines Element Guideline Quotation marks In 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 containing a slash (/) • Uppercase options specified with UNIX commands Consider these examples: 1.
Using TCP/IP Services Management Commands 1.1 Entering Commands Table 1–1 (Cont.) Management Command Guidelines Element Guideline 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.
Using TCP/IP Services Management Commands 1.1 Entering Commands Table 1–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. 1.1.
Using TCP/IP Services Management Commands 1.1 Entering Commands CREATE NETWORK CREATE PROXY CREATE ROUTE • 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 1.1.4 Adding and Deleting Records To add and delete records from the TCP/IP Services databases, use the CONVERT, ADD, and REMOVE management commands.
Using TCP/IP Services Management Commands 1.1 Entering Commands 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.
Using TCP/IP Services Management Commands 1.1 Entering Commands • SHOW PROXY 1.1.8 Using NFS The TCP/IP Services software includes commands for using NFS.
Using TCP/IP Services Management Commands 1.2 UNIX Management Commands Table 1–3 (Cont.) UNIX Management Commands Command Description nfsstat Displays statistical information about the network file system (NFS) and remote procedure call (RPC) interfaces in the kernel. It can also be used to reinitialize this information. ripquery Requests all routes known by a RIP gateway by sending a RIP request or a POLL command. route Allows you to manipulate the routing table manually.
2 Command Descriptions This chapter describes the TCP/IP Services management commands in alphabetical order. For information about how to enter commands, see Chapter 1.
ADD EXPORT ADD EXPORT Adds an export entry, in the form of a UNIX path name, to the export database for a Network File System (NFS) file system.
ADD EXPORT /OPTIONS= { [NO]DATA_CONVERSION | [NO]NAME_CONVERSION | [NO]PURGE_VERSIONS | [NO]TYPELESS_DIRECTORIES } Optional. Note For clients operating in OpenVMS to OpenVMS mode, the server ignores the options in the export record and uses the settings required for OpenVMS to OpenVMS mode.
ADD EXPORT • TYPELESS_DIRECTORIES, NOTYPELESS_DIRECTORIES TYPELESS_DIRECTORIES Removes .dir.1 from the name of directories. A naming conflict could arise if, for example, two files exist in the parent directory: DOVE.;1 (regular file) DOVE.DIR;1 (directory file) The name is returned as dove., rather than dove, if a file and a conflicting directory exist. NOTYPELESS_DIRECTORIES (default) Returns names as file.ext and file.dir. Examples 1.
ADD PROXY ADD PROXY Adds entries to the proxy database that give remote users an OpenVMS identity (account name). Applies to the NFS server, NFS client, PC-NFS, RSH, LPR/LPD, and customer-developed services. The proxy database contains communication proxies and NFS proxies: • Communication proxy Provides an identity for users of RSH, RLOGIN, REXEC, RMT/RCD, LPR/LPD, and customer-written services, if these services are marked with SET SERVICE /FLAGS=APPLICATION_PROXY.
ADD PROXY For each entry, use uppercase and lowercase consistently. Parameters user Required. Local OpenVMS identity for the user of: NFS server, NFS client, PC-NFS, remote shell, or LPR/LPD. Qualifiers /GID=n Required for an NFS proxy. Group identifier (GID) for an NFS user. Wildcards not allowed. /HOST=host Required. Host name on which the NFS user is working. • The host must be seen on the SHOW HOST/LOCAL display.
ADD PROXY /UID=n Required for an NFS proxy. Specifies the user identifier (UID) for an NFS user. Wildcards are not allowed. Examples 1. TCPIP> ADD PROXY HAWAIIAN_GOOSE /NFS=(OUTGOING,INCOMING) _TCPIP> /GID=10 /UID=444 /HOST="nene" Creates a proxy called HAWAIIAN_GOOSE, authorizing use of both the NFS client and the NFS server to and from host nene. 2.
ANALYZE CONTAINER ANALYZE CONTAINER Verifies the integrity of a UNIX container file, including the following checks: • Superblock validation • Inode validation • Directory validation • Internal allocation validation • Directory hierarchy validation Reports, and optionally corrects, problems within the structure of the container directory. Applies to the NFS server. Related commands: DIRECTORY, MAP, UNMAP Format ANALYZE CONTAINER device:path.
ANALYZE CONTAINER %TCPIP-E-ANA_SUP_BADIICGSIZE, Problem: Bad initial inode cell group size:bad_value Solution: Will be replaced by default size: good_value CONFIRM [Y/N/G]: Respond to the CONFIRM: prompt by entering one of the following: • Y to repair the problem • N to ignore the problem • G to change to NO CONFIRMATION mode /REPAIR /NOREPAIR Optional. Default: /NOREPAIR. Any errors will be repaired. Examples 1.
ANALYZE MAIL ANALYZE MAIL Verifies the consistency of the SMTP queues with SMTP control files. Related commands: REMOVE MAIL, SHOW MAIL Format ANALYZE MAIL [ [ [ [ [ [ user ] /[NO]CONFIRM ] /DELETE[=options ] /HOLD=time ] /LOG=file ] /[NO]REPAIR ] Restrictions Requires SYSNAM, SYSPRV, or BYPASS privilege to access mail that is not yours. Parameters user Optional. Default: All users. User whose mail you want to analyze. Qualifiers /CONFIRM /NOCONFIRM Optional.
ANALYZE MAIL • =SINCE=time Deletes files created since the specified time. Default: Deletes all files. Use the /DELETE and /REPAIR qualifiers on the same command line only if their time frames do not conflict. The following command requeues lost mail created since yesterday and deletes all previous mail: TCPIP> ANALYZE MAIL /REPAIR /DELETE=BEFORE=YESTERDAY /HOLD=time Optional. Default: Immediate retransmission. Hold, until the specified time, lost control files that you requeued. /LOG[=file] Optional.
ANALYZE MAIL 2. TCPIP> ANALYZE MAIL /DELETE Creates the summary of SMTP queues, and deletes each valid control file that lacks a corresponding SMTP queue entry. 3. TCPIP> ANALYZE MAIL DRAKE /REPAIR /DELETE=BEFORE=24-APR-2003 This command does the following: • Creates a summary of SMTP entries and control files for user DRAKE. • Requeues control files that lack corresponding queue entries. • Deletes control files created before April 24, 2003.
ANALYZE SERVICE ANALYZE SERVICE Searches through the services database for corrupted definitions. Displays invalid records and, with the /REPAIR qualifier, deletes them. Related commands: SET SERVICE, SHOW SERVICE Format ANALYZE SERVICE [ /[NO]CONFIRM ] [ /[NO]REPAIR ] Restrictions Requires write access to the directory with the services database. Qualifiers /CONFIRM /NOCONFIRM Optional. Default: /NOCONFIRM. Use only with the /REPAIR qualifier.
ANALYZE SERVICE 2. TCPIP> ANALYZE SERVICE /REPAIR /CONFIRM Service Invalid IP option records Port Proto Process TOE Remove? [N]: YES 67 UDP Service Port Proto NESTING Remove? [N]: YES 69 UDP Address TOED 0.0.0.0 Process Address NEW_EGGS_TCPIP 0.0.0.0 Displays the total protocol option records and deletes, after confirmation, the invalid records.
CONVERT/CONFIGURATION_BIND CONVERT/CONFIGURATION_BIND Converts the UCX BIND Version 4.x name server configuration to the BIND Version 8.1 format. Applies to the BIND name server. Use this command if you have a BIND configuration from an earlier release (Version 4.2 or lower) of the TCP/IP Services software. This command extracts the BIND configuration information from the file UCX$CONFIGURATION.DAT and creates the ASCII file TCPIP$BIND.CONF.
CONVERT/UNIX BIND CONVERT/UNIX BIND Creates a BIND server database and populates it with records from the local host and MX databases. This command will create either a forward translation file or a reverse translation file. If you specify a domain.name that ends in IN-ADDR.arpa, a reverse translation file is created. Related commands: SET HOST, SET MX_RECORD Format CONVERT/UNIX BIND /DOMAIN=domain.name [ /[NO]LOG ] Qualifiers /DOMAIN=domain.name Required. Domain for which to extract data.
CONVERT/UNIX BIND Shows records as they are processed. Examples 1. TCPIP> CONVERT/UNIX BIND /DOMAIN=KESTREL.SMALL.FALCON On host KESTREL, creates a BIND server database with default file name SYS$SPECIFIC:[TCPIP$BIND]KESTREL_SMALL_FALCON.DB. BIND and MX records for the host’s domain, kestrel.small.falcon, are extracted, converted, and written to KESTREL_SMALL_FALCON.DB. 2. TCPIP> CONVERT/UNIX BIND /LOG /DOMAIN=ABC.COM Creates a BIND server database.
CONVERT/UNIX HOST CONVERT/UNIX HOST Reads the hosts database and converts the information to an ASCII file formatted for use as a hosts file on a UNIX system. The name and location of the hosts database is specified by the logical name TCPIP$HOST. If this name is not defined, the command looks for TCPIP$HOST.DAT in your current directory.
CONVERT/UNIX NETWORK CONVERT/UNIX NETWORK Converts the networks database to an ASCII file formatted for use on a UNIX system. The name and location of the networks database is specified by the logical name TCPIP$NETWORK. If this name is not defined, the command looks for TCPIP$NETWORK.DAT in your current directory.
CONVERT/VMS BOOTP CONVERT/VMS BOOTP Populates the existing BOOTP database with entries from a BIND-formatted UNIX /etc/bootptab file. If the logical name TCPIP$BOOTP is defined, it is used to specify the directory and file name for the database. If TCPIP$BOOTP is not defined, the database is created as [current_directory]TCPIP$BOOTP.DAT.
CONVERT/VMS HOST CONVERT/VMS HOST Populates the existing hosts database with entries from a UNIX /etc/hosts file. The name and location of the hosts database is specified by the logical name TCPIP$HOST. If this name is not defined, the command looks for TCPIP$HOST.DAT in your current directory. Related commands: CREATE HOST, SET HOST, SHOW HOST Format CONVERT/VMS HOST [ source_file ] [ /LOG ] [ /UPCASE ] Restrictions Requires: • Read and write access to the hosts database.
CONVERT/VMS NETWORK CONVERT/VMS NETWORK Populates the existing networks database with entries from a UNIX /etc/networks file. The name and location of the networks database is specified by the logical name TCPIP$NETWORK. If this name is not defined, the command looks for TCPIP$NETWORK.DAT in your current directory.
CONVERT/VMS PROXY CONVERT/VMS PROXY Populates the existing proxy database with entries from a UNIX /etc/passwd file. The name of the proxy database is specified by the logical name TCPIP$PROXY. If this name is not defined, the command looks for TCPIP$PROXY.DAT in your current directory. Related commands: ADD PROXY, CREATE PROXY Applies to: NFS server, NFS client, PC-NFS Format CONVERT/VMS PROXY [ source_file ] [ /LOG ] Restrictions Requires: • Read and write access to the proxy database.
CREATE BOOTP CREATE BOOTP Creates the BOOTP database file, using the file name and location specified by the logical name TCPIP$BOOTP. If the logical name is not defined, creates the database file in your current directory as TCPIP$BOOTP.DAT. Related commands: CONVERT/VMS BOOTP, SET BOOTP Format CREATE BOOTP Restrictions Requires write access to the directory with the BOOTP configuration database. Caution Do not execute this command unless you intend to reconfigure your entire cluster. Examples 1.
CREATE CONFIGURATION CREATE CONFIGURATION Creates the configuration database file, using the file name and location specified by the logical name TCPIP$CONFIGURATION. If the logical name is not defined, creates the database file in your current directory as TCPIP$CONFIGURATION.DAT. Format CREATE CONFIGURATION Restrictions Requires write access to the directory with the configuration database. Caution Do not execute this command unless you intend to reconfigure your entire cluster. Examples 1.
CREATE CONTAINER CREATE CONTAINER Creates a UNIX file system with: • An empty OpenVMS style root directory • An empty local directory that corresponds to the UNIX root directory • A container file in the OpenVMS style root directory Applies to: NFS server Format CREATE CONTAINER device:directory [ /HOST=host ] [ /[NO]LOG ] [ /OWNER=[uic] ] [ /ROOT_MODE=n ] [ /SIZE=option=value ] [ /UID=n ] [ /USER_NAME=vms_user_name ] Restrictions Requires: • Read and write access to the specified device and direc
CREATE CONTAINER (The other files in this directory are owned by the OpenVMS users whose proxy database entries correspond to the UNIX owner UIDs of the individual files.) /ROOT_MODE=n Optional. Default: 755 (provides the following protection for owner, group, and world rwx-rx-rx). UNIX protection of the default container files: root directory, bit map, and superblock. Specify octal values in the following order: for user, for group, for others.
CREATE CONTAINER Specifies the owner of the UNIX container root directory. /USER_NAME=vms_user_name Required. Specifies the user name of the owner of the container file system. The user name must be in the proxy database. The specified user becomes the owner of the internal root directory of the container. Examples 1. TCPIP> CREATE CONTAINER DUCK$4:[DUCKLING] /HOST=MALLARD _TCPIP> /OWNER=[300,12] /ROOT_MODE=755 /UID=7015 _TCPIP> /USER_NAME=G_JONES Creates container directory DUCK$4:[DUCKLING].
CREATE DIRECTORY CREATE DIRECTORY Creates a directory within an existing UNIX container. Applies to: NFS server Related commands: DIRECTORY, REMOVE DIRECTORY Format CREATE DIRECTORY "/path/name" [ /HOST=host ] [ /[NO]LOG ] [ /MODE=n ] [ /UID=n ] [ /USER_NAME=vms_user_name ] Restrictions Requires: • Read and write access to the parent directory. • SYSPRV or BYPASS privilege if you specify /USER_NAME with a name other than your own. The container file system must be mapped with the MAP command.
CREATE DIRECTORY • 1 — Execute access • 2 — Write access • 3 — Write and execute access • 4 — Read access • 5 — Read and execute access • 6 — Read and write access • 7 — Read, write, and execute access For example, /MODE=751 provides: User Group Other Read, write, and execute access Read and execute access Execute access 7 5 1 rwx rx x /UID=n Optional. Default: None. Entry in the proxy database that determines, if necessary, the ownership of the container root directory.
CREATE DIRECTORY User UID GID Host UMBRELLA SYSTEM 300 0 12 1 * * If UMBRELLA does not have SYSPRV or BYPASS privilege, the directory is created as follows: UID = 300 GID = 12 UIC = [340,6] If UMBRELLA has SYSPRV or BYPASS privilege, the directory is created as follows: UID = 0 GID = 1 UIC = [SYSTEM] Command Descriptions 2–31
CREATE EXPORT CREATE EXPORT Creates the export database file, using the file name and location specified by the logical name TCPIP$EXPORT. If the logical name is not defined, creates the database file in your current directory as TCPIP$EXPORT.DAT. Related commands: ADD EXPORT, SHOW EXPORT Applies to: NFS server Format CREATE EXPORT Restrictions Requires write access to the directory with the export database. Caution Do not execute this command unless you intend to reconfigure your entire cluster.
CREATE HOST CREATE HOST Creates a hosts database file with: • One entry for LOCALHOST • LOCALHOST’s alias, localhost • LOCALHOST’s address, 127.0.0.1 The hosts database file name and location are specified by the logical name TCPIP$HOST. If the logical name is not defined, the database file name will be TCPIP$HOST.DAT in your current directory. Related commands: SET HOST, SHOW HOST, CONVERT/VMS HOST Format CREATE HOST Restrictions Requires: • Write access to the directory with the hosts database.
CREATE NETWORK CREATE NETWORK Creates the networks database file, using the file name and location specified by the logical name TCPIP$NETWORK. If the logical name is not defined, creates the database file in your current directory as TCPIP$NETWORK.DAT. Related commands: SET NETWORK, SHOW NETWORK, CONVERT/VMS NETWORK Format CREATE NETWORK Restrictions Requires write access to the directory with the networks database.
CREATE PROXY CREATE PROXY Creates the proxy database file, using the file name and location specified by the logical name TCPIP$PROXY. If the logical name is not defined, creates the database file in your current directory as TCPIP$PROXY.DAT. Related commands: ADD PROXY, SHOW PROXY, CONVERT/VMS PROXY Format CREATE PROXY Restrictions Requires write access to the directory with the proxy database. Caution Do not execute this command unless you intend to reconfigure your entire cluster. Examples 1.
CREATE ROUTE CREATE ROUTE Creates the routes database file, using the file name and location specified by the logical name TCPIP$ROUTE. If the logical is not defined, creates the database file named TCPIP$ROUTE.DAT in your current directory. Related commands: SET ROUTE, SHOW ROUTE Format CREATE ROUTE Restrictions Requires write access to the directory with the routes database. Caution Do not execute this command unless you intend to reconfigure your entire cluster. Examples 1.
DEFINE COMMUNICATION_CONTROLLER DEFINE COMMUNICATION_CONTROLLER Defines the mapping between a communication controller device and its corresponding Internet interface. Each mapping or controller definition is stored as a record in the configuration database.
DEFINE COMMUNICATION_CONTROLLER Qualifiers /DESCRIPTION=text Optional. Default: None. Optional text describing the communication controller. /INTERNET_INTERFACE=character Required. Specifies the first character of the Internet interface name. If you prefer using a standard name, call your HP support representative. /TYPE=(option[,...]) Required. Specifies the communication controller type and cluster attribute.
DELETE COMMUNICATION_CONTROLLER DELETE COMMUNICATION_CONTROLLER Deletes communication controller definitions from the configuration database. Related commands: DEFINE COMMUNICATION_CONTROLLER, LIST COMMUNICATION_CONTROLLER Format DELETE COMMUNICATION_CONTROLLER [ controller ] [ /[NO]CONFIRM ] [ /INTERNET_INTERFACE=character ] Restrictions Requires OPER privilege. Parameters controller Required. Specifies the OpenVMS device name of the communication controller. Qualifiers /CONFIRM /NOCONFIRM Optional.
DELETE CONTAINER DELETE CONTAINER Deletes a container file system and all its contents. Applies to: NFS server Related commands: CREATE CONTAINER Format DELETE CONTAINER container_file_system Restrictions Wildcards are not allowed. Requires both read and delete access to the directory. Requires BYPASS privilege. Parameters container_file_system Required. Device and directory name of the container file (no wildcards). The container file has file type .CONTAINER. Examples 1.
DIRECTORY DIRECTORY Displays a list of files, along with typical directory information, in a UNIX container directory. Applies to: NFS server Format DIRECTORY "/path/name" [ /FULL ] [ /VMS ] Restrictions Requires: • Read access to the specified container directory. • BYPASS privilege. Parameters "/path/name" Required. Name of the UNIX container directory for which you want a directory listing and, optionally, directory names. Qualifiers /FULL Optional. Default: Brief display.
DIRECTORY .. OpenVMS file: _$1$DISK:[SYSTEM.NEST.HATCHLING]00012301$BFS.DIR;1 Size File ID: 74497 Blocks: 4 Owner Bytes: 1915 UID: 0 Created: 1-NOV-2002 13:17:18.91 GID: 1 Revised: 1-NOV-2002 13:17:19.24 Mode: 755 Type: Directory Accessed: 1-NOV-2002 13:16:20.52 Links: 2 .SUPER.SYS OpenVMS file: no corresponding file Size Blocks: 1 Bytes: 54 Created: 1-NOV-2002 13:17:18.91 Revised: 1-NOV-2002 13:17:17.24 Accessed: 1-NOV-2002 13:16:18.52 File ID: Owner UID: GID: Mode: Links: 6145 .BITMAP.
DISABLE SERVICE DISABLE SERVICE For most services, this command disables the specified service but does not stop the current process. This allows you to perform an orderly shutdown of the service, which prevents new connections while allowing current connections to continue. To stop and restart the current process: 1. Wait until the process exits, or stop it using the service-specific shutdown command procedure (TCPIP$service_SHUTDOWN.COM). 2.
DISABLE SERVICE Examples 1. TCPIP> DISABLE SERVICE TELNET Disables TELNET. 2. TCPIP> DISABLE SERVICE RLOGIN /ADDRESS=130.180.4.7 Disables the remote login process that is bound to address 130.180.4.7.
DISCONNECT DEVICE_SOCKET DISCONNECT DEVICE_SOCKET Interactively terminates a TCP/IP connection. Format DISCONNECT DEVICE_SOCKET dev_sock_number Parameters dev_sock_number Required. Number of the device socket associated with the connection you want to terminate. Examples 1. TCPIP> DISCONNECT DEVICE_SOCKET BG123 Interactively terminates the connection at DEVICE_SOCKET BG123.
DISMOUNT DISMOUNT Makes a physically remote file system that is currently accessible to local users inaccessible. Dismounts a remote file system or directory from local device DNFSn: (the mount point). Related commands: MOUNT, SHOW MOUNT Applies to: NFS client Format DISMOUNT { mount_point | logical_name } [ /ALL ] [ /HOST=host ] [ /[NO]WAIT ] Restrictions Dismounting a /SYSTEM mount requires SYSNAM privilege. Dismounting a /GROUP mount requires GRPNAM privilege.
DISMOUNT Qualifiers /ALL Optional. Dismounts one of the following: • All file systems from all servers: DISMOUNT /ALL • All file systems on the specified server: DISMOUNT /ALL /HOST=host • All file systems on the specified device: DISMOUNT DNFSn: /ALL If you dismount using the /ALL qualifier, the dismount operation completes even if the server is not currently reachable. /HOST=host Optional. Default: None. Dismounts all file systems from the specified NFS server. Valid only with the /ALL qualifier.
DISMOUNT 5. TCPIP> DISMOUNT /ALL /HOST="robin" Dismounts all mount points served by host robin.
ENABLE SERVICE ENABLE SERVICE Enables a service on the running TCP/IP Services software. Related commands: DISABLE SERVICE, SHOW SERVICE Format ENABLE SERVICE [ [ [ [ [ service ] /ADDRESS=IP_address ] /PORT=n ] /PROCESS=process ] /PROTOCOL=protocol ] Parameters service Optional. Default: All services. Specifies the service to enable. The service must be defined in the services database. Qualifiers /ADDRESS=IP_address Optional. Default: 0.0.0.0. Binds the service only to the specified address.
ENABLE SERVICE 3. TCPIP> ENABLE SERVICE SMTP Starts the SMTP receiver. To start the SMTP sender, see the START MAIL command. For instructions on how to start the SMTP sender when TCP/IP Services starts up, see the SET CONFIGURATION ENABLE SERVICE command.
EXIT EXIT Exits from the management program.
EXPORT EXPORT Copies a file from within a container directory to an OpenVMS file. Related commands: IMPORT, DIRECTORY Format EXPORT "/path/name" vms_file_name Restrictions No wildcards. Parameters "/path/name" Required. Specifies the container directory and name of the file you want to copy. vms_file_name Required. Specifies the target OpenVMS file name for the copied file. Examples 1. TCPIP> EXPORT "/upland/sand/piper" USER1$:[BIRDY]JOBS.
HELP HELP Displays online help for using management commands. Format HELP [ topic ] Parameters topic Optional. Specifies a specific topic for which to display help. When you enter the HELP command without specifying topic, a list of topics is displayed.
IMPORT IMPORT Copies an OpenVMS file to a UNIX file located in a container directory. Related commands: EXPORT, DIRECTORY Applies to: NFS server Format IMPORT vms_file_name "/path/name" [ /[NO]CONVERT ] [ /HOST=host ] [ /[NO]LOG ] [ /MODE=n ] [ /UID=n ] [ /USER_NAME=vms_user_name ] Restrictions No wildcards. Parameters vms_file_name Required. Name of the file to copy. "/path/name" Required. Specifies the name of the UNIX container directory into which you want to copy the file and a file name.
IMPORT /MODE=n Optional. Default: 755 (provides the following protection for owner, group, and world: rwx-rx-rx). Specifies a UNIX protection mask for a new directory. Specify octal values in the following order: user, group, others.
IMPORT If you have SYSPRV or BYPASS privilege and do not specify the /USER_NAME qualifier, the proxy record with a UID of 0 and a GID of 1 is selected. SYSPRV or BYPASS privilege is required to select a user name that has a UIC different from the UIC of the process running the management program. You can use the /USER_NAME qualifier in any combination with the /HOST and /UID qualifiers.
LIST COMMUNICATION_CONTROLLER LIST COMMUNICATION_CONTROLLER Displays the communication controller definitions defined in the configuration database. Related commands: DEFINE COMMUNICATION_CONTROLLER, DELETE COMMUNICATION_CONTROLLER Format LIST COMMUNICATION_CONTROLLER [ controller ] [ /INTERNET_INTERFACE=character ] Parameters controller Optional. Default: All devices. Specifies the OpenVMS device name of communication controller definitions to be displayed.
LIST COMMUNICATION_CONTROLLER Controller: PP Internet Interface: P Description: Point to Point Protocol Type: PPP Controller: EB Internet Interface: B Description: Shared Memory LAN Type: CLUSTER ETHERNET Controller: EI Internet Interface: I Description: Fast Ethernet - I82558 Type: CLUSTER ETHERNET Controller: FA Internet Interface: A Description: Type: CLUSTER FDDI Controller: FC Internet Interface: C Description: Type: CLUSTER FDDI Controller: IC Internet Interface: C Description: Type: CLUST
LOOP LOOP Sends ICMP ECHO packets to hosts to determine whether they are active. Same as the PING command. Format LOOP [ [ [ [ [ [ [ [ [ host ] /ADDRESS=xx.xx.xx.xx ] /ALL ] /FULL ] /NUMBER_PACKETS=n ] /PACKET_SIZE=n ] /PATTERN="hexadecimal-string" ] /[NO]ROUTE ] /WAIT=n ] Parameters host Optional. Default: None. Specifies the host to which the test packets are sent.
LOOP /PATTERN=hexadecimal-string Optional. Fills out the packet you send with up to 16 bytes, which is useful for diagnosing data-dependent problems. The hexadecimal-string is a string of hexadecimal digits of up to 32 characters (16 bytes). For example, /PATTERN="ff" causes the sent packet to be filled with ones (1). /ROUTE /NOROUTE Optional. Default: /ROUTE. /ROUTE Request is routed through the normal routing tables. /NOROUTE Normal routing tables are bypassed.
MAP MAP Maps (logically links) one of the following to the NFS server: • OpenVMS disk — Requires one execution of MAP to map the disk to a UNIX path name. • Container file system — Requires two executions of MAP. The first maps the disk, and the second maps the file system. Mapping creates a logical file system, also called an NFS file system. A logical file system (with an entry in the export database) is accessible to NFS client users for mounting.
MAP Examples 1. TCPIP> (TCPIP>)MAP "/usr" CANARY$DUA2: Maps local disk CANARY$DUA2: to /usr. This disk can be exported as /usr to users on remote NFS clients. 2. TCPIP> MAP "/remote" VERDIN$DUA3: TCPIP> MAP "/flyers" VERDIN$DUA3:[UNIX_BIRD_FILES] Maps [UNIX_BIRD_FILES], a container file system on disk VERDIN$DUA3:, to /flyers. This file system can be exported as /flyers to NFS server users. (The first MAP command maps the underlying OpenVMS file system.
MOUNT MOUNT Makes a physically remote file system accessible to local users. Applies to: NFS client Mounts a remote directory to local device DNFSn:. Similar in function to the UNIX /etc/mount command, MOUNT gives a file system a UNIX path name. (In format and style, MOUNT resembles the DCL command MOUNT.) You can mount either OpenVMS or UNIX file systems.
MOUNT /qualifier=(option_a:value1,option_b:value2,value3) Parameters mount_point Required. Local device (and optional directory tree) on which to mount the remote NFS file system. Specify this mount point as one of the following: DNFSn: DNFSn:[dir.subdir] DNFSn:[dir.subdir]file where: n Specifies the unit number. Specify a value from 0 to 9999. Specifying 0 causes the client to choose the next available unit number. (It does not mount a device named DNFS0:.) [dir] or [dir.
MOUNT The full default definition becomes: DNFSn:[dir.dir.subdir] The client places the logical name in the SYSTEM logical name table, unless you specify the /GROUP or /SHARE qualifier. The client deletes the logical name from the SYSTEM table when you dismount the volume. The process must have SYSNAM privilege to mount a system mount point. Without SYSNAM or GRPNAM privilege, the user must specify /SHARE for a JOB mount. (See the /SHARE qualifier for more information.
MOUNT /BACKGROUND [= {DELAY:OpenVMS_delta_time | RETRY:n}] Optional. Defaults: • If you omit this qualifier, background mode mounting is not attempted. • If you omit the DELAY keyword, background mode mounting is set up with /BACKGROUND=(DELAY:00:00:30,RETRY:10). This qualifier enables background mode for mounting the file system. The optional DELAY time specifies amount of time to wait if the mount attempt fails before trying again. Specify the time as hh:mm:ss.
MOUNT By reading the directory contents, the client can be aware of any changes to the number of files within the directory, even if the directory’s modify time was not updated. /CONVERT /NOCONVERT Optional. Default: /CONVERT. Converts files with the following attributes to STREAM_LF files: • Sequential • Variable length • Carriage return/carriage control (VAR-CR) The convert feature works with some utilities and DCL commands but not with others.
MOUNT With NONUNIQUE, the client uses the file handle instead of the file ID. This can refresh directory entries in the client’s cache more quickly. However, this can degrade performance because the client must issue additional RPC requests to get the file handle. /FORCE /NOFORCE Optional. Default: /NOFORCE. Performs an overmount or a mount that can cause file system occlusion.
MOUNT Associates an ancillary control process (ACP) to process the volume, overriding the default manner in which the client associates ACPs with NFS devices (starting a new ACP for each mount request). The options are: • UNIQUE Creates a new ACP for the new NFS device. Requires OPER privilege. • SAME:DNFSn: Uses the same ACP as the specified device. Requires OPER privilege. • FILE:file Creates a new ACP running the image specified by file. Do not use wildcards, host names, or directory names.
MOUNT Refer to the HP TCP/IP Services for OpenVMS Management manual for more information. /STRUCTURE Optional. Default: /STRUCTURE=2 Specifies whether the volume should be formatted in Files-11 On-Disk Structure Level 2 (ODS-2), which is the default, or Files-11 On-Disk Structure Level 5 (ODS-5). For more information about ODS-5 disks, refer to the HP OpenVMS System Manager’s Manual: Essentials. /SUPERUSER=uid /NOSUPERUSER Optional. Default: /NOSUPERUSER.
MOUNT Default UID if no UID mapping exists for file access. Restriction: Requires OPER privilege. Both the NFS server and NFS client use the proxy database for access control. HP strongly recommends that you provide a proxy with a unique UID for every NFS client user. If you need to provide universal access to world-readable files, you can use the default UID to avoid creating a proxy for every NFS client user.
MOUNT 5. TCPIP> MOUNT DNFS22:[USERS.SMITH.MNT] /HOST="sigma" /PATH="/usr" %DNFSMOUNT-S-MOUNTED, /usr mounted on _DNFS22:[USERS.SMITH.MNT] TCPIP> MOUNT DNFS22:[USERS.SMITH] /HOST="sigma" /PATH="/usr" /FORCE %DNFSMOUNT-S-MOUNTED, /usr mounted on _DFS22:[USERS.SMITH] %TCPIP-I-OCCLUDED, previous contents of _DNFS22:[USERS.SMITH] occluded The /FORCE qualifier performs an occluded mount.
PING PING Sends ICMP ECHO packets to hosts to determine whether they are active. Same as the LOOP command. Format PING [ [ [ [ [ [ [ [ [ host ] /ADDRESS=xx.xx.xx.xx ] /ALL ] /FULL ] /NUMBER_PACKETS=n ] /PACKET_SIZE=n ] /PATTERN="hexadecimal-string" ] /[NO]ROUTE ] /WAIT=n ] Parameters host Specifies the host to which the test packets are sent. Omitting host tests the TCP/IP Services software on the local node, as defined by the system logical TCPIP$INET_HOST. Qualifiers /ADDRESS=xx.xx.xx.xx Optional.
PING Fills out the packet you send with up to 16 bytes, which is useful for diagnosing data-dependent problems. The string is a hexadecimal string of up to 32 characters (16 bytes). For example, /PATTERN="ff" causes the sent packet to be filled with ones (1). /ROUTE /NOROUTE Optional. Default: /ROUTE. /ROUTE Request is routed through the normal routing tables. /NOROUTE Normal routing tables are bypassed. If the host is not on the LAN, you get an error. /WAIT=n Optional.
REMOVE DIRECTORY REMOVE DIRECTORY Removes a link to a directory within a UNIX container directory. If there are no other links to it, the directory is deleted. Related commands: CREATE DIRECTORY, DIRECTORY Applies to: NFS server Format REMOVE DIRECTORY "/path/name" Restrictions Requires: • Read and write access to the parent directory • BYPASS privilege Parameters "/path/name" Required. Directory with the link you want to remove. Examples 1.
REMOVE EXPORT REMOVE EXPORT Deletes directory names from the export database so that they are not available for mounting by an NFS client. Related commands: ADD EXPORT, SHOW EXPORT, MAP, SET CONFIGURATION MAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW CONFIGURATION MAP Applies to: NFS server Format REMOVE EXPORT "/path/name" [ /[NO]CONFIRM ] [ /HOST=host ] Restrictions Requires read and write access to the export database. Parameters "/path/name" Required.
REMOVE EXPORT Examples 1. TCPIP> REMOVE EXPORT "/house/finch" Removes the name of container directory /house/finch from the export database. This directory is now inaccessible to NFS client users. 2. TCPIP> REMOVE EXPORT "/oceans/swamps" /HOST=("tern","crane") Modifies the accessibility of local UNIX directory /oceans/swamps. This directory is now unavailable to users working on hosts tern and crane, which run NFS client software.
REMOVE FILE REMOVE FILE Removes a link to a file within a container directory. If there are no other links to it, the file is deleted. Related commands: DIRECTORY, REMOVE DIRECTORY Applies to: NFS server Format REMOVE FILE "/path/name" Restrictions Requires: • Read and write access to the parent directory • BYPASS privilege Parameters "/path/name" Required. File with the link you want to remove. Examples 1. TCPIP> REMOVE FILE "/peacock/feather.
REMOVE MAIL REMOVE MAIL Deletes mail messages from SMTP queues. Without the user parameter, all messages from the user name that correspond to your process’s user name are deleted. Related commands: SEND MAIL, SHOW MAIL Applies to: SMTP Format REMOVE MAIL [ [ [ [ user ] /[NO]COPY=[directory] ] /[NO]CONFIRM ] /ENTRY=n ] Restrictions Requires SYSPRV or BYPASS privilege for mail messages that are not yours. Parameters user Optional. Default: All mail messages with your process’s user name.
REMOVE MAIL /ENTRY=n Optional. Default: All. Queue entry numbers to remove from the SMTP queue. Examples 1. TCPIP> REMOVE MAIL Removes all messages for your process’s user name, or deletes everything in the SMTP queue if you have either SYSPRV or BYPASS privilege. 2. TCPIP> REMOVE MAIL /ENTRY=781 Removes message 781, if it corresponds to your process’s user name, or if you have either SYSPRV or BYPASS privilege. 3.
REMOVE PROXY REMOVE PROXY Deletes entries from the volatile and permanent proxy database.
REMOVE PROXY If you specify the /NOCONFIRM qualifier, the operation is performed without asking you to confirm the request. /GID=n Optional. Default: All GIDs. Deletes only proxies for the specified group identifier (GID). /HOST=host Optional. Default: All hosts. Deletes only proxies for the specified host. /NFS=INCOMING /NFS=OUTGOING Optional. Default: /NFS=(INCOMING,OUTGOING). Deletes an NFS proxy.
SEND MAIL SEND MAIL Requeues a mail message for delivery. Releases jobs that are in a hold state. Related commands: REMOVE MAIL, SHOW MAIL Applies to: SMTP Format SEND MAIL [ [ [ [ user ] /AFTER=time ] /[NO]CONFIRM ] /ENTRY=n ] Restrictions SYSPRV or BYPASS privilege required to requeue mail messages that do not correspond to your process’s user name. Parameters user Optional. Default: All. Requeues messages sent from the specified user name. Qualifiers /AFTER=time Optional.
SET ARP SET ARP Provides the dynamic mapping from an IP address to the corresponding physical network address (hardware address) on an FDDI, Ethernet, or Token Ring LAN segment. SET NOARP removes an address-mapping pair (IP address to physical network address). Related command: SHOW ARP Formats SET ARP mac_address host [ /[NO]PERMANENT ] [ /[NO]PUBLIC ] SET NOARP [host] Restrictions Requires OPER privilege. Parameters mac_address Required.
SET ARP Not valid with SET NOARP. Examples 1. TCPIP> SET ARP AA-BB-04-05-06-07 CONDOR Permanently maps CONDOR’s host name to FDDI address AA-BB-04-05-06-07.
SET BOOTP SET BOOTP Creates client entries in the BOOTP database. SET NOBOOTP does not require any qualifiers. Related commands: CONVERT/VMS BOOTP, SHOW BOOTP Format SET [NO]BOOTP host [ /FILE=file] /HARDWARE=ADDRESS=hex_address [ /GATEWAYS=hosts ] [ /NETWORK_MASK=IP_address ] [ /SERVERS=type=host ] [ /TIME_OFFSET=seconds ] Restrictions Requires read, write, and delete access to the BOOTP database. Parameters host Required. Specifies the client to which your system will download files upon request.
SET BOOTP /NETWORK_MASK=IP_address Required if you use subnets; otherwise optional. Specifies the part of the host field of an IP address identified as the subnet. The software calculates the default by setting the following: • The bits representing the network field to 1 • The bits representing the host field to 0 You can divide the host field into a site-specific subnetwork and a host field. If you use subnets, you must specify a subnet field. /SERVERS=type=host Optional.
SET COMMUNICATION SET COMMUNICATION Modifies the IP, TCP, UDP, and INET_ACP software on the running system. Related commands: SET CONFIGURATION COMMUNICATION, SHOW COMMUNICATION Format SET COMMUNICATION [ [ [ [ [ /ACCEPT=options ] /DOMAIN=domain ] /LOCAL_HOST=host ] /PROXIES=n ] /REJECT=options ] Restrictions Requires OPER privilege. Qualifiers /ACCEPT { =[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks) } Optional. Default: All hosts and all networks.
SET COMMUNICATION Defines the following logical names for the local host: • TCPIP$INET_HOST=host-name This logical is always set with the primary host name even if the alias name was specified as host. • TCPIP$INET_HOSTADDR=host-IP-address If the local host has multiple IP addresses, this logical name is set with a name for each address, called TCPIP$INET_HOSTADDRn, where n is a number starting at 2. This qualifier requires either SYSPRV or BYPASS privilege. /PROXIES=n Optional.
SET CONFIGURATION BIND SET CONFIGURATION BIND Configures the BIND name server.
SET CONFIGURATION BIND NODOMAIN deletes the entry. • FILE specifies the name of the hints file. If you use /CACHE with no options: • DOMAIN defaults to "." ("root"). • FILE defaults to NAMED.CA. /CLUSTER=name /NOCLUSTER=name Required to configure cluster load balancing. Identifies the name of a TCP/IP cluster as the first step to setting up cluster load balancing. For information about the remaining procedure, refer to the HP TCP/IP Services for OpenVMS Management manual.
SET CONFIGURATION BIND Examples 1. TCPIP> SET CONFIGURATION BIND _TCPIP> /PRIMARY=(DOMAIN:RHEA.LAB.UBIRD.EDU) Configures the host as the primary server for domain RHEA.LAB.UBIRD.EDU. 2. TCPIP> SET CONFIGURATION BIND _TCPIP> /SECONDARY=(DOMAIN:JACANA.LAB.UBIRD.EDU) _TCPIP> /SECONDARY=(FILE:JACANA.DB,HOST=MARSHY) Configures the host as a secondary server for domain JACANA.LAB.UBIRD.EDU and names the boot file JACANA.DB. Omitting the file name would default to file JACANA_LAB_UBIRD_EDU.DB. 3.
SET CONFIGURATION COMMUNICATION SET CONFIGURATION COMMUNICATION Enters information into the configuration database to start the IP, TCP, UDP, and INET_ACP software when the system starts up. When TCP/IP Services starts up, this configuration overrides the default settings.
SET CONFIGURATION COMMUNICATION Defines the following logical names for the local host: • TCPIP$INET_HOST=host-name This logical is always set with the primary host name, even if the alias name was specified as host. • TCPIP$INET_HOSTADDR=host-IP-address If the local host has multiple IP addresses, this logical name is set with a name for each address, called TCPIP$INET_HOSTADDRn, where n is a number starting at 2. This qualifier requires either SYSPRV or BYPASS privilege. /PROXIES=n Optional.
SET CONFIGURATION ENABLE SERVICE SET CONFIGURATION ENABLE SERVICE Modifies service-related information in the permanent configuration database that enables (or disables) services for startup. Allows you to specify that the service be enabled or disabled for startup on the current node only or on all nodes in the cluster. To specify clusterwide enabling or disabling of services, use the /COMMON qualifier.
SET CONFIGURATION ENABLE SERVICE Examples 1. TCPIP> SET CONFIGURATION ENABLE SERVICE TELNET In the configuration database, enables the TELNET service for startup on this node. 2. TCPIP> SET CONFIGURATION ENABLE SERVICE FTP /COMMON In the configuration database, enables the FTP service for startup on every node in the cluster. 3.
SET CONFIGURATION INTERFACE SET CONFIGURATION INTERFACE Enters information into the configuration database, which defines one of the following when TCP/IP Services starts up: • An Internet interface (hardware connection to the network) • A serial line Internet interface (a form of hardware connection to the network) • A pseudointerface (a data structure that extends subnet routing so that, on the same physical network, an interface acts as a gateway between multiple subnets) Related commands: SHOW IN
SET CONFIGURATION INTERFACE Qualifiers /ARP /NOARP Optional. Default: /ARP. Enables IP address-to-hardware address (Ethernet or FDDI) mapping. /ARP is valid when you create an interface but not when you modify an existing interface. /AUTO_START /NOAUTO_START Optional. Default: /AUTO_START. Valid for a SLIP or PPP interface. Automatically creates the interface when TCP/IP Services starts. /BROADCAST_MASK=IP_address Optional. Sets the Internet interface to receive all broadcast messages.
SET CONFIGURATION INTERFACE /NOCLUSTER disables Internet cluster processing on the specified interface. Caution When you specify /NOCLUSTER, active communication is aborted for applications bound to the cluster alias name. /COMPRESS= {ON | OFF | AUTOMATIC} Optional. Defaults: For PPP interface, /COMPRESS=ON; for SLIP interface, /COMPRESS=OFF. Valid for SLIP and PPP interfaces. Enables or disables TCP header compression. /COMPRESS=AUTOMATIC turns off compression unless the remote end begins to use it.
SET CONFIGURATION INTERFACE /LOOPBACK /NOLOOPBACK Optional. Default: /NOLOOPBACK. Sets loopback mode. /NETWORK_MASK=IP_address Required if you use subnets. The part of the host field of the IP address identified as the subnet. The software calculates the default by the following methods: • Setting the bits representing the network fields to 1 • Setting the bits representing the host field to 0 An IP address consists of a network number and a host number.
SET CONFIGURATION INTERFACE 3. TCPIP> SET CONFIGURATION INTERFACE PP0 /SERIAL_DEVICE=TTA0: _TCPIP> /HOST=10.10.1.2 /DESTINATION=10.10.1.3 Configures the interface as a PPP serial device. This command specifies that the local host is a dialup provider. The address specified with the /DESTINATION qualifier (10.10.1.3) is the address assigned to the client system requesting an address.
SET CONFIGURATION MAP SET CONFIGURATION MAP Adds information to the configuration database that maps (logically links) one of the following to the NFS server: • OpenVMS disk — Requires one execution of SET CONFIGURATION MAP to map the disk to a UNIX path name (logical file system). • Container file system — Requires two executions of SET CONFIGURATION MAP. The first maps the disk, and the second maps the file system. Mapping creates a logical file system, also called an NFS file system.
SET CONFIGURATION MAP 2. TCPIP> SET CONFIGURATION MAP "/remote" VERDIN$DUA3: _TCPIP> SET CONFIGURATION MAP "/flyers" VERDIN$DUA3:[UNIX_BIRD_FILES] Maps [UNIX_BIRD_FILES], a container file system on disk VERDIN$DUA3:, to /flyers. This file system can be exported to NFS server users as /flyers. (The first MAP command maps the underlying OpenVMS file system.
SET CONFIGURATION NAME_SERVICE SET CONFIGURATION NAME_SERVICE When TCP/IP Services starts up, configures the BIND resolver and designates a BIND server. All settings are systemwide. Related commands: SET NAME_SERVICE, SHOW CONFIGURATION NAME_SERVICE Format SET CONFIG [NO]NAME_SERVICE [ /[NO]SERVER=host] [ /[NO]DOMAIN=domain ] [ /[NO]PATH=domain ] [ /RETRY=number of retries ] [ /TIMEOUT=seconds ] [ /TRANSPORT=protocol ] Qualifiers /CLUSTER=dev:[directory] Optional. Specifies the common BIND directory.
SET CONFIGURATION NAME_SERVICE /SERVER=host /NOSERVER=host Optional. Host name or address of the BIND server or servers that the BIND resolver will query. To specify multiple hosts, list them by request preference. The resolver sends the first lookup request to the first host on the list. /NOSERVER removes hosts from the list. If you define a server list and then issue another SET CONFIGURATION NAME_SERVICE /SERVER command, TCP/IP Services appends the new servers to the end of the list.
SET CONFIGURATION NOMAP SET CONFIGURATION NOMAP Removes map records from the configuration database that were previously added with SET CONFIGURATION MAP. When the NFS server starts up, it issues a GENERATE MAP command that creates the mappings for disks and container file systems.
SET CONFIGURATION PROTOCOL SET CONFIGURATION PROTOCOL Enters information into the configuration database that sets the parameters for ICMP, IP, TCP, and UDP when TCP/IP Services starts up.
SET CONFIGURATION PROTOCOL TCP Qualifiers /MTU_SEGMENT_SIZE /NOMTU_SEGMENT_SIZE Optional. Default: /NOMTU_SEGMENT_SIZE. If a connection is more than one hop away, sets the segment size. Specify one of the following: /MTU_SEGMENT_SIZE /NOMTU_SEGMENT_SIZE Sets the segment size as close as possible to the maximum transfer unit (MTU) size. Sets the segment size as close as possible to the standard 512 bytes. /DELAY_ACK /NODELAY_ACK Optional. Default: /DELAY_ACK.
SET CONFIGURATION PROTOCOL UDP Qualifiers /BROADCAST /NOBROADCAST Optional. Default: /NOBROADCAST. Enables privilege checking for broadcast messages. • /BROADCAST — Nonprivileged users can send broadcast messages. • /NOBROADCAST — To send broadcast messages, users need a privileged UIC or SYSPRV, BYPASS, or OPER privilege. Sun RPC applications use broadcast messages and need privilege checking disabled. /FORWARD /NOFORWARD Optional. Default: /NOFORWARD. Forwards IP messages. /QUOTA=options Optional.
SET CONFIGURATION SMTP SET CONFIGURATION SMTP Modifies the SMTP configuration in the configuration database. SET CONFIGURATION NOSMTP with no qualifiers deletes all SMTP records.
SET CONFIGURATION SMTP NOGENERAL_PURPOSE deletes the specified destination for protocols other than SMTP. /HOP_COUNT_MAXIMUM=n Optional. Default: 16. Maximum number of relays (hops) between routers until SMTP considers the mail undeliverable. /INTERVAL={ INITIAL="OpenVMS_delta_time" | RETRY="OpenVMS_delta_time" | MAXIMUM="OpenVMS_delta_time" } Optional. Defaults: INITIAL=30 minutes, RETRY=60 minutes, MAXIMUM=3 days. Time intervals related to repeated attempts before delivery fails.
SET CONFIGURATION SMTP • [NO]RELAY Relays mail to other hosts by functioning as an end node. /QUEUES=n Optional. Default: 1. Number of execution queues for the specified nodes. Use this qualifier only on nodes that own the SMTP queues — that is, nodes not using clusterwide SMTP queues or managing SMTP clusterwide queues for other nodes. /RECEIVE_TIMEOUT=minutes Optional. Default: 5 minutes. Maximum time between socket receipts of a message for a particular dialog.
SET CONFIGURATION SMTP Note For changes made with the /SUBSTITUTE_DOMAIN qualifier to take effect, you must stop and restart SMTP. For more information about stopping and starting SMTP, refer to the HP TCP/IP Services for OpenVMS Management manual. /ZONE[=domain] /NOZONE[=domain] Optional. Default: /NOZONE (no gateway searching). Domain for your environment (probably a superset of your local domain). Mail sent to another network must be sent to this gateway.
SET CONFIGURATION SNMP SET CONFIGURATION SNMP Configures SNMP on an individual host. SET CONFIGURATION NOSNMP does not require any qualifiers. After making changes to the SNMP configuration, shut down and restart the master agent and any subagents.
SET CONFIGURATION SNMP /COMMUNITY="name" /NOCOMMUNITY="name" Optional. Default: To enable the standard "public" community, you can run the TCPIP$CONFIG procedure. Used with the /ADDRESS qualifier. Name of the community that the SNMP agent recognizes. Optionally, specify a type of access and a list of host addresses. Enclose the name in quotation marks to preserve lowercase characters. See the /TYPE and /ADDRESS qualifiers for more information. [NO]COMMUNITY="name" removes a community name.
SET CONFIGURATION SNMP If you specify two options, they are appended when sent to a client in response to an SNMP request for syslocation. For example, if FIRST is abc and SECOND is def, the value of the location is abcdef with no spaces. The total number of characters must not exceed 215. /TYPE= {[NO]READ | [NO]TRAP | [NO]WRITE} Optional. Default: READ. Sets the type of access (to your local MIB data) to allow for a specified community.
SET CONFIGURATION SNMP 2. TCPIP> SET CONFIGURATION SNMP /COMMUNITY="rw" /TYPE=WRITE _TCPIP> /ADDRESS=136.20.100.10 /FLAGS=SETS Configures a community with only read/write access to the host with the address specified. Other hosts still have read access through the public community. Also sets the SETS flag to enable the SNMP agents to process write requests from SNMP clients on host 136.20.100.10.
SET CONFIGURATION SNMP 3. TCPIP> SET CONFIGURATION SNMP /NOCOMMUNITY="rw" Removes the rw (read/write) community (set in example 2.) 4. TCPIP> SET CONFIGURATION SNMP /COMMUNITY="trapit" /TYPE=TRAP _TCPIP> /ADDRESS=136.20.0.10 Configures SNMP so that agents can send trap messages to the well-known UDP port 162 on the host identified with the address 136.20.0.10. 5. TCPIP> SET CONFIGURATION SNMP /FLAGS=AUTHEN_TRAPS _TCPIP> /COMMUNITY="trapit2" /TYPE=TRAP _TCPIP> /ADDRESS=(136.20.0.12,136.20.0.
SET CONFIGURATION START ROUTING SET CONFIGURATION START ROUTING Enters information into the configuration database to start dynamic routing when TCP/IP Services starts. Related commands: SHOW CONFIGURATION START ROUTING, START ROUTING Format SET CONFIGURATION START [NO]ROUTING [ /GATED ] [ /LOG ] [ /SUPPLY[=DEFAULT] ] Qualifiers /GATED Optional. Enables the gateway routing daemon (GATED).
SET GATED SET GATED Configures the Gateway Routing Daemon (GATED). GATED obtains information from several routing protocols and selects the best routes based on that information. These protocols are configured in the file TCPIP$GATED.CONF. Related commands: START ROUTING /GATED, STOP ROUTING /GATED Format SET GATED [ [ [ [ /CHECK_INTERFACES ] /FILE=file ] /SAVE_STATE ] /TOGGLE_TRACE ] Qualifiers /CHECK_INTERFACES Optional. Instructs GATED to scan the kernel interface list for changes.
SET HOST SET HOST Defines or deletes an entry in the hosts database. Equivalent to maintaining the /etc/hosts file on UNIX hosts. Related command: SHOW HOST, CONVERT/VMS HOST Format SET [NO]HOST host /ADDRESS=IP_address [ /[NO]ALIAS=alias ] [ /[NO]CONFIRM ] Restrictions Requires read, write, and delete access to the hosts database. Parameters host Required. Name of a host that is a source or destination of Internet communications.
SET HOST TCPIP> SET NOHOST MOA /ADDRESS=11.33.33.8 /CONFIRM LOCAL database Host address Host name 11.33.33.8 MOA Remove? [N]: If you specify the /NOCONFIRM qualifier, the operation is performed without asking you to confirm the request. Examples 1. TCPIP> SET HOST MOA /ADDRESS=11.33.33.8 _TCPIP> /ALIAS=("moa","bigbrd","nofly") Sets the IP address of host MOA to 11.33.33.8 and establishes moa, bigbrd, and nofly as aliases for host MOA. 2.
SET INTERFACE SET INTERFACE Defines one of the following: • An Internet interface • A serial line IP (SLIP) or point-to-point (PPP) connection • A pseudointerface (a data structure that extends subnet routing) Before you issue SET INTERFACE, do the following to identify the name of an interface: • Issue the LIST COMMUNICATION_CONTROLLER command to find your system’s controller. • Use the first character of the associated interface name.
SET INTERFACE Parameters interface Required. Specifies an interface name for the communication controller, such as RF1, RT1, ZE0, XE0, SL0, SL1, SL2, PP0, PP1, PP2. Qualifiers /ARP /NOARP Optional. Default: /ARP. Enables IP address-to-hardware address (Ethernet or FDDI) mapping. /ARP is valid when you create an interface but not when you modify an existing interface. /AUTO_START /NOAUTO_START Optional. Default: /AUTO_START. Valid for a SLIP or PPP interface.
SET INTERFACE Specifies the cluster host name (alias host identifier). Before using this qualifier, first define the same name in the hosts database. /CLUSTER=host associates the alias host identifier with each interface in a cluster. /NOCLUSTER disables Internet cluster processing on the specified interface. Caution When you specify /NOCLUSTER, active communication is aborted for applications bound to the cluster alias name. /COMPRESS= {ON | OFF | AUTOMATIC} Optional.
SET INTERFACE Local host name or IP address using the interface. If this information is not specified for a PPP interface, PPP obtains the correct address from the remote host. If your host is multihomed, specify an address. /LOOPBACK /NOLOOPBACK Optional. Default: /NOLOOPBACK. Sets loopback mode. /NETWORK_MASK=IP_address Required if you use subnets. The part of the host field of the IP address identified as the subnet.
SET INTERFACE 3. TCPIP> SET INTERFACE PP0 /SERIAL_DEVICE=TTA0: _TCPIP> /HOST=10.10.1.2 /DESTINATION=10.10.1.3 Configures the interface as a PPP serial device. This command specifies that the local host is a dialup provider. The address specified with the /DESTINATION qualifier (10.10.1.3) is the address assigned to the client system requesting an address. Refer to HP TCP/IP Services for OpenVMS Management manual for more information on setting up interfaces for SLIP and PPP communication. 4.
SET MX_RECORD SET MX_RECORD For routing mail, adds routing information to the local Mail Exchanger (MX) database. Each entry contains a list of hosts that can accept mail for the specified destination. The list is in order of routing preference. The local MX information is stored in the routes database. The MX entry is one of the record types in the BIND database. In addition, a BIND server might provide an MX record. SMTP is designed to determine where the sending system should try to relay mail.
SET MX_RECORD Arbitrary number for ranking multiple gateways for a destination. The smaller the number, the higher the preference in sending mail by way of that gateway. Do not use with SET NOMX_RECORD. Examples 1. TCPIP> SET MX_RECORD JUNO /GATEWAY=MARS /PREFERENCE=100 Assigns MARS as the gateway for host JUNO with a preference of 100. 2. TCPIP> SET MX_RECORD JUNO /GATEWAY=VENUS /PREFERENCE=200 Assigns VENUS as the gateway for host JUNO with a preference of 200.
SET NAME_SERVICE SET NAME_SERVICE Configures the BIND resolver and designates a BIND server. By default, all settings are process specific. • To make modifications that are systemwide, use the /SYSTEM qualifier. • The local host’s domain is used as the default domain unless you also specify /DOMAIN. • To reload the BIND server databases, use the /INITIALIZE qualifier. • /NOSERVER does not require any options.
SET NAME_SERVICE /NODOMAIN deletes the process-specific definition of the domain. Do not use with /SYSTEM. /ENABLE Optional. Default: Not enabled. Enables the BIND resolver. Must be used with /SYSTEM. /INITIALIZE Optional. Default: No reloading. Reloads all BIND server databases and the BIND configuration file. Either TCPIP$ETC:RNDC.CONF or TCPIP$ETC:RNDC.KEY must be set up to allow for secure communication between the user and the BIND server.
SET NAME_SERVICE Makes your settings systemwide. /TIMEOUT=seconds Optional. Default: 4 seconds. Specifies the timeout interval for the BIND resolver’s requests to a server. When the BIND resolver is used by the auxiliary server, the following conditions are true: • The number of retries is one. • The timeout interval is 1 second.
SET NETWORK SET NETWORK Defines or deletes an entry in the networks database. Equivalent to maintaining the /etc/networks file on UNIX hosts. Related commands: SHOW NETWORK, CONVERT/VMS NETWORK Format SET [NO]NETWORK network [ /ADDRESS=IP_address ] [ /[NO]ALIAS=alias ] [ /[NO]CONFIRM ] Restrictions Requires read, write, and delete access to the networks database. Parameters network Required. Name of the network. You cannot delete a network by specifying an alias name.
SET NETWORK Examples 1. TCPIP> SET NETWORK MYNA /ADDRESS=128.30.30.10 /ALIAS=MYNA_1 Creates an entry for network MYNA at IP address 128.30.30.10, and its alias MYNA_1, to the networks database. 2. TCPIP> SET NETWORK MYNA /ALIAS=MYNA_2 Adds a second alias for network MYNA. 3. TCPIP> SET NETWORK MYNA /NOALIAS=MYNA_2 Deletes the alias MYNA_2 from the network MYNA entry in the networks database. 4.
SET NFS_SERVER SET NFS_SERVER Modifies dynamic configuration parameters that control NFS server operation. To modify a dynamic configuration parameter, use one or more of the command qualifiers. Static configuration parameters can take effect only by restarting the NFS server. For more information, refer to the HP TCP/IP Services for OpenVMS Management manual. Edit the TCPIP$ETC:SYSCONFIGTAB.
SET NFS_SERVER /UID_DEFAULT=n Optional. Default: –2. Default UID associated with files owned by a UIC that has no corresponding proxy mapping. Examples 1. TCPIP> SET NFS_SERVER /INACTIVITY_TIMER=180 Sets the time period that unaccessed NFS files remain open to 180 seconds.
SET PROTOCOL SET PROTOCOL Sets parameters for ICMP, IP, TCP, and UDP. Related commands: SET CONFIGURATION PROTOCOL, SHOW PROTOCOL Format SET PROTOCOL ICMP [ /[NO]REDIRECT ] SET PROTOCOL IP [ /[NO]FORWARD ] [ /REASSEMBLY_TIMER=seconds ] SET PROTOCOL TCP [ [ [ [ [ [ /[NO]MTU_SEGMENT_SIZE ] /[NO]DELAY_ACK ] /DROP_COUNT=n ] /PROBE_TIMER=seconds ] /QUOTA=[ SEND=bytes,RECEIVE=bytes ] /[NO]WINDOW_SCALE ] SET PROTOCOL UDP [ /[NO]BROADCAST ] [ /QUOTA=options ] Restrictions Requires OPER privilege.
SET PROTOCOL Qualifiers for TCP /MTU_SEGMENT_SIZE /NOMTU_SEGMENT_SIZE Optional. Default: /NOMTU_SEGMENT_SIZE. If a connection is more than one hop away, sets the segment size. Specify one of the following: /MTU_SEGMENT_SIZE /NOMTU_SEGMENT_SIZE Sets the segment size as close as possible to the maximum transmission unit (MTU) size. Sets the segment size as close as possible to the standard 512 bytes. /DELAY_ACK /NODELAY_ACK Optional. Default: /DELAY_ACK.
SET PROTOCOL Qualifiers for UDP /BROADCAST /[NO]BROADCAST Optional. Default: /NOBROADCAST. Enables privilege checking for broadcast messages. • /BROADCAST — Nonprivileged users can send broadcast messages. • /NOBROADCAST — To send broadcast messages, users need a privileged UIC or the SYSPRV, BYPASS, or OPER privilege. ONC RPC applications use broadcast messages and need privilege checking disabled. /QUOTA=options Optional. Specifies the queue size (in bytes) for messages.
SET ROUTE SET ROUTE Defines a routing path in either the permanent or volatile routes database. Routes in the permanent, on-disk routes database are static. Static routes can be supplemented by routes that the dynamic routing server receives. Defaults are as follows: • If the network is not active, the command affects the permanent database. • If the network is active, the command affects the volatile database. (To modify the permanent database, use the /PERMANENT qualifier.
SET ROUTE Not valid with /DEFAULT_ROUTE. Qualifiers /CONFIRM /NOCONFIRM Optional. Default: /CONFIRM if you use a wildcard. Prompts you to confirm the change. If you specify the /NOCONFIRM qualifier, the operation is performed without asking you to confirm the request. /DEFAULT_ROUTE Optional. Default: 0.0.0.0. Defines a second route to use if the first try to route a packet fails. You must also specify a value for /GATEWAY. Not valid with the destination parameter. /GATEWAY=host Optional. Default: None.
SET ROUTE Examples 1. TCPIP> SET ROUTE DODO /GATEWAY=RHEA Defines a route for local host DODO to send packets. 2. TCPIP> SET ROUTE 101.81 /GATEWAY=100.42 Defines a gateway for routing packets for the host with IP address 101.81. 3. TCPIP> SET ROUTE 100.45.0 /GATEWAY=REMOTE /NETWORK Sets a route through the network whose IP address is 100.45.0. 4. TCPIP> SET ROUTE /DEFAULT /GATEWAY=DEFGATE /PERMANENT Sets a default route with host DEFGATE as the default gateway.
SET SERVICE SET SERVICE Defines a new entry or modifies an existing entry in the services database. The /FILE, /PORT, /PROCESS_NAME, and /USER_NAME qualifiers are required when defining a new entry and optional when modifying an existing one.
SET SERVICE Requires write access to the directory with the services database. Parameters service Required for SET SERVICE; optional for SET NOSERVICE. Service you want to modify or enter into the services database. Qualifiers /ACCEPT {=[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks)} Optional. Default: Offers the service to all hosts on all networks. • /ACCEPT=HOST=(host) Grants host or hosts access to the service. Denies access to all other hosts.
SET SERVICE /ADDRESS=IP_address Optional. Default: 0.0.0.0 (all local interfaces receive incoming requests for the service). If you have multiple Internet interfaces and, therefore, more than one IP address, /ADDRESS specifies the particular address on which incoming requests are received. To define a service name more than once, use /ADDRESS with different values for each instance.
SET SERVICE /LOG_OPTIONS= [ [NO]ACCEPT ] [ [NO]ACTIVATE ] [ [NO]ADDRESS ] [ [NO]ALL ] [ [NO]CONNECT ] [ [NO]DEACTIVATE ] [ [NO]ERROR ] [ [NO]EXIT_CLEANUP ] [ [NO]LOGIN ] [ [NO]LOGOUT ] [ [NO]MODIFY ] [ [NO]REJECT ] Sets the specified logging options for the service you are configuring. The logging options have the following meanings: Option Meaning [NO]ACCEPT [NO]ACTIVATE [NO]ADDRESS Message is logged when a request is accepted. Message is logged when the service is activated.
SET SERVICE /PROCESS_NAME=process Required if defining a new service entry. Cannot be modified (use SET NOSERVICE to delete the entry and then re-create the entry with the modification you want to make). Name of the service’s process. Specify a character string up to 15 characters long. The name is truncated to 15 characters if it exceeds that limit. /PROTOCOL=protocol [=options] Optional. Default: TCP. Protocol, and its parameters, that the service will use.
SET SERVICE Option Meaning HOSTS=hosts Makes the service unavailable to the specified hosts. Maximum is 32. Examples: /REJECT=HOSTS=(host1_name,host2_name, host3_address) /REJECT=HOSTS=* NOHOSTS=hosts Removes the specified hosts from the reject list. You can use the wildcard character (*) in place of the hosts list to remove all hosts from the reject list. Maximum is 32.
SET SERVICE /SEPARATOR=option=character Optional. Default: 0 (null). Character that separates the following fields in received packets: • PORT=character • USER_NAME=character • PASSWORD=character • COMMAND=character /SOCKET_OPTIONS=(options) Optional. The following socket options are available. Option Description Default BROADCAST Sockets are UDP broadcast. Sockets are not UDP broadcast. Sockets are TCP keepalive. Sockets are not TCP keepalive. Receive socket quota. Send socket quota.
SHOW ARP SHOW ARP Displays ARP information. Related command: SET ARP Format SHOW ARP [host] [/[NO]LOCAL] Parameters host Optional. Default: All hosts; same as specifying /NOLOCAL. Specifies the host about which you want information. Qualifiers /LOCAL /[NO]LOCAL Optional. Default: /NOLOCAL. If you either omit this qualifier or specify /NOLOCAL, the software checks the hosts database. If a lookup fails, it also checks the BIND resolver. Limits name-to-address lookups to the local hosts database.
SHOW BOOTP SHOW BOOTP Displays client entries in the BOOTP database. Related command: SET BOOTP Format SHOW BOOTP [ [ [ [ host ] /HARDWARE=ADDRESS=hex_address ] /LOCAL ] /OUTPUT=file ] Parameters host Optional. Default: Displays all entries. Host entry you want to display. Qualifiers /HARDWARE=ADDRESS=hex_address Optional. Default: None. Identifies the entry by hardware address. Specify the address as hh-hh-hh-hh-hh-hh. /LOCAL Optional.
SHOW BOOTP Servers: Cookie: IEN: Impress: Log: LPR: Name: Resource: Time: TCPIP> not defined not defined not defined not defined not defined owl.wise.mouser.edu not defined not defined Displays the entry for client myna in the BOOTP database. When myna requests a download, TCP/IP Services sends system image MYNA.SYS.
SHOW COMMUNICATION SHOW COMMUNICATION Displays the settings and status for the IP, TCP, UDP, and INET_ACP software, including routing, buffers, sockets, and memory on the running system. Related commands: SET COMMUNICATION Format SHOW COMMUNICATION [ /MEMORY ] [ /ROUTE ] [ /SECURITY ] Qualifiers /MEMORY Optional. Displays information about memory allocated to data structures associated with network operations. /ROUTE Optional. Displays routing statistics. /SECURITY Optional.
SHOW COMMUNICATION 2.
SHOW CONFIGURATION SHOW CONFIGURATION Displays the information in the configuration database. This database, read by the TCP/IP Services startup procedure, holds information to: • Configure the lower-layer protocols, including dynamic routing. • Configure and enable the Internet interfaces. • Configure the services you want enabled when TCP/IP Services starts up. • Configure the BIND resolver. • Configure the BIND server, including the default domain. • Configure SMTP. • Configure SNMP.
SHOW CONFIGURATION Qualifiers /COMMON Optional. Default: Node specific. Valid only with SHOW CONFIGURATION ENABLE SERVICE. Displays the information in the configuration database for the clusterwide enabling or disabling of services. /FULL Optional. The default is to give a brief listing of the information. Displays complete information. Use with the component parameter. /OUTPUT=file Optional. Default: Screen display. Writes output to the specified file. Examples 1.
SHOW CONFIGURATION 3. TCPIP> SHOW CONFIGURATION NAME_SERVICE BIND Resolver Configuration Transport: Domain: Retry: Timeout: Servers: Path: TCPIP> UDP fred.parrot.brd.com 4 4 11.20.208.10, 11.20.208.53 No values defined Displays, from the configuration database, the BIND resolver configuration. 4. TCPIP> SHOW CONFIGURATION INTERFACE Interface: DE1 IP_Addr: 11.20.208.100 Interface: LO0 IP_Addr: 137.0.0.1 TCPIP> NETWRK: 255.255.0.0 BRDCST: 11.20.255.255 NETWRK: 255.0.0.
SHOW CONFIGURATION PROTOCOL SHOW CONFIGURATION PROTOCOL Displays information in the configuration database which sets the parameters for ICMP, IP, TCP, and UDP when TCP/IP Services starts up. Related commands: SET CONFIGURATION PROTOCOL, SET PROTOCOL Format SHOW CONFIGURATION PROTOCOL [ protocol ] [ /PARAMETERS ] Parameters protocol Optional. Default: All protocols. Specify one of the following: ICMP, IP, TCP, UDP. Qualifiers /PARAMETERS Optional. Shows parameter settings. You can specify any protocol.
SHOW DEVICE_SOCKET SHOW DEVICE_SOCKET Displays: • Device socket counters • Current settings from the running communications software (A device socket is composed of two parts: the Internet device (interface) and the socket.) Format SHOW DEVICE_SOCKET [ [ [ [ [ [ [ [ device_socket ] /CONTINUOUS[=n] ] /FULL ] /HOST=host ] /[NO]LOCAL ] /PORT=n ] /SERVICE=service ] /TYPE=socket_type ] Parameters device_socket Optional. Default: All device sockets. Device socket for which you want information.
SHOW DEVICE_SOCKET /LOCAL /NOLOCAL Optional. Default: /LOCAL. Displays information for device sockets bound to hosts in the local hosts database. /NOLOCAL: Displays information for device sockets bound to hosts in the hosts database and hosts known by the BIND resolver. /PORT=n Optional. Default: All local ports. Displays information for device sockets bound to the specified local port. /SERVICE=service Optional. Default: All services. Displays information for device sockets used for the specified service.
SHOW DEVICE_SOCKET The following table describes the counters in the first column of the display. Counter Meaning Q0LEN Number of sockets that are about to be connected to the specified socket Number of sockets that have established a connection but have not yet been accepted by the specified socket Number of sockets for the Q0LEN and QLEN sockets Not used Error code temporarily stored on the socket Out-of-band mark QLEN QLIMIT TIMEO ERROR OOBMARK 2.
SHOW EXPORT SHOW EXPORT Displays disks/directories available for mounting by NFS clients, in the form of UNIX path names. It also displays the clients allowed to mount these path names. Related commands: ADD EXPORT, REMOVE EXPORT, MAP, SET CONFIGURATION MAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW CONFIGURATION MAP Format SHOW EXPORT [ "/path/name" ] [ /HOST=host ] [ /OUTPUT=file] ] Restrictions Requires read access to the export database. Parameters "/path/name" Optional.
SHOW EXPORT 2. TCPIP> SHOW EXPORT/HOST="condor" File System /condor_root/root /condor_root/work4 Host name condor condor Displays exported NFS file systems for clients on host condor.
SHOW HOST SHOW HOST Displays information from the hosts database. If the BIND resolver is enabled, information from the BIND database is also displayed. Related commands: SET HOST Format SHOW HOST [ [ [ [ [ [ host ] /ADDRESS=IP_address ] /DOMAIN=domain ] /LOCAL ] /OUTPUT=file ] /SERVER=server ] Restrictions Requires read access to the hosts database. Parameters host Optional. Default: All hosts. All alias names for the specified host are displayed.
SHOW HOST /DOMAIN=domain Optional. Default: Name service domain. Domain to be used by the local host. However, the definition of the domain name is valid only during the execution of the current SHOW HOST command. The BIND request is sent to the specified domain. /LOCAL Optional. Limits name-to-address lookups to the local hosts database. /OUTPUT=file Optional. Default: Screen display. Specifies a file for the output of the SHOW HOST command. /SERVER=server Optional. Default: Name server list.
SHOW HOST 2. TCPIP> SHOW HOST ABCXYZ BIND database Server: 128.182.4.164 ZSERVE Host address Host name 128.180.5.164 ABCXYZ.one.nam.com Displays information about a host found in the BIND database. Note that the display includes the name and address of the BIND server that supplied the information. 3. TCPIP> SHOW HOST * Displays the entire hosts database and BIND database (if the resolver is enabled). In the following examples, host heron has the following IP addresses and aliases: 4.
SHOW INTERFACE SHOW INTERFACE Displays information from the running system for Internet interfaces and pseudointerfaces. The flags that can appear in the display include: • AMCST—The interface will receive multicast packets. • BRDCAST—Indicates the interface supports broadcast messages. • LOOP—The interface is a loopback mode. Packets transmitted on this interface will be looped back in the driver and not be transmitted out on the network. • MCAST—The interface supports multicast packets.
SHOW INTERFACE /FULL Optional. Default: Brief description is displayed. Displays full information. Examples 1. TCPIP> SHOW INTERFACE WE0 /FULL Interface: WE0 IP_Addr: 126.65.100.102 NETWRK: 255.255.255.0 BRDCST: 126.65.100.255 Ethernet_Addr:AA-00-05-CC-2D-2B MTU: 65535 Flags: UP BRDCST RUN RECEIVE SEND Packets 3817269 595744 Errors 0 Collisions: 0 Displays information about interface WE0.
SHOW MAIL SHOW MAIL Displays SMTP queue information. Related commands: REMOVE MAIL, SEND MAIL Format SHOW MAIL [ [ [ [ user ] /FULL ] /RECIPIENT[=options] ] /ENTRY=n ] Restrictions Requires SYSPRV or BYPASS privilege to display information for other users. Parameters user Optional. Default: All users. Displays SMTP process information of the specified user. Qualifiers /FULL Optional. Default: Brief description is displayed. Displays detailed information. /RECIPIENT[=options] Optional. Default: ALL.
SHOW MAIL 3. TCPIP> SHOW MAIL /FULL /RECIPIENT=ALL Displays detailed information about all mail messages sent by the user of your process’s user name.
SHOW MAP SHOW MAP Displays the names of mapped (logically linked) file systems, also called NFS file systems. Applies to: NFS server Related commands: MAP, UNMAP, ADD EXPORT, SHOW EXPORT, REMOVE EXPORT, SET CONFIGURATION MAP, SET CONFIGURATION NOMAP, SHOW CONFIGURATION MAP Format SHOW MAP [ /path/name ] Parameters /path/name Optional. Name of the file system (the first element of the UNIX file specification). Examples 1.
SHOW MOUNT SHOW MOUNT Displays a list of mounted directories at all mount points or at a particular mount point. Related commands: MOUNT, DISMOUNT Format SHOW MOUNT [ [ [ [ device ] /ALL ] /FULL ] /HOST=host ] Parameters device Optional. Default: All mounted file systems. Local device for which to display mount information. Specify one of the following: • DNFSn: — the full NFS device name and directory tree, for example, DNFS3:[USER.
SHOW MOUNT Examples 1. TCPIP> SHOW MOUNT _DNFS1:[000000] automount (inactivity timer 0 00:23:00.00), mounted SIGMA.PROCESS.COM:/usr _DNFS2:[000000] mounted IRIS.PROCESS.COM:/usr/users Shows the characteristics of all mounted file systems on all local NFS devices. 2. TCPIP> SHOW MOUNT DNFS3: /ALL _DNFS3:[A.B] mounted SIGMA.PROCESS.COM:/usr _DNFS3:[A.C] mounted SIGMA.PROCESS.COM:/work Shows the characteristics of all mounted file systems on local device DNFS3:.
SHOW MX_RECORD SHOW MX_RECORD Displays SMTP routing information. If you omit destination, you see the entries in the local Mail Exchange (MX) database. If you specify destination, you see all the entries in all the databases that TCP/IP Services would look at, if necessary, to resolve the address. To send mail, SMTP looks up addresses in one or more databases (if necessary) in the following order: 1. Local MX databse 2. Remote MX database 3. BIND server database 4.
SHOW MX_RECORD Host address Host name 18.18.100.10 SWAN.WEBBED.FEET.COM Displays, in order of preference, the routing hops to reach host SWAN if an attempt fails. The local host tries to route through: 1. WATER.PIPIT.WEBBED.FEET.COM 2. bd-gw.purple.martin.com 3. great.horned.owl.com 4. bird.food.seeds.worms.com Both the alternate gateway and the zone affect how SMTP determines where to relay nonlocal mail. MX records tell mailers where to relay mail that is destined for a given host.
SHOW NAME_SERVICE SHOW NAME_SERVICE Logs information about the BIND resolver. Related commands: SET NAME_SERVICE, SHOW CONFIGURATION NAME_SERVICE Format SHOW NAME_SERVICE [ /STATISTICS ] Restrictions The /STATISTICS qualifier requires BYPASS, READALL, or SYSPRV privilege. Qualifiers /STATISTICS Optional. Dumps statistics to SYS$SPECIFIC:[TCPIP$BIND]TCPIP$BIND.STATS. Either TCPIP$ETC:RNDC.CONF or TCPIP$ETC:RNDC.KEY must be set up to allow for secure communication between the user and the BIND server.
SHOW NAME_SERVICE 2. TCPIP> SHOW NAME_SERVICE /STATISTICS Logs current BIND server statistics to the file TCPIP$BIND_SERVER_STATISTICS.LOG. The following sample shows such a log file.
SHOW NETWORK SHOW NETWORK Displays information about the networks database. Related command: SET NETWORK Format SHOW NETWORK [ network ] [ /ADDRESS=address ] [ /OUTPUT=file ] Restrictions Requires read access to the networks database. Parameters network Optional. Default: All known networks. Network about which to display information. • Displays all alias names of the specified network. • If you specify an alias, the network name and all its alias names are displayed.
SHOW NFS_SERVER SHOW NFS_SERVER Displays NFS server performance counters and statistics. Related commands: SET NFS_SERVER, ZERO NFS_SERVER Format SHOW NFS_SERVER [ [ [ [ /CONTINUOUS[=seconds] ] /RPC] /SERVER ] /VERSION=versions ] Restrictions Requires SYSNAM and WORLD privilege. Qualifiers /CONTINUOUS[=seconds] Optional. Defaults: Static display; if you specify /CONTINUOUS without a value, the default is 4 seconds. Provides a dynamic display with optional screen-update interval.
SHOW PORTMAPPER SHOW PORTMAPPER Displays a list of all registered remote procedure call (RPC) programs. The Portmapper running on the specified host gets this list. Format SHOW PORTMAPPER [ host ] Parameters host Optional. Default: Local host. Host with the Portmapper you want to query. Examples 1.
SHOW PROTOCOL SHOW PROTOCOL Displays statistics and configuration information for the specified protocol. Related commands: SET PROTOCOL SET CONFIGURATION PROTOCOL Format SHOW PROTOCOL [ protocol ] [ /PARAMETERS ] Parameters protocol Optional. Default: All protocols. Specify one of the following: ICMP, IP, TCP, UDP. Qualifiers /PARAMETERS Optional. Shows parameter settings. You can specify any protocol. Examples 1.
SHOW PROTOCOL 2 keepalive timeouts 2 keepalive probes sent 0 connections dropped by keepalive Displays the TCP statistics. The following abbreviations are used for the TCP counters display: ack — acknowledge URG — urgent dup. — duplicate embryonic connections—connections not yet established rtt — retries rexmt — retransmit 2.
SHOW PROXY SHOW PROXY Displays entries in the proxy database. Related commands: ADD PROXY, REMOVE PROXY Applies to: NFS server, NFS client, PC-NFS, remote shell, LPR/LPD, and customer-developed services Format SHOW PROXY [ [ [ [ [ [ user_name ] /COMMUNICATION ] /GID=n ] /HOST=host ] /NFS =[options] ] /UID=n ] Restrictions Requires read access to the proxy database. Parameters user_name Optional. Default: SHOW PROXY * (all entries).
SHOW PROXY These entries might be for local clients, remote clients, or PC-NFS clients. You can include the following options: /NFS=OUTGOING /NFS=INCOMING /NFS=(OUTGOING,INCOMING) Proxy to use NFS client Proxy to use NFS server Proxy to use both the NFS client and the NFS server /UID=n Optional. Default: All NFS proxies. Displays the database entry for the client with the specified UID. Examples 1.
SHOW PROXY 2. TCPIP> SHOW PROXY /COMMUNICATION VMS User_name Type Remote User_name Host_name BLUEJAY QUETZAL FALCON MYNA CANVASBACK CD CD CD C CD JAY quetzal FALCON MYNA CBACK * central.america.com HAWK PARROT,parrot DUCK,duck Shows all the communication proxies.
SHOW ROUTE SHOW ROUTE Displays the permanent or volatile routes database. To display the permanent database, use the /PERMANENT qualifier. Looks up the destination you specify first in the hosts database and then, if this lookup fails, in the networks database.
SHOW ROUTE /OUTPUT=file Optional. Default: Screen display. Sends output to the specified file. /PERMANENT Optional. Displays only the permanent routes database. • If TCP/IP Services is running and you omit /PERMANENT, the volatile database is displayed. • If TCP/IP Services is not running, the permanent database is displayed. 1. TCPIP> SHOW ROUTE Examples DYNAMIC Type AN AN AH AH Destination 0.0.0.0 16.20.0.0/16 16.20.208.100 127.0.0.1 Gateway 16.20.0.173 16.20.208.100 16.20.208.100 127.0.0.
SHOW SERVICE SHOW SERVICE Displays the following information about configured services: Service name Port for listening Protocol Process name IP address State RPC information Related commands: SET SERVICE, DISABLE SERVICE, ENABLE SERVICE Format SHOW SERVICE [ [ [ [ [ [ [ [ service ] /ADDRESS=address ] /FULL ] /PERMANENT ] /PORT=n ] /PROCESS=process ] /PROTOCOL=protocol ] /RPC ] Parameters service Optional. Default: All services. Service for which you want information.
SHOW SERVICE Displays information only for services that use the specified port. /PROCESS=process Optional. Default: All services. Displays information for only the services that use the specified process. /PROTOCOL=protocol Optional. Default: All services. Displays information only for services that use the specified protocol. /RPC Optional. Default: No RPC information is displayed. Displays a brief summary of the services that are configured with RPC information.
SHOW SERVICE 3. TCPIP> SHOW SERVICE PCNFS /FULL /PERMANENT Service: PCNFS Port: Inactivity: Limit: File: Flags: 5151 Protocol: TCP,UDP 0 User_name: TCPIP$PCNFS 1 TCPIP$SYSTEM:TCPIP$PCNFSD_RUN.COM TCPIP Prot Socket Opts: Rcheck Scheck Receive: 0 Send: Log Opts: File: Address: 0.0.0.0 Process: TCPIP$PCNFSD 0 Acpt Actv Dactv Conn Error Exit Logi Mdfy Rjct TimO Addr SYS$SYSDEVICE:[TCPIP$PCNFS]TCPIP$PCNFSD_STARTUP.
SHOW SERVICE 6. TCPIP> SHOW SERVICE REXEC /FULL /PERMANENT Service: REXEC Port: Inactivity: Limit: File: Flags: 512 Protocol: TCP 5 User_name: not defined 3 Address: 0.0.0.0 Process: TCPIP$REXECD TCPIP$SYSTEM:TCPIP$REXEC_RUN.COM Case Listen Rexe TCPIP Socket Opts: Rcheck Scheck Receive: 0 Send: 0 Log Opts: File: Acpt Actv Dactv Error Exit Mdfy Rjct TimO Addr TCPIP$REXEC.LOG Separators: Port: 0 User_name: 0 Password: 0 Command: 0 Security Reject msg: not defined Accept host: 0.0.0.
SHOW VERSION SHOW VERSION Displays the version of the TCP/IP Services software that is currently running, including individual components. Format SHOW VERSION [ /ALL ] Qualifiers /ALL Optional. Default: TCP/IP Services version. Displays the version of all running TCP/IP Services components. Examples 1. TCPIP> SHOW VERSION HP TCP/IP Services for OpenVMS Alpha Version 5.4 on an AlphaServer 1000 4/200 running OpenVMS V7.3-1 Displays the following information: • Version of TCP/IP Services that is running.
START MAIL START MAIL Manually starts the SMTP sender queues (not the receiver [server]). Related commands: SHOW MAIL, ENABLE SERVICE SMTP, SHOW CONFIGURATION SMTP Format START MAIL Restrictions Requires SYSPRV or BYPASS privilege. SMTP consists of the sender and the receiver. Start the sender before you enable the receiver. Do not issue this command unless SMTP has been configured (with the SET CONFIGURATION SMTP command). Examples 1. TCPIP> START MAIL Starts the SMTP sender.
START ROUTING START ROUTING Starts dynamic routing with ROUTED or GATED. If you want to change from one to the other, you must stop the current dynamic routing daemon then start the desired daemon. You cannot run both GATED and ROUTED at the same time. Related commands: STOP ROUTING, SET GATED Format START ROUTING [/GATED ] [ /LOG ] [ /SUPPLY[=DEFAULT] ] Qualifiers /GATED Optional. Enables the gateway routing daemon (GATED).
START ROUTING 3. TCPIP> START ROUTING /SUPPLY Immediately starts ROUTED dynamic routing. The local host both broadcasts and receives network routing information.
STOP ROUTING STOP ROUTING Stops dynamic routing. If GATED routing is used, stops dynamic routing but preserves GATED routes in the routing table. Use with SET NOROUTE when you require full manual control over the routing table. Related command: START ROUTING Format STOP ROUTING [ /GATED ] Qualifiers /GATED Optional. Use to stop GATED dynamic routing and to remove all GATED routes from the routing table.
UNMAP UNMAP Makes unknown to the NFS server either a mapped (logically linked) OpenVMS disk or a container file system. Unmapping removes a logical file system, also called Network File System (NFS). Unmapped file systems are not accessible to remote users working on NFS clients.
ZERO NFS_SERVER ZERO NFS_SERVER Resets the NFS server performance counters. Related commands: SET NFS_SERVER, SHOW NFS_SERVER Format ZERO NFS_SERVER [ /HOST=host ] [ /SERVICES ] [ /USER_NAME=vms_user_name ] Restrictions Requires SYSNAM and WORLD privileges. Qualifiers /HOST=host Optional. Default: All users, all hosts. With /USER_NAME, clears the counters relating to the specified users sharing the specified OpenVMS account. /SERVICES Optional. Default: NFS server services.
Index A Account, OpenVMS user creating, 2–5, 2–23 deleting, 2–81 displaying, 2–183 ACP (ancillary control process) associating to process a volume, 2–69 process buffer parameter, 2–65 ADD EXPORT command, 2–2 ADD PROXY command, 2–5 Address 0.0.0.
BOOTP database (cont’d) CONVERT/VMS BOOTP command, 2–20 creating, 2–24 displaying, 2–151 disabling, 2–43 enabling at system startup, 2–95 monitoring, 2–188 Bootstrap Protocol See BOOTP Buffers displaying, 2–153 setting, 2–93 setting ACP process parameter for, 2–65 C Clients adding, to BOOTP database, 2–86 Cluster alias defining, 2–98, 2–124 Cluster load balancing See BIND server Commands See individual commands DCL AUTHORIZE, 2–5 displaying information, 1–9 guidelines for entering, 1–1 preserving case, 1–3
D Database BIND displaying, 2–164 BIND server CONVERT/UNIX BIND command, 2–16 BOOTP adding entries to, 2–86 CONVERT/VMS BOOTP command, 2–20 creating, 2–24 displaying, 2–151 configuration BIND server entries creating, 2–90 creating, 2–25 displaying, 2–155 lower-layer software entries creating, 2–93 lower-level protocol entries creating, 2–107 name server entries creating, 2–104 SMTP entries creating, 2–110 SNMP entries creating, 2–114 displaying SMTP routing information, 2–174 export adding directory names i
/etc/mount command, 2–63 /etc/networks file CONVERT/UNIX NETWORK command, 2–19 CONVERT/VMS NETWORK command, 2–22 Ethernet address mapping to IP, 2–84, 2–150 controller specifying interface name, 2–97, 2–124 Exchange identification See XID EXIT command, 2–51 EXPORT command, 2–52 Export database adding directory names in the export database, 2–2 creating, 2–32 deleting directory names from the export database, 2–76 displaying, 2–162 F FDDI address mapping to IP, 2–84, 2–150 controller specifying interface na
IP (cont’d) setting parameters in configuration database, 2–93, 2–107 setting parameters on running system, 2–88, 2–137 starting, 2–93 L LIST COMMUNICATION_CONTROLLER command, 2–57 Load balancing See BIND server Logging See Event logging Lookups by BIND resolver, 2–131, 2–186 in hosts database, 2–130, 2–150, 2–151, 2–160, 2–165, 2–186 using BIND resolver, 2–104 using hosts database, 2–104 LOOP command, 2–59 LPD disabling, 2–43 enabling at system startup, 2–95 monitoring, 2–188 proxy database, 2–5 registeri
NFS server (cont’d) displaying export database, 2–162 displaying files in UNIX container directory, 2–41 displaying proxy database, 2–183 enabling at system startup, 2–95 export database, 2–32 links creating, 2–29 deleting, 2–75, 2–78 making files available for mounting, 2–61, 2–102 making files unavailable, 2–106 making files unavailable to, 2–197 mapping displaying, 2–171 mapping files or disks to, 2–61 mapping file systems, 2–102 displaying, 2–155 making unavailable, 2–197 NFS clients making files unavai
Protocol IP (cont’d) configuring on running system, 2–137 displaying configuration, 2–158 starting, 2–93 TCP configuring in configuration database, 2–107 configuring on running system, 2–137 displaying configuration, 2–158 starting, 2–93 UDP configuring in configuration database, 2–107 configuring on running system, 2–137 displaying configuration, 2–158 starting, 2–93 Proxy database adding entries to, 2–5, 2–23 creating, 2–35 deleting entries from, 2–81 displaying, 2–183 displaying, 2–183 removing entries f
Services enabling (cont’d) interactively, 2–49 names, 1–2 setting communication properties of, 2–88, 2–93 SET ARP command, 2–84 SET BOOTP command, 2–86 SET COMMUNICATION command, 2–88 SET CONFIGURATION BIND command, 2–90 SET CONFIGURATION COMMUNICATION command, 2–93 SET CONFIGURATION ENABLE SERVICE command, 2–95 SET CONFIGURATION INTERFACE command, 2–97 SET CONFIGURATION MAP command, 2–102 SET CONFIGURATION NAME_SERVICE command, 2–104 SET CONFIGURATION PROTOCOL command, 2–107 SET CONFIGURATION SMTP command,
T TCP setting parameters in configuration database, 2–93, 2–107 setting parameters on running system, 2–88, 2–137 starting, 2–93 TELNET disabling, 2–43 enabling at system startup, 2–95 monitoring, 2–188 print symbiont See Printing TELNETSYM See Printing Terminal emulation of IBM 3270 model terminals See TELNET Testing for active connectivity LOOP command, 2–59 PING command, 2–73 Internet interface, 2–100, 2–126 TFTP disabling, 2–43 enabling at system startup, 2–95 monitoring, 2–188 TIME configuration displa
