DIGITAL TCP/IP Services for OpenVMS
Management Command Reference

User name of the account that receives all undeliverable mail. To set up this account:

Check that the spooling directory is in a SYS$SPECIFIC directory.
Ensure that the Postmaster account can access the spooling directory.
Define the same user name and Postmaster in the SMTP service's definition.

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

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

/SUBSTITUTE_DOMAIN=NOHIDDEN
In the From: and Return-Path fields, displays the sender's name and fully qualified domain.
/SUBSTITUTE_DOMAIN=HIDDEN
In the From and Return-Path fields, substitutes the value given in name for the host name. The following example shows how this qualifiers can be used:
A sender's host is configured with /SUBSTITUTE_DOMAIN=HIDDEN,NAME=eagle. User magpie on host condor.hawk.eagle.org sends mail to daw on another host. When it arrives, it appears to be from magpie@eagle, rather than magpie@condor.hawk.eagle.org.
This is what daw sees:
#707 18-NOV-1998 14:02:02.71 MAIL From: SMTP%"magpie@eagle" To: SMTP%"daw@crow.ravin.rook.org" CC: Subj: Big sale today!

/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 DIGITAL TCP/IP Services for OpenVMS 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.

SET CONFIGURATION SNMP

Configures SNMP clusterwide.
SET CONFIGURATION NOSNMP does not require any qualifiers.
After making changes to the SNMP configuration, shut down and restart the master agent and any subagents. Issue:
$ @SYS$STARTUP:TCPIP$SNMP_SHUTDOWN $ @SYS$STARTUP:TCPIP$SNMP_STARTUP
Related command: SHOW CONFIGURATION SNMP

Format

SET CONFIGURATION [NO]SNMP [ /[NO]ADDRESS=host ]
[ /[NO]COMMUNITY=name ]
[ /[NO]CONFIRM ]
[ /CONTACT=name ]
[ /FLAGS=options]
[ /LOCATION=options ]
[ /TYPE=options ]

restrictions

Requires SYSPRV or BYPASS privileges.
If you add a new community and do not specify the /TYPE qualifier, the value of /TYPE defaults to read only.
If you add a new community and do not specify the /ADDRESS qualifier, the default address is 0.0.0.0.

Qualifiers

/ADDRESS=(IP_address)

/NOADDRESS=(IP_address)
Optional. Default: 0.0.0.0
Hosts that belong to a particular community. You can specify multiple addresses.
A remote host cannot access information from this host unless its address appears in one or more communities. This qualifier must be used in conjunction with the /COMMUNITY qualifier.
If you add a new community and do not specify this qualifier, the new entry's address is 0.0.0.0.
If you use the /ADDRESS qualifier with a community that already exists, these addresses are added to the existing address list.
/NOADDRESS deletes addresses from an existing list. If the deleted address is the only address listed for the community name, this qualifier also deletes the community.
/COMMUNITY=name

/NOCOMMUNITY=name
Optional. Default: None.
Used with the /ADDRESS qualifier. Name of the community that the SNMP agent recognizes. Specify a type of access (minimum is READ access) field and a list of host addresses. Enclose the name in quotation marks to preserve lower case characters in the name. See the /ADDRESS and /TYPE qualifiers for more information.
[NO]COMMUNITY="name" removes a community name.

/CONFIRM

/NOCONFIRM
Optional. Default: /CONFIRM with wildcards.
When you delete communities (with the /NOCOMMUNITY qualifier), asks first for your confirmation.
/CONTACT=name
Optional unless /LOCATION is not specified. Default: None.
Name of the system administrator (or other contact person) of the host on which the SNMP agent runs. The name field has a maximum length of 235.
/FLAGS=options
Optional. Default: None.
The options are:

SETS
Lets the master agent process SET commands from SNMP clients.
AUTHEN_TRAPS
Lets the master agent send unauthorized trap messages in response to community strings from SNMP clients.

