Document revision date: 19 July 1999

Mail files are within your own directory, so you have the option of applying the file protection techniques for sensitive files described in Chapter 19. In addition:

• Use your judgment in responding to mail requests: if a node is outside your local OpenVMS Cluster environment, it is possible that the source node is incorrectly identified, either accidentally or intentionally.
• It is best to use discretion in the content of your mail messages and in the selection of your audience.
• Never reveal your password or send details about how to use your account. You have no control over information in a mail message once you have sent it.

The following sections describe how to use text editors in the Mail environment.

6.12.1 Using EVE

You can use a text editor to write a message before you send it. To do so, specify the /EDIT qualifier with the SEND command. After you respond to the To: and Subj: prompts, Mail invokes the text editor. Unless you have selected a different editor, Mail invokes the DECTPU-based EVE editor.

The [End of file] marker moves down as you enter text. For more information about the EVE editor, see Chapter 8. To send the message, press the Do key and enter the EXIT command. To cancel the send operation, press the Do key and enter the QUIT command.

In the following example, EVE is used to create a mail message:

MAIL> SEND/EDIT [Return]

[End of file] Buffer: MAIN | Write | Insert | Forward

By specifying the /EDIT qualifier when you invoke Mail, you can use the editor for sending, replying, and forwarding during the ensuing mail session. You can also use keywords with the /EDIT qualifier to set the default for Mail.

To invoke the editor only when you are replying to a message, use the REPLY keyword with the MAIL/EDIT command. To invoke the editor and display the message to which you are replying, use the REPLY keyword with the =EXTRACT option. If you do not specify a keyword with /EDIT, the default is /EDIT=(SEND,REPLY).

To send or reply to a message, EXIT from the editor. To cancel a SEND or REPLY command, enter the QUIT command to exit from the editor.

Examples

• In the following example, the editor will be invoked for every mail message that is sent or forwarded:

  $ MAIL/EDIT=(SEND,FORWARD) [Return]

• In the following example, the editor will be invoked for every message that is replied to:

  $ MAIL/EDIT=(REPLY) [Return]

• In the following example, the editor will be invoked and the message to which you are replying will be included as text every time you reply to a message:

  $ MAIL/EDIT=(REPLY=EXTRACT) [Return]

By default, Mail invokes the DECTPU-based EVE editor when you specify the Mail command SEND/EDIT. If you are not running an ANSI-compliant CRT (hardcopy) terminal, you will not be able to invoke DECTPU-based editors (such as EVE and LSE). If you attempt to invoke a DECTPU-based editor, you will receive the error message :

%TPU-E-NONANSICRT, SYS$INPUT must be supported CRT

By entering the Mail command SET EDITOR, you can specify that a different editor be invoked instead of EVE. For example, to select the EDT editor, issue the Mail command SET EDITOR EDT. The EDT editor remains your default Mail editor (even if you log out of the system and log back in) until you enter another SET EDITOR command.

6.12.4 Displaying the Selected Editor

To display the name of the selected Mail editor, enter the Mail command SHOW EDITOR.

In the following example, the EDT editor is selected and then used to create a message:

MAIL> SET EDITOR EDT [Return] MAIL> SHOW EDITOR [Return] Your editor is EDT.

MAIL> SEND/EDIT [Return] To: STONE::THOMPSON [Return] Subj: Budget Meeting [Return] [EOB] *

6.12.5 Using EDT

When EDT is used to edit messages, you will see an asterisk (*) after you enter the subject line and press Return. Enter the CHANGE command and press Return to switch to the screen editor. For more information on using EDT, see Chapter 9. Enter the text of your message using EDT commands to move around in the buffer. A buffer is a temporary storage area that exists only during an editing session. To send the message, press Ctrl/Z. To cancel and not send the message, press Ctrl/C.

6.12.6 Using a Command File to Edit Mail

You can define the logical name MAIL$EDIT to be a command file before entering Mail. Then, when you issue any Mail command that invokes an editor, the command file will be called to perform the edit. In the command file, you can also invoke other utilities such as the spell-checker and you can specify any function that can be done in a command file. Refer to Appendix C for an annotated example of a MAILEDIT.COM command procedure and refer to Chapter 15 and Chapter 16 for more information on command files.

6.12.7 Overriding Your Selected Editor

