DIGITAL TCP/IP Services for OpenVMS
Management Command Reference


Previous Contents Index

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

  1. Check that the spooling directory is in a SYS$SPECIFIC directory.
  2. Ensure that the Postmaster account can access the spooling directory.
  3. 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:

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.

/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:

/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:

  1. [NO]FIRST=text
    Specifies the first part of the location. Maximum length of text is 200 characters.
  2. [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.

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:

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

  1. Issue the LIST COMMUNICATION_CONTROLLER command to find your system's controller.
  2. Use the first character of the associated interface name.
  3. 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:

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


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:

/C_BROADCAST_MASK=IP_address

Optional.


Previous Next Contents Index