/LOCATION=options
Optional unless /CONTACT is not specified. Default: None.
Location of the system on which the SNMP agent runs. Maximum size is 215 characters.
The options are:

[NO]FIRST=text
Specifies the first part of the location. Maximum length of text is 200 characters.
[NO]SECOND=text
Specifies the last part of the location. Maximum length of text is 200 characters.

If you specify two options, they are appended when sent to a client in response to an SNMP request for syslocation. For example, if FIRST is abc and SECOND is def, the value of the location is abcdef with no spaces. The total number of characters must not exceed 215.
/TYPE= {[NO]READ | [NO]TRAP | [NO]WRITE}
Optional. Default: READ.
Sets the type of access (to your local MIB data) you wish to allow for a specified community.

Type READ allows read-only access to the local SNMP MIB objects.
Type TRAP allows the local master agent to issue TRAPS to members of a specified community. Members of a TRAP community receive SNMP Trap-PDUs for significant events, including coldStart traps when the agent is initialized, and authenticationFailure traps when the agent receives an SNMP request that specifies an unauthorized community string.
Type WRITE lets the master agent accept SET commands from clients (management stations).

READ access is assumed when specifying TRAP or WRITE.
You can remove the READ type without affecting the way the agent responds to a READ request. For example:
SET CONFIGURATION SNMP /COMMUNITY="name" /TYPE=NOREAD

Examples

#1
TCPIP> SET CONFIGURATION SNMP /COMMUNITY="public" - _TCPIP> /CONTACT="Sam Spade" - _TCPIP> /LOCATION=(FIRST="Falcon Building",SECOND="Los Angeles, California")

Configures SNMP with the standard public community, taking the default type (read) and address (0.0.0.0) for that community. Both contact and location are specified.
The first and second parts of the location text is concatenated when displayed by an SNMP client. For example:
Falcon BuildingLos Angeles, California
If no update to the location text is done by an SNMP client, the display produced by TCPIP SHOW CONFIGURATION SNMP is as follows:
Location First: Falcon Building Second: Los Angeles, California
If the text is updated by an SNMP client (for example, to change "Falcon" to "Falconi"), the original formatting is not preserved and the display produced by TCPIP SHOW CONFIGURATION SNMP is as follows:
Location First: Falconi BuildingLos Angeles, California

#2
TCPIP> SET CONFIGURATION SNMP /COMMUNITY="rw" /TYPE=WRITE - _TCPIP /ADDRESS=136.20.100.10 /FLAGS=SETS

Configures a community with read/write access only to the host with the address specified. Other hosts still have read access through the public community. Also sets the SETS flag to enable the SNMP agents to process write requests from SNMP clients on host 136.20.100.10.

#3
TCPIP> SET CONFIGURATION SNMP /NOCOMMUNITY="rw"

Removes the "rw" community (set in the previous example.)

#4
TCPIP> SET CONFIGURATION SNMP /COMMUNITY="trapit" /TYPE=TRAP - _TCPIP> /ADDRESS=136.20.0.10

Configures SNMP so that agents can send trap messages to the well-known port 162 on the host identified with the address 136.20.0.10.

#5
TCPIP> SET CONFIGURATION SNMP /FLAGS=AUTHEN_TRAPS - _TCPIP> /COMMUNITY="trapit2" /TYPE=TRAP - _TCPIP> /ADDRESS=(136.20.0.12,136.20.0.15)

Configures SNMP with the AUTHEN_TRAPS flag so that the master agent sends trap messages when it detects a client request containing an invalid community name. Also configures an additional trap community. Trap messages, including authentication traps, go to all three addresses specified in both trap communities.

#6
TCPIP> SET CONFIGURATION SNMP /COMMUNITY="rw2" /TYPE=WRITE - _TCPIP> /ADDRESS=(136.20.0.15,136.20.0.100)

Configures a community "rw2" which gives read/write access to two hosts. Note that one address can appear for more than one community, although a given address cannot be specified more than once for a single community.

