HP OpenVMS Systems Documentation

Content starts here HP TCP/IP Services for OpenVMS

HP TCP/IP Services for OpenVMS
Management Command Reference


Previous Contents Index

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 the HP TCP/IP Services for OpenVMS Management manual for more information about setting up interfaces for SLIP and PPP communication.


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.

When the NFS server starts up, it issues a GENERATE MAP command, which creates the mappings for disks and container file systems; these mappings are viewable with the SHOW MAP command.

Related commands: ADD EXPORT, SHOW EXPORT, REMOVE EXPORT, MAP, UNMAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW CONFIGURATION MAP


Format

SET CONFIGURATION MAP "file system name" logical_file_system

restrictions

Requires SYSPRV and BYPASS privileges.

Parameters

"file system name"

Required.

Specifies the name for the file system or disk. When mapping a disk, the "/path" can be only one level from the root. This parameter specifies the name by which users access the file system.

logical_file_system

Required.

Specifies the file system to make known to the NFS server.

To map an OpenVMS file system, specify its disk as follows:


$ SET CONFIGURATION MAP "/disk" disk:

To map a container file system, specify the disk and the directory name as follows:


TCPIP> SET CONFIGURATION MAP "/container_name" -
_TCPIP> disk:[vms.directory.name]

Examples

#1

TCPIP> SET CONFIGURATION MAP "/usr" CANARY$DUA2:
      

Maps local disk CANARY$DUA2: to /usr . This disk can be exported to users on remote NFS clients as /usr .

#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

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. By default, the clusterwide common database common-disk:[TCPIP$BIND_common] is used. This qualifier reloads the BIND database on every master BIND server running the OpenVMS cluster.

/DOMAIN=domain

/NODOMAIN

Optional. Default: The local domain.

Defines the default domain.

/NODOMAIN deletes the definition of the domain.

/PATH=domain

/NOPATH=domain

Optional. SYSNAM privilege is required for this command.

Defines the BIND resolver domain search list. The /NOPATH qualifier removes domains from the list.

To specify multiple domains, list them by search preference. The resolver starts with the first domain on the list, and continues to search each domain until the name is found (or until all domains have been exhausted and the lookup fails).

If you define a domain list and then issue another SET CONFIGURATION NAME_SERVICE /PATH command, TCP/IP Services appends the new domains to the end of the list.

If a search list is not defined, the default behavior of the BIND resolver is to do a lookup on the name as you typed it. If that lookup fails, then the default domain is appended and the lookup is attempted again.

/RETRY=number of retries

Optional. Default: Four retries.

Number of times that the BIND resolver attempts to contact a BIND server if previous tries failed.

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

/TIMEOUT=seconds

Optional. Default: 4 seconds.

Timeout interval for the BIND resolver's requests to a BIND server. Represents the length of time to wait for a reply after each retry attempt.

The total timeout period will be:

timeout_value * retry_value * number_servers

/TRANSPORT=protocol

Optional. Default: UDP.

Protocol used for communicating with a BIND server. Specify one:

  • UDP
  • TCP

Examples

#1

TCPIP> SET CONFIGURATION NAME_SERVICE /SERVER=(PARROT,SORA,JACANA)
      

When TCP/IP Services starts, defines hosts PARROT, SORA, and JACANA as BIND servers.

#2

TCPIP> SET CONFIGURATION NAME_SERVICE /SERVER=OSPREY -
_TCPIP> /PATH=(abc.dec.com,xyz.dec.com)
      

When TCP/IP Services starts, defines host OSPREY as the BIND server. The BIND resolver searches the abc.dec.com domain first, and then searches the xyz.dec.com domain.


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.

Related commands: SET CONFIGURATION MAP,
SHOW CONFIGURATION MAP, ADD EXPORT, SHOW EXPORT, REMOVE EXPORT, MAP, UNMAP, SHOW MAP


Format

SET CONFIGURATION NOMAP "/path/name" [ /[NO]CONFIRM ]

restrictions

Requires SYSPRV and BYPASS privilege.

Parameters

"/path/name"

Required.

UNIX name of the file system to unmap.

You can use wildcards.


Qualifiers

/CONFIRM

/NOCONFIRM

Optional. Default: /CONFIRM if you use a wildcard.

With /CONFIRM enabled, requests confirmation before unmapping each file system. If you specify the /NOCONFIRM qualifier, the operation is performed without asking you to confirm the request.


Examples

#1

TCPIP> SET CONFIGURATION NOMAP "/disk_host"
      

Unmaps the NFS file system /remote , making it unavailable to client users when TCP/IP Services starts.


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.

Related commands: SET PROTOCOL, SHOW CONFIGURATION PROTOCOL


Format

SET CONFIGURATION PROTOCOL ICMP [ /[NO]REDIRECT ]

