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

See the Compaq 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:

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:


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.

Requests confirmation before unmapping each file system.


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=seconds ]
[ /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. Default: 10 minutes.

Specifies the maximum number of seconds to probe for idle TCP connections before a TCP connection close times out.

/PROBE_TIMER=n

Optional. Default: 75 seconds.

Specifies the number of seconds between probes for idle TCP connections. Also indicates the maximum number of seconds before a TCP connection 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:

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

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:


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=options ]
[ /[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.

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

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

/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 |[NO]HIDDEN)

Optional.

/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