UCX NFS (UCP) SET — VMS UCX_1.3
Additional information available:
ARPCOMMUNICATIONHOSTINTERFACENAME_SERVICE
NETWORKNFS_SERVERROUTE
ARP
The SET ARP command is not normally used.
ARP (address resolution protocol) is used to map dynamically between
DARPA Internet and 10Mb/s Ethernet addresses. It is used by all the
10Mb/s Ethernet interface drivers.
The SET ARP command has two parameters. The first parameter is the
Ethernet address of the interface you wish to communicate to. The
second parameter specifies the host name on which the interface
resides. UCX will look up the internet address for the named host.
This parameter is optional. If you have not assigned a name to the
host, you must use the /ADDRESS qualifier.
Use the SET NOARP command to remove an Internet to Ethernet address
mapping.
Format:
SET [NO]ARP Ethernet_address [host_name]
Additional information available:
Explanation
ARP caches Internet-Ethernet address mappings every 3 minutes.
When an interface requests a mapping for an address not in the
cache, ARP queues the message which requires the mapping and
broadcasts a message on the associated network requesting the
address mapping. If a response is provided, the new mapping is
cached and any pending messages are transmitted. An interface
mapping request times out in twenty seconds.
There are two situations where the system manager may want to
manually provide mapping information.
A. ARP is running and a change has been made to a network
interface on some host. In this case, the system manager
would want to flush the Internet-Ethernet mapping tables so
that the new address change can be made known to the system.
B. One of the host systems which you want to communicate with
does not support ARP; therefore, you must map Internet to
Ethernet addresses manually.
/ADDRESS
Specifies the internet address of the host on which the target
interface resides.
Format:
SET [NO]ARP Ethernet_address [host_name]/ADDRESS=Internet_address
/PERMANENT
Format:
SET [NO]ARP Ethernet_address [host_name]/[NO]PERMANENT
Specifies that the ARP mapping is to be made permanent in the
internet driver's ARP tables. This is the default. Specify
/NOPERMANENT to remove ARP mapping.
/PUBLIC
Format:
SET [NO]ARP Ethernet_address [host_name]/[NO]PUBLIC
Specifies that the ARP code should respond to ARP requests for the
indicated host coming from other machines. This is the default.
Specify /NOPUBLIC if you want the mapping information to be
defined only on the local host.
COMMUNICATION
The SET COMMUNICATION command is used to set Internet software
parameters for communication on the local host.
Format:
SET COMMUNICATION
Additional information available:
/BROADCAST/CHECKSUM/CLUSTER_TIMER/DEVICE_SOCKETS
/FORWARD/IRP/LARGE_BUFFERS/LOCAL_HOST/REASSEMBLY_TIMER
/SMALL_BUFFERS/TCP_QUOTA/UDP_QUOTA
/BROADCAST
Used by the system manager to give a nonprivileged user the ability
to send broadcast packets over the network.
Format
SET COMMUNICATION /[NO]BROADCAST
/CHECKSUM
Use this qualifier to enable/disable checksum validation of messages.
There are three options:
[NO]IP Checksum validation is to be performed at the IP level
[NO]TCP Checksum validation is to be performed for TCP messages
[NO]UDP Checksum validation is to be performed for UDP messages
The default is that checksum validation is to be performed for all
messages.
Format:
SET COMMUNICATION /CHECKSUM=option_list
/CLUSTER_TIMER
A cluster can be thought of as a chain of hosts which respond to
internet messages. The cluster_timer specifies the maximum number
of minutes in which a particular host in the chain has before the
message is passed to the next host.
Format:
SET COMMUNICATION /CLUSTER_TIMER=number
/DEVICE_SOCKETS
Specifies the maximum number of device_sockets
Format:
SET COMMUNICATION /DEVICE_SOCKETS=number
/FORWARD
Specifies whether or not IP messages are to be forwarded.
Format:
SET COMMUNICATION /[NO]FORWARD
/IRP
The VMS/ULTRIX Connection Internet driver is serviced by the VMS
Ethernet driver through request packets that are allocated from VMS
nonpaged pool.
The /IRP qualifier specifies quotas for the number of internet
request packets.
NOTE: If the number of Internet Request Packets in the system has
reached the quota, the process that is serviced by the
Internet driver is either put in a wait stat (resource mode
wait is enabled), or the I/O request is aborted with an
SS$_EXQUOTA status.
There are two options:
MAXIMUM:number Specifies the maximum number of IRPs which will be
allocated by the Internet driver.
FREE:number The Internet driver maintains a cache of free IRPs.
This option is used to set the size of this cache.
When the Internet driver is started, it will
preallocate the specified number of IRPs from VMS
nonpaged pool.
Format:
SET COMMUNICATION /IRP=option_list
/LARGE_BUFFERS
The Internet software maintains a set of large buffers to be used
for storing data. There are two types; static and dynamic.
Static buffers are allocated when the Internet software is started
and not deallocated until a STOP COMMUNICATION command is issued.
Dynamic buffers are additional buffers that the software may
require in order to hold messages before they can be processed.
The number of buffers used depends on the load on the Internet
software. Failure to specify enough buffers will result in
messages being dropped at peak loads. A large buffer is 1536
bytes in length.
There are two options for setting large buffers
MIN:number Specifies the number of static buffers
MAX:number Specifies the total static and dynamic buffers.
Format:
SET COMMUNICATION /LARGE_BUFFERS=option_list
/LOCAL_HOST
Specifies the local host name.
Format:
SET COMMUNICATION /[NO]LOCAL=host_name
/REASSEMBLY_TIMER
Specifies the maximum amount of time which will be spent trying
to reassemble a message which was received from the network
if the message had to be fragmented.
Format:
SET COMMUNICATION /REASSEMBLY_TIMER=number
/SMALL_BUFFERS
The Internet software maintains a set of small buffers to be used
for storing control information. There are two types; static and
dynamic. Static buffers are allocated when the Internet software
is started and not deallocated until a STOP COMMUNICATION command
is issued. Dynamic buffers are additional buffers that the
software may require in order to hold messages before they can be
processed. The number of buffers used depends on the load on the
Internet software. Failure to specify enough buffers will result
in messages being dropped at peak loads.
A small buffer is 128 bytes in length. Typically, you would want
to allocate 3 times more small buffers than large buffers.
There are two options for setting large buffers
MIN:number Specifies the number of static buffers
MAX:number Specifies the total static and dynamic buffers.
Format:
SET COMMUNICATION /SMALL_BUFFERS=option_list
/TCP_QUOTA
Specifies the queue size (in bytes) for TCP messages
There are two options
RECEIVE:number Specifies the receive queue size
SEND:number Specifies the send queue size
Format:
SET COMMUNICATION /TCP_QUOTA=option_list
/UDP_QUOTA
Specifies the queue size (in bytes) for UDP messages
There are two options
RECEIVE:number Specifies the receive queue size
SEND:number Specifies the send queue size
Format:
SET COMMUNICATION /UDP_QUOTA=option_list
HOST
This command is used to define or modify the host database on
the local system. It provides maintenance for both the local
and remote hosts. In terms of the ULTRIX environment, this
would involve the maintenance of the /etc/hosts file.
Use SET NOHOST to remove one or more hosts from the network.
Format:
SET [NO]HOST host_name
Additional information available:
/ADDRESS
Defines the Internet address of a particular host.
Format:
SET HOST host_name /ADDRESS=Internet_address
/ALIAS
An alias is a means of referencing a host by several different host
names. This is provided for convenience.
Use the /NOALIAS qualifier to delete all or any particular aliases.
This qualifier is not available for SET NOHOST
Format:
SET HOST host_name /[NO]ALIAS=[host_name_list]
/CONFIRM
Use the /NOCONFIRM qualifier to disable confirmation before removal
of a host record.
Format:
SET NOHOST host_name /[NO]CONFIRM
INTERFACE
This command is used to define the communication interface(s)
residing on the local host. The interface is defined
by associating an Internet address with the interface name.
In terms of the ULTRIX environment, this command implements
the IFCONFIG utility and involves the maintenance of the
following files:
/etc/rc
/etc/rc.local
The system manager can use this command either to define a new
network interface, or modify the parameters of an existing
interface.
Use the SET NOINTERFACE command to remove a communication
interface from the network.
The supported internet device names are: DE, QE, SE, and NI.
Format:
SET [NO]INTERFACE Internet_device_name
Additional information available:
/ACTIVE/ADDRESS/ARP/BROADCAST_MASK/C_ADDRESS
/C_BROADCAST_MASK/C_NETWORK_MASK/CLUSTER/HOST
/LOOPBACK/NETWORK_MASK/TRAILER/RECEIVE_BUFFERS
/ACTIVE
Sets the state of the interface to active or inactive. If the
interface is given an address via the /HOST or /ADDRESS
qualifiers, then the default is /ACTIVE, otherwise the default
is /NOACTIVE.
Format:
SET INTERFACE Internet_device /[NO]ACTIVE
/ADDRESS
Specifies the Internet address of the local host which will be
using this interface in order to communicate via the Ethernet.
This qualifier cannot be used with the /HOST qualifier
Format:
SET INTERFACE Internet_device /ADDRESS=internet_address
/ARP
See SET ARP for a description of the Address Resolution Protocol.
The /NOARP qualifier would not normally be used.
Use this qualifier to enable or disable Internet-Ethernet
address mapping between network level addresses and link level
addresses. The default is that ARP will be used.
Format:
SET INTERFACE Internet_device /[NO]ARP
/BROADCAST_MASK
A broadcast address has a special meaning: whenever a message is
transmitted to the broadcast address, every system on the network
which specifies this address as its broadcast_mask will receive the
message.
The /BROADCAST_MASK qualifier is the means by which the broadcast
address is made known to the network interface.
Format:
SET INTERFACE Internet_device /BROADCAST_MASK=Internet_address
/C_ADDRESS
A VAXcluster can be configured so that the whole cluster appears
to remote network hosts as though it were a single host.
This is implemented by means of the Internet routing mechanism.
The Internet VAXcluster is identified by a host name (see /CLUSTER)
or a cluster address, and must be activated on each of the
hosts that will comprise the Internet VAXcluster. Not all members
of a VAXcluster need participate in the Internet VAXcluster.
Use the /C_ADDRESS qualifier to specify the address of the cluster
host.
This qualifier cannot be used with /CLUSTER
Format:
SET INTERFACE Internet_device /C_ADDRESS=Internet_address
/C_BROADCAST_MASK
Specifies the cluster broadcast address
Format:
SET INTERFACE Internet_device /C_BROADCAST_MASK=Internet address
/C_NETWORK_MASK
Specifies the cluster network mask
Format:
SET INTERFACE Internet_device /C_NETWORK_MASK=Internet address
/CLUSTER
The Internet VAXcluster is identified by a host name or a cluster
address (see /C_ADDRESS), and must be activated on each of the
hosts that will comprise the Internet VAXcluster. Not all members
of a VAXcluster need participate in the Internet VAXcluster.
The /CLUSTER qualifier specifies the cluster host name. A value
is required, and cannot be used in combination with the /C_ADDRESS
qualifier.
Suppose that there are two members of a VMS cluster; BRKLYN,
GOLDEN, and the Internet VAXcluster host name is DWHOAN. First,
the system manager would use the SET HOST command to define each
cluster member (BRKLYN and GOLDEN), as well as the cluster name,
DWHOAN. Next, the system manager would use the /CLUSTER qualifier
when defining the Internet interface of each of the Internet
VAXcluster members.
For example: SET INTERFACE se /HOST=brklyn /CLUSTER=dwhoan
The /NOCLUSTER qualifier is used to disable Internet cluster
processing on the specified interface. It does not take a value,
and can not be specified with any other qualifier.
NOTE: If /NOCLUSTER is specified, active communication will be
aborted for any applications which were bound to the cluster
alias name.
Format:
SET INTERFACE Internet_device /CLUSTER=host_name or
SET INTERFACE Internet_device /NOCLUSTER
/HOST
Specifies the name of the local host which will be using
this interface in order to communicate via the Ethernet.
Format:
SET INTERFACE Internet_device /HOST=host_name
/LOOPBACK
Specifies that the interface is to perform loopback communication.
In loopback communication, data packets are sent out and received
on the same interface without going over the network. Loopback
communication allows the system manager to test the network
software on the local host without affecting the rest of the
network.
If the interface is already active the system manager must first
deactivate the interface by using the SET INTERFACE/NOACTIVE
command. Next, select loopback testing by issuing the
SET INTERFACE/LOOPBACK command, and finally activate the
interface using the SET INTERFACE/ACTIVE command.
The default is /NOLOOPBACK.
Format:
SET INTERFACE Internet_device /[NO]LOOPBACK
/NETWORK_MASK
Defines the interface's network mask
Format:
SET INTERFACE Internet_device /NETWORK_MASK=Internet_address
Additional information available:
Explanation
The network mask specifies how much of the host field of an Internet
address is to be reserved for the subnetwork part of the address.
This mask is specified in the same format as an Internet address in
that there are four fields.
field.field.field.field
The value of each of these fields is usually either 255 or zero. Each
field of the network_mask which has a value of 255 tells the system to
interpret the corresponding host field of the Internet address as a
subnetwork address. Each field of the network_mask which has a value
of zero tells the system to interpret the corresponding host field of
the Internet address as a host address.
The number of fields in the Internet address that make up the network
identification is determined by the Internet address class type.
For example, if the Internet address is class B, the first two fields
refer to a network number, and the last two fields refer to a
subnetwork or a host. If the network mask is 255.255.255.0, then the
entire Internet address will be interpreted as having the first two
fields refer to the network, the next field refers to the subnetwork,
and the last field refers to the host.
NOTE: Every host on the same network must have the same network_mask.
/TRAILER
The /TRAILER qualifier enables the use of a trailer link level
encapsulation when sending a message. If a network interface supports
trailers, the system when possible, encapsulates outgoing messages in
a manner that minimizes the number of memory-to-memory copy operations
performed by the receiver.
In order to use trailer encapsulation, all systems involved must
support the trailer protocol.
Setting /NOTRAILER disables the encapsulation.
/NOTRAILER is the default.
Format:
SET INTERFACE Internet_device /[NO]TRAILER
/RECEIVE_BUFFERS
Specifies the number of buffers that are pre-allocated by the VMS
Ethernet driver for receiving Internet packets on the interface. It
It has a range of 1 to 255. The default is 10.
Format:
SET INTERFACE Internet_device /RECEIVE_BUFFERS=number
NAME_SERVICE
This command is used to configure the BIND name resolver. The
/SYSTEM qualifier is used to modify system wide parameters
These parameters are:
ENABLE Allows UCX applications access to the BIND resolver
DISABLE Disallows BIND resolver access
DOMAIN Used to define the local domain
SERVER Used to define the known servers
TRANSPORT Used to select the communication transport
If the /SYSTEM qualifier is not specified, then modification to the
BIND resolver parameters will be used by the current process only.
The parameters which may be specified without the /SYSTEM qualifier
are:
DOMAIN
SERVER
TRANSPORT
NOTE: the BIND resolver cannot be enabled if the SERVER and
DOMAIN system parameters have not been defined.
Additional information available:
DOMAINDISABLEENABLESERVERTRANSPORT
DOMAIN
Used to specify the local DOMAIN.
Use the /NODOMAIN qualifier to delete your process definition (and
therefore, reset to the system definition for the local domain).
The /NODOMAIN qualifier cannot be used with the /SYSTEM qualifier
Format
SET NAME_SERVICE /[NO]DOMAIN="x.y.z"
DISABLE
Disables the BIND resolver. This qualifier may be specified only with
the /SYSTEM qualifier.
Format:
SET NAME_SERVICE /DISABLE/SYSTEM
ENABLE
Enables the BIND resolver. This qualifier may be specified only with
the /SYSTEM qualifier.
Format:
SET NAME_SERVICE /ENABLE/SYSTEM
SERVER
Defines the BIND servers to which requests will be made. The order
in which you specify the servers determines server preference. For
example, the first server in the list will be accessed first. If
that server does not respond, then a request will be sent to the
second server in the list, and so on.
A server may be specified by its name or its address; however, if
the server is specified by name, that name must be registered in the
local UCX$HOST database.
If a server list is already defined, then new servers specified with
the /SERVER qualifier will be appended to the end of the list.
Use the /NOSERVER qualifier to delete one or more servers from the
list. Use /NOSERVER without a value to delete all servers from the
list; however, this form of the qualifier cannot be specified with
the /SYSTEM qualifier. There must be at least 1 system server defined.
Format:
SET NAME_SERVICE /[NO]SERVER=(server1, server2)
TRANSPORT
Use the /TRANSPORT qualifier to change the Internet protocol used to
communicate with the BIND resolver.
The supported protocols are TCP and UCP. The default is UDP.
Format:
SET NAME_SERVICE /TRANSPORT=protocol
NETWORK
This command allows the system manager to assign a network name to a
network number. This function implements the ULTRIX /etc/networks
file.
Use SET NONETWORK to remove 1 or more hosts from the network.
Format:
SET [NO]NETWORK network_name
Additional information available:
/ADDRESS
Specifies the internet address for the named network.
Format:
SET NETWORK network_name /ADDRESS=internet_address
/ALIAS
An alias is a means of referencing a network by several different
network names. This is provided for convenience.
Use the /NOALIAS qualifier to delete any or all alias names for the
network.
The /ALIAS qualifier is not available for SET NONETWORK
Format:
SET NETWORK network_name /[NO]ALIAS=network_name[,...]
/CONFIRM
Use the /NOCONFIRM qualifier to disable confirmation before removal
of a network record. The default is /CONFIRM for a wildcarded
delete.
Format:
SET NONETWORK network_name /[NO]CONFIRM
NFS_SERVER
The SET NFS_SERVER command is used to modify the characteristics of
the active NFS server. The NFS server must first have been started
by running SYS$MANAGER:UCX$NFS_STARTUP.COM.
Format:
SET NFS_SERVER
Additional information available:
/DISABLE/ENABLE/GID_DEFAULT/INACTIVITY_TIMER/THREADS
/UID_DEFAULT/XID
/DISABLE
This qualifier is used to disable reporting. There are two options:
ERROR Disables error logging
OPCOM Disables reporting to operator console
Format:
SET NFS_SERVER /DISABLE=reporting_list
/ENABLE
This qualifier is used to enable reporting. There are two options:
ERROR Enables error logging
OPCOM Enables reporting to operator console
Format:
SET NFS_SERVER /ENABLE=reporting_list
/GID_DEFAULT
Specifies the GID associated with the superuser.
Format:
SET NFS_SERVER /GID_DEFAULT=gid
/INACTIVITY_TIMER
The INACTIVITY_TIMER specifies that opened files will be closed
if they are not accessed within the specified period of time. The
The time unit is expressed as MM:SS, where MM is minutes and SS is
seconds.
Format:
SET NFS_SERVER /INACTIVITY_TIMER=MM:SS
/THREADS
Specifies the maximum number of simultaneous requests which can be
processed by the NFS server.
Format:
SET NFS_SERVER /THREADS=number
/UID_DEFAULT
Specifies the UID associated with the superuser.
Format:
SET NFS_SERVER /UID_DEFAULT=uid
/XID
Specifies the maximum buffer allocation for XID (transmission request
identifier) caching.
Format:
SET NFS_SERVER /XID=number
ROUTE
The SET ROUTE command is not normally used. This command is the means by which static (or dynamic) host or network routing is provided. Use this command to force a specific routing path to the specified host or network. Use the SET NOROUTE command to remove static (or dynamic) routing information. The database to be modified (static or dynamic) changes depending on the state of the Internet software. If dynamic routing is active, then the default is to modify the dynamic routing tables. If the /PERMANENT qualifier is used, or the Internet is not active, then the UCX$ROUTE static database will be modified.
Additional information available:
/ADDRESS/DEFAULT/G_ADDRESS/GATEWAY/NETWORK/PERMANENT
Explanation
Suppose you have the following network configuration:
--------------------------------
HOST Internet ADDRESS
--------------------------------
BRKLYN 100.45
GOLDEN 100.42
GOLDEN_GATE 101.42
DWHOAN 101.81
Suppose further that you would like to send a message from BRKLYN,
which resides on network 100 to DWHOAN, which resides on network 101.
It is possible to provide this specific route because on network 100,
GOLDEN_GATE is a gateway to network 101. You make this route known to
the system by issuing the following command from the local host,
BRKLYN:
SET ROUTE DWHOAN /GATEWAY=GOLDEN_GATE
This function implements the ULTRIX /etc/route file
Format:
SET [NO]ROUTE [destination]
For UCX V1.3 and later releases:
1. The destination parameter may take a name or an address as
a value.
2. The /GATEWAY qualifier may take a name or an address as a
value.
/ADDRESS
Specifies the destination internet address. This may be the address
of either a host or a network. UCX will determine whether this
address is for a host or network.
Format:
SET [NO]ROUTE /ADDRESS=destination internet_address
This qualifier is not needed for UCX V1.3 and later releases.
The destination address may be specified in the destination parameter.
/DEFAULT
Specifies the "default route". If all attempts to send packets to
a destination fail, then the packets will be sent to the named
gateway.
This qualifier cannot be used with the DESTINATION parameter or
/ADDRESS qualifier.
Format:
SET [NO]ROUTE /DEFAULT /GATEWAY=gateway
/G_ADDRESS
Specifies the gateway internet address. You should either use the
/G_ADDRESS or the /GATEWAY qualifier to identify the gateway
host.
Format:
SET [NO]ROUTE [destination_name] /G_ADDRESS=gateway internet_address
This qualifier is not needed for UCX V1.3 and later releases.
The gateway address may be specified with the /GATEWAY qualifier.
/GATEWAY
Specifies the gateway host name or address. If a name is specified,
it must first have been defined by using the SET HOST command.
Format:
SET [NO]ROUTE [destination] /GATEWAY=gateway name or address
/NETWORK
Use this qualifier to identify a destination route to be a network
route whenever the route is specified using an Internet address.
UCX classifies the internet address - based solely on internet rules.
For example, the address 128.45.2.0 is assumed to be a host address.
If the network mask is 255.255.255.0, this is an incorrect
classification.
Use the /NETWORK qualifier in order to specify that the route is for
a network destination.
Format:
SET ROUTE destination_internet_address /NETWORK
/GATEWAY=gateway_name
/PERMANENT
This qualifier is used to specify that the static route database is
to be modified.
If dynamic routing is active, the default is for the SET ROUTE command
to modify the dynamic routing database.
Format:
SET ROUTE destination /GATEWAY=gateway /PERMANENT