Enables or disables checksum calculations. Specify one or two of the following:
RECEIVE | Enables checksum calculations on receive |
NORECEIVE | Disables checksum calculations on receive |
SEND | Enables checksum calculations on send |
NOSEND | Disables checksum calculations on send |
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 |
Enables or disables a delay before sending acknowledgments:
/DELAY_ACK | ACKs are generated with a delay. |
/NODELAY_ACK | ACKs are generated without any delay. |
Maximum number of seconds to probe for idle TCP connections before a TCP connection close times out.
Number of seconds between probes for idle TCP connections. Also indicates the maximum number of seconds before a TCP connection request times out.
There are two options:
Queue size (in bytes) for messages.
The options for setting TCP message queue size are:
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.
/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 privileges.
Sun RPC applications use broadcast messages and need privilege checking disabled.
/CHECKSUM=option
Optional.There are two options:
- [NO]RECEIVE --- Enables or disables checksum calculations on receive.
- [NO]SEND --- Enables or disables checksum calculations on send.
/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.
#1
UCX> SET PROTOCOL IP /FORWARD
Sets IP to forward messages to other hosts, including other internet cluster nodes.
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.
When you issue SET NOROUTE, you are running dynamic routing. You have the following restrictions:
- You can add routes.
- You cannot use SET NOROUTE to remove a route that is maintained by the route daemon.
- To have full manual control over your routing table, first issue STOP ROUTING and then use SET NOROUTE.
- SET NOROUTE does not require any qualifiers.
Related commands: SHOW ROUTE, STOP ROUTING
Applies to: Routing
Note
DIGITAL strongly recommends that you do not specify alias names with the destination parameter or the /GATEWAY=host qualifier.
SET [NO]ROUTE destination {/[NO]CONFIRM | /DEFAULT_ROUTE | /GATEWAY=host | /NETWORK | /PERMANENT}
Requires OPER privileges if:
- The internet is active.
- The routes database requires read and write access.
destination
Required unless you specify /DEFAULT_ROUTE.Host or network through which to route packets. Specify one:
- A host, as it is defined in the hosts database
- A network, as it is defined in the networks database
Not valid with /ADDRESS or /DEFAULT_ROUTE.
/CONFIRM
NOCONFIRM
Optional. Default: /CONFIRM if you use a wildcard.When the software encounters a problem, it displays a description and solution and then requests confirmation before deleting each record. Enter one of the following:
- Y to repair the problem
- N to ignore the problem
- G to change to NO CONFIRMATION mode
Example:
%UCX-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]:/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.Gateway for the route. Necessary to send packets to a host on another network.
/NETWORK
Optional. Defaults:
- Destination is classified based on its Internet network class --- A, B, or C.
- If the address is clearly a network number, SET ROUTE interprets the number correctly.
Defines the route as a network route.
Required when you also specify /ADDRESS and the route is a network route.
Use this qualifier if the network number could be misinterpreted as an IP host address, for example, if a network mask is nonstandard or the IP address is abbreviated.
/PERMANENT
Optional. Defaults:If the network is not active, the permanent routes database is changed. If the network is active, the volatile routes database is changed.
Changes only the permanent routes database.
#1
UCX> SET ROUTE DODO /GATEWAY=RHEA
#2Defines a route for local host DODO to send packets.
UCX> SET ROUTE 101.81 /GATEWAY=100.42
#3Defines a gateway for routing packets for the host with IP address 101.81.
UCX> SET ROUTE 100.45.0 /GATEWAY=REMOTE /NETWORK
#4Sets a route through the network whose IP address is 100.45.0.
UCX> SET ROUTE /DEFAULT /GATEWAY=DEFGATE /PERMANENT
Sets a default route with host DEFGATE as the default gateway. Adds the definition to the permanent routes database.
Defines a service in the services database or modifies an existing entry.You cannot modify the following fields:
- service
- /ADDRESS
- /PORT
- /PROCESS_NAME
- /PROTOCOL (except for the optional settings)
To make changes to these fields, delete the record with SET NOSERVICE and then re-create it.
Note
There is no RCP service. RCP uses the RSH server process.
Related command: SHOW SERVICE
SET [NO]SERVICE service* {/FILE=startup_file* | /PORT=n* | /PROCESS_NAME=process* | /USER_NAME=vms_user_account*} [/ACCEPT=options | /ADDRESS=IP_address | /FLAGS=options | /INACTIVITY_TIMER=n | /LIMIT=n | /LOG_OPTIONS=options | /PROTOCOL=protocol=options | /REJECT=options | /RPC=values | /SEPARATOR=option | /SOCKET_OPTIONS=options]
* Required for SET SERVICE; optional for SET NOSERVICE.
- DIGITAL strongly suggests that, for the UCX-provided services, you do not use this command to reset:
- The required qualifiers
- The /FLAGS qualifier, except for APPLICATION_PROXY and CASE_INSENSITIVE
- SET NOSERVICE without a specified service or specified qualifiers deletes all entries for all services.
- Requires write access to the directory with the services database.
service
Required.Service you want to enter into the services database. Specify a string of up to 10 characters.
/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
- /ACCEPT=NOHOST=host removes access to the service for a host that previously gained access with /ACCEPT=HOST.
You can use wildcards. The following options are available:
Option Meaning HOSTS= hosts Makes the service available to the specified hosts.
Denies to all other hosts access to the service.
Maximum is 32. Example:/ACCEPT=HOSTS=( host1_name, host2_name, host3_address) NOHOSTS= hosts Removes the specified hosts from the accept list so they cannot gain access to the service.
Maximum is 32. Example:/ACCEPT=NOHOSTS=( host1_name, host2_name, host3_address) NETWORKS= networks Makes the service available to the specified networks. Denies access to the service to all other networks.
Maximum is 16.
For each network, you can optionally specify the network mask. The default net mask equals network's class number. For example, for the network 11.200.0.0., the default mask is 255.0.0.0. Example:/ACCEPT=NETWORKS=( net1_name, net2_address, net3: net3mask) NONETWORKS[= networks] Removes the specified networks from the accept list so they cannot gain access to the service.
Maximum is 16.
For each network, you can optionally specify the network mask. The default net mask equals network's class number. For example, for network 11.200.0.0., the default mask is 255.0.0.0. Example:/ACCEPT=NONETWORKS=( net1_name, net2_address , net3: net3mask) /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. A reason to duplicate a service name, for example, is that your local host has three interfaces, and you want to make a service available on two of them. Each service-interface pair must be unique.
/FILE=startup_file
Required.Name of the service's startup command file.
/FLAGS= {[NO]APPLICATION_PROXY | [NO]MULTITHREAD | [NO]PROXY | [NO]CASE_INSENSITIVE}
Optional.The flag options are:
- [NO]APPLICATION_PROXY. Default: NOAPPLICATION_PROXY.
The service does its own proxy checking.
Applies to Remote Shell (RSH) and Line Printer Daemon (LPD).
Note
The ROOT account does not require a communication proxy in the proxy database. The setting of /FLAGS=APPLICATION_PROXY flag is not relevant.
- [NO]MULTITHREAD. Default: NOMULTITHREAD.
While connecting a socket to a remote host and passing the socket to the requested server, the auxiliary server continues to listen for incoming requests.
Use with the LISTEN option on UDP sockets.- [NO]PROXY. Default: NOPROXY.
User account information is from the proxy database.- [NO]CASE_INSENSITIVE. Default: CASE_INSENSITIVE.
Case sensitivity of the remote user name in the proxy database.
Use with /PROXY./INACTIVITY_TIMER=n
Optional.Number of minutes that the service can be idle, at which time it is terminated.
Valid for services not marked as LISTEN.
/LIMIT=n
Optional.Maximum number of copies of the requested service allowed to run on the system. If the maximum number is reached, any additional requests for the service are rejected.
/LOG_OPTIONS=([FILE=file], [[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 | [NO]TIMEOUT] )
Optional.
- For the service you are configuring, defines the file to which event-logging messages are written.
- For the service you are configuring, sets the specified logging options.
- To modify the defaults for these options, issue SET COMMUNICATION /ALLOW_LOG_OPTIONS /FORCE_LOG_OPTIONS qualifier).
The options have the following meanings:
/PORT=n
Required.Port number that the service will use. Specify a number from 1 to 65535.
/PROCESS_NAME=process
Required.Name of the service's process.
Specify a character string up to 15 characters long, truncated to 15 bytes, if necessary.
/PROTOCOL=protocol [=options]
Optional. Default: TCP.Protocol, and its parameters, that the service will use. To set these parameters, use the following options.
Protocol Option Meaning IP TYPE_OF_SERVICE= n Type of service, expressed as a value between 0 and 255. TIME_TO_LIVE= n Maximum number of hops that packets can traverse before being dropped. TCP
(Stream socket type)[NO]DELAY_ACK Delays the sending of acknowledge (ACK) packets.
Default: DELAY.DROP_TIMER= seconds TCP connection-request timeout interval for the service.
(Maximum number of seconds to probe for idle TCP connections before such a connection times out and closes.)PROBE_TIMER= seconds Number of seconds between probes for idle connections. UDP None Datagram socket type /REJECT {=[NO]HOSTS=(hosts ) | =[NO]NETWORKS=(networks )} [[NO]MESSAGE="text"]
Optional. Default: No rejections if /ACCEPT is set to its default (service all hosts).
- /REJECT=HOST=host denies host access to the service.
- /REJECT=NOHOST=host re-grants host access to the service.
- You can use wildcards.
- The following options are available.
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.
Maximum is 32. Examples:/REJECT=NOHOSTS=( host1_name, host2_name, host3_address) /REJECT=NOHOSTS=* NETWORKS= networks Makes the service unavailable to the hosts on the specified networks.
Maximum is 16.
For each network, you can optionally specify the network mask. The default net mask equals network's class number. For example, for network 11.200.0.0., the default mask is 255.0.0.0. Example:/REJECT=NETWORKS=( net1_name, net2_address, net3: net3mask) NONETWORKS[= networks] Removes the specified networks from the reject list.
Maximum is 16.
For each network, you can optionally specify the network mask. The default net mask equals network's class number. For example, for network 11.200.0.0., the default mask is 255.0.0.0. Example:/REJECT=NONETWORKS=( net1_name, net2_address, net3: net3mask) [NO]MESSAGE= text
NOMESSAGEMessage sent to "reject-list" clients when UCX rejects their request for the service.
Optional.
Specify a character string up to 63 characters.
Enclose the string in quotation marks.
Use this option only for a service whose clients require and support reject messages.
Messages are sent with a carriage return/line feed at the end.
For RLOGIN, RSH, and REXEC, this message is preceded by a byte with a value of 1 and terminated with a byte with a value of 0.
/REJECT=NOMESSAGE deletes the stored message text./RPC=(PROGRAM_NUMBER=n, VERSION_NUMBER=(LOW=n, HIGH=n))
Required for services that use the Portmapper; otherwise, not valid. Defaults:
- MOUNT
- PROGRAM_NUMBER=100005
- VERSION_NUMBER=(LOWEST=1, HIGHEST=1)
- NFS server
- PROGRAM_NUMBER=100003
- VERSION_NUMBER=(LOWEST=2, HIGHEST=2)
- PCNFSD
- PROGRAM_NUMBER=150001
- VERSION_NUMBER=(LOWEST=1, HIGHEST=2)
- PORTMAPPER
- PROGRAM_NUMBER=100000
- VERSION_NUMBER=(LOWEST=1, HIGHEST=1)
Information that identifies the service to the Portmapper. Use this qualifier for all applications that use RPCs.
/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
NOBROADCASTSockets are UDP broadcast.
Sockets are not UDP broadcast.Null character (hexadecimal 00) KEEPALIVE
NOKEEPALIVESockets are TCP keepalive.
Sockets are not TCP keepalive.Null character (hexadecimal 00) RECEIVE Receive socket quota. Null character (hexadecimal 00) SEND Send socket quota. Null character (hexadecimal 00) /USER_NAME=vms_user_account
Required.OpenVMS account information for users working on client systems. Required for a user to access the UCX service.
The user must also be defined in the system user authorization file (SYSUAF.DAT).
#1
UCX> SET SERVICE MOUNT - _UCX> /RPC=(PROGRAM_NUMBER=100044, VERSION_NUMBER=(LOWEST=2, HIGHEST=2))
#2Identifies the MOUNT service to the Portmapper and makes available the MOUNT service's RPC information.
UCX> SET SERVICE TOE /USER_NAME=LITTLE_PIGGY - _UCX /PROCESS_NAME=TOEd /PORT=1050 /PROTOCOL=UDP - _UCX /FILE=SYS$COMMON:[SYSMGR]TOE_STARTUP.COM
#3Defines the service TOE, which implements UDP on port 1050. This service has the OpenVMS process context of user LITTLE_PIGGY.
After you issue an ENABLE SERVICE TOE command, the auxiliary server executes TOE_STARTUP.COM when a request comes in for service TOE.
UCX> SET SERVICE LPD - _UCX> /REJECT=NETWORK=(11.30.0.0:255.255.0.0, 11.40.0.0)
#4Sets the LPD service to be inaccessible to the two specified networks.
UCX> SET SERVICE FTP - _UCX> /LOG_OPTIONS=(FILE=SYS$SYSDEVICE:[UCX$FTP]MY_FTPD_LOG.LOG, NOACCEPT,CONNECT)
#5For the FTP service:
- Defines its event-logging file as SYS$SYSDEVICE:[UCX$FTP]MY_FTPD_LOG.LOG
- Specifies that a message is not to be logged when a request is accepted
- Sets messages to be logged when the auxiliary server issues a connect request back to the client
UCX> SET SERVICE RSH /FLAGS=(PROXY,CASE_INSENSITIVE)
Previous | Next | Contents