DIGITAL TCP/IP Services for OpenVMS
Management Command Reference

Contents

Index

Sets the cluster broadcast mask to receive all broadcast messages.

The software calculates the default by:

Using the network number from the network mask
Setting all bits in the host number field to 1

/C_NETWORK=IP_address

Optional.

Network mask of the cluster network. This mask is specific to the cluster host network.

The software calculates the default by:

Setting the bits representing the network fields to 1
Setting the bits representing the host field to 0

/CLUSTER=host

/NOCLUSTER

Optional. Default: None.

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. Default: /NOCOMPRESS.

Valid for a SLIP interface. Enables or disables TCP header compression (CSLIP).

/COMPRESS=AUTOMATIC turns off compression unless the remote end begins to use it.

/DESTINATION=IP_address

Optional. No default.

Valid for a PPP interface. Used on the local host to provide dialup access to remote systems. The value specified is the IP address to be given to remote clients for use while PPP connection is active. If using /DESTINATION, you must provide the address of the local host with the /HOST qualifier.

/FLOWCONTROL

Optional. Default: No flow control.

Valid for a SLIP interface. Enables the handling of XON and XOFF characters to properly interoperate with modems that are configured to interpret these characters locally.

Specify /FLOWCONTROL only if the host at the other end of the line is another host running DIGITAL TCP/IP Services for OpenVMS.

/HOST=host

Required if first setting the interface. Optional if already defined. Always required for a SLIP interface. Optional for a PPP interface unless you are setting up the local host as a dialup provider using the /DESTINATION qualifier.

Local host name or IP address using the interface. If 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.

The software calculates the default by:

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. You can also divide the host field into a site-specific subnetwork and host field.

/SERIAL_DEVICE=device

Required for SLIP and PPP interfaces; otherwise not used.

Identifies the OpenVMS terminal device used as a serial device. Specify an arbitrary terminal device name. (Unlike Ethernet, FDDI, and Token Ring interface names, a serial interface name is not related to the OpenVMS device name.)

Examples

#1
TCPIP> SET INTERFACE SL5 /HOST=LARK /NETWORK_MASK=255.255.255.0 - _TCPIP> /SERIAL_DEVICE=TTA3: /COMPRESS=ON /FLOWCONTROL

Configures SLIP interface SL5, using the local IP address assigned to host LARK, with a subnet mask of 255.255.255.0.
The interface uses the terminal device TTA3:.
The /COMPRESS qualifier enables TCP header compression (CSLIP).
The /FLOWCONTROL qualifier enables special handling of XON and XOFF characters, so as to be properly interoperable with modems that are configured to interpret these characters locally.

#2
TCPIP> SET INTERFACE FF0 /HOST=KESTREL /NETWORK_MASK=255.255.0.0 - _TCPIP> /BROADCAST_MASK=128.30.0.0 /ARP

For new interface FF0 on host KESTREL, sets the network mask to 255.255.0.0, sets the broadcast mask to 128.30.0.0, enables ARP and trailer headers, and activates the interface.

#3
TCPIP> SET INTERFACE PP0 /SERIAL_DEVICE=TTA0: - _TCPIP> /DESTINATION=128.30.0.0

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 (128.30.0.0) is the address assigned to the client system requesting an address.
See DIGITAL TCP/IP Services for OpenVMS Management guide for more information on setting up interfaces for SLIP and PPP communication.

#4
TCPIP> SET NOINTERFACE DE2 TCPIP> SET INTERFACE DE2 /LOOPBACK . . . TCPIP> SET INTERFACE DE2

Disables defined interface DE2, sets loopback mode for testing this interface, and after testing, re-activates it.

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 MX record.
SMTP is designed to determine where the sending system should try to relay mail. It is also designed to see where the sending system actually tries to relay mail. To find a destination address, MX routing's lookup process is as follows:

Local MX database
Remote MX database
BIND database
Local hosts database

Related command: SHOW MX_RECORD

Formats

SET MX_RECORD destination /GATEWAY=host /PREFERENCE=n

SET NOMX_RECORD [ destination ]
[ /GATEWAY=host ]

restrictions

Requires read and write access to the routes database.

Parameters

destination
Required for SET MX_RECORD.
Optional for SET NOMX_RECORD.
Host name or domain name to which mail will be sent.

Qualifiers

/GATEWAY=host
Required with SET MX_RECORD.
Not valid with SET NOMX_RECORD.
Gateway through which mail will be relayed. Must have an address in either the local hosts database or the BIND database.
A destination can have multiple gateways, each with an associated preference value.
/PREFERENCE=n
Required.
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.
Not valid 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

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.
To reload the BIND server databases, use the /INITIALIZE qualifier.
/NOSERVER does not require any options.

