Compaq TCP/IP Services for OpenVMS
Management Command Reference

SET SERVICE

Defines a new entry in the services database or modifies an existing entry.
Related command: SHOW SERVICE

Format

SET [NO]SERVICE service
{ /FILE=startup_file*
/PORT=n*
/PROCESS_NAME=process*
/USER_NAME=vms_user_account* }
[ /ACCEPT=options ]
[ /ADDRESS=IP_address ]
[ /FLAGS=options ]
[ /LIMIT=n ]
[ /LOG_OPTIONS=options ]
[ /PROTOCOL=protocol=options ]
[ /REJECT=options ]
[ /RPC=values ]
[ /SEPARATOR=option ]
[ /SOCKET_OPTIONS=options ]

restrictions

You cannot modify the following fields in an existing entry:

service
/ADDRESS
/PORT
/PROCESS_NAME
/PROTOCOL (except for the optional settings)

To make changes to these fields, use SET NOSERVICE to delete the entry and then re-create the entry.

Note
There is no RCP service. RCP uses the RSH server process.

Compaq strongly suggests that, for the services provided by TCP/IP Services, you do not use this command to reset the following:

The required qualifiers
The /FLAGS qualifier, except for the APPLICATION_PROXY and CASE_INSENSITIVE options

Using SET NOSERVICE without either a specified service or specified qualifiers deletes all entries for all services.
Requires write access to the directory with the services database.

Parameters

service
Required for SET SERVICE; optional for SET NOSERVICE.
Service you want to enter into the services database. Specify a string of up to 10 characters.

Qualifiers