SET CONFIGURATION PROTOCOL IP [ /[NO]FORWARD ]
[ /REASSEMBLY_TIMER=seconds ]

SET CONFIGURATION PROTOCOL TCP [ /[NO]MTU_SEGMENT_SIZE ]
[ /[NO]DELAY_ACK ]
[ /DROP_COUNT=n ]
[ /PROBE_TIMER=seconds ]
[ /QUOTA=[ SEND=bytes,RECEIVE=bytes ] ]
[ /[NO]WINDOW_SCALE ]

SET CONFIGURATION PROTOCOL UDP [ /[NO]BROADCAST ]
[ /[NO]FORWARD ]
[ /QUOTA=options ]

restrictions

Requires OPER privilege.

Parameters

{ICMP | IP | TCP | UDP}

Required.

Specifies the protocol software to configure.


ICMP Qualifiers

/REDIRECT

/NOREDIRECT

Optional. Default: /NOREDIRECT.

Sends ICMP_REDIRECT messages.


IP Qualifiers

/FORWARD

/NOFORWARD

Optional. Default: /NOFORWARD.

Forwards IP messages to other hosts.

/REASSEMBLY_TIMER=n

Optional. Default: 7 seconds. Valid range: 1 to 126.

Sets the maximum time for trying to reassemble a received datagram.


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 Sets the segment size as close as possible to the maximum transfer unit (MTU) size.
/NOMTU_SEGMENT_SIZE Sets the segment size as close as possible to the standard 512 bytes.

/DELAY_ACK

/NODELAY_ACK

Optional. Default: /DELAY_ACK.

Enables or disables a delay before sending acknowledgments:

/DELAY_ACK ACKs are generated with a delay.
/NODELAY_ACK ACKs are generated without any delay.

/DROP_COUNT=n

Optional.

Number of idle probes that can go unsatisfied before the software declares a TCP connection dead and closes it.

/PROBE_TIMER=n

Optional. Default: 75 seconds.

Number of seconds between probes for idle TCP connections (when the SO_KEEPALIVE option is set). If the remote system fails to respond, the connection is removed. Also, when initiating a TCP connection request, indicates the maximum number of seconds that the software waits for a response from the remote system before the request times out.

/QUOTA=[SEND=bytes,RECEIVE=bytes]

Optional.

Specifies the queue size (in bytes) for messages.

The options for setting TCP message queue size are:

  • RECEIVE:n --- Receive queue size. Default: 4096 bytes.
  • SEND:n --- Send queue size. Default: 4096 bytes.

/WINDOW_SCALE

/NOWINDOW_SCALE

Optional.

Turns TCP window scaling on and off. Default is on.

Scaling allows windows larger than 64 KB to be represented in the normal 16-bit TCP window field. Large windows allow improved throughput. Turning this option off may help troubleshoot communication problems with another TCP/IP implementation.


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.

Specifies the queue size (in bytes) for messages.

The options for setting UDP message queue size are:

  • RECEIVE:n --- Receive queue size. Default: 9000 bytes.
  • SEND:n --- Send queue size. Default: 9000 bytes.

Examples

#1

TCPIP> SET CONFIGURATION PROTOCOL IP /FORWARD
      

Sets IP to forward messages to other hosts, including other Internet cluster nodes.

#2

TCPIP> SET CONFIGURATION PROTOCOL TCP /PROBE_TIMER=50
      

Sets the TCP protocol probe timer parameter to 50 seconds.


SET CONFIGURATION SMTP

Modifies the SMTP configuration in the configuration database.

SET CONFIGURATION NOSMTP with no qualifiers deletes all SMTP records.

Related commands: SHOW CONFIGURATION SMTP


Format

SET CONFIGURATION [NO]SMTP [ /ADDRESS_RETRIES=n ]
[ /GATEWAY=option=host ]
[ /HOP_COUNT_MAXIMUM=n ]
[ /INTERVAL=options ]
[ /[NO]LOG=[file] ]
[ /OPTIONS=options ]
[ /QUEUES=n ]
[ /RECEIVE_TIMEOUT=minutes ]
[ /SEND_TIMEOUT=minutes ]
[ /SUBSTITUTE_DOMAIN=[NO]NAME=fully-qualified-name ]
[ /[NO]ZONE[=domain] ]

restrictions

For clusters, issue this command only on the nodes where the SMTP queues reside --- that is, on nodes that are not using clusterwide queues and are not managing clusterwide queues for other nodes.

Requires SYSPRV or BYPASS privilege.


Qualifiers

/ADDRESS_RETRIES=n

Optional. Default: 16.

Maximum number of different addresses to which SMTP will send as it tries to deliver mail. Beyond this number of attempts, the message is undeliverable.

A message is also undeliverable if SMTP fails to deliver after it attempts all the possible addresses from an MX lookup.

/GATEWAY=option=host