Related commands: SHOW NAME_SERVICE, SET CONFIGURATION NAME_SERVICE

Format

SET NAME_SERVICE /[NO]SERVER=host [ /DISABLE ]
[ /[NO]DOMAIN=domain ]
[ /ENABLE ]
[ /INITIALIZE ]
[ /[NO]PATH=domain ]
[ /RETRY=number of retries ]
[ /SYSTEM ]
[ /TIMEOUT=seconds ]
[ /TRANSPORT=protocol ]

restrictions

The /SYSTEM qualifier requires SYSPRV or BYPASS and SYSNAM privileges.

Qualifiers

/DISABLE
Optional.
Disables the BIND resolver. All name-address lookups are now directed to the hosts database. Use with /SYSTEM.
/DOMAIN=domain

/NODOMAIN=domain
Optional.
Defines the default domain. The default domain is appended to host name references made from the local process.
/NODOMAIN deletes the process-specific definition of the domain. Do not use with /SYSTEM.
/ENABLE
Optional. Default: Not enabled.
Enables the BIND resolver. Use with /SYSTEM.
/INITIALIZE
Optional. Default: No reloading.
Reloads the BIND server databases.
/PATH=domain

/NOPATH=domain
Required.
Defines the BIND resolver's domain search list.
To specify multiple domains, list them by search preference. The resolver will start with the first domain on the list, and continue to search each domain until the name is found (or until all domains have been exhausted and the lookup fails).
/NOPATH removes domains from the list.
If you define a domain list and then issue another SET NAME_SERVICE /PATH command, DIGITAL TCP/IP Services for OpenVMS appends the new domains to the end of the list.
If no search list is 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: 4 retries.
Number of times that the BIND resolver attempts to contact a BIND server if previous tries fail. Do not use with the /SYSTEM qualifier.
/SERVER=host

/NOSERVER=host
Required.
Host name or address of the BIND server or servers that the 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 NAME_SERVICE /SERVER command, DIGITAL TCP/IP Services for OpenVMS appends the new servers to the end of the list.
Do not specify /NOSERVER=* with /SYSTEM.
/SYSTEM
Optional. Default: Changes are process-specific.
Makes your settings systemwide.
Sets the local host's domain as the default domain, unless you also specify /DOMAIN.
/TIMEOUT=seconds
Optional. Default: 4.
Timeout interval for the BIND resolver's requests to a server.
When the BIND resolver is used by the auxiliary server:

The number of retries is one.
The timeout interval is 1 second.
The timeout interval increases by the power of two for each retry.

For example:

Current settings: Retries=4
Timeout=4

Retry Times out in...

First 4 seconds

Second 8 seconds

Third 16 seconds

Last 32 seconds

Total = 1 minute for one host

If a secondary BIND server exists and both servers time out, total = 2 minutes

Do not use with /SYSTEM.
/TRANSPORT=protocol
Optional. Default: UDP.
Protocol used for communicating with a BIND server. Specify one:

UDP
TCP

Current settings:	Retries=4 Timeout=4
Retry	Times out in...
First	4 seconds
Second	8 seconds
Third	16 seconds
Last	32 seconds
	Total = 1 minute for one host
	If a secondary BIND server exists and both servers time out, total = 2 minutes

Examples

#1
TCPIP> SET NAME_SERVICE /SERVER=(PARROT,SORA,JACANA) /SYSTEM /ENABLE

Defines hosts PARROT, SORA and JACANA as systemwide BIND servers. Also enables the BIND resolver.

#2
TCPIP> SET NAME_SERVICE /SERVER=OSPREY

For your process, defines host OSPREY as the BIND server. The servers that are defined systemwide will not be queried.

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.

Qualifiers

/ADDRESS=IP_address
Required for a new entry.
IP address of the network.
/ALIAS=alias

/NOALIAS=alias
Optional.
Alternate name for the network.

Not valid with SET NONETWORK.
/NOALIAS=alias deletes an alias.
/NOALIAS=* deletes all aliases.

/CONFIRM

NOCONFIRM
Optional. Default: /CONFIRM if you use a wildcard.
When used with SET NONETWORK, prompts you to confirm the delete request.

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
TCPIP> SET NETWORK "jungle" /ALIAS=("parrot","canary","motmot")

For network jungle, creates the aliases parrot, canary, and motmot.

SET NFS_SERVER

Modifies the parameters of the NFS server software.
You can dynamically modify some characteristics, but other values are static, with modifications taking effect by shutting down and restarting the NFS server software:

Dynamically modifiable qualifiers:

/DISABLE
/ENABLE
/GID_DEFAULT
/HOSTS=n
/INACTIVITY_TIMER
/UID_DEFAULT

Static qualifiers:

/HOSTS=n
/THREADS
/XID

To make your changes permanent, modify SYS$STARTUP:TCPIP$NFS_SERVER_STARTUP.COM.
To shut down the NFS server, issue:
$ @SYS$STARTUP:TCPIP$NFS_SHUTDOWN.COM
To enable the server to restart, issue:
$ @SYSSTARTUP:TCPIP$NFS_SERVER_STARTUP.COM
The auxiliary server automatically restarts the NFS server upon an incoming client request.
Related commands: SHOW NFS_SERVER, ZERO NFS_SERVER

Format

SET NFS_SERVER { /DISABLE=logging_options
/ENABLE=logging_options
/GID_DEFAULT=n
/HOSTS=n
/INACTIVITY_TIMER=n
/THREADS=n
/UID_DEFAULT=n
/XID=n }

restrictions

Requires the following privileges:

SYSNAM
WORLD
SYSPRV or BYPASS

Qualifiers

/DISABLE=ERROR

=OPCOM
Optional. Default: ERROR and OPCOM enabled.
Disables the specified logging options.
/ENABLE=ERROR

=OPCOM
Optional. Default: ERROR and OPCOM enabled.
Enables the specified logging options.
/GID_DEFAULT=n
Optional. Default: --2.
Default GID associated with files not created by the NFS server.
/HOSTS=n
Optional.
Maximum number of hosts that the NFS server's proxy cache can hold.
/INACTIVITY_TIMER=n
Optional. Default: 02:00.
Maximum length of time that unaccessed NFS files remain open.
Specify mm:ss, where mm = the number of minutes and ss = the number of seconds.
/THREADS=n
Optional. Default: 20.
Maximum number of simultaneous requests that the NFS server processes.
/UID_DEFAULT=n
Optional. Default: --2.
Default UID associated with files not created by the NFS server.
/XID=n
Optional. Default: 20.
Maximum buffer allocation for XID (eXchange IDentification) caching.

Examples

#1
TCPIP> SET NFS_SERVER /ENABLE=(ERROR,OPCOM)

Enables the logging of all NFS server activity.

#2
TCPIP> SET NFS_SERVER /HOSTS=10

Sets the maximum number of hosts in the proxy cache to 10.

SET PROTOCOL

Sets parameters for ICMP, IP, , TCP, and UDP.
Related commands: SET CONFIGURATION PROTOCOL, SHOW PROTOCOL

Formats

SET PROTOCOL ICMP {/[NO]UNREACHABLE
/[NO]REDIRECT}

SET PROTOCOL IP {/[NO]FORWARD
/REASSEMBLY_TIMER=n }

SET PROTOCOL TCP {/[NO]MTU_SEGMENT_SIZE
/[NO]DELAY_ACK
/DROP_COUNT=n
/PROBE_TIMER=n
/QUOTA=options
/[NO]WINDOW_SCALE}

SET PROTOCOL UDP { /[NO]FORWARD
/QUOTA=options}

restrictions

Requires OPER privileges.

Parameters

{ ICMP | IP | TCP | UDP}
Required.
Protocol software to configure.

Qualifiers for ICMP

/REDIRECT

/NOREDIRECT
Optional. Default: /NOREDIRECT.
Sends ICMP_REDIRECT messages.

Qualifiers for IP

/FORWARD

/NOFORWARD
Optional. Default: /NOFORWARD.
Forwards IP messages to other hosts.
/REASSEMBLY_TIMER=n
Optional. Default: 7 seconds. Valid range: 1--126.
Maximum time for trying to re-assemble a received datagram.

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:

/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.
Maximum number of seconds to probe for idle TCP connections before a TCP connection close times out.
/PROBE_TIMER=n
Optional. Default: 75 seconds.
Number of seconds between probes for idle TCP connections. Also indicates the maximum number of seconds before a TCP connection request times out.
/QUOTA=options
Optional.
Queue size (in bytes) for messages.
The options for setting TCP message queue size are:

RECEIVE:n --- Receive queue size. The default value is 4096 bytes.
SEND:n --- Send queue size. The default value is 4096 bytes.

/WINDOW_SCALE

/NOWINDOW_SCALE
Optional.
Turns TCP window scaling on and off. Default is on.
Scaling allows windows larger than 64K bytes 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.

Qualifiers for UDP

/FORWARD

/[NO]FORWARD
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 PROTOCOL IP /FORWARD

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

#2
TCPIP> SET PROTOCOL TCP /PROBE_TIMER=50

Sets the TCP probe timer parameter to 50 seconds.