If you wish to temporarily override your selected editor, you can define MAIL$EDIT to be the string "CALLABLE_" with the desired editor name appended. For example, to use callable EDT rather than callable EVE, you can type the following command:

$ DEFINE MAIL$EDIT CALLABLE_EDT

If you issue the SET EDITOR command during a session that was invoked with MAIL$EDIT defined, you override both your permanent selected editor and the current editor setting. In order to use the command file defined by MAIL$EDIT again, you must exit from Mail and restart it.

6.13 Customizing Your Mail Environment

When you receive a message, Mail interprets the specified address as follows:

• If the node component of the address contains a period (.), the address is interpreted as an Internet address. Mail uses the SMTP protocol by default unless you have previously set up your system to use a different Internet protocol by defining that alternate protocol with the MAIL$INTERNET_TRANSPORT logical name.
• If the node component of the address does not contain a period, the address is interpreted as a DECnet address.

However, you can customize your Mail environment to force the system to choose a specific protocol. This option is helpful in cases where a mail address can be interpreted as valid for either the Internet or DECnet protocol.

To specify protocols, you can define the MAIL$INTERNET_MODE logical name as follows:

• HYBRID (the default)
  If the node component of the address contains a period (.), Mail uses an Internet protocol. If there are no periods, Mail uses the DECnet protocol.
• DECNET
  Mail always interprets the node component of the address as a DECnet node specification.
• SMTP
  Mail always interprets the node component of the address as an Internet address specification. The default transport is SMTP unless you use the MAIL$INTERNET_TRANSPORT logical to define an alternate Internet transport.

To modify your Mail environment in any of these ways, Compaq recommends that you define the MAIL$INTERNET_MODE and MAIL$INTERNET_TRANSPORT logicals in your LOGIN.COM file. (See Chapter 13 for complete information about using and defining logical names.)

For example, if your system is set up to use the default (HYBRID), the Mail address smith@pluto is interpreted as a DECnet address because there are no periods in that address. However, if you want Mail to use SMTP instead of DECnet, you can add the following line to your LOGIN.COM file:

$ DEFINE MAIL$INTERNET_MODE SMTP

When you then specify smith@pluto, Mail interprets this address as an Internet address and uses the SMTP protocol (for example, SMTP%"smith@pluto.xyz.dec.com").

6.13.1 Using the Mail Keypad

You can use the numeric keypad on your keyboard to execute commands in Mail. Most keypad keys can execute two commands.

Figure 6-2 shows the Mail keypad. To enter the top command for each key shown, press the appropriate key. To enter the bottom command shown, press the PF1 key first, and then the desired function key.

Figure 6-2 Mail Utility Keypad

To execute the Mail command SEND, press KP7. To execute the Mail command SEND/EDIT, press the PF1 key first and then press KP7.

6.13.1.1 Redefining Keypad Keys

You can redefine the keypad keys to execute Mail commands when you are in Mail. Note that the previous definition of the key is superseded when you redefine a key.

Defining keypad keys in Mail is similar to defining keypad keys to execute DCL commands.

In the following example, the key KP2 is defined as the Mail command PRINT/PARAM=PAGE_ORIENT=LANDSCAPE. After KP2 is defined, you can press it to display the PRINT/PARAM=PAGE_ORIENT=LANDSCAPE command:

MAIL> DEFINE/KEY KP2 "PRINT/PARAM=PAGE_ORIENT=LANDSCAPE" [Return]

6.13.1.2 Assigning Additional Key Definitions

To increase the number of key definitions available on your terminal, use the /STATE qualifier. You can assign many definitions to the same key as long as each definition is associated with a different state. State names can be any alphanumeric string. By specifying states, you can press a key once to enter a command and a second time to enter a qualifier.

In the following example, PF1 (pressed twice) is defined as DIRECTORY/FOLDER:

MAIL> DEFINE/KEY PF1 "DIRECTORY"/SET_STATE=FOLDER /NOTERMINATE [Return] MAIL> DEFINE/KEY PF1 "/FOLDER" /IF_STATE=FOLDER /TERMINATE [Return]

Press PF1 twice to enter the command DIRECTORY/FOLDER. The /TERMINATE qualifier ends the command line so you do not need to press the Return key.

6.13.1.3 Creating Permanent Key Definitions