SET CONFIGURATION START ROUTING

Enters information into the configuration database to start dynamic routing when DIGITAL TCP/IP Services for OpenVMS starts up.
Related commands: SHOW CONFIGURATION START ROUTING, START ROUTING
See the START ROUTING command for a description of valid parameters and qualifiers.

SET CONFIGURATION NOMAP

When DIGITAL TCP/IP Services for OpenVMS starts up, this command removes NFS mapping information from the configuration database TCPIP$CONFIGURATION.DAT. The previously mapped (logically linked) OpenVMS disk or container file system is no longer visible to the NFS server as a result of this command.
Related commands: SET CONFIGURATION MAP,
SHOW CONFIGURATION MAP
See the UNMAP command for a description of valid parameters and qualifiers.

SET GATED

Configures the Gateway Routing Daemon (GATED). GATED obtains information from several routing protocols and selects the best routes based on that information. These protocols are configured in the file TCPIP$GATED.CONF.
Related commands: START ROUTING /GATED, STOP ROUTING /GATED

Format

SET GATED
[ /CHECK_INTERFACES ]
[ /FILE=file ]
[ /SAVE_STATE ]
[ /TOGGLE_TRACE ]

Qualifiers

/CHECK_INTERFACES
Optional.
Instructs GATED to scan the kernel interface list for changes.
/FILE=file

Optional.
Specifies the name of the GATED configuration file. Use with the /SAVE_STATE qualifier.
/SAVE_STATE
Optional.
Causes GATED to save the current state of all tasks, timers, protocols, and tables to the file SYS$SYSDEVICE:[TCPIP$GATED]TCPIP$GATED.DMP (default).
Use the /FILE qualifier to specify a file name other than the default.
/TOGGLE_TRACE
Optional.
Use to close the trace file. A subsequent set GATED /TOGGLE_TRACE command reopens the trace file. This allows the file to be copied regularly. Valid only when a trace file is specified in the GATED configuration file.

Examples

#1
TCPIP> SET GATED /SAVE_STATE

This example causes GATED to save its current state to the file SYS$SYSDEVICE:[TCPIP$GATED]TCPIP$GATED.DMP.

#2
TCPIP> SET GATED /SAVE_STATE /FILE=STATE.DMP

This example causes GATED to save its current state to the file named STATE.DMP.

SET HOST

Defines or deletes an entry in the hosts database.
Equivalent to maintaining the /etc/hosts file on UNIX hosts.
Related command: SHOW HOST, CONVERT/VMS HOST

Format