/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.
The following options are available:
Option Meaning
HOSTS= hosts
Makes the service available to the specified hosts.
Denies 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. You can specify a wildcard character (*) in place of the hosts list to remove all hosts from the accept list.
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 network 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. You can specify a wildcard character (*) in place of the networks list to remove all networks from the accept 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.
/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. This allows connections based on defined proxies.
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.
[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.

/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=
[ [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 ]
Sets the specified logging options for the service you are configuring.
The logging options have the following meanings:

Option Meaning

[NO]ACCEPT Message is logged when a request is accepted.

[NO]ACTIVATE Message is logged when the service is activated.

[NO]ADDRESS For auxiliary server messages and OpenVMS security events, the message displays the IP address as a host name. If host names are not relevant, Compaq recommends that you specify [NO]ADDRESS.

[NO]ALL Messages are logged for all events.

[NO]CONNECT Message is logged when the auxiliary server issues a connect request back to the client. The services that usually make this request (on a second socket) are remote shell and remote execute.

[NO]DEACTIVATE Message is logged when the service is being deactivated.

[NO]ERROR Message is logged when an error is detected while processing a request to the service.

[NO]EXIT_CLEANUP Message is logged when the service fails to complete startup (that is, the server did not assign the BG device, with logical name SYS$NET, or did not issue a C socket before exiting).

[NO]LOGIN Message is logged when a connected terminal server accepts a remote login request.

[NO]LOGOUT Message is logged when a connected terminal server terminates a connection.

[NO]MODIFY Message is logged when the active service is being modified.

[NO]REJECT Message is logged when a request is rejected.

/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 acknowledgment (ACK) packets.
Default: DELAY.

DROP_COUNT= 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 regrants host access to the service.

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. You can use the wildcard character (*) in place of the hosts list to remove all 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. You can use the wildcard character (*) in place of the networks list to remove all 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
NOMESSAGE Message sent to "reject-list" clients when TCP/IP Services 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 is 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:

Service Program Number Highest Version Lowest Version

MOUNT 100005 1 1

NFS server 100003 2 2

PCNFS 150001 1 2

PORTMAPPER 100000 1 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

NOBROADCAST Sockets are UDP broadcast.
Sockets are not UDP broadcast. Null character (hexadecimal 00)

KEEPALIVE

NOKEEPALIVE Sockets 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 service.
The user must also be defined in the system user authorization file (SYSUAF.DAT).

Option	Meaning
HOSTS= hosts	Makes the service available to the specified hosts. Denies 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. You can specify a wildcard character () in place of the hosts* list to remove all hosts from the accept list. 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 network 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. You can specify a wildcard character () in place of the networks* list to remove all networks from the accept 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. /ACCEPT=NONETWORKS=( net1_name, net2_address, net3: net3mask)

Option	Meaning
[NO]ACCEPT	Message is logged when a request is accepted.
[NO]ACTIVATE	Message is logged when the service is activated.
[NO]ADDRESS	For auxiliary server messages and OpenVMS security events, the message displays the IP address as a host name. If host names are not relevant, Compaq recommends that you specify [NO]ADDRESS.
[NO]ALL	Messages are logged for all events.
[NO]CONNECT	Message is logged when the auxiliary server issues a connect request back to the client. The services that usually make this request (on a second socket) are remote shell and remote execute.
[NO]DEACTIVATE	Message is logged when the service is being deactivated.
[NO]ERROR	Message is logged when an error is detected while processing a request to the service.
[NO]EXIT_CLEANUP	Message is logged when the service fails to complete startup (that is, the server did not assign the BG device, with logical name SYS$NET, or did not issue a C socket before exiting).
[NO]LOGIN	Message is logged when a connected terminal server accepts a remote login request.
[NO]LOGOUT	Message is logged when a connected terminal server terminates a connection.
[NO]MODIFY	Message is logged when the active service is being modified.
[NO]REJECT	Message is logged when a request is rejected.

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 acknowledgment (ACK) packets. Default: DELAY.
	DROP_COUNT= 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.

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. You can use the wildcard character () in place of the hosts* list to remove all 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. You can use the wildcard character () in place of the networks* list to remove all 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 NOMESSAGE	Message sent to "reject-list" clients when TCP/IP Services 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 is terminated with a byte with a value of 0. /REJECT=NOMESSAGE deletes the stored message text.

Service	Program Number	Highest Version	Lowest Version
MOUNT	100005	1	1
NFS server	100003	2	2
PCNFS	150001	1	2
PORTMAPPER	100000	1	1

Option	Description	Default
BROADCAST NOBROADCAST	Sockets are UDP broadcast. Sockets are not UDP broadcast.	Null character (hexadecimal 00)
KEEPALIVE NOKEEPALIVE	Sockets 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)

Examples

#1
TCPIP> SET SERVICE TOE /USER_NAME=LITTLE_PIGGY - _TCPIP /PROCESS_NAME=TOEd /PORT=1050 /PROTOCOL=UDP - _TCPIP /FILE=SYS$COMMON:[SYSMGR]TOE_STARTUP.COM

Defines the service TOE, which implements UDP on port 1050. This service has the OpenVMS process context of user LITTLE_PIGGY.
After you issue a SET SERVICE TOE command, the auxiliary server executes TOE_STARTUP.COM when a request arrives for service TOE.

#2
TCPIP> SET SERVICE LPD - _TCPIP> /REJECT=NETWORK=(11.30.0.0:255.255.0.0,11.40.0.0)

Sets the LPD service to be inaccessible to the two specified networks.

#3
TCPIP> SET SERVICE RSH /FLAGS=(PROXY,CASE_INSENSITIVE)

Sets the proxy and case-sensitivity flags for the RSH service.

SHOW ARP

Displays ARP information.
Related command: SET ARP

Format

SHOW ARP [host] [/[NO]LOCAL]

Parameters

host
Optional. Default: All hosts; same as specifying /NOLOCAL.
Specifies the host about which you want information.

Qualifiers

/LOCAL

/[NO]LOCAL
Optional. Default: /NOLOCAL.
If you either omit this qualifier or specify /NOLOCAL, the software checks the hosts database. If a lookup fails, it also checks the BIND resolver.
Limits name-to-address lookups to the local hosts database.

Examples

#1
TCPIP> SHOW ARP Cnt Flags Timer Host Phys Addr 1: UC 425 * 00-00-f8-40-ad-91 2: UC 60 150.110.4.191 08-00-2b-39-4b-40 3: UC 438 150.110.5.117 00-00-f8-8d-24-d4 4: UCS 878 150.110.5.109 00-00-f8-4f-f1-63 5: UCS 426 150.110.5.31 08-00-2b-a1-b1-93 7: UC 104 150.110.4.2 aa-00-04-00-6d-10

TCPIP> SHOW ARP  
                              
 
Cnt  Flags    Timer Host                     Phys Addr 
  1: UC        425  *                        00-00-f8-40-ad-91 
  2: UC         60  150.110.4.191            08-00-2b-39-4b-40 
  3: UC        438  150.110.5.117            00-00-f8-8d-24-d4 
  4: UCS       878  150.110.5.109            00-00-f8-4f-f1-63 
  5: UCS       426  150.110.5.31             08-00-2b-a1-b1-93 
  7: UC        104  150.110.4.2              aa-00-04-00-6d-10

Displays the contents of the ARP table.
The flags have the following meanings:

Flag Meaning

U Up, or in use

C Complete

S Stale

P Permanent

D Dead

Flag	Meaning
U	Up, or in use
C	Complete
S	Stale
P	Permanent
D	Dead

#2
TCPIP> SHOW ARP PARROT parrot (11.170.6.45) at O8-CC-2B-12-C2-BB

Displays IP address-to-hardware address mapping for host PARROT.

SHOW BOOTP

Displays client entries in the BOOTP database.
Related command: SET BOOTP

Format

SHOW BOOTP [ host ]
[ /HARDWARE=ADDRESS=hex_address ]
[ /LOCAL ]
[ /OUTPUT=file ]

Parameters

host
Optional. Default: Displays all entries.
Host entry you want to display.

Qualifiers

/HARDWARE=ADDRESS=hex_address
Optional. Default: None.
Identifies the entry by hardware address.
Specify the address as hh-hh-hh-hh-hh-hh.
/LOCAL
Optional. Default: The command checks the hosts database; if a lookup fails, it also checks the BIND resolver.
To display hardware-address/IP-identification matches, limits host-name-to-IP-address lookup for each entry in the BOOTP database to the local hosts database.
/OUTPUT=file
Optional. Default: Screen display.
Output is directed to the specified file.

Examples

#1
TCPIP> SHOW BOOTP MYNA /FULL Host: 17.22.222.255 myna Hardware Address: 07-06-2B-05-04-03 Network mask: 255.0.0.0 Type: Ethernet File: MYNA.SYS Time offset: 0 Vendor: Birds, Inc. Gateways: not defined Servers: Cookie: not defined IEN: not defined Impress: not defined Log: not defined LPR: not defined Name: owl.wise.mouser.edu Resource: not defined Time: not defined TCPIP>

TCPIP> SHOW BOOTP MYNA /FULL   
  
Host:         17.22.222.255   myna  
                                        Hardware Address: 07-06-2B-05-04-03  
Network mask: 255.0.0.0                          Type:    Ethernet  
File:         MYNA.SYS  
  
Time offset:            0               Vendor: Birds, Inc.  
  
Gateways:     not defined  
  
Servers:  
 Cookie:      not defined  
 IEN:         not defined  
 Impress:     not defined  
 Log:         not defined  
 LPR:         not defined  
 Name:        owl.wise.mouser.edu  
 Resource:    not defined  
 Time:        not defined  
TCPIP>

Displays the entry for client myna in the BOOTP database. When myna requests a download, TCP/IP Services sends system image MYNA.SYS.

Contents

Index

Compaq TCP/IP Services for OpenVMS
Management Command Reference

SET SERVICE

Format

restrictions

Parameters

service

Qualifiers

/ACCEPT {=[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks)}

/ADDRESS=IP_address

/FILE=startup_file

/FLAGS= {[NO]APPLICATION_PROXY | [NO]MULTITHREAD | [NO]PROXY | [NO]CASE_INSENSITIVE}

/LIMIT=n

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

/PORT=n

/PROCESS_NAME=process

/PROTOCOL=protocol [=options]

/REJECT {=[NO]HOSTS=(hosts ) |=[NO]NETWORKS=(networks ) |=[NO]MESSAGE="text"] }