Any keypad keys that you define during a Mail session are lost when you exit from Mail. To retain keypad key definitions from one Mail session to another, create a file containing key definitions (for example, MAIL$KEYDEF.INI) in your top-level directory. For example, the following MAIL$KEYDEF.INI file contains six key definitions:

DEFINE/KEY PF1 "DIRECTORY " /NOTERMINATE /SET_STATE=folder DEFINE/KEY PF1 "/FOLDER" /TERMINATE /IF_STATE=folder DEFINE/KEY PF2 "SELECT " /NOTERMINATE /SET_STATE=mail DEFINE/KEY PF2 "MAIL" /TERMINATE /IF_STATE=mail DEFINE/KEY PERIOD "READ " /NOTERMINATE /SET_STATE=new DEFINE/KEY PERIOD "/NEW" /TERMINATE /IF_STATE=new

To execute these commands each time you invoke Mail, enter the following command line in your login command file (LOGIN.COM):

$ DEFINE MAIL$INIT SYS$LOGIN:MAIL$KEYDEF.INI

6.14 Summary of Mail Commands

This section contains a summary of all Mail utility commands. For complete information on qualifiers used with these commands, refer to online help.

See also Section 6.15 for information about using the MIME utility to read and compose MIME-encoded messages.

6.14.1 Reading Messages

Use the following commands to read messages:

• BACK
  Displays the message preceding the current or last-read message when the last command issued was READ. When the last command issued was DIRECTORY, the BACK command displays the preceding screen of the directory listing.
• CURRENT
  Displays the beginning of the message you are currently reading.
• DIRECTORY [folder-name]
  Displays a list of the messages in the current mail file, including message number, sender's name, date, and subject.
• ERASE
  Clears your terminal screen.
• EXTRACT
  Places a copy of the current message into the specified output file. To copy a mail message to a folder in a Mail file, use either the COPY, FILE, or MOVE command.

• FIRST
  Displays the first message in the current folder.
• LAST
  Displays the last message in the current folder.
• NEXT
  Skips to the next message and displays it.
• READ [folder-name] [message-number]
  Displays your messages. Pressing the Return key is the same as entering the READ command without parameters.
• SEARCH search-string
  Searches the currently selected folder for the message containing the first occurrence of the specified text string.
• SHOW NEW_MAIL_COUNT
  Displays the number of unread mail messages.

Use the following commands to exchange messages:

• ANSWER [filespec]
  REPLY [filespec]
  Sends a message to the sender of the message you are currently reading or of the one you last read.
• FORWARD
  Sends a copy of the message you are currently reading (or have just read) to one or more users.
• MAIL [filespec]
  SEND [filespec]
  Sends a message to one or more users.

Use the following commands to remove messages:

• DELETE [message-number]
  Deletes either the message you are currently reading, a range of messages, or the message you just read, and moves it to the WASTEBASKET folder.
• PURGE
  Deletes all the messages in the WASTEBASKET folder. When you exit from Mail or enter a SET FILE command (to select a new mail file), an implicit purge is done to empty the WASTEBASKET folder, unless you have previously entered the SET NOAUTO_PURGE command.
• SET [NO]AUTO_PURGE
  Determines whether Mail empties the WASTEBASKET folder when you enter the EXIT or SET FILE command. When you use the SET NOAUTO_PURGE command, you must enter the PURGE command periodically to delete the messages in the WASTEBASKET folder.

• SHOW AUTO_PURGE
  Displays whether messages in the WASTEBASKET folder are deleted (purged automatically) when you enter the EXIT or SET FILE command.

Use the following commands to print messages:

• PRINT
  Adds a copy of the message you are currently reading to the print queue. The files created by the PRINT command are released to the print queue when you exit from Mail. Multiple messages are concatenated into one print job unless you use the /NOW or /PRINT qualifier.
• SET [NO]FORM form-name
  SHOW FORM
  Sets the default print form for printing done within Mail. The SET NOFORM command clears the default print form. The SHOW FORM command displays the default print form.
• SET [NO]QUEUE queue-name
  SHOW QUEUE
  Sets the default print queue to be used when you enter the PRINT command from within Mail. SET NOQUEUE clears the previously defined print queue and sets the queue to SYS$PRINT, the default print queue. The SHOW QUEUE command displays your default print queue.

Use the following commands to organize messages:

• COPY folder-name [filename]
  Copies a message to another folder without deleting it from the current folder. If the specified folder does not exist, it is created.
