DIGITAL TCP/IP Services for OpenVMS
Management


Previous | Contents

The rrestore command can display messages such as "You have not read any volumes yet" and ask you to specify the next volume. Although the messages might appear, rrestore should work properly.

In this example, rrestore extracts the filename from dump file number 2 on the tape:

 
UNIX>/etc/rrestore fsx vax:device/nomount/nounload/norewind 2 
filename 
 

In the following example, rrestore invokes the interactive utility to let the user specify particular files that were put on the tape in dump file 2. The add command then adds the files to the extraction list and the extract command restores them:

 
UNIX>/etc/rrestore fis vax:device/nomount/nounload/norewind 2 
restore> add filename 
restore> extract 
 


Chapter 12
Configuring and Managing SMTP

The Simple Mail Transfer Protocol (SMTP) is the standard protocol used as a reliable and efficient mail delivery system between systems communicating in a TCP/IP network. SMTP specifies the format of control messages sent between two machines to exchange electronic mail, but does not specify the mail interface.

The DIGITAL TCP/IP Services for OpenVMS product implements SMTP as an OpenVMS symbiont that works with OpenVMS mail.

This chapter reviews key concepts and describes how to configure, customize, and manage the SMTP symbiont. See the DIGITAL TCP/IP Services for OpenVMS User's Guide for information on using SMTP to send and receive mail.

12.1 Reviewing Key Concepts

To be reliable, electronic mail systems must be able to cope with situations where the recipient is temporarily unavailable, for example, the recipient's host is down or offline. Mail must also be able to handle situations where some of the recipients on a distribution are available and some are not.

SMTP is a store--and--forward mail protocol that accepts mail from an originating host and forwards it through one or more intermediate hosts before reaching its final destination. Note that this behavior differs from OpenVMS mail, where mail is sent directly from the originating node to the destination node.

12.1.1 How SMTP Clients and Servers Communicate

In most implementations, SMTP servers listen at port 25 for client requests. In the UCX SMTP implementation, the auxiliary server listens for client requests and starts the SMTP symbiont as needed.

If configured, the SMTP symbiont processes all mail on a UCX host. It receives jobs one at a time from the generic SMTP queue and delivers them either locally, by means of OpenVMS mail or remotely, by means of SMTP.

The configuration procedure UCX$CONFIG sets up the SMTP queues for you. See Section 12.3 for more information on configuring SMTP.

After receiving a client request, the SMTP server responds, indicating its status (available/not available) and if available, starts an exchange of control messages with the client to relay mail. (Like FTP, SMTP does not define a message format. SMTP commands are sent as ASCII text and the SMTP server at the remote host parses the incoming message to extract the command.)

The following steps occur:

  1. The auxiliary server listens for requests and starts the SMTP symbiont and initiates a TCP connection.
  2. The client identifies itself by sending its fully qualified domain name.
  3. The server replies with its own fully qualified domain name.
  4. The client sends the full email address of the sender enclosed in angle brackets; if the server is able to accept the mail it returns a readiness code.
  5. The client sends the full mail address (also enclosed in angle brackets) of the message's intended recipient.
  6. The client sends the body of the message.

A minimum of five control message commands are required to conduct the above sequence of events. Table 12-1 describes these commands.

Table 12-1 SMTP Client Commands
Command Description
HELO Used to identify the originating host to the server host. Use the /domain qualifier to provide the name of the originating host.
MAIL FROM:<reverse_path> Identifies the address at which undeliverable mail should be returned. Usually is the originating host.
RCPT TO:<forward-path> The address of the intended receiver. If sending mail to multiple recipients, use one RCPT TO command for each recipient.
DATA Signals the end of the RCPT TO commands and tells the recipient to prepare to receive the message itself.
QUIT Indicates no more commands.

12.1.2 Understanding the SMTP Control File

With UCX SMTP, each mail message is packaged into a special-purpose binary file called a control file. This control file is submitted to a generic SMTP queue to be processed by the SMTP symbiont. Each control file contains one SMTP mail message. Note that an SMTP message addressed to multiple recipients is stored in one control file.

Control file names provide information about the mail contained within. The format for the control file name is as follows:

yymmddhhsshh_username.UCX_scnode

where
yymmddhhsshh The timestamp taken when the file is created
username The user name of the process in which the control file was created; values for this name include:
  • UCX_SMTP --- The mail arrived via SMTP. The file was created by the SMTP receiver process running in the UXC_SMTP account.
  • MAIL$SERVER --- The mail arrived over DECnet and was destined for an SMTP address. In this case, the control file is created by the DECnet MAIL11 network object that runs the MAIL$SERVER account. This happens when the user sets mail forwarding to an SMTP address.
  • SYSTEM --- If the control file is in the UCX_SMTP account directory, this indicates the message is undeliverable mail.
  • username --- Mail composed by the user and sent to an SMTP address.
scnode Value of the SYSGEN SCNODE parameter

12.1.3 Understanding SMTP Headers

Unlike OpenVMS mail, SMTP messages have a rich set of headers. In addition to the From, To, Subj, and CC headers, SMTP supports

UCX SMTP scans the message headers, comparing them to the above list. The first header found is used for the OpenVMS mail header From:.

You can modify the following SMTP defaults related to SMTP headers: