Redistributes a message to additional addresses.
dist [ +Folder ] [ -nodraftfolder | -draftfolder +Folder ] [ Message | -draftmessage Message ] [ -annotate [ -inplace | -noinplace ] | -noannotate ] [ -form FormFile ] [ -editor Editor | -noedit ] [ -nowhatnowproc | -whatnowproc Program ]
The dist command provides an interface for redistributing existing messages to a new list of addresses. By default, the dist command copies the current message in the current folder to the UserMHDirectory/draft file and starts an editor. To specify a message in the current folder other than the default, use the Message parameter.
Once started, the editor prompts you to enter values for each header field. The dist command uses the header format defined in the UserMHDirectory/distcomps file. (If this file does not exist, the system uses the /etc/mh/distcomps file.) Since the body of the message is the message you are redistributing, do not fill in the body. To define a format file other than UserMHDirectory/distcomps file, use the -form flag.
To change the default editor, use the -editor flag or define the Editor: entry in your $HOME/.mh_profile file.
Press the Ctrl-D key sequence to exit the editor. Upon exiting the editor, the dist command starts the Message Handler (MH) What Now? prompt. Press the Enter key to see a list of the available whatnow subcommands. These subcommands enable you to continue editing the message header, list the message header, direct the disposition of the message, or end the processing of the dist command.
Note: A line of dashes or a blank line must be left between the header and the body of the message for the message to be identified when it is sent.
Redistributed messages consist of the original header and body appended to a new header. The draft file you edit using the dist command consists of header fields only. A copy of the original message with the new draft message is not automatically stored.
To annotate the original message with redistribution information, use the -annotate flag. This flag appends the original message with the Resent: field, and the current date and time.
The following entries are entered in the UserMHDirectory/.mh_profile file:
Current-Folder: | Sets the default current folder. |
Draft-Folder: | Sets the default folder for drafts. |
Editor: | Sets the default editor. |
fileproc: | Specifies the program used to refile messages. |
Path: | Specifies the user's MH directory. |
whatnowproc: | Specifies the program used to prompt What now? questions. |
distThe system prompts you for the header field values. After entering a value, press the Enter key. To skip an entry, press the Enter key without entering a value. You must fill in the Resent-to: field. After completing the headers, do not modify the body of the text. Press the Ctrl-D key sequence to exit the editor. The system prompts you with:
What now?Press the Enter key to see a list of available options. If you want to redistribute this message, enter send. Your message is redistributed to the new list of addresses.
distThe system responds with a message similar to the following:
Draft "$HOME/Mail/draft" exists (43 bytes). Disposition? _To redistribute this draft, enter:
replaceThe system prompts you for the header field values. After entering a value, press the Enter key. To skip an entry, press the Enter key without entering a value. You must fill in the Resent-to: field. After completing the headers, do not modify the body of the text. Press the Ctrl-D key sequence to exit the editor. The system prompts you with:
What now?Press the Enter key to see a list of available options. If you want to redistribute the draft, enter send. Your message is redistributed to the new list of addresses.
dist +schedules 15The system prompts you for the header field values. After entering a value, press the Enter key. To skip an entry, press the Enter key without entering a value. You must fill in the Resent-to: field. After completing the headers, do not modify the body of the text. Press the Ctrl-D key sequence to exit the editor. The system prompts you with:
What now?Press the Enter key to see a list of available options. To redistribute the message, type send and press the Enter key.
/etc/mh/distcomps | Contains the system default message format. |
UserMHDirectory/distcomps | Contains the user's default message format. |
UserMHDirectory/draft | Contains the current draft file. |
/usr/bin/dist | Contains the executable form of the dist command. |
The ali command, anno command, comp command, forw command, prompter command, refile command, repl command, send command, whatnow command.
The mh_alias file, mh_profile file.
Mail Overview in AIX Version 4.3 System User's Guide: Communications and Networks.
Peek, Jerry. MH and xmh: E-mail for Users and Programmers. Sebastopol, CA: O'Reilly & Associates, 1992.