Contents

Index

/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	ACKs are generated with a delay.
/NODELAY_ACK	ACKs are generated without any delay.

DIGITAL TCP/IP Services for OpenVMSManagement Command Reference

/C_NETWORK=IP_address

/CLUSTER=host

/NOCLUSTER

/COMPRESS= {ON | OFF | AUTOMATIC}

/DESTINATION=IP_address

/FLOWCONTROL

/HOST=host

/LOOPBACK

/NOLOOPBACK

/NETWORK_MASK=IP_address

/SERIAL_DEVICE=device

Examples

SET MX_RECORD

Formats

SET MX_RECORD destination /GATEWAY=host /PREFERENCE=n

SET NOMX_RECORD [ destination ] [ /GATEWAY=host ]

restrictions

Parameters

destination

Qualifiers

/GATEWAY=host

/PREFERENCE=n

Examples

SET NAME_SERVICE

Format

SET NAME_SERVICE /[NO]SERVER=host [ /DISABLE ] [ /[NO]DOMAIN=domain ] [ /ENABLE ] [ /INITIALIZE ] [ /[NO]PATH=domain ] [ /RETRY=number of retries ] [ /SYSTEM ] [ /TIMEOUT=seconds ] [ /TRANSPORT=protocol ]

restrictions

Qualifiers

/DISABLE

/DOMAIN=domain

/NODOMAIN=domain

/ENABLE

/INITIALIZE

/PATH=domain

/NOPATH=domain

/RETRY=number of retries

/SERVER=host

/NOSERVER=host

/SYSTEM

/TIMEOUT=seconds

/TRANSPORT=protocol

Examples

SET NETWORK

Format

SET [NO]NETWORK network [ /ADDRESS=IP_address ] [ /[NO]ALIAS=alias ] [ /[NO]CONFIRM ]

restrictions

Parameters

network

Qualifiers

/ADDRESS=IP_address

/ALIAS=alias

/NOALIAS=alias

/CONFIRM

NOCONFIRM

Examples

SET NFS_SERVER

Format

SET NFS_SERVER { /DISABLE=logging_options /ENABLE=logging_options /GID_DEFAULT=n /HOSTS=n /INACTIVITY_TIMER=n /THREADS=n /UID_DEFAULT=n /XID=n }

restrictions

Qualifiers

/DISABLE=ERROR

=OPCOM

/ENABLE=ERROR

=OPCOM

/GID_DEFAULT=n

/HOSTS=n

/INACTIVITY_TIMER=n

/THREADS=n

/UID_DEFAULT=n

/XID=n

Examples

SET PROTOCOL

Formats

SET PROTOCOL ICMP {/[NO]UNREACHABLE /[NO]REDIRECT}

SET PROTOCOL IP {/[NO]FORWARD /REASSEMBLY_TIMER=n }

SET PROTOCOL TCP {/[NO]MTU_SEGMENT_SIZE /[NO]DELAY_ACK /DROP_COUNT=n /PROBE_TIMER=n /QUOTA=options /[NO]WINDOW_SCALE}

SET PROTOCOL UDP { /[NO]FORWARD /QUOTA=options}

restrictions

Parameters

DIGITAL TCP/IP Services for OpenVMS
Management Command Reference

SET NOMX_RECORD [ destination ]
[ /GATEWAY=host ]

SET NAME_SERVICE /[NO]SERVER=host [ /DISABLE ]
[ /[NO]DOMAIN=domain ]
[ /ENABLE ]
[ /INITIALIZE ]
[ /[NO]PATH=domain ]
[ /RETRY=number of retries ]
[ /SYSTEM ]
[ /TIMEOUT=seconds ]
[ /TRANSPORT=protocol ]

SET [NO]NETWORK network
[ /ADDRESS=IP_address ]
[ /[NO]ALIAS=alias ]
[ /[NO]CONFIRM ]

SET NFS_SERVER { /DISABLE=logging_options
/ENABLE=logging_options
/GID_DEFAULT=n
/HOSTS=n
/INACTIVITY_TIMER=n
/THREADS=n
/UID_DEFAULT=n
/XID=n }

SET PROTOCOL ICMP {/[NO]UNREACHABLE
/[NO]REDIRECT}

SET PROTOCOL IP {/[NO]FORWARD
/REASSEMBLY_TIMER=n }

SET PROTOCOL TCP {/[NO]MTU_SEGMENT_SIZE
/[NO]DELAY_ACK
/DROP_COUNT=n
/PROBE_TIMER=n
/QUOTA=options
/[NO]WINDOW_SCALE}

SET PROTOCOL UDP { /[NO]FORWARD
/QUOTA=options}