O ‘  H  s $ K ¤ Ó R € B  þ Û H$ î$ �% ¨& z) ˆ+ ’, X- _1 °2 ª7 à; Ó< t> ‹? p@ xC èH yU `Y Àb ÷k o q -s Mu jv Ix fy yz È{ ¬| ~ ³ ·� yƒ „ 3… ކ Ň ?‰ ÊŠ ÄŒ XŽ ;� Z• ™ +Ÿ —¦ -® _² T³ Ÿ¹ @¼ ¾ Ì¿ Á ÂÁ Öà ÃÄ 7Ç È �Ê ƒË ‚Í žÐ 7Ó Welcome to Pegasus Mail, a simple mail facility for use with Novell Networks. You are currently at the main menu: select a choice from this menu by using the and arrow keys to move the reverse-video bar, then press . In brief, the available choices at this point are: N: Read new mail messages: this option only appears if you have received mail messages, but have not yet read them. When you select it, you will be presented with a list of unread messages. S: Send a mail message: when you select this option, the screen will change to a message editing screen. Enter the user, or list of users to whom you want to send a message, then type the message. When you have finished, press . F: Send a file via mail: a window will open listing asking you for a recipient, or list of recipients, a subject, and a filename. While in the filename field, you can expand filenames by pressing . C: Change file server: this option allows you to select a new NetWare file server to work with. A window will open listing all known servers, allowing you to select one. If you select a server to which you are not attached, Pmail will prompt you for user details, and log you in. B: Browse mail messages: use this option to look at messages you've already read and filed. Q: Quit using mail: select this when you have finished using Pegasus mail, and you will return to DOS. Entering addresses for users: (Help message deleted - you should NEVER see this text!!) Subject: The subject is a one-line pr‚cis of the contents of the message which is displayed on the browse list. You may enter anything on this line, or you can leave it blank. When you create a new entry, you should give it a "long name", the name which appears in the selector window. The long name can be up to 50 characters in length, and can contain any characters, including spaces and quotes. You can also supply a short name, which is the name Pmail will use for the actual file or directory associated with the entry. This should have no more than 8 characters, consisting of only letters and digits - do not use any special characters. The short name is optional - if you do not supply one, then Pmail will generate a name for you. We recommend that you give your own short names to folders, since these names appear on the browse screen. There is probably no real need to give explicit short names to archives, address books or lists, although you may do so if you wish. Personal name: Your personal profile contains information about the way you use Pegasus Mail. Your personal name is a name appended to your usercode in messages sent by you to other users, to make it easier for them to work out who you are. You may put anything you like in this field, but you should keep it meaningful if it is to be useful. File to send: Enter the name (including a full path, if necessary) to the file you want to send via mail. While you are entering the filename, you can EXPAND what you have typed by pressing the key: if you have typed enough characters to identify the file uniquely, the rest of the name will be filled in for you, otherwise a small window containing a list of possible files will open, and you can select from that list. While the list is visible, you can SPEED-SEARCH through it by pressing the first letter of the name of the file you want to find. Search for user: This function allows you to search a file server for users by name or by usercode. You may enter a part of either a name or a usercode, and the system will present all entries in the File Server's bindery containing that string. To search a File Server other than the default server, place its name and a '/' in front of your search pattern. You may also be more selective by using combinations of '?' and '*' characters: you could, for instance, type in THOM*SON, and the system would respond with (for example) THOMPSON, THOMSON or THOMKINSON. You may use as many '*' or '?' characters in the string as you wish. Browsing messages: Use the arrow keys to scroll through the list of messages until the message you wish to work with is highlighted: you may also mark multiple entries by pressing or space. will toggle the marking state of every message in the list (ie, marked messages will become unmarked, and vice versa). When you have selected the message or messages you want to work with, press: <Enter> to read the message <F10> to select a different folder to browse (this option is not available in the New Mail folder). <Del> to delete the message, or messages. <A> to Archive the message: archiving allows you to store the message in a compressed form, taking up much less disk space. <C> to make copies of the message or messages to another folder. <D> to pass the message or marked messages to an MS-DOS command: a window will open allowing you to enter the command. You should not delete the message with this. <F> to forward the message to another user or users. <L> to search for a text string in either all messages or in marked messages. This option can also be used to select messages containing particular text. <M> to move the message to a folder: the folder window will open (you can create a folder at this point). <P> to print the current message. <R> to reply to the message: a dialog box will open allowing you to specify the format and addressing of your reply. <S> to choose how you want the messages sorted. <X> to extract the message to a text file: if the message is a file transfer envelope, this option will allow you to extract the enclosed file. Press  when you are ready to return to the main menu. Selecting a folder: Folders are storage areas for mail messages: you can use them to keep related messages together, or for filing messages according to any criteria you wish. When you first use Pegasus Mail, no folders will exist, so you must create them using the New Folder option. This will open a small window asking for a folder name, which must consist of 1 to 8 letters or numbers - do not use any punctuation or special characters. If folders are displayed on the list, you can select them by using the arrow keys to move the reverse-video bar to the one you want and pressing . Main folder refers to the top level mail folder where your messages reside when you first receive them. A signature is a small file containing address information and any other details you might want to add to the end of a message. If you specify an existing file as a signature, Pegasus Mail will automatically append it to the end of each mail message you send. While you are entering your filename, you can EXPAND what you have typed by pressing the key: if you have typed enough characters to identify the file uniquely, the rest of the name will be filled in for you, otherwise a small window containing a list of possible files will open, and you can select from that list. While the list is visible, you can SPEED-SEARCH through it by pressing the first letter of the name of the file you want to find. In this field, you can specify a default right margin which Pegasus Mail will use when you edit a message or file. When text reaches the right margin, the word at the end of the line will be moved to the next line (this is called word-wrap). If you place a value in this field, Pegasus Mail will use it as your home mailbox: all your folders will be placed here, and after you have read your new mail, it will be moved there automatically. If you have already been using a mailbox, or if you have mail on the server, it will be moved to the new location automatically. To move your home mailbox back to the server leave the field blank. A home mailbox need not be on the file server - it can be on a local hard disk. A filename consists of two sections:  A name, of up to 8 characters  An optional Extension, consisting of a period ('.') and up to three further characters. You must use only LETTERS and NUMBERS in filenames - MS-DOS places severe restrictions on the use of other characters, and you should avoid them. While you are entering your filename, you can EXPAND what you have typed by pressing the key: if you have typed enough characters to identify the file uniquely, the rest of the name will be filled in for you, otherwise a small window containing a list of possible files will open, and you can select from that list. While the list is visible, you can SPEED-SEARCH through it by pressing the first letter of the name of the file you want to find. Advanced users: Pmail will correctly expand wildcard file specifications in the standard DOS form (*, ?). Enter Y here if you want a copy of the message kept for yourself, or N if you do not. Self copies will be stored in the folder defined in your personal profile. Enter in this field the name of the folder where Pmail will store messages copied to self. You can enter a name consisting of up to eight characters or numbers. Place here the string Pmail should use by default to comment out messages on reply. The string you supply will be put at the start of every line of the original message when you choose the "commented" option in a reply. The default value is "> ". Note that spaces are significant. If you answer 'Y' to this option, Pmail will wait until you have finished editing the message, then will prompt you for a Key: the key is effectively your password to the message, and must be known by the user to whom the note is addresses (otherwise they won't be able to read it!). The key should have from 5 - 8 characters, and Pmail will prompt you to enter it twice (to verify that you've typed it correctly). The key will be used to encrypt the body of the message, but the subject and remainder of the header will remain readable. Pegasus Mail uses an extremely efficient encryption algorithm, and even the author cannot decrypt the message if you forget the key, so make sure you choose a value you can remember! Pegasus Mail is prompting you to enter the password for this message: if you are trying to read the message, then Pmail needs it so that it can decrypt the message for you: if you are sending a message, Pmail needs the key to perform the encryption. The key can have up to eight characters, and should include only letters, numbers and underscore characters. The case of the key IS significant, so "DAVID" and "david" are different keys. Remember your key! Even the author cannot help you if you forget the key to a message! Enter here a short abbreviation for this entry: Pegasus Mail will use the abbreviation to sort the entries in the address book. Future versions may also allow you to access the address book directly from the 'TO:' field without calling it up, using the index value. The value you place in this field is purely for your own reference: normally, you would place a short description of the entry so you can see at a glance what it is while browsing through the list. This is Pegasus Mail's Address Book: it allows you to store up to 500 entries, each entry containing one or more mail addresses in any format acceptable to Pegasus Mail. You can call up the address book at any time, but if you call it from a TO: field, any address entries you select will be fed back to the field when you press . Groups are shown in the list with a '#' sign before them, and with a 'G' at the end of the entry: if your Supervisor has limited the ability to mail to groups, you might not see groups listed in this screen. To search the address book, press : Pmail will prompt you for a string to search for. You can enter any string or string fragment, and Pmail will proceed to search for that fragment in each Index and Address entry: if it finds a match, it will move the cursor to that entry. You can use regular expression characters in this field (* and ? characters) to limit the search. Press to select the current entry/marked entries or press to return without selecting. Carbon Copy: Enter in this field the names of people who should receive copies of the message. Cc: recipients are essentially people whom you want to 'overhear' the message: when they receive it, it will be marked as 'TO' the main recipient (s), but there will be a field in the message indicating that they are reading a Carbon copy. Pegasus Mail includes a full-function mail editor similar to WordStar (tm), capable of editing messages up to 32Kb in size. Some users, however, will prefer to use some other text editor to create messages, perhaps because they are more familiar with it, or because it offers some features which the internal editor does not. To use an external editor, place in this field the command you would type at the DOS prompt to invoke it. If the editor is not normally on your path, you should provide a full path to the program as well. Pegasus Mail will add the name of the file to edit to the end of the command you provide: if you need to add switches, or if for some other reason you need to specify where the filename should go, place the characters %s in the string at the place where the filename should appear. Editors which cannot accept a filename on the command line cannot be used. Messages created by external editors can be any size. Comments: the editor will have, on average, around 250Kb RAM available to it when it is invoked. The editor MUST be a plain ASCII text editor - DO NOT specify a word-processor here unless it creates plain ASCII text (most do not). Pegasus Mail does NOT depend on the ERRORLEVEL return of your editor to function correctly. If you specify that you want to use an external editor to create mail messages, you should also specify a scratch directory, or temporary workspace, in which Pegasus Mail can create the files necessary for transmission. Enter in this field the name of the directory to use, with NO trailing backslash (\) character. Temporary files created in the scratch directory will be deleted when Pegasus Mail has finished using them. If you regularly define a TMP, TEMP or BTMP DOS variable, then you do not need to enter a value here - Pegasus Mail will use that directory instead. Most editors will not accept filenames in NetWare syntax, so if your scratch space is on the file server, you will have to specify a path using a drive letter you know will be mapped. If you do not understand the significance of this field, you should contact your system manager for help prior to attempting to use an external editor. If you do not specify a temporary workspace, either here or by an environment variable, you will probably have trouble sending messages to users on other servers. This list displays users currently logged-in to the current file server. You can select their usercodes for insertion into an address field using , or to select them all, and you can send short messages to them by pressing M. Blind Carbon Copies are copies of messages which are sent without indication to the main recipient of the message, unlike Cc:, where the recipient sees a header stating that copies have been sent to certain people. Use Bcc: if you want to send a copy of a message to someone without the main recipient being able to tell that you have done so. Only the recipient of the copy will know that he has been Blind-copied. If you want the recipient(s) of this message to reply to an address other than your own normal address, enter the reply address here. This is useful for managers who might want replies to a message sent to their secretary, or if you are sending the message to a list of users. Pegasus Mail is offering you the chance to edit the fields in the message which are not displayed here, such as CC:, Reply-to and Encrypt. You can achieve the same effect by pressing in either the To: or the Subject: field. Pegasus Mail's editor is similar to WordStar, or to the Borland "Turbo" editors, but it has some differences, some omissions, and some extra features. In particular, the block operations are a bit different: ^KV and ^KC move/copy the marked area to a scrap buffer: you use ^KI to insert the scrap buffer at the cursor position. While you are editing a message, you can press any time and edit the headers (Cc:, Reply-to and so on) for the current message. You can paste entries from your address book into the current message using . The cursor will move back to the Subject: and To: fields if you press the arrow while at the start of the first line. To accept your message and send it, press . To cancel your message at any time, press ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Editor Quick Reference ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Movement: , , ,  Cursor one character/line <^Q S>, <^Q D> / ,  Cursor to start/end of line <^C>, <^R> / ,  Cursor a page at a time <^Q R> <^Q C> / <^PgUp>, <^PgDn> Top/Bottom of message <^Left>, <^Right> Move word left/right <^Q G> Goto line number Deletion: <^Y> Delete line <^End> Delete to end of line <^T> Delete word right Block: <^K B> Start block <^K C> Copy Block to buffer <^K V> Cut block to buffer <^K I> Paste buffer <^K M> Comment a block <^K R> Read a file <^K W> Write to file <^K H> Unmark block Other: <^Q F> Find text <^Q A> Find and replace  Next tab stop, or indent block , <^K Q> Abandon message <^Enter>, <^K D> Accept and send message <^P> Quote next character into document <^Q M>, <^Q T> Set wordwrap margin/set tabs In commands consisting of two characters, the second character can also be its equivalent - so, typing ^K^B has the same effect as typing ^KB. Blocks can start anywhere on a line, and may extend forwards or backwards from the starting point. To mark a block, type ^KB, then move the cursor to mark the area you want to affect. To turn off block marking, type ^KH. Most block commands will affect the whole buffer if no area is currently marked - so, ^KW will write a block to a file if one is marked, or the whole buffer if not. The following block commands are supported in Pegasus Mail: ^KB: Start marking a block at the cursor position. ^KH: Finish block marking. ^KV: Copy the marked block to the internal scrap buffer, then delete the original block from the message. ^KC: Copy the marked block to the internal scrap buffer, but do not delete the original block. Both of these commands require a marked block - they will not work on the whole buffer if nothing is marked. ^KI: Insert the current contents of the internal scrap buffer at the cursor position. The scrap is not cleared, and the operation may be repeated. ^KM: Mark a block: Pmail will prompt you for a marking string, then will prepend that string to the start of every line in the marked area, or in the whole document if no block is marked. ^KS: Suspend the current editing session. The next time you send a message, Pmail will ask you if you want to resume the suspended session. All details for the current message are saved. Only one session can be suspended at any time. ^KW: Write the marked area, or if none, the whole message to a text file. ^KR: Read a text file into the current message at the cursor position. ^KE: Invoke an external command (usually an editor). The marked area, or the whole message if none, is saved to a temporary file and deleted from the editor. Pmail will prompt you for an external command, using the "External Editor" string from your profile as a default. Enter a command, and Pmail will execute it, appending the name of the temporary file to the end of the string. Once the command has completed, the message will be read back into the editor. ^KO: Centre the marked area or current line within the edge of the screen and the current right margin. If the line has leading spaces, these are stripped and the line(s) recentred. ^KT: Toggle line-trimming. By default, Pmail allows you to have trailing spaces on lines, but you can force it to remove trailing spaces (like the Borland "Turbo" editors) with this command. Del: Delete the current marked area (not to scrap). ^KY will also delete the current marked area. Tab: Indent the marked block to the next tab stop. Sh-Tab: "Outdent" the marked block one tab stop. Pegasus Mail's editor supports the following commands for moving around in a message while you edit: : Move one unit in the arrow direction. ^S, ^D: Left one char, right one char. ^E, ^X: Up one line, down one line. ^-Left: One word to the left (^A does the same). ^-Right: One word to the right (^F does the same). PgUp: Top of screen, or up one screen if at top. (^R does the same). PgDn: End of screen, or down one screen if at end. (^C does the same). ^PgUp: Move to top of message (^QR does the same). ^PgDn: Move to end of message (^QC does the same). Home: Move to start of line (^QS does the same). End: Move to end of line (^QD does the same). ^Z, ^W: Scroll screen Up/Down one line. ^QG: Goto a particular line in the message. The editor provides facilities for finding and replacing text using the following commands: ^QF: Find text: you will be prompted to enter a string, which Pmail will attempt to find in the message. You will also be prompted for options (explained below). ^QA: Find text, and replace it with a string: you will be prompted for a string to find, just as for a search, then the editor will prompt you for a replacement, and options. Pmail will find the text, and replace it, possibly checking with you before doing so (see options). ^L: Repeat the last searching operation: if the last operation was a search, it will be repeated using the same string and options; if it was a replace, the editor will attempt to perform the same replace operation again. Options: When performing either a search or a replace, you will be prompted for Options: these are characters you can type to control the way the search or replace will be made. Options are single characters, can be entered in any order, and are not case-sensitive (ie, 'G' is the same as 'g'). The following options are offered: G: Global: start from the top of the message. If you do not specify G, the search or replace will start at the cursor position. U: Uppercase: ignore case while searching: if you specify this, then "hello" will match "Hello", "HELLO", "heLLo" or any other such combination. N: Do not confirm (only meaningful with Replace operations). If you do not specify N, then the editor will prompt you before each replace. R: Regular expression search: if you specify R, then some characters in your search string are handled specially: '*' matches any number of characters, '?' matches any single character, and '[' and ']' are regarded as enclosing sets of characters which can match any one character. You may have as many wildcards in a search string as you wish. Exercise caution using Regular expressions while replacing: the replacement string is always treated literally. The editor makes the following commands available for particular functions: Deletion: Del: Delete character at the cursor position. Bks: Delete the character left of the cursor. ^T: Delete the word to the right of the cursor. ^End: Delete to the end of the current line. ^Y: Delete the current line entirely. Others: ^N: Insert line break without moving cursor. Ins: Toggle insert mode: when in insert mode, the status line will show 'I', otherwise it will show 'O' (for overstrike). ^QM: Set right margin for wordwrap. When the cursor strikes the margin you've set, the current word will be move to the next line. To disable word- wrap, enter a right margin of 136. The editor will not allow a right margin less than 20. ^QT: Set tabs: the value you enter here will become the new distance between tab stops. Since the editor converts characters to spaces, this command will not affect existing text. ^P: Quote: insert the next character typed into the message, irrespective of what it is. ^V: Form digraph: this allows you to form a letter from the IBM extended ASCII set by 'describing' it. Enter two character, a base character and a modifier, press ^V, and the editor will form the correct extended value. Example: to form the '‚' character, type "e'" (e-apostrophe) then type ^V, and pmail will form it. Valid modifiers are: char + " forms char-umlaut (eg, a" -> „) char + ' forms char-acute (eg, e' -> ‚) char + ` forms char-grave (eg, e` -> Š) char + ^ forms char-circonflex (eg, o^ -> “) char + ~ forms char-tilde (eg, n~ -> ¤) char + / forms char-slash (eg, o/ -> í) c + , forms c-cedilla (ie, c, -> ‡) a + o forms a-ring (ie, ao -> †) << or >> forms ® or ¯ !! or ?? forms ­ or ¨ Alt-D and  on AT keyboards also form digraph characters. If you enter 'Y' in this field, then Pegasus Mail will always use the external editor you have specified for editing messages. If you enter 'N', then Pegasus Mail will continue using the built-in editor, but you can use your external editor "on demand" with the internal editor's ^KE command. Pressing ^KE in the editor allows you to pass a block or the whole file to a DOS command - perhaps another editor, or maybe a spelling checker. When the external command has completed, Pegasus Mail will read the file back into the internal editor. When you use ^KE, the default command (which can be edited on the editor's status line) is whatever you have entered as your external editor. Note that if you intend to use the ^KE feature, you should definitely define a scratch area on a local drive. If you enter 'Y' here, Pegasus Mail's browser will display messages exactly as they are received, with every header and continuation intact. Since many headers (particularly in SMTP mail) are not directly relevant to the content of the message, you may prefer the default, 'N', which tells the browser to tidy the headers, presenting them in a uniformly-spaced manner, and stripping out irrelevant entries. The value in this field never affects the message itself - just the headers attached to it. Enter a command here, exactly as you would at the DOS prompt, and Pmail will pass it to COMMAND.COM for the current file, or for all selected files. By default, Pmail will attach the name of the message file to the end of the string you enter: if you need to control where the filename appears, place the special string %s (a percent sign and a lower-case s) in the command at the place the name should appear. You may use DOS redirection characters (|, < and >) in any command entered here. DO NOT delete the message file with this command. Enter a string of characters Pmail should search for in the current message file, or selected files. Pmail will only match within single lines (you can't search across lines). You may use the special wildcard characters * and ? in search strings: * matches any number of characters while ? matches any single character. So, for instance, to search for all messages from ALKALI/DAVID, you could search for: From:*ALKALI/DAVID* Pmail will search files from the cursor position in the browser list, and will display any file found. If you enter Y in this field, Pmail will select (ie, mark) any files it finds containing the search string, rather than displaying them. This is useful. for instance, for selecting all messages from a particular user or on a particular subject for manipulation with other commands. You can enter any single address valid to Pegasus Mail in this field: if you do, all mail sent to you until you clear the field will be redirected to that address. You can enter a list in this field if the list is publicly accessible - Pmail cannot access lists in your private directories, so you must place the list somewhere where all users have access to it. You may use address overrides (PM:, MHS: and IN:) in this field, and you may use "chatty" RFC822 format addresses. If you enter an internet address in this field, it will be used by the Charon gateway to auto-forward mail when it comes to you. Note that you must enter an address in a form suitable for Charon - that is, either a strict RFC822 format address string, or a reference to a Charon list. If you enter a Y in this field, Pmail (and the Charon gateway) will still deliver any message for you to your mail directory as well as auto-forwarding it, if you have auto-forwarding enabled. If you do not have autoforwarding addresses defined, this field has no effect. If you enter Y in this field, then Pmail will not honour requests for confirmation of your having read a message. A user requesting confirmation of delivery will be told at the instant of mailing that you will not accept their request for confirmation, so they will know not to expect one, and will not be able to double-guess you. If you enter Y in this field then Pegasus Mail will not deliver mail to you at all. Anyone attempting to send mail to you will be notified at the moment of sending that you are not accepting mail, and no delivery will occur. If you enter Y in this field, Pegasus Mail will not broadcast "New Mail" messages to you when you receive mail while logged in. This flag does not affect the NEWMAIL program, which will still tell you what unread mail you have when you login. Set this flag if you receive a lot of mail, or if you find the notification messages annoying. Enter Y in this field if you want to be informed when the recipient actually reads the message. You will receive a mail message indicating the time and date the message is read. Note that individual users may be permitted by the Supervisor to refuse to acknowledge these requests: if you attempt to request confirmation from such a user, you will be advised at the moment the message is sent that no confirmation will be provided. If you enter an address in this field, it will be used as your default "Reply-to" address in outgoing messages. You can change the value on a message-by-message basis, but Pmail will automatically copy this field into the headers for you when you start editing a message. This feature is useful if you are using SMTP mail and your gateway is "hidden" behind a larger mailer. You should consult your system manager if you are unsure of the purpose of this field, and whether or not you should enter anything in it. This list contains all the file servers know on your network: servers to which you are attached are marked with an asterisk. From this list, you can select any server on which you have a usercode and attach to it. If you select a file server to which you are not attached, Pegasus Mail will prompt you for a usercode and password, and will log you into that server. Pressing will close the window, and leave your server attachment unchanged. Enter here the username you want to use to login to the indicated file server. Pressing will close the window and leave your attachment unchanged. Enter here the password associated with the usercode you have entered. If the usercode has no password, simply press . Your password will display as dots while you enter it, to protect it from prying eyes. Pressing will close the window and leave your attachment unchanged. Enter 'Y' in this field if you want Pegasus Mail to include a copy of the message you are replying to in your reply. The whole message will be included, and you can edit or delete parts of it. The original message is not altered in any way. This is useful for providing context when you are answering specific points of a message in your reply. If you enter 'Y' in this field, then the original message (if included) will be "commented out" - that is, every line in the original will be prefixed with the comment string you have defined in your profile. This is extremely useful for highlighting the sections of the original message you are replying to. Address options: this block of options allows you to extract addresses from the current message to form the TO: field of the reply. You can select any combination of these fields (the values of which are shown to the right), subject only to the maximum length of the TO: field (60 chars). From: Enter Y in this field if you want to reply to the original sender of the message. Address options: this block of options allows you to extract addresses from the current message to form the TO: field of the reply. You can select any combination of these fields (the values of which are shown to the right), subject only to the maximum length of the TO: field (60 chars). Reply-to: Enter Y in this field if you want to reply to any reply-to address specified in the message. Address options: this block of options allows you to extract addresses from the current message to form the TO: field of the reply. You can select any combination of these fields (the values of which are shown to the right), subject only to the maximum length of the TO: field (60 chars). Sender: Enter Y in this field if you want to reply to any Sender field in the message. A Sender field is typically present if you have received a message from an automated server, or from an auto-forwarding service. Address options: this block of options allows you to extract addresses from the current message to form the TO: field of the reply. You can select any combination of these fields (the values of which are shown to the right), subject only to the maximum length of the TO: field (60 chars). CC: Enter Y in this field if you want to reply to those people who received carbon-copies of the current message. Enter Y in this field if you would like any CC field in the current message to be copied into the CC field of your reply. This allows you to send carbon copies of your message to the same people copied in the original message. Entering addresses: You can enter addresses in a number of formats: more than one address can be entered, provided they are separated by commas. While in the TO: field, you can press for a listing of users on the current file server, to use the address book, or for a listing of users currently logged-in on the file server. Anything you select from these lists will be entered into the address field. You can perform "quick-lookups" from the address book by typing the index you defined for an entry in the To: field and pressing . When you enter an address, Pmail will attempt to verify it: with Pmail addresses, this involves ensuring that the user you have specified exists. With Internet and MHS addresses, Pmail merely checks that the interface is defined, and that you have the right to use it. Address overrides: occasionally, you might need to specify that an address should be sent a particular way, rather than allowing Pmail to determine what way to use. This is most likely to happen when you have both Internet and MHS services enabled in your system: Internet and MHS have similar-enough address formats that Pmail cannot easily tell them apart. It is possible to OVERRIDE an address by prefixing it with a special sequence of characters: the following are defined: "PM:" - send via Pmail's standard delivery agent. "IN:" - send via the Internet gateway. "MHS:" - send via the MHS gateway. For example, entering the address MHS:DAVID@ALKALI forces Pmail to send the message via the MHS service, if defined. Pegasus Mail's own mail delivery agent expects addresses in the standard NetWare syntax - SERVER/USERNAME. If the address is for a user on the current server, then the SERVER/ section is not required. Pmail can only deliver to other file servers if your Supervisor has enabled this feature. Example: the address DAVID is taken as meaning the user with the NetWare usercode DAVID on the current server. the address GANDALF/DAVID is taken as meaning the user called DAVID on the file server GANDALF. You can also deliver to NetWare user groups using the same syntax, but placing a hash character (#) in front of the group name. The Supervisor can restrict use of this feature to certain users only. Example: entering #EVERYONE tells Pmail to deliver to every member of the NetWare group EVERYONE on the current server. entering #ALKALI/EVERYONE tells Pmail to deliver to every member of group EVERYONE on file server ALKALI. Internet Address Format: Internet Mail is only available if the Charon SMTP Gateway (by Brad Clements, of Clarkson Uni- versity) is installed in your system. If Charon is installed, then you can enter any valid Internet address directly, and Pmail will pass it to Charon for delivery. Internet addresses are complex addresses of the general form: user@host.domain User: the name of the user you are sending to. Host: the name of the machine (host) where that user is found. Domain: the name of the site where that machine is found. Example: david@elrond.otago.ac.nz means user david, on the machine elrond, at the site otago.ac.nz (the University of Otago). Charon can also deliver to other file servers on your network using a simple variation of this format: entering user@host (note - no domain), where host is the name of a NetWare server, will cause Charon to deliver to that server. So: david@alkali is equivalent to the Pmail address - alkali/david Special considerations: * Mail containing extended IBM characters (like the foreign alphabets, or the line-draw characters) will change if sent via Charon: the high bit will be stripped from these chars, resulting in odd-looking messages at the other end. * Files sent to Internet addresses are always transformed by a process called UUENCODING, which allows binary (eight-bit) data to be sent, but is quite a lot larger in size. In some systems, you will not be able to send large files to Internet addresses without manually uuencoding and breaking them up. Address lists: if you regularly send mail to lists of users, or to more users than you can fit in one command line, you can create a file containing that list, and access that file from here. List files must be plain text files - you can create them easily with the "Edit a file" option on the main menu. To use a list file, type the special character @, followed by the name of the file. Complete paths are allowed, and are necessary if the file is not in the directory you were in when you ran Pmail: NetWare paths are also allowed. Pmail will report an error at once if the file cannot be found. The list file contains any number of addresses, one per line, in any format recognised by Pegasus Mail. You may include user groups (#GROUPNAME), Internet or MHS addresses, overridden addresses, and even other list files (up to a maximum of 5 levels deep). You may use two special entries at the start of the list file to control the format of the message: \sender - create a special header in the message showing that the message is to . Particularly useful for mailing lists and the like where you want to indicate that the message was sent to a general group, rather than just an individual. \replyto - allows you to specify
automatically as the "Reply-to" field of the message. This means that when someone receiving the message attempts to reply to it, they will reply to the address you specify, rather than to the list. Note that the onus is on you to ensure that the TO: address and Reply-to: address are appropriate in context: if the members of the list are all Internet addresses, you should provide To: and Reply-to: addresses which are also internet addresses: most receiving mailers will not understand Pmail or MHS addresses. Pegasus Mail provides an address book, in which you can store commonly-used addresses for quick lookup later. You can call up the address book at any time by pressing : if you are in an address field when you call it, you will be able to select and enter addresses from the book into that field. The address book is easy to use, and consists of two types of entries - System entries, and user entries. You cannot modify system entries - they are created by the Supervisor, and are available to everyone. User entries are those addresses you have added to your own address book. They are stored separately and are available only to you. To create an entry, highlight the "Add new entry" bar at the top of the list, or press . A dialog box will open asking you for an index, a description, and the address. The index is used by the address book to sort the entries, and can be used for quick lookups (see below). The description is simply the text appearing in the address list which describes the entry, while the address is the actual address Pmail should enter when you select the entry. Pmail does not attempt to validate the address at this stage, so you can enter anything here. While you are in any Address field, you can perform a "quick lookup" from the address book by typing enough characters to identify the index for the entry you want, then pressing . Pmail will search for the address, and enter it in the field for you, replacing the index you typed. If the index you type matches more that one entry, the FIRST entry in the address book is used. This is chronological, not alphabetical. If you choose to add an entry to the address book while browsing a message, Pmail will automatically supply the From: address of the current message in the address field for you. If you add an address while sending a message, the contents of the To: field are supplied for you in the address field of the entry. Pegasus Mail's address parser is compliant with the Internet standard for messages, RFC-822. This means that you can enter any address valid in RFC-822 terms, and Pmail will parse it correctly. RFC-822 addresses allow a "chatty" format which includes a human-readable form of the address. Without going too much into the details of RFC-822, the following general address forms are valid: * Human-readable user name * "Human-readable user name" real-address * (Human-readable user name) real-address * real-address Although this sounds obscure, its real use to the average user is to allow you to include the name of the recipient as well as his username. This can aid delivery if your message goes to the wrong address, particularly when the username does not obviously identify the addressee: example: "David Harris" For further details on RFC-822 message formats (if you're a real masochist) obtain the RFC from NIC.DDN.MIL on the Internet, or by asking your friendly local UNIX guru (if he can remember how to talk). If you enter 'Y' in this field, Pegasus Mail will delete any message after it has been successfully archived using the 'Archive' option in the browser. If you set this field to 'N', then the message will be left in the folder after archiving. Pegasus Mail's Archive manager allows you to store messages in a specially-compressed format: on an average NetWare system, disk usage savings can run to 85% when using archives. When you select the archive manager, the archive selection window pops up: either choose an archive to work with, or create one by selecting the "New archive" bar at the top of the list. You can also delete an archive by highlighting it and pressing . When you select an archive, a window will open showing its current contents. The messages are stored with a special abbreviated header which shows only a pr‚cis of each message's sender, subject and date. You can mark multiple messages for deletion using or , as in other lists. The following additional options are available when working with archived messages: * Press to delete a message or any marked messages from the archive. After you have deleted 20Kb from an archive, there will be a brief pause while it is compressed. * Press to see the contents of the message. * Press to reply to an archived message: a temporary copy of the message will be made in your mail directory, and you will be able to edit and reply normally. * Press to extract the current message: a popup-menu will appear allowing you to choose between extracting the message to one of your mail folders, where it will appear just like any other message, or to another file, which allows you to create a copy of the message in any directory of your choosing. You can finish using the archive manager at any time by pressing the key. If you enter Y in this field, Pegasus Mail will automatically place any message copies to self in an archive called COPYSELF, rather than in the folder you specified above. Placing your copies in an archive can result in dramatic savings in disk usage, at very little cost in flexibility. To manipulate copies to self stored in an archive, you must use the Archive Manager, accessible by pressing at any time. You can change this flag at will: while it is Y, messages will be added to the archive, and while it is N, they will be copied as files into the folder you specified above, or (if none) into your home mailbox. We recommend you archive your copies to self. Address options: this block of options allows you to extract addresses from the current message to form the TO: field of the reply. You can select any combination of these fields (the values of which are shown to the right), subject only to the maximum length of the TO: field (60 chars). To: Enter Y in this field if you want to reply to the person to whom the message was addressed: this is normally only useful if the message was addressed to a list, for instance. You can select any item in this list by moving the light bar to it and pressing . The list might contain "system entries" which are provided by the system manager: you cannot delete, rename or edit system entries. You can delete any of your own entries by highlighting it and pressing (you can't mark multiple entries). You can rename any of your own entries by pressing <^R>. You can create a new entry by pressing . Pegasus Mail allows you to place print entries into NetWare print queues even if you are not currently capturing to them. Enter the name of the queue you want to print to in this field. You can list the available queues by pressing while in this field. An error will occur if you try to print to a queue to which you have no rights. If you want to print a message to a file, enter the name of the file in this field. The name can be in either DOS or NetWare format, and can have a path attached. If you are printing to a printer which uses the PostScript typesetting language (for instance, an Apple LaserWriter), set this field to 'Y'. If you set this field to 'Y', you will be able to choose from a list of fonts in the next field. Some printers may not support all the fonts in the list - if you choose one which your printer does not have, the document will either not print, or will print in Courier. Remember that selecting Proportionally-spaced fonts such as Times-Roman will throw tables and columns out of alignment. Enter in this field the length of the paper you will be printing on, expressed in lines, at 6 lines per inch. So, if you are using standard US Letter paper, enter 66 (6 x 11"). Or, if you are using A4 paper, enter 70 here (6 x 11.69"). Pegasus Mail can swap itself out of memory when you run any DOS task, including the DOS shell (Ctrl-F10): it will relocate almost all of itself in EMS, or on your hard disk while the other task runs, then will reload itself afterwards. Swapping may be desirable if you want to run large programs (e.g. WordPerfect) from within Pmail. We have found no conflicts with other programs, but there can be a performance degradation when swapping. Set this to 'Y' if you want Pmail to swap itself out, or to 'N' if you want it to remain resident. If it remains resident, the RAM available to the task will be reduced by around 250Kb. If you want to modify the message before forwarding it to the new recipient, set this field to 'Y': Pmail will open the message editor, and copy the message in, with a marker showing where the original message begins. Enter 'Y' in this field if you want Pegasus Mail to generate a banner page for this print job. The banner page simply contains your username, the time of printing, and the name of the sender of the first message printed. Banners are particularly useful if printing to a queue, so your job can be distinguished from those of other users. If you are printing to a captured printer port with NetWare banners turned on, you should set this field to 'N', since you will get two banners otherwise (Pmail generates its own). Pegasus Mail knows how to generate banner pages for PostScript printers, unlike the normal NetWare CAPTURE command. You are examining a file in this window: the file cannot be modified (because it is read-only on disk, or because it is a system file). You can move around in the file using the arrow and page keys. Press or when you have finished. Help on the Browser Screen The Browser Screen lists all the messages in the current folder. If you selected "N: check for New mail" from the main menu, then the list will show all your unread messages. The 'A' option on this screen only MOVES messages to archives: to manipulate archives, press to call up the archive manager. You can change and manipulate folders by pressing . Remember that help is available by pressing . Please press now to return to the Browser Screen. Help on sending mail messages In this screen, you compose messages for sending. Enter the address of the user you want to mail to, a subject (which is just a brief pr‚cis of the message), then edit your message. At any time in this screen, you can view and change many options which affect how the message will be handled (like CC, BCC, copy-self, encryption and so on) by pressing . Press for comprehensive help. While you are entering the address, you can press to obtain a list of users on the current server, for your address book, for a list of logged-in users, for the distribution list manager, and for the archive manager. You can cancel the message at any time by pressing . Press now to return to the message editing screen. Enter 'Y' in this field if the file you are sending is a plain text file - that is, contains ONLY ASCII characters in the range 1-127. If the document has binary information, characters from the extended IBM ASCII set (such as line draw characters), or if you are not sure, you should enter 'N' here. If you enter 'Y', the file you specify will be sent as if it were a message you had typed in. If the file is larger than 32Kb and the recipient is also using Pmail, he will have to extract it to be able to read it. NOTE: Most word processors and spreadsheet programs DO NOT create ASCII files - they normally include special characters to indicate formatting.