SET [NO]HOST host /ADDRESS=IP_address
[ [/[NO]ALIAS=alias ]
[ /[NO]CONFIRM ]

restrictions

Requires read, write, and delete access to the hosts database.

Parameters

host
Required.
Name of a host that is a source or destination of internet communications.

Note
To define a name in lowercase or mixed-case, enclose it in quotation marks.
If you define a mixed-case name, also define an alias in either all uppercase or all lowercase characters.
You cannot delete a host by specifying its alias.

Qualifiers

/ADDRESS=IP_address
Required for SET HOST.
Host's IP address.
/ALIAS=alias

/NOALIAS=alias
Optional.
Add or remove an alternate name for a host. Not valid with SET NOHOST.
/CONFIRM

NOCONFIRM
Optional. Default: /CONFIRM if you use a wildcard.
Used with the SET NOHOST command, prompts you to confirm the delete request. For example:
TCPIP> SET NOHOST MOA /ADDRESS=11.33.33.8 /CONFIRM LOCAL database Host address Host name 11.33.33.8 MOA Remove? [N]:

Examples

#1
TCPIP> SET HOST MOA /ADDRESS=11.33.33.8 - _TCPIP> /ALIAS=("moa","bigbrd","nofly")

Sets the IP address of host MOA to 11.33.33.8 and establishes moa, bigbrd, and nofly as aliases for host MOA.

#2
TCPIP> SET HOST MOA /ALIAS="MOA_2"

Establishes MOA_2 as an alias for host MOA.

#3
TCPIP> SET HOST MOA /ADDRESS = 128.33.33.9

Establishes a second IP address for host MOA.

#4
TCPIP> SET HOST MOA /ADDRESS = 128.33.33.9 /ALIAS="MOA_3"

Establishes MOA_3 as an alias for host MOA's second IP address 128.33.33.9.

#5
TCPIP> SET HOST MOA /NOALIAS="MOA_2"

Deletes MOA_2 as an alias for host MOA.

#6
TCPIP> SET NOHOST MOA /NOCONFIRM

Deletes MOA and all of its associated aliases.

SET INTERFACE

Defines one of the following:

An internet interface
A serial line IP (SLIP) or point-to-point (PPP) connection
A pseudo-interface (a data structure that extends subnet routing)

Before you issue SET INTERFACE, to identify the name of an interface:

Issue the LIST COMMUNICATION_CONTROLLER command to find your system's controller.
Use the first character of the associated interface name.
Look at the TYPE field. If the type is:

ETHERNET, the second character is E.
FDDI, the second character is F.
SERIAL, the second character is S.

SET NOINTERFACE deletes a record. No qualifiers are required.
Related commands: SHOW INTERFACE, SET CONFIGURATION INTERFACE

Format

SET [NO]INTERFACE interface
{ /[NO]ARP
/[NO]AUTO_START
/BROADCAST_MASK=IP_address
/C_BROADCAST_MASK=IP_address
/C_NETWORK=IP_address
/[NO]CLUSTER=host
/COMPRESS=options
/DESTINATION=IP_address
/FLOWCONTROL
/HOST=host
/[NO]LOOPBACK
/NETWORK_MASK=IP_address
/SERIAL_DEVICE=device }

restrictions

Before you issue the SET INTERFACE command, disable the interface. This command requires:

OPER privileges
Read access to the hosts database
Read access to the networks database
Read, write, and delete access to the routes database

Every host on the same network must have the same network mask.

Parameters

interface
Required.
Specifies an interface name for the communication controller, such as: FZ0, FZ1, FR1, IR1, EZ0, EX0, SL0, SL1, SL2, PP0, PP1, PP2.
An internet interface name is denoted by two characters followed by the unit number of the communication controller, as shown below:

Controller Unit Number

First 0

Second 1

Third 2

An internet pseudo-interface name is denoted by three characters followed by one digit for the pseudo-interface unit number, with the following additional rules:

The maximum unit number is 9.
The first two characters are the same as the two characters in the internet interface name.
The third character identifies the controller number that corresponds to the pseudo-interface, following this pattern:

A Controller 0

B Controller 1

C Controller 2

The unit number differentiates interfaces with the same name.

The following table shows a few examples of supported controllers with their corresponding interface names.

Interface Name Communication Controllers OpenVMS Device Name

Ethernet

DE n DEUNA, DELUA XE

QE n DEQNA, DELQA, DEQTA XQ

FDDI

CF n DEFZA FC

FF n DEMFA FX

SLIP

SL n n/a TTA3:

PPP

PP n

Controller	Unit Number
First	0
Second	1
Third	2

Interface Name	Communication Controllers	OpenVMS Device Name
Ethernet
DE n	DEUNA, DELUA	XE
QE n	DEQNA, DELQA, DEQTA	XQ
FDDI
CF n	DEFZA	FC
FF n	DEMFA	FX
SLIP
SL n	n/a	TTA3:
PPP
PP n

Qualifiers

/ARP

/NOARP
Optional. Default: /ARP.
Enables IP address-to-hardware address (Ethernet or FDDI) mapping.
/ARP is valid when you create an interface, but not when you modify an existing interface.
/AUTO_START

/NOAUTO_START
Optional. Default: /AUTO_START.
Valid for a SLIP or PPP interface. Automatically creates the interface when DIGITAL TCP/IP Services for OpenVMS starts.
/BROADCAST_MASK=IP_address
Optional.
Sets the internet interface 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_BROADCAST_MASK=IP_address
Optional.

Previous Next Contents Index

DIGITAL TCP/IP Services for OpenVMSManagement Command Reference

/QUEUES=n

/RECEIVE_TIMEOUT=minutes

/SEND_TIMEOUT=minutes

/SUBSTITUTE_DOMAIN=([NO]NAME=fully_qualified_domain |[NO]HIDDEN)

/ZONE[=domain]

/NOZONE[=domain]

Examples

SET CONFIGURATION SNMP

Format

SET CONFIGURATION [NO]SNMP [ /[NO]ADDRESS=host ] [ /[NO]COMMUNITY=name ] [ /[NO]CONFIRM ] [ /CONTACT=name ] [ /FLAGS=options] [ /LOCATION=options ] [ /TYPE=options ]

restrictions

Qualifiers

/ADDRESS=(IP_address)

/NOADDRESS=(IP_address)

/COMMUNITY=name

/NOCOMMUNITY=name

/CONFIRM

/NOCONFIRM

/CONTACT=name

/FLAGS=options

/LOCATION=options

/TYPE= {[NO]READ | [NO]TRAP | [NO]WRITE}

Examples

SET CONFIGURATION START ROUTING

SET CONFIGURATION NOMAP

SET GATED

Format

SET GATED [ /CHECK_INTERFACES ] [ /FILE=file ] [ /SAVE_STATE ] [ /TOGGLE_TRACE ]

Qualifiers

/CHECK_INTERFACES

/FILE=file

/SAVE_STATE

/TOGGLE_TRACE

Examples

SET HOST

Format

SET [NO]HOST host /ADDRESS=IP_address [ [/[NO]ALIAS=alias ] [ /[NO]CONFIRM ]

restrictions

Parameters

host

Qualifiers

/ADDRESS=IP_address

/ALIAS=alias

/NOALIAS=alias

/CONFIRM

NOCONFIRM

Examples

SET INTERFACE

Format

SET [NO]INTERFACE interface { /[NO]ARP /[NO]AUTO_START /BROADCAST_MASK=IP_address /C_BROADCAST_MASK=IP_address /C_NETWORK=IP_address /[NO]CLUSTER=host /COMPRESS=options /DESTINATION=IP_address /FLOWCONTROL /HOST=host /[NO]LOOPBACK /NETWORK_MASK=IP_address /SERIAL_DEVICE=device }

restrictions

Parameters

interface

Qualifiers

/ARP

/NOARP

/AUTO_START

/NOAUTO_START

/BROADCAST_MASK=IP_address

/C_BROADCAST_MASK=IP_address

DIGITAL TCP/IP Services for OpenVMS
Management Command Reference

SET CONFIGURATION [NO]SNMP [ /[NO]ADDRESS=host ]
[ /[NO]COMMUNITY=name ]
[ /[NO]CONFIRM ]
[ /CONTACT=name ]
[ /FLAGS=options]
[ /LOCATION=options ]
[ /TYPE=options ]

SET GATED
[ /CHECK_INTERFACES ]
[ /FILE=file ]
[ /SAVE_STATE ]
[ /TOGGLE_TRACE ]

SET [NO]HOST host /ADDRESS=IP_address
[ [/[NO]ALIAS=alias ]
[ /[NO]CONFIRM ]

SET [NO]INTERFACE interface
{ /[NO]ARP
/[NO]AUTO_START
/BROADCAST_MASK=IP_address
/C_BROADCAST_MASK=IP_address
/C_NETWORK=IP_address
/[NO]CLUSTER=host
/COMPRESS=options
/DESTINATION=IP_address
/FLOWCONTROL
/HOST=host
/[NO]LOOPBACK
/NETWORK_MASK=IP_address
/SERIAL_DEVICE=device }