Optional. Default: None.

An alternate route through which SMTP sends mail if delivery fails.

  • [NO]ALTERNATE=host
    • Alternate host or domain to which delivery is attempted.
    • Used by ZONE, if a zone is defined, as the last chance for delivery (see the /ZONE qualifier).
    • NOALTERNATE deletes an existing alternate destination.
  • [NO]GENERAL_PURPOSE=host
    • Gateway to handle non-SMTP mail, for example, UUCP addresses.
    • 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. Specify the value within quotation marks as follows: "dddd hh:mm:ss:cc." For example:

dddd = days (0--9999)
h = hours (0--24)
m = minutes
s = seconds
cc = milliseconds

You can modify the following options:

  • INITIAL="OpenVMS_delta_time" is the amount of time that SMTP waits before making a second attempt to deliver.
  • RETRY="OpenVMS_delta_time" is the time SMTP waits between retries, starting with the second attempt. (Recommended time: twice the initial interval.)
  • MAXIMUM="OpenVMS_delta_time" is the maximum elapsed time that SMTP retries delivery.

/LOG=[file]

/NOLOG=[file]

Optional. Default: SYS$SPECIFIC:[TCPIP_SMTP]TCPIP$SMTP_LOGFILE.LOG.

File to which SMTP queue activity is logged.

/OPTIONS=options

Optional. Defaults: NOEIGHT_BIT, HEADERS, NORELAY.

The following SMTP options are available:

  • [NO]EIGHT_BIT
    All characters must have the eighth bit clear. Allows the transmission of 8-bit characters.
  • Header control. Specify one of the following:
    HEADERS Headers are printed at bottom of messages.
    NOHEADERS Headers are omitted.
    TOP_HEADERS Headers are printed at top of messages.
    NOTOP_HEADERS Resets TOP_HEADERS to the default.

  • [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.

If a message is not received within this interval, the connection is broken and the mail control file is deleted.

/SEND_TIMEOUT=minutes

Optional. Defaults:
DATA --- 3 minutes
INITIAL --- 5 minutes
MAIL --- 5 minutes
RECEIPT --- 5 minutes
TERMINATION --- 10 minutes

Maximum time between remote host acknowledgments of a particular SMTP command.

If an acknowledgment is not received within the specified time, it is assumed that there are communication problems with the remote host. If the next delivery attempt takes place before the mail's delivery date, the mail is rescheduled for later delivery.

/SUBSTITUTE_DOMAIN=[NO]NAME=fully-qualified-domain

Optional.

By default, the From: and Return-Path fields display the sender's name and fully qualified domain. NONAME causes the sender's domain name to be omitted from the Return-Path field. If you specify a fully qualified domain name (/SUBSTITUTE_DOMAIN=NAME=fully-qualified-domain), that specified domain name is displayed as the sender's domain name.

For example, suppose you specify the fully qualified domain name eagle for the sender's return path (/SUBSTITUTE_DOMAIN=NAME= eagle ). When user magpie on host condor.hawk.eagle.org sends mail to daw on another host, user daw sees the return path as magpie@eagle rather than magpie@condor.hawk.eagle.org .

This is what daw sees:


    #707        18-NOV-2002 14:02:02.71                  MAIL
From:   SMTP%"magpie@eagle"
To:     SMTP%"daw@crow.ravin.rook.org"
CC:
Subj:   Big sale today!

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.

With no value, /ZONE defaults to one level higher than your local domain.

For example, if your local domain is a.b.com , the default value of /ZONE is b.com because TCP/IP Services has been started; this assumes that the domain is known.

Mail for delivery outside of your zone is sent to its destination by the alternate gateway (see the /GATEWAY qualifier).


Examples

#1

TCPIP> SET CONFIGURATION SMTP /INTERVAL=(INIT="0 00:10:00.00")
      

The system waits 10 minutes before making its first attempt to deliver the message.

#2

TCPIP> SET CONFIGURATION SMTP /INTERVAL=(RETRY="0 00:20:00.00")
      

Specifies the wait time between retries.

#3

TCPIP> SET CONFIGURATION SMTP /INTERVAL=(MAX="3 00:20:00.00")
      

Specifies the maximum amount of time to retry before an error message is issued.

#4

TCPIP> SET CONFIGURATION SMTP /GATEWAY=(ALTERNATE:route_gateway)
      

Specifies the alternate host or domain to which delivery is attempted if mail cannot be delivered to the primary destination.

#5

TCPIP> SET CONFIGURATION SMTP /GATEWAY=(GENERAL:uucp_gateway)
      

Specifies a general-purpose gateway to handle non-SMTP mail.

#6

TCPIP> SET CONFIGURATION SMTP /ZONE=rsch.opt.com
      

Specifies that rsch is a domain that can be used to divert messages to nodes outside the local domain.


Previous Next Contents Index