Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / UUPC11XD.ZIP / MAIL.PRN < prev next >

Wrap

Text File | 1992-09-04 | 46.2 KB | 639 lines

September 4, 1992 UUPC/extended 1.11v Mail Command Reference Revision and Copyright: Revision and Copyright: Revision and Copyright: This is the 67th revision of this document and applies to version 1.11v of UUPC/extended. This document was last updated on September 4, 1992 by Katherine E. Williams. Portions of this documentation are Copyright (c) Andrew H. Derbyshire 1989 and Copyright (c) Kendra Electronic Wonderworks 1990-1992. Full copyright information for UUPC/extended appears in the file README.DOC. Introduction: Introduction: Introduction: This file describes how to invoke and use the UUPC/extended MAIL MAIL MAIL program. It lists the commands available from the question mark (?) prompt in when reading MAIL. See tilde.hlp for tilde (~) escape commands available when sending mail. Command line options Command line options Command line options The MAIL MAIL MAIL program is used for both sending and receiving mail. The options available depend whether you wish to send or receive mail. For sending mail interactively, the syntax is: mail -s "subject" addressees If the -s "subject" is omitted, the user is prompted for a subject. Addressees must be specified, and are in the form listed below. For receiving mail, the syntax is: mail -f filename mail -u userid where filename is the mailbox to be read using the syntax described below for filenames, or userid is the user id whose system mailbox is to be read. The default is to read your own system mailbox. Types of operands Types of operands Types of operands In the list of available commands, items refers to one or more items in the mail box. These items can be specified in the following fashion: Item Number A single numeric value, the special character dot (.) to specify the current item, or the special character dollar sign ($) to specify the last item in the mailbox. Item range Two Item numbers separated by a hyphen (-). The items must be in ascending order; for example, 1-$ is valid, $-1 is not valid. September 4, 1992 UUPC/extended 1.11v Mail Command Reference List of items A list of item numbers and/or item ranges, separated by spaces. The list need not be in ascending order. An example is: 1-5 8 7 14-17. Asterisk (*) Selects all items in the mailbox Subject A slash (/) followed by a subject to search for, optionally followed by a terminating slash. Each Subject: or Resent-Subject: will be searched for the specified string. An example is /UUPC bugs/ User id A single word (no white space) appearing in the From or Resent-From lines of the mail header. Note that if the command accepts both an item and a userid, you cannot specify the item as a user id. Note: Note: Note: If the command accepts both an item and file name and you specify a user id for the item, you must explicitly provide the default filename unless the user id includes the characters at sign (@), percent sign (%), or exclamation point (!). Some commands also allow file names as operands. These may be described in the following fashion: Simple file An MS-DOS file name with no path name name Relative path An MS-DOS file name with one or more back name slashes (\) which does not begin with a back slash or drive letter. Absolute path An MS-DOS file name with one or more back name slashes (\) which begins with a back slash or drive letter. Mailbox A simple file name prefixed by the plus sign (+) character. This will cause the file be referenced as if it is the mailbox for the specified user. For example, +postmast refers to the mailbox for user postmast. Relative to A simple file name preceded by a tilde and your home slash (~/). The file is then referenced by directory the prepending the home directory listed in your PERSONAL.RC to the simple file name. Relative to A simple file name preceded by a tilde, the another's home userid, and a slash (~userid/). The file is directory. then referenced by the prepending the home directory listed in the PASSWD file for user "userid" to the simple file name. When sending mail from the MS-DOS command line or via the mail mail mail or forward forward forward commands, addressees must be entered. These take the form: September 4, 1992 UUPC/extended 1.11v Mail Command Reference userid A simple user id, for delivery on the local system. userid@node A user id and node combination, for delivery to userid on system node. nickname A user or list defined in the user's ALIASES ALIASES ALIASES. . .TXT TXT TXT file. If the flag -c -c -c is inserted before a user id, then all following users are delivered as Carbon Copy (Cc:) addressees. If the flag -b -b -b is inserted before a user id, then all following users are delivered as blind carbon copies; their addresses do not appear in the mail header. The blind carbon copy flag must follow any all normal addressees and carbon copy addressees. Commands available when reading mail: Commands available when reading mail: Commands available when reading mail: Commands are entered in response to the mail question mark prompt (?); all commands must be separated from their operands, if any, by white space. Most commands can be abbreviated to a single character; the commands which cannot be so abbreviated and their shortest allowable abbreviation are debug debug debug (deb deb deb), dquit dquit dquit (dq dq dq), previous previous previous (pre pre pre), set set set (se se se), and status status status (st st st). The commands supported by UUPC/extended are as follows: empty line If the current mail has not been touched, then an empty line acts as a print print print command; otherwise, it acts as a next next next command. ! command Executes command as an MS-DOS command. If command is omitted, runs an inferior command processor (which gives the user a new DOS prompt.) ? Prints a summary of commands available. + integer Alias for down down down command. - integer Alias for up up up command. alias a1 a2 a3 Displays alias information loaded from user's ALIASES ALIASES ALIASES. . .TXT TXT TXT file for nicknames a1 a2 a3. If an alias is list of other aliases, the list is recursively exploded and displayed. This command has no default operand; at least one alias must be specified. copy items file Copies mail items into file with headers. Default file is the printer on device PRN PRN PRN. September 4, 1992 UUPC/extended 1.11v Mail Command Reference debug integer Sets internal trace level to integer; default is 0 at start up, 1 if command is entered with no operands. This can also be set by the command line flag - - - x. x. x. delete items Sets status of to deleted. items Deleted items are ignored when selecting mail by subject or user id, and are purged from the mailbox when quit quit quit the command is issued. dquit items Short for delete delete delete followed by quit. quit. quit. exit Exits mail without updating mailbox; deleted items are left alone. Compare this to the quit quit quit command. forward items addrs Resends to items Note that if addrs. askcc askcc askcc the option is set, each item forwarded will be prompted for Carbon Copy addressees. items go Positions to the last of the items selected. headers Displays summary information for all items in the mailbox. Headers items Displays summary information for the selected in the mailbox. items help Prints this long help text. subject addrs mail -s Interactively send mail to addrs with addrs mail optional subject. next integer Move down in mailbox by integer items. Default is 1. previous integer Alias of up up up command. items print Print items from mailbox, using the external pager if defined in the configuration file and ignoring (not printing) a standard list of RFC-822 fields in the mail header such as Received: and Message-Id:. Compare this to the Print Print Print type type type , , and Type Type Type commands, , , Print items Print from mailbox, using items internal pager and ignoring (not printing) a standard list of RFC-822 fields in the mail header. quit Terminates the reading of mail. All deleted items are purged, and all other items are saved in the original mailbox or in =mbox depending on the setting of the flag. save save save reply items Interactively sends mail to the authors of each of the items requested. Note that each item is replied to separately, specifying "reply 1-10" will send ten pieces of mail to ten people. September 4, 1992 UUPC/extended 1.11v Mail Command Reference save items file Saves the specified items complete with mail headers into file, and then deletes the items. Compare this to the copy copy copy and write write write commands. set Sets various boolean options. These option can also be set in your PERSONAL PERSONAL PERSONAL. . .RC RC RC file. The options are listed below under SET OPTIONS SET OPTIONS SET OPTIONS. . . status Reports miscellaneous program information, including: The version and creation time of the program The operating system version The current address and related information The current file name, size, and date last updated type items Print items from mailbox, using external pager if available and displaying RFC-822 fields suppressed by the print print print command. Compare this to the print rint rint, Print Print Print, and Type Type Type commands, , , Type items Print items from mailbox, using internal pager and displaying RFC-822 fields suppressed by the print print print and Print Print Print commands. undelete Changes status of items to unread. write items file Writes items items items to file file file without the RFC- 822 headers and then deletes them. The default file is ~/mbox ~/mbox ~/mbox. Compare this to the copy copy copy and save save save commands. xit Alias for the exit exit exit command. Set options Set options Set options In addition to the commands listed above, a variety of options can be set in the various configuration files; of special note are the boolean options specified via options= options= options= keyword in the configuration files, as they can be changed via the set set set command. Options are enabled by specifying their keyword, and disabled by prefixing the keyword with the characters "no"; the default for all options is disabled. Valid boolean options which can be set by the user in the UUPC.RC file, their PERSONAL.RC file, or via the options options options command are as follows: September 4, 1992 UUPC/extended 1.11v Mail Command Reference Option Default operation Operation if set name askcc The user must enter all After composing, reply addressees when invoking to, or forwarding mail, mail mail mail forward forward forward or . the user is prompted for Additional addressees carbon copy (Cc:) cannot be added to mail addressees. generated by . reply reply reply autoedit When sending mail, the If the user has defined user is presented with an editor, when sending the line oriented send mail, the editor is mail interface. To use a immediately invoked for full screen editor, the the user to enter mail user must use the ~e ~e ~e with. The user must exit (edit) command or exit the editor to include line oriented data entry mail from the active to invoke his editor. mailbox. autoincl Do not automatically When the reply command is ude include the text of mail invoked, automatically being replied to. include the text of the mail being replied to as if the ~m command was issued. autosign When sending mail, the If defined in the user's user's signature file is configuration file, the not appended to outgoing signature is mail automatically. If automatically appended to defined, the user mail all outgoing mail. still include the file via the ~g ~g ~g (include autograph) command. September 4, 1992 UUPC/extended 1.11v Mail Command Reference backup Do not create a backup of Before updating or the file being processed deleting the current file before rewriting or when exiting mail, rename deleting it. the existing file to the same file name with the extension defined by the configuration variable BackupExt BackupExt BackupExt. Note: Note: Note: If no extension is defined, a default extension of "BAK" is used. doskey Under DOS, interactive If installed, the MS-DOS input is read from the 5.0 DOSKEY program is console using standard used to read input from DOS services (INT 21H the console; normal function 0AH). DOSKEY, DOSKEY functions, if installed, is ignored. including the ability to Empty input lines are edit and scroll input, processed normally. along with macro expansion, is available. Empty lines (which can be generated by DOSKEY macro processing) are ignored at the command prompt unless the expert expert expert option is also set. Note: Note: Note: If DOSKEY is not installed, when the user is first prompted for input the doskey doskey doskey option is reset to nodoskey nodoskey nodoskey with a warning message. dot When sending mail, When sending mail, interactive input must be interactive input can be terminated by the DOS end terminated by a single of file character (Ctrl- period (.) in column one. Z). September 4, 1992 UUPC/extended 1.11v Mail Command Reference expert All informational Boiler plate messages, messages are displayed, such as the initial help and if the option doskey doskey doskey prompt, are suppressed, is also set, empty input and empty input lines are lines are ignored in not ignored when the response to the command doskey doskey doskey option is set. prompt. forward- Mail sent via the forward forward forward If the user has defined save command is not saved in an outgoing mailbox, then the user's outgoing mail sent via the forward forward forward mailbox. command is saved in the same fashion as other outgoing mail. fromsep Items in the mailbox must Items in the mailbox can be separated by a line of be separated only by UUCP binary ones (1). format lines. The From From From line of binary ones (1) required between items by the default operation of nofromsep nofromsep nofromsep is still generated when updating mailboxes. Note: Note: Note: This option must be set in a system or user configuration file, because it only examined at start up. pager help help help print print print , and type type type help help help use print print print and , type type type use the external pager if one the internal pager, and is defined, and Print Print Print Print Print Print and Type Type Type and use the use the in Type Type Type ternal external pager if one is pager. defined purge Empty mailboxes are left Empty mailboxes are in place when the user deleted when the user exits mail. exits mail. September 4, 1992 UUPC/extended 1.11v Mail Command Reference save Mail is left in the If mail is not deleted user's system mailbox from the user's system after reading. mailbox after reading, it is automatically saved in his file when the ~/mbox ~/mbox ~/mbox user exits mail. suppress Display the UUPC/extended Suppress the copyright - copyright notice at notice at program copyrigh program startup. startup. This, of t course, does not suppress the associated responsibility. Note: Note: Note: This option must be set in a system or user configuration file, because it only examined at start up. undelete The environment variable The DELDIR DELDIR DELDIR environment is reset to a null DELDIR DELDIR DELDIR variable is left alone, string by , causing UUPOLL UUPOLL UUPOLL causing OS/2 to copy all files deleted by its deleted files to a hidden children ( UUPOLL UUPOLL UUPOLL , UUCICO UUCICO UUCICO , directory. This causes a and CLEAN CLEAN CLEAN UU UU UU ) to not be performance and free disk archived by the OS/2 space impact by saving ing system for operat files which the user later recovery. should never have to access, much recover. Note: Note: Note: This option must be set in a system or user configuration file, because it is only exam- ined at UUPOLL UUPOLL UUPOLL start up. September 4, 1992 UUPC/extended 1.11v Mail Command Reference verbose When invoked from mail, When invoked from mail, only displays error RMAIL RMAIL RMAIL rmail displays both error messages. messages and nominal status messages, including the addresses mail was delivered to. Note: Note: Note: This option must be set in a system or user configuration file, because it only examined at start up. The following system oriented options must apply to all users on a system and can only only only be set in the UUPC.RC file: Option Default operation Operation if set name bang RFC-822 headers are RFC-822 headers are generated with a generated with UUCP style name" <user@node> "User (User name) node!user format. format. collect The size of mail is not The RMAIL delivery and reported by RMAIL. spooling messages include the size of the files delivered. director Mail for "user" is Mail for "user" is y delivered to the file delivered to the file in the directory user newmail in the user sub- specified by the maildir= maildir= maildir= directory of the line in the system directory specified by configuration file. the maildir= maildir= maildir= line in the system configuration file. September 4, 1992 UUPC/extended 1.11v Mail Command Reference escape Only Ctrl-Break can be If the Esc (Escape) key used to exit from UUPOLL is pressed, then the next or UUCICO. time UUPOLL or UUCICO polls the type-ahead buffer the program will act as if Cntl-Break was pressed. Note: Note: Note: Enabling this option effectively disables type-ahead, since all characters except Esc are discarded with an error message. history No news history is A history is maintained maintained. of all news articles read and posted. Note: Note: Note: history history history The option is currently ignored. kanji No translation of Mail which orginates characters takes place locally is translated during RMAIL processing. from a 2 byte Kanji code called Shift-JIS (Japanese ideogram) to Kanji in a 7bit subset of ISO2022 which can be transmitted via SMTP. Mail from remote systems which is delivered locally is translated from JIS 7bit back to Shift-JIS. monocase Job sequence ids are Job sequence ids are generated in base 62 generated in base 36 using numerics and upper using numerics and upper and lower case case alphabetics. alphabetics. September 4, 1992 UUPC/extended 1.11v Mail Command Reference multitas Processing is optimized Additional processing is k for speed over system performed to insure integrity. system integrity. This additional processing includes creating lock files to prevent concurrent access to system spool directories, writing program logs to temporary files and then appending the file to the permanent log file at program termination, and movng new mail from the user's system mailbox into the user's home directory when is MAIL MAIL MAIL first run after the new mail's arrival. multique When queuing mail for When queuing mail for ue other hosts, each ad- other hosts, a single dressee is delivered file delivered via the separately. remote UUCP can have multiple addressees. snews Incoming news is written Incoming news is written to seperate files in to a file in the Dir Dir Dir News News News directories based on the directory without examing news group names listed the ACTIVE file. in the ACTIVE file located in the NewsDir NewsDir NewsDir directory. symmetri When actively polling, UUCICO UUCICO UUCICO transmits the grades c UUCICO UUCICO UUCICO does not transmit maximum grade for file the maximum grade for transfers allowed by the file transfers allowed by SYSTEMS SYSTEMS SYSTEMS file to the SYSTEMS SYSTEMS SYSTEMS the file to the remote system at startup. remote system at startup. syslog No record is made of The file SYSLOG is files transferred. written in the spool directory with a record for each file transferred to or from the local system. September 4, 1992 UUPC/extended 1.11v Mail Command Reference