/RPC=(PROGRAM_NUMBER=n, VERSION_NUMBER=(LOW=n, HIGH=n))

/SEPARATOR=option=character

/SOCKET_OPTIONS=(options)

/USER_NAME=vms_user_account

Examples

SHOW ARP

Format

Parameters

host

Qualifiers

/LOCAL

/[NO]LOCAL

Examples

SHOW BOOTP

Format

Parameters

host

Qualifiers

/HARDWARE=ADDRESS=hex_address

/LOCAL

/OUTPUT=file

Examples

Compaq TCP/IP Services for OpenVMSManagement Command Reference

SET SERVICE

Format

restrictions

Parameters

service

Qualifiers

/ACCEPT {=[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks)}

/ADDRESS=IP_address

/FILE=startup_file

/FLAGS= {[NO]APPLICATION_PROXY | [NO]MULTITHREAD | [NO]PROXY | [NO]CASE_INSENSITIVE}

/LIMIT=n

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

/PORT=n

/PROCESS_NAME=process

/PROTOCOL=protocol [=options]

/REJECT {=[NO]HOSTS=(hosts ) |=[NO]NETWORKS=(networks ) |=[NO]MESSAGE="text"] }

/RPC=(PROGRAM_NUMBER=n, VERSION_NUMBER=(LOW=n, HIGH=n))

/SEPARATOR=option=character

/SOCKET_OPTIONS=(options)

/USER_NAME=vms_user_account

Examples

SHOW ARP

Format

Parameters

host

Qualifiers

/LOCAL

/[NO]LOCAL

Examples

SHOW BOOTP

Format

Parameters

host

Qualifiers

/HARDWARE=ADDRESS=hex_address

/LOCAL

/OUTPUT=file

Examples

Compaq TCP/IP Services for OpenVMS
Management Command Reference

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