Modifies the SMTP configuration in the configuration database.
SET CONFIGURATION NOSMTP with no qualifiers deletes all SMTP
records.
Related commands: SHOW CONFIGURATION SMTP
Format
SET CONFIGURATION [NO]SMTP [ /ADDRESS_RETRIES=n ]
[ /GATEWAY=option=host ]
[ /HOP_COUNT_MAXIMUM=n ]
[ /INTERVAL=options ]
[ /[NO]LOG=[file] ]
[ /OPTIONS=options ]
[ /QUEUES=n ]
[ /RECEIVE_TIMEOUT=minutes ]
[ /SEND_TIMEOUT=minutes ]
[ /SUBSTITUTE_DOMAIN=[NO]NAME=fully-qualified-name
]
[ /[NO]ZONE[=domain] ]
1 – Restrictions
For clusters, issue this command only on the nodes where the SMTP
queues reside - that is, on nodes that are not using clusterwide
queues and are not managing clusterwide queues for other nodes.
Requires SYSPRV or BYPASS privilege.
2 – Qualifiers
2.1 /ADDRESS_RETRIES
/ADDRESS_RETRIES=n
Optional. Default: 16.
Maximum number of different addresses to which SMTP will send
as it tries to deliver mail. Beyond this number of attempts, the
message is undeliverable.
A message is also undeliverable if SMTP fails to deliver after it
attempts all the possible addresses from an MX lookup.
2.2 /GATEWAY
/GATEWAY=option=host
Optional. Default: None.
An alternate route through which SMTP sends mail if delivery
fails.
o [NO]ALTERNATE=host
- Alternate host or domain to which delivery is attempted.
- Used by ZONE, if a zone is defined, as the last chance for
delivery (see the /ZONE qualifier).
- NOALTERNATE deletes an existing alternate destination.
o [NO]GENERAL_PURPOSE=host
- Gateway to handle non-SMTP mail, for example, UUCP
addresses.
- NOGENERAL_PURPOSE deletes the specified destination for
protocols other than SMTP.
2.3 /HOP_COUNT_MAXIMUM
/HOP_COUNT_MAXIMUM=n
Optional. Default: 16.
Maximum number of relays (hops) between routers until SMTP
considers the mail undeliverable.
2.4 /INTERVAL
/INTERVAL={ INITIAL="OpenVMS_delta_time" | RETRY="OpenVMS_
delta_time" | MAXIMUM="OpenVMS_delta_time" }
Optional. Defaults: INITIAL=30 minutes, RETRY=60 minutes,
MAXIMUM=3 days.
Time intervals related to repeated attempts before delivery
fails. Specify the value within quotation marks as follows: "dddd
hh:mm:ss:cc." For example:
dddd = days (0-9999)
h = hours (0-24)
m = minutes
s = seconds
cc = milliseconds
You can modify the following options:
o INITIAL="OpenVMS_delta_time" is the amount of time that SMTP
waits before making a second attempt to deliver.
o RETRY="OpenVMS_delta_time" is the time SMTP waits between
retries, starting with the second attempt. (Recommended time:
twice the initial interval.)
o MAXIMUM="OpenVMS_delta_time" is the maximum elapsed time that
SMTP retries delivery.
2.5 /LOG
/LOG=[file]
/NOLOG=[file]
Optional. Default: SYS$SPECIFIC:[TCPIP_SMTP]TCPIP$SMTP_
LOGFILE.LOG.
File to which SMTP queue activity is logged.
2.6 /OPTIONS
/OPTIONS=options
Optional. Defaults: NOEIGHT_BIT, HEADERS, NORELAY.
The following SMTP options are available:
o [NO]EIGHT_BIT
All characters must have the eighth bit clear. Allows the
transmission of 8-bit characters.
o Header control. Specify one of the following:
HEADERS Headers are printed at bottom of messages.
NOHEADERS Headers are omitted.
TOP_HEADERS Headers are printed at top of messages.
NOTOP_ Resets TOP_HEADERS to the default.
HEADERS
o [NO]RELAY
Relays mail to other hosts by functioning as an end node.
2.7 /QUEUES
/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.
2.8 /RECEIVE_TIMEOUT
/RECEIVE_TIMEOUT=minutes
Optional. Default: 5 minutes.
Maximum time between socket receipts of a message for a
particular dialog.
If a message is not received within this interval, the connection
is broken and the mail control file is deleted.
2.9 /SEND_TIMEOUT
/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 of 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.
2.10 /SUBSTITUTE_DOMAIN
/SUBSTITUTE_DOMAIN=[NO]NAME=fully-qualified-domain
Optional.
By default, the From: and Return-Path fields display the
sender's name and fully qualified domain. NONAME causes the
sender's domain name to be omitted from the Return-Path field.
If you specify a fully qualified domain name (/SUBSTITUTE_
DOMAIN=NAME=fully-qualified-domain), that specified domain name
is displayed as the sender's domain name.
For example, suppose you specify the fully qualified
domain name eagle for the sender's return path
(/SUBSTITUTE_DOMAIN=NAME=eagle). When user magpie on host
condor.hawk.eagle.org sends mail to daw on another host,
user daw sees the return path as magpie@eagle rather than
magpie@condor.hawk.eagle.org.
This is what daw sees:
#707 18-NOV-2002 14:02:02.71 MAIL
From: SMTP%"magpie@eagle"
To: SMTP%"daw@crow.ravin.rook.org"
CC:
Subj: Big sale today!
NOTE
For changes made with the /SUBSTITUTE_DOMAIN qualifier
to take effect, you must stop and restart SMTP. For more
information about stopping and starting SMTP, refer to the
HP TCP/IP Services for OpenVMS Management manual.
2.11 /ZONE
/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 TCP/IP Services 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).
3 – 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.