• FILE folder-name [filename]
  MOVE folder-name [filename]
  Moves the current message to the specified folder and deletes the message from the original folder.
• SELECT [folder-name]
  SET FOLDER [folder-name]
  Establishes a set of messages that you can affect as a group. You can copy or move this set of messages from one folder to another. You can also read and delete, or search and extract a set of messages. In addition, you can use the SELECT and SET FOLDER commands to move from one folder to another.
• SET FILE filename
  Establishes (or opens) another file as the current mail file. By default, your mail file is MAIL.MAI. If you use the COPY command, the FILE command, or the MOVE command to create other mail files (for example, JOKES.MAI or HISTORY.MAI), you can then use the SET FILE command to open the Mail files.
• SHOW FILE
  Displays the name of the mail file that is currently open.

• SHOW FOLDER [folder-name]
  Displays the current folder name.
• SET WASTEBASKET_NAME folder-name
  Changes the name of the WASTEBASKET folder, which contains messages to be deleted. You can delete all the messages in the WASTEBASKET folder by entering the PURGE command. If AUTO_PURGE is set, when you enter the EXIT command, messages in the WASTEBASKET folder will be deleted. If AUTO_PURGE is set, you can avoid deleting messages in the WASTEBASKET folder by entering the QUIT command.
• SHOW WASTEBASKET_NAME
  Displays the name of the WASTEBASKET folder.
• SHOW DELETED
  Displays the amount of deleted message space in the current mail file.

The following commands are used for marking messages:

• MARK [message-number]
  Sets the current or specified message as marked. Marked messages are displayed with an asterisk (*) in the left column of the directory listing. To select or organize marked messages, use the SELECT command with the /MARKED qualifier.
• UNMARK [message-number]
  Sets the current or specified message as unmarked. The asterisk (*) in the left column of the directory listing is deleted.

The following commands are used for customizing the mail environment:

• DEFINE/KEY key-name string
  Defines a key to execute a Mail command. You can press the key to enter a command instead of typing the command name.
• SHOW KEY [key-name]
  Displays the key definitions created by the DEFINE/KEY command.
• EDIT [filename]
  Invokes your selected editor and enables you to edit a message before you send it.
• HELP [topic]
  Displays information about Mail. To obtain information about individual commands or topics, enter HELP followed by the command or topic name.
• SET [NO]CC_PROMPT
  Sets the default for determining whether the carbon copy (CC:) prompt appears when sending a message.
• SET COPY_SELF command[,command]
  Sets the default for determining whether the SEND, REPLY, or FORWARD commands return to the sender a copy of the message being sent.
• SHOW COPY_SELF
  Displays which command (SEND, REPLY, or FORWARD) automatically sends a copy of the message to you.
• SET [NO]SIGNATURE_FILE
  Sets the Mail utility to append a signature text file to the end of a mail message automatically whenever you use the ANSWER, FORWARD, MAIL, REPLY, or SEND command.
• SHOW SIGNATURE_FILE
  Displays information that shows whether you specified a default signature file and, if so, the name of that file. (The SHOW ALL command also displays signature file information.)
• SET EDITOR editor-name
  Selects the text editor to be used when you edit a message (for example, with the Mail command SEND/EDIT). You can use any callable editor available on your system. This command overrides any definition that the command procedure MAIL$EDIT has set.
• SHOW EDITOR
  Displays the name of your selected text editor.
• SET [NO]FORWARD address
  Sets a forwarding address for your mail.
• SHOW FORWARD
  Displays the name of your current forwarding address.
• SET [NO]MAIL_DIRECTORY [.subdirectory-name]
  Specifies that all mail files (file type .MAI) be moved from your SYS$LOGIN directory to the specified subdirectory.
• SHOW MAIL_DIRECTORY
  Displays the name of the device and directory containing all your .MAI files.
• SET [NO]PERSONAL_NAME "text-string"
  Appends a text string to the end of the From: field of mail messages you send. You can fill this field with your full name or any other information. Note that your personal name must begin with a letter and may not have two consecutive spaces.
• SHOW PERSONAL_NAME
  Displays the text string established with the SET PERSONAL_NAME command.
• SHOW ALL
  Displays detailed information about your current Mail settings.

	privacy and legal statement
6489PRO_012.HTML