POPMail / PC An electronic mail package for the IBM PC Version 3.1 produced by The Microcomputer and Workstation Networks Center University of Minnesota (c) 1991, 1992 University of Minnesota - POPMail / PC.................Table of Contents 1. Table of Contents 1. Introduction..................................2 1.1 What is it?................................2 1.2 Background and Philosophy..................3 1.3 Overview...................................3 2. POPMail Elements..............................6 2.1 In this chapter............................6 2.2 Menu Bar...................................6 2.3 With a mouse...............................6 2.4 From the keyboard..........................7 2.5 Shortcuts for advanced users...............7 2.6 Status Bar.................................7 2.7 Dialog boxes...............................8 2.8 Buttons....................................9 2.9 Input Boxes...............................10 2.10 Check Boxes..............................10 2.11 Radio Buttons............................11 2.12 List Box.................................11 2.13 Editing Text.............................12 3. Installation.................................14 3.1 In this chapter...........................14 3.2 Installation steps........................14 3.3 System Requirements.......................14 3.4 Discussion................................15 3.5 Getting access to a mail server...........16 3.6 How to Obtain POPMail.....................17 3.7 Redistributing & using POPMail/PC.........17 3.8 From your network administrator...........17 3.9 Getting it yourself by FTP................17 3.10 Installing POPMAIL.......................20 3.11 Loading the Packet Driver................20 4. Configuring POPMail..........................22 4.1 In this Chapter...........................22 4.2 The configuration process.................22 4.3 User Name.................................23 4.4 Password..................................23 4.5 Host Computer.............................23 4.6 To enter these values.....................24 4.7 Entering other IP numbers.................24 4.8 Microcomputer IP address..................24 4.9 Gateways..................................25 4.10 Name Servers.............................25 - POPMail / PC.......................Version 3.0 ii - POPMail / PC.................Table of Contents 4.11 Subdirectory for Mail....................25 4.12 Time Zone................................25 4.13 Language.................................26 5. POPMail's Windows............................28 5.1 In this Chapter...........................28 5.2 Overview..................................28 5.3 The Composer Window.......................28 5.4 Sending Mail to Other Users...............29 5.5 Go to the Composer window.................30 5.6 Specifying the Recipient..................30 5.7 Specifying the Subject....................31 5.8 Type the Message..........................31 5.9 Sending the message.......................32 6. Sending Mail - Advanced Topics...............34 6.1 In this Chapter...........................34 6.2 Sending Carbon Copies.....................34 6.3 Sending Mail to a Group...................34 6.4 Creating Groups...........................34 6.5 Choosing a Predefined Group...............35 7. About Enclosures.............................38 7.1 In this chapter...........................38 7.2 Why Enclosures............................38 7.3 Sending Enclosures........................39 7.4 Sending multiple enclosures...............40 7.5 Enclosures for non-POPMail users..........41 7.6 Pure text enclosure.......................41 7.7 Quirks in Exchanging Documents............42 7.8 Exchanging MS Word documents..............42 7.9 File converters...........................42 7.10 Other considerations.....................43 7.11 Getting Enclosures from a Mac............43 7.12 Sending Enclosures to a Mac..............43 8. The Viewer Window............................46 8.1 In this chapter...........................46 8.2 Background................................46 8.3 Fetching Incoming Mail....................47 8.4 Paging through your messages..............47 8.5 Replying to Incoming Mail.................48 8.6 Forwarding Mail...........................48 8.7 Viewing very long messages................48 - POPMail / PC.......................Version 3.0 iii - POPMail / PC.................Table of Contents 9. Managing your messages.......................50 9.1 In this chapter...........................50 9.2 Background................................50 9.3 Going from folder to folder...............50 9.4 Mail flow.................................51 9.5 The Message Index.........................52 9.6 Overview..................................52 9.7 Turning on/off the index display..........52 9.8 Browsing through the index................52 9.9 Browsing through the index................53 9.10 Managing messages........................54 9.11 Marking..................................54 9.12 Marking one message at a time............54 9.13 Marking many messages....................54 9.14 Marking messages with....................55 9.15 Advanced mark with.......................56 9.16 Operating on marked messages.............56 9.17 Moving messages..........................56 9.18 Trashing messages........................56 9.19 Copying messages.........................57 10. Command Reference Guide.....................58 11. The "File" Menu.............................58 11.1 Open.....................................58 11.2 New......................................59 11.3 Save.....................................59 11.4 Save As..................................59 11.5 Change Dir...............................60 11.6 Print....................................60 11.7 Exit.....................................60 12. The "Edit" Menu.............................62 12.1 Undo.....................................62 12.2 Cut......................................62 12.3 Copy.....................................62 12.4 Paste....................................63 12.5 Find.....................................63 12.6 Search and Replace.......................64 12.7 Clear Composer...........................64 13. The "Manage" Menu...........................66 13.1 Go to folder.............................67 13.2 Sort folder.............................68 13.3 Mark current message.....................68 13.4 Mark All messages........................68 - POPMail / PC.......................Version 3.0 iv - POPMail / PC.................Table of Contents 13.5 Unmark all messages......................68 13.6 Mark messages with.......................68 13.7 Move marked messages.....................69 13.8 Delete marked messages...................69 13.9 Copy marked messages.....................70 13.10 Empty Trash.............................70 14. The "Setup" Menu............................72 14.1 Lines/screen.............................72 14.2 Preferences..............................72 14.3 Signature................................73 14.4 Network..................................73 14.5 User Name................................73 14.6 Password.................................73 14.7 Host Computer............................74 14.8 To enter these values....................74 14.9 Entering other IP numbers................75 14.10 Microcomputer IP address................75 14.11 Gateways................................75 14.12 Name Servers............................75 14.13 Subdirectory for Mail...................76 14.14 Time Zone...............................76 14.15 Language................................76 14.16 The Test Button.........................76 14.17 Groups..................................77 14.18 Printer.................................78 14.19 Trace...................................78 15. The "Window" Menu...........................80 15.1 Close....................................80 15.2 Resize/move..............................80 15.3 Next Window..............................80 15.4 Zoom.....................................81 15.5 Cascade..................................81 15.6 Viewer...................................81 15.7 Composer.................................81 15.8 Show clipboard...........................81 16. The "Help" Menu.............................82 17. Sending to other mail systems...............82 17.1 America Online...........................83 17.2 Applelink................................83 17.3 AT&TMail.................................83 17.4 Bitnet...................................83 17.5 BIX......................................83 - POPMail / PC.......................Version 3.0 v - POPMail / PC.................Table of Contents 17.6 CompuServe...............................84 17.7 Connect..................................84 17.8 Dialmail.................................84 17.9 Econet...................................84 17.10 MCI.....................................84 17.11 SprintMail..............................85 17.12 Summary.................................85 17.13 Other mail services.....................85 18. Setting POPMail Preferences.................86 18.1 Include message in Reply.................87 18.2 Add signature to outgoing mail...........87 18.3 Save copy of outgoing mail...............87 18.4 Check for mail at startup................87 18.5 Prompt for password......................87 18.6 43/50 line mode as default...............87 19. Desk Accessories............................88 19.1 Calculator...............................88 19.2 Calendar.................................88 19.3 ASCII Table..............................89 19.4 IP Finder................................89 19.5 U of M Address Book;.....................90 19.6 Flexible address book....................91 19.7 Ping.....................................91 19.8 Webster..................................92 20. Other Features..............................94 20.1 Text Editor..............................94 20.2 Moving a Window..........................94 20.3 Resizing windows.........................94 20.4 Zooming Windows..........................94 20.5 Trace Facility...........................95 21. Advanced configuration......................98 21.1 Preferred Full Name......................99 21.2 Net mask.................................99 21.3 Domain request timeout...................99 21.4 Connect timeout..........................99 21.5 I/O timeout..............................99 21.6 Retransmit timeout......................100 21.7 Max transmit unit in bytes..............100 21.8 Max segment we can receive..............100 21.9 Most bytes without ACK..................100 21.10 POP port...............................100 21.11 Finger port............................101 - POPMail / PC.......................Version 3.0 vi - POPMail / PC.................Table of Contents 22. Program Switches...........................102 22.1 The /PATH option........................102 22.2 The /BATCH option.......................103 22.3 The /MEM option.........................103 22.4 The /D option...........................103 22.5 The /NOEMS option.......................104 22.6 The /MONO option........................104 22.7 The /GRAY option........................104 23. Multi- function Buttons....................106 23.1 Shift-Send..............................106 23.2 Shift-Discard...........................106 23.3 Shift-Enclose...........................106 24. Acknowledgments............................106 25. Miscellaneous Technical Issues.............108 25.1 Network card Drivers....................108 25.2 POPMail and Lan Manager.................108 25.3 Using its own TCP driver................108 25.4 Using FTP Inc's Driver..................109 25.5 PCNFS and other TCP drivers.............109 25.6 POPMail and Novell NetWare..............109 25.7 NetWare & packet driver.................110 25.8 NetWare & ODI...........................110 25.9 POPMail and Windows 3.0.................110 26. Character sets.............................112 26.1 Introduction............................112 26.2 In depth................................112 26.3 How POPMail does it.....................113 26.4 With outgoing mail......................113 26.5 With Incoming mail......................113 27. Upgrading 2.XX to 3.1.....................114 27.1 Changes from version 2.XX...............114 28. Future Enhancements........................116 29. Questions & Answers........................117 - POPMail / PC.......................Version 3.0 vii - POPMail / PC.................Table of Contents 29.1 Not enough memory.......................117 29.2 Defining groups.........................117 29.3 POP3 servers............................117 29.4 "TCP did not load" error................117 29.5 Manual format...........................118 29.6 BOOTP support...........................118 29.7 Multiple packet drivers.................118 29.8 3c503 problems..........................118 29.9 POPMail as a TSR........................119 29.10 POP2 described.........................119 29.11 Password encryption....................119 29.12 Where are packet drivers...............120 29.13 Connection problems....................120 29.14 Dialup mail............................120 29.15 No Full Name...........................121 29.16 Implementation Language................121 30. For more Help..............................121 30.1 If you like POPMail.....................122 31. Error Messages.............................124 32. Index......................................135 - POPMail / PC.......................Version 3.0 viii - POPMail / PC Introduction 1. Introduction 1.1 What is it? POPMail is an electronic mail (E-mail) system for personal computers. With POPMail you can send and receive E-mail messages to anyone on your local-area network or to anyone on the Internet. The Internet is a large network that spans the globe, and is commonly available at colleges, government institutions, and private companies around the world. There are POPMail programs available for the IBM PC and for the Apple Macintosh series of microcomputers. This manual is about POPMail for IBM-PC, and 100% compatibles. In this document, for the sake of simplicity, we will often refer to these computers as IBM's or PC's. When we talk about "POPMail", we usually mean just the programs the run on your personal computers. POPMail also depends on a network and TCP/IP mail servers to store and forward mail messages. POPMail was designed and written by microcomputer support staff at the University of Minnesota. POPMail is easy to use. Its ease of use is due to two main design principles-- (1) POPMail keeps things simple, and (2) it uses a graphical user interface (GUI). The "keep it simple" principle m+eans that, as much as possible, there are no arcane commands and procedures. Simple ideas such as "fill in the blanks" amd "Press Send". The Graphical User Interface means that you operate on objects on the screen, you don't type arcane commands. With a GUI, you interact with the program by responding to graphical symbols on the computer screen, rather than by issuing single line commands (as with the MS-DOS operating system). Because of its intuitive user interface, POPMail is largely self-explanatory and very easy-to-use. If you are familiar with the GUI in Microsoft Windows or the Apple Macintosh operating system, you will be able to run POPMail without much help from this manual. But with POPMail you don't pay the high price of most GUI's. POPmail appears to have a graphical user interface (GUI). Actually, POPMail only uses the regular IBM-PC characters, but in a clever way that emulates a true GUI. For this reason, POPMail - POPMail / PC Version 3.1 2 - POPMail / PC Introduction runs on a wide range of IBM PCs and compatibles, including the earliest PCs which contained a monochrome display adapter (with no graphics support). In other words, with POPMail you get many of the advantages of a GUI, including intuitive commands and ease of operation-- without the disadvantages of a GUI, such as slower operation, increased memory usage. Unlike full GUI's, such as MS Windows 3, POPMail does not require a special graphics display adapter or display in your computer. Any IBM PC or compatible can take advantage of POPMail. 1.2 Background and Philosophy A good E-mail system should have three qualities: wide connectivity, ease of use, and reasonable cost. We designed POPMail with these three goals in mind. Wide connectivity is crucial because most people do not want to use three or four different E-mail packages to communicate with colleagues who use different computers. POPMail lets you exchange E-mail with mainframes, workstations, and personal computers. POPMail not only can talk to a variety of computers, it talks through a large network. This lets you exchange E-mail with people on the worldwide internet (CICNET, NSFNET, and MRNET) and on BITNET Many mainframe computers and workstations have mail programs with wide connectivity, but often these E-mail programs are difficult to learn and use. POPMail gives you wide connectivity in a user- friendly environment. In addition, POPMail is free (in the public domain). POPMail's name is derived from Post Office Protocol (POP), the protocol that defines how a computer can retrieve mail from another computer which acts as a shared post office or mail- server. POPMail uses either the POP2 or POP3 protocol to communicate between POPMail and the mail server. 1.3 Overview To use POPMail you need to have access to two computers, formally known as the POPMail client and the POPMail server. The POPMail client computer can be any IBM PC or compatible. This is the computer at which you send and receive messages. The POPMail server is usually a larger central computer that acts as your post office (also known as a POP server). Incoming mail is held in your mailbox on the post office server until you use your POPMail client on your microcomputer to call for the mail. This process is similar to having your paper mail held for you in - POPMail / PC Version 3.1 3 - POPMail / PC Introduction a P.O. box at the U.S. Post Office. Like the paper mail user, those who use POPMail do not need to know how the post office business works; they just need to know how to collect their mail. - POPMail / PC Version 3.1 4 - POPMail / PC Elements 2. POPMail Elements 2.1 In this chapter In this chapter we'll discuss the main parts of POPMail's user interface. If you are already familiar with terms like Menus, Check Boxes, Dialog Boxes, and the like, you may be able to skip this chapter. If you are new to computers, or to GUI's, this chapter may be useful. 2.2 Menu Bar The very top line of the computer screen displays POPMail's menu bar: Ŀ File Edit Manage Window Setup Help The menu bar is your first point of communication with POPMail. All of the menus on the menu bar have "pull-down" labels; that is, when you select Edit in the menu bar, the edit menu drops down from the Edit menu label. You can use either a mouse or the keyboard to select commands. 2.3 With a mouse To use the mouse, simply click on a menu title. This will "pull down" the menu. (Use only the left mouse button if your mouse has more than one button). Then click on the desired command. Or you can push the mouse button over a menu title and then hold the mouse button down while you move the mouse down from the menu title to the desired command. Then release the mouse button. If you decide not to choose a command, just move the mouse cursor out of the boundaries of the pull-down menu and release the mouse button. Then no action will be performed. - POPMail / PC Version 3.1 6 - POPMail / PC Elements 2.4 From the keyboard To choose menu commands using the keyboard, first press the F10; key to make the menu bar active. Use the arrow keys until the menu you want is highlighted. Once you have pulled down the menu, use the up-down arrow keys to highlight the command you want and press ENTER to choose (perform) the highlighted command. The individual items under the pull-down menus are shown below. Highlighted letters (shown here as capital letters) are used to perform the various short-cuts described in the previous section and elsewhere in this manual. Note that the highlighted letter (shown here as a capital letter) associated with each command is not always the first letter of the command. In addition, some menu commands are considered to be so important that they can be activated with a hot key alternative. These hot keys are also shown below. Some of the menu commands end in three periods (...). These lead to a dialog box where you choose other options. Commands not ending in ... need no more options; they take effect immediately. 2.5 Shortcuts for advanced users To choose a menu, press F10, then the first letter of the menu. Then press the ENTER key to pull-down the menu. There also is a hot-key alternative method to pull-down a menu. Hold the Alt key down while typing the letter corresponding to the first letter of the menu title you want (e.g., type Alt-F to pull-down the File menu). The hot key to pull-down the = menu (called the system menu) is Alt-Spacebar. To choose an item from a pulled-down menu, press the highlighted letter of the desired command in order to choose it. 2.6 Status Bar POPMail's status bar is located across the bottom line of the screen. The status bar looks like this: Ŀ F2 Compose F3 Fetch F4 Forward F5 Reply F6 Delete F7Prev Msg F8Next Msg - POPMail / PC Version 3.1 7 - POPMail / PC Elements The status bar contains "hot spots." Hot spots are located wherever words occur in the status bar. For example, "F3 Prev Msg" constitutes one hot spot. Hot spots are separated from each other by more than one space. When you click on a hot spot with a mouse, the indicated function will be carried out. For example, when you click on the words "F8Next Msg", POPMail displays the next message stored in your mail folder; when you click on the words "F2 Compose", POPMail takes you to the Composer window, allowing you to compose a new mail message. You can also hit hot spots from the keyboard. If you press the F2 function key, POPMail will display the Composer window. 2.7 Dialog boxes Once you choose a menu item, POPMail will do one of two things: either carry out the command immediately or display a dialog box. If a menu command is followed by three periods, (e.g., Save As...), you'll see a dialog box. A dialog box is a question- and-answer session which asks you to make some choices and fill in the blanks before POPMail will proceed. See Figure 1 Ŀ [] Generic Dialog Box ͻ Sort entries by: (*) By arrival time [ OK ] ( ) By subject ( ) By sender [ Cancel ] ͼ Figure 1 - A typical dialog box. Note that while a dialog box is displayed, the menus are inactive-- i.e. you cannot use the menus or function keys while the dialog box is up. In order to set options in a dialog box, you use five on-screen gadgets. These five gadgets or "controls" are: * radio buttons * check boxes * software buttons - POPMail / PC Version 3.1 8 - POPMail / PC Elements * list boxes * input boxes These are all described below. Note: Inside a dialog box, any item with a highlighted letter indicates that that particular gadget can be accessed by holding the ALT key down while typing that highlighted letter. 2.8 Buttons Ŀ [ OK ] Figure 2 - A typical Button To choose a button with the mouse, move the cursor pointer over the button and then click the mouse button. The modal dialog box shown in Figure 1 has two software buttons: oK and Cancel. If you choose oK, the choices you select in the dialog box are instituted. If you choose Cancel, nothing happens and the dialog box goes away without instituting any of your changes. If you do not have a mouse, use the keyboard command equivalents to choose and activate a button. You can press the TAB key to advance forward through the dialog box until you've selected the desired button. The currently selected button becomes highlighted (brighter than usual). Once you've TAB'ed to the desired button, press the ENTER key to choose that button. If there are many buttons in this dialog box, it might be quicker for you to tab backwards through the buttons to get to the desired button. You can tab backwards by pressing Shift-TAB to move backwards in a dialog box. If you are satisfied with your choices in a dialog box, you can type Alt-K to activate the OK button. The OK button signals that you are done with this dialog box and wish to continue with these choices. If you do not like the choices you have made in this dialog box, you can reject these choices by pressing the CANCEL button, or by - POPMail / PC Version 3.1 9 - POPMail / PC Elements typing the ESC key. The settings will stay as they were before you opened up the dialog box. 2.9 Input Boxes Input boxes let you enter text. For example, in one of POPMail's dialog boxes, POPMail requires that you enter your full name in an input box. If you type in more text than will fit within the input box, the text will scroll automatically. 2.10 Check Boxes Some dialog boxes also have check boxes. An [X] indicates that option is set ON. An empty box [ ] indicates it's OFF. You set a check box to the ON- or OFF-state by clicking on the square or by clicking on the text immediately to the right of the square. If you do not have a mouse, press the TAB key one or more times until the check box is highlighted and then press the Spacebar. Alternatively, you can turn a check box ON or OFF (toggling) by holding the Alt key down while typing the highlighted letter (if one is provided). Any number of check boxes can be checked ON at any one time. Ŀ [ ] Generic Check Box Figure 3 Typical check box If several check boxes are grouped together, press the TAB key to move to the next group. Once the group is selected, you can use the up-down arrow keys to highlight the check box you want within the group, and then press the Spacebar to turn the individual check box ON or OFF. On monochrome monitors, POPMail indicates the highlighted check box or group of check boxes by placing a chevron symbol () next to it. When you press TAB, the symbol moves to the next check box or group of check boxes. - POPMail / PC Version 3.1 10 - POPMail / PC Elements 2.11 Radio Buttons Radio buttons work just like check boxes, except that one and only one radio button in a group is ON at any one time. Since only one radio button in a group can be ON at a time, any other button in the group which was previously turned on is turned OFF automatically when you select another. Ŀ (*) Radio button #1 ( ) Radio button #2 ( ) Radio button #3 Figure 4 Typical group of radio buttons 2.12 List Box A list box lets you scroll through a list of choices. You activate a list box by clicking in it or by pressing the TAB until it's highlighted. Once a list box is active, you can use the mouse to manipulate the scroll bar (or if you do not have a mouse, press the up-down arrow keys to move within the list). Ŀ [] Generic List Box ͻ Folders: AAAA  BBBB CCCC EMPTY INBOX NUPOP SAVE SENTMAIL  ͼ Figure 5 Typical list box - POPMail / PC Version 3.1 11 - POPMail / PC Elements 2.13 Editing Text POPMail contains basic word-processing features. Anywhere in POPMail, the DEL key deletes text forward from the current cursor position, and the backspace key deletes text to the left of the cursor position. In most places you can use the mouse to drag over (select) text to be cut or copied. Without a mouse, you select text by holding the Shift key down and pressing the arrow keys to expand the amount of text selected, starting with the current cursor position. Once the text is selected (highlighted) you can cut the selected text, by selecting Cut from the Edit menu. Likewise, to copy selected text, select Copy from the Edit menu. Once selected text has been cut or copied, it is stored temporarily in POPMail's clipboard. To paste the text contained in the clipboard, position the cursor in the desired location and then select Paste from the Edit menu. Note: Every Cut or Copy command overrwrites whatever was on the Clipboard with the new text, so don't do a Cut or Copy if you have something important on the Clipboard. POPMail does not support underlined, bold, or italic text. If you are familiar with WordStar, then you'll be pleased to know that the POPMail editor also uses the WordStar control keys sequences for cursor movement: Ctrl-E = Line Up; Ctrl-R = Page Up; Ctrl-F = Next Word; Ctrl-Y = Delete Line, etc - POPMail / PC Version 3.1 12 - POPMail / PC Installation 3. Installation 3.1 In this chapter In this chapter we'll discuss how to install POPMail on your computer. You can skip this chapter if POPMail is already installed and running on your personal computer. 3.2 Installation steps To install POPMail on your personal computer, follow these steps: * Check that you have everything listed below under "system requirements". * Get the POPMail software, as described below under "getting the POPMail software". * Install POPMail. * Configure POPMail. 3.3 System Requirements You need the following to run POPMail: Hardware: (1) An IBM-PC or 100% compatible, with at least 512K of RAM, (640K preferred). (2) A hard disk or a floppy disk with at least 500K of free space (much more desirable). (3) A network connection. This could be through: * an Ethernet adapter card hooked to an EtherNet network. * a LocalTalk adapter card connected to a LocalTalk network. * a serial port and a modem (2400 bps or greater) connected to a telephone network. (4) Any kind of IBM-PC display adapter and display including MDA, CGA, MCDA, EGA, VGA, XGA, SVGA. Software: (1) PCDOS or MSDOS version 3.0 or greater. - POPMail / PC Version 3.1 14 - POPMail / PC Installation (2) A packet driver for the above network card. Accounts: You need a e-mail account on a mail server. Optional and desirable: (1) at least 300K of EMS (expanded) memory. (2) a Microsoft compatible mouse. (3) "SMARTDRV.SYS" or similar disk caching software. 3.4 Discussion In order to run POPMail, your microcomputer must be connected to a local area network (LAN). Usually, the LAN will be connected to a backbone network, allowing you to send and receive mail outside your local work group. In order for your microcomputer to operate on the LAN you must have a network adapter card installed in your microcomputer. POPMail takes an interesting approach to talking to network cards. It doesn't. POPMail does not know how to talk directly to any network card. Unlike some network programs such as NCSA Telnet, which know how to talk to some network cards, POPMail doesn't know how to talk to any card. It does know how to talk to something called a "packet driver." The packet driver is a piece of software, actually a small program, that does know how to talk to a network card. Packet drivers exist for most network cards. Many new cards now come with packet drivers. There are also many packet drivers for older cards in the public domain, meaning it costs you nothing to acquire and use these packet drivers. There are several advantages of having POPMail and your other network programs talk to the network through a packet driver: (1) We do not have to change POPMail as new network cards become available. (2) You do not have to get a new version of POPMail for new network cards. You just need to get the proper packet driver. (3) You just have to configure *one* program, the packet driver, with information about your network card, instead of having to tell POPMail, Telnet, Gopher, Novell, trumpet, etc.... For these reasons and others, we suggest you use the packet drivers for all your network access. - POPMail / PC Version 3.1 15 - POPMail / PC Installation For a list of network adapter cards currently supported by the packet Drivers, please consult our accompanying documentation entitled "Installing the Packet Driver". POPMail runs under DOS version 3.0 or greater and requires 512K of RAM. POPMail was designed to run on a wide range of IBM PC's and compatibles, including the earliest PC's which contained only a monochrome display adapter (no graphics support). A Microsoft-compatible mouse is helpful but optional. You must load mouse driver software into your system before running POPMail. Note also that if your mouse contains more than one mouse button, you will be using only the left mouse button when running POPMail. A disk caching program such as SMARTDRV.SYS is desirable. A disk cache will greatly speed up POPMail's operations. 3.5 Getting access to a mail server To use POPMail, you need access to a host computer that acts as a centrally shared mail server. Several host options are available to you. If you are student or staff at the University of Minnesota Twin Cities campus, you probably have an account already created for you. If you have access to a Unix-based computer in your department or work group, you may want to use that machine as your host mail server. Examples of small Unix hosts include SUN workstations, NeXT computers, or Apple Macintosh IIs running the A/UX operating system. Computers of this size should be adequate for servicing around 150 POPMail users. Because Unix machines have excellent connectivity to other systems, they are a good choice for a mail server. Of course, for full connectivity, any mail server you select must be connected to a backbone network in order to communicate with the rest of the world. Another low-cost option you can consider for a host mail server is to use the University of Minnesota's MailStop program. MailStop is a mail-server application that runs on Macintosh computers. This server software is designed to service client workstations (either IBM-compatibles or Macintosh computers) that run POPMail. MailStop is in the public domain and is included as part of our overall POPMail package. This means that MailStop, along with POPMail, is available from us via anonymous FTP on the internet. See the "Configuring POPMail" section below for details. - POPMail / PC Version 3.1 16 - POPMail / PC Installation 3.6 How to Obtain POPMail POPMail software consists of two major components: a Packet driver (matched to your microcomputer's network adapter card) and the POPMail program software itself. 3.7 Redistributing & using POPMail/PC You can use POPMail/PC at no charge. You can also distribute POPMail/PC to any person or group provided that: (1) Our copyright notices are not altered or removed. (2) You do not charge others for the use or distribution of our software. (3) You do not alter the program code in any way. 3.8 From your network administrator The best place to get POPMail is from someone who has already set it up for you or for others in your group. Check with your local network or mail server administrator person. If they have thought ahead, they'll have collected the necessary pieces for you. 3.9 Getting it yourself by FTP If POPMail is not already at your site, you can get it by anonymous FTP. You can obtain all this software by anonymous FTP from our FTP server named "boombox.micro.umn.edu" Look in the UNIX directory called /pub/pc therein you'll see several directories: packet-drivers popmail-3.1 the "packet-drivers" directory contains several directories: "drivers" contains the actual packet drivers. Each file is a packet driver for a particular type of network interface card. You'll want to get the one that matches your interface card. These are all executable .COM files that must be ftp'ed in BINARY mode. - POPMail / PC Version 3.1 17 - POPMail / PC Installation "notes" contains notes about packet drivers. You will want to get the one for your card, plus the general installation document "INSTALL.DOC". You may also want to look at some of the hints in "UOFMPKT.DOC". This document has some suggestions that we have developed while installing packet drivers at the U of M. All of these files should be ftp'ed in ASCII mode. Note that card names and model numbers are often confusing. In particular, the 3COM cards are often called by names such as "EtherLink XXX", but the associated packet driver is named by the card's model number, i.e. 3CNNN, where NNN is 501, 502, 523, .... The "popmail-3.1" directory contains the POPMail Version 3.1 files. You'll need to get these files in BINARY mode. In FTP, you'll have to use the "bin" command to switch FTP to binary mode. You'll need to get the files POPMAIL.EXE and POPMAIL.HLP. It's a good idea to think ahead and put these files in a common directory. Here's a sample ftp session to get POPMail and the 3C523 packet driver. Note that the exact file lengths may be slightly different for the version of POPMail that you have fetched: Ŀ c:\> mkdir pop { make a directory to hold the POPMail files} c:\> cd pop c:\pop> ftp ftp> open boombox.micro.umn.edu Domain looking for boombox.micro.umn.edu boombox FTP server (Version 4.1) ready. Username: anonymous Guest login ok, send ident as password. Password: aeinstein@eth Login ok, restrictions apply. Figure 6 - Logging onto FTP server - POPMail / PC Version 3.1 18 - POPMail / PC Installation Ŀ ftp> cd /pub/pc ftp> ls 00README packet-drivers popmail-3.1 ftp> cd packet-drivers ftp> ls drivers notes programs sources ftp> ls 3c501.com 3c503.com 3c507.com 3c523.com byu_ipx.com slip8250.com ... more ... ftp> bin Type set to I. ftp> get 3c523.com Opening BINARY mode connection for 3c523.com (5635 bytes). Transferred 5635 bytes. ftp> cd ../notes ftp> ls 3c501.doc 3c503.doc 3c507.doc 3c523.doc byu_ipx.doc slip8250.doc ... more ... ftp> ascii Type set to A. ftp> get 3c507.doc Opening ASCII mode connection for 3c507.doc (306 bytes). Transferred 312 bytes. Figure 7 - Getting packet driver Ŀ ftp> cd /pub/pc/popmail-3.1 CWD command successful. ftp> ls aaa-readme popmail.exe popmail.hlp ftp> bin Type set to I. ftp> get popmail.exe Opening BINARY mode conn for popmail.exe (360750 bytes). Transferred 360750 bytes. ftp> get popmail.hlp Opening BINARY mode conn for popmail.hlp (85365 bytes). Transferred 85365 bytes. ftp> quit Goodbye. Figure 8 - Getting POPMail files - POPMail / PC Version 3.1 19 - POPMail / PC Installation Ŀ c:\pop> dir Directory of c:\pop 3c507.com 5338 10-18-92 12:16p 3c507.not 2446 10-18-92 12:16p popmail.exe 361476 10-18-92 12:16p popmail.hlp 85344 10-18-92 12:16p 454,820 bytes in 4 files. Figure 9 - Verifying transfer went ok 3.10 Installing POPMAIL You'll probably want to be able to type "POPMAIL" from any directory to run POPMail. To be able to do this, POPMAIL.EXE has to be in one of the directories in your default PATH. You can inspect your path by typing "ECHO %PATH". Either you can add the "pop" directory to your path, or you can move POPMAIL.EXE and POPMAIL.HLP to one of the directories in your current path. To minimize confusion, in this example we'll keep the POPMail files in the directory C:\POP and we'll add C:\POP to the PATH. The PATH is defined in the file AUTOEXEC.BAT. You can use any text editor, such as DOS's "EDIT" to add it in. Here is our path before and after the editing: Ŀ C:\> echo %path C:\DOS;C:\BATCH;C:\BIN {Edit AUTOEXEC.BAT, then restart the computer } C:\> echo %path C:\DOS;C:\BATCH;C:\BIN;C:\POP 3.11 Loading the Packet Driver POPMail needs a packet driver in order to send or fetch mail through the network. In fact, many other network programs are set up to require the packet driver to talk through the network. At the U of M, we typically configure all network programs, such as FTP, Telnet, Gopher, and POPMail to use the packet drivers. The packet driver isn't part of these programs, it's a separate program that has to be run, just once, sometime before you run POPMail. To run it, you type the name of the packet driver and a few parameters to tell the packet driver some information about your network card. For instance, to run the packet driver for the Etherlink Plus card, you would have to type: - POPMail / PC Version 3.1 20 - POPMail / PC Installation Ŀ C:\> 3C503 0x60 0x3 0x300 These parameters are more fully described in the packet driver installation guide, "INSTALL.DOC". The values here are typical, but not sacred. You could enter this command by hand, but it is much more convenient to run it from the AUTOEXEC.BAT file. That way it will always be every time you start up the computer. - POPMail / PC Version 3.1 21 - POPMail / PC Configuration 4. Configuring POPMail 4.1 In this Chapter In this chapter we discuss how to configure POPMail-- that is, how you set up POPMail to work for you, the way you want it. You can skip this chapter if POPMail is already configured to work for you. 4.2 The configuration process When you use POPMail for the first time, you need to tell POPMail a few things. POPMail needs some information about you and your network. You configure POPMail through the Setup|Network... dialog box: Ŀ [] Configure ͻ User Name phil Password ******* Host Computer staff.micro.umn.edu Microcomputer IP address 0.0.0.0 Subdirectory for Mail c:\philmail\ [Time Zone.] CST[Language.]English [Advanced..][ Test ] Gateways Name Servers 1st IP address 0.0.0.0 0.0.0.0 [ OK ] 2nd IP address 0.0.0.0 0.0.0.0 3rd IP address 0.0.0.0 0.0.0.0 [Cancel] 4th IP address 0.0.0.0 0.0.0.0 ͼ Do not be scared by the large number of things that pop up; you do not need to fill them all in. In fact, if your local network administrators have set things up nicely, you only have to fill in THREE pieces of information: - POPMail / PC Version 3.1 22 - POPMail / PC Configuration User Name: Password: Host Computer: Here's a brief description of each of the parameters 4.3 User Name The User Name (sometimes called the account name, or login name) is the one assigned to you for use on the host mail server. This is usually a 1 to 8 letter abbreviation of your name. Take care to use the correct capitalization in your name. 4.4 Password The Password is the keyword that the host mail server uses to validate your user name. The person who sets up your account on the host mail server will assign you this password. Warning: Be sure to type in your password exactly as it was assigned, again, be sure you type your password exactly as given-- upper- and lower-case is important. Note that when you enter your password in the Configure dialog box, you will not see your actual password displayed on the screen. This is a security feature of the POPMail program, since it prevents people from viewing your password as you enter it. Be sure that the CAPS-LOCK key is not down, as you could inadvertently be entering an UPPER CASE password, which many mail hosts do not consider a match for its lower case equivalent. 4.5 Host Computer This is the name or IP address of the computer you are using as a host mail server. Ask the mail system administrator for the name of the mail host that you have your mail account on. Every computer on a TCP/IP network has a unique numerical address called an IP address. The IP address looks something like 128.101.63.1. In much the same way as the post office uses home addresses to distinguish one residence from another, the network uses IP addresses to distinguish one computer from another when delivering electronic mail. In addition to having an IP address, each computer on the network often has a name, e.g., vx.cis.umn.edu. You can enter either the host computer name or its IP address. The advantage in using the name is that it's - POPMail / PC Version 3.1 23 - POPMail / PC Configuration easier to remember a name than it is to remember a series of numbers. 4.6 To enter these values To enter or edit Password, Host computer, or any of the other parameters in the Configure dialog box, use the TAB key (or Up and Down arrow keys) to advance to the appropriate parameter field. Then enter the appropriate parameter information. As a short-cut you can select any of the parameter names by holding down the Alt key while typing the highlighted character in that parameter name, e.g., type Alt-P to select the Password parameter name. Remember: In general, we use a capital letter to designate a highlighted letter within a dialog box. If your network administrators are providing BOOTP service, then you need not enter any further information. Ask if BOOTP is available on your network and at the PC's that you are going to be using. If BOOTP is not available, you have to enter more information as described below. 4.7 Entering other IP numbers If BOOTP service is not available you'll have to enter: Microcomputer IP address At least 1 Name server. If your mail host computer is not on the same physical network as your micro, you'll also have to enter: At least 1 Gateway. You'll get these numbers from your local network administrator. 4.8 Microcomputer IP address This is the IP address of your individual microcomputer or workstation. It is a number such as 128.101.95.33. See your network administrator for a microcomputer IP address assignment. Note: This number is almost always assigned to a specific PC at a specific location on the network. Using an occupied or random IP address will cause problems for you or for others on the network. - POPMail / PC Version 3.1 24 - POPMail / PC Configuration If you move your PC to a different spot on the network, or you move POPMail to a different PC, then the IP address MUST BE CHANGED. 4.9 Gateways A gateway is a device which gives your computer access to the outside world by transferring information from one type of network to another. If you want to use POPMail to send messages beyond your local area network (LAN), you must specify the IP address of one or more gateways to which your LAN has access. If more than one gateway is available to you, it is to your advantage to enter more than one, increasing the chance that you will find one that is up and running when POPMail needs it. A gateway moves your POPMail information off your LAN and routes it to the outside world. Contact your network administrator for the IP address of gateways accessible to your LAN. 4.10 Name Servers A name server is a computer that provides IP name lookup services. Type in the IP address of your name server in this parameter field (see your network administrator for the value to enter). If more than one name server is available to you, it is to your advantage to enter more than one IP address, increasing the chance that you will find a name server that is up and running when POPMail needs it. 4.11 Subdirectory for Mail POPMail needs a directory on your computer in which to store your incoming and outgoing messages. If you do not enter anything here, POPMail will use the directory X:\POPMAIL, where X is the letter of the disk that POPMAIL.EXE is on. In general, choose a disk that has at least several 100K bytes free. If you plan to carry your messages around with you, then you should enter the name of the diskette, probably A: or B:. 4.12 Time Zone The Time Zone List Box allows you to specify your time zone. - POPMail / PC Version 3.1 25 - POPMail / PC Configuration Ŀ [] Time Zone ͻ GMT  UT EST EDT CST CDT MST  [ OK ] [Cancel] ͼ Figure 10 The Time Zone dialog box. The Time Zone is used to correctly time stamp your outgoing messages. To enter your time zone, use the scroll arrows or the up-down arrow keys, to select your time zone from the list. Once your time zone is highlighted, press the ENTER key or click on the oK button. 4.13 Language The Language List Box allows you to indicate the human language (e.g., Swedish, English, etc.) you use to communicate. If the Language setting is incorrect, some language-specific characters, such as umlauted or accented letters will not display properly. To choose a language, use the scroll arrows or the up-down arrow keys, to select your language from the list. Once you find your preferred language, press the ENTER key or click on the oK button. - POPMail / PC Version 3.1 26 - POPMail / PC Configuration Ŀ [] Language ͻ British  English Finnish French FrenchCanadian German IBM 8-Bit  [ OK ] [Cancel] ͼ Figure 11 - The language dialog box. - POPMail / PC Version 3.1 27 - POPMail / PC Main Windows 5. POPMail's Windows 5.1 In this Chapter In this chapter we discuss the core of POPmail-- its two main windows. This is an important chapter. 5.2 Overview POPMail has two main windows, the Viewer window and the Composer window. You use the Viewer Window to view messages which have been sent to you. You use the Composer Window to compose new messages to send to others. In addition to these windows, you can open up any number of text edit windows. A text editor window allows you to view and edit text files while staying in POPMail. 5.3 The Composer Window The Composer window is where you compose your message. Your message consists of several parts, all visible in the Composer window: (1) The recipient's E-Mail address. (2) A subject for the message. (3) The Message Body. Below is a typical (empty) Composer window, as you'll see it when you start to compose a message: - POPMail / PC Version 3.1 28 - POPMail / PC Main Windows Ŀ Composer []ͻ From: grg@yoyo.micro.umn.edu Outgoing Mail Date: 14-Oct-92 (*) To:  ( ) Cc: ( ) Bcc:  Subject:   ͼ F2 View F3 Fetch F4 Send F5 Enclose F6 Group Figure 12 - The Composer window 5.4 Sending Mail to Other Users Using POPMail to send an electronic mail message is easy. Just follow these steps: 1. Go to the Composer window. 2. Type in recipient's E-Mail address. 3. Type in the recipients of carbon copies, if any. 4. Type in the subject of the message. 5. Type the message itself. 6. Send the message. We will explain each of these steps in detail below. - POPMail / PC Version 3.1 29 - POPMail / PC Main Windows 5.5 Go to the Composer window. If the Composer window is not already on top, press the F2 function key. This will bring the Composer window in front of any other windows. 5.6 Specifying the Recipient. In order to send a letter to someone through the mail, you must know their name and address. Likewise, to send an electronic mail message to someone, you need to know their electronic name and address. This is commonly called their E-mail address. The To: field is where you enter the recipient's E-mail address. In the example below, the message is being sent to two people. One recipient is someone whose E-Mail address is: kathy@student.tc.umn.edu This address is read aloud as: kathy at student dot tc dot umn dot edu. This address denotes a person whose E-mail user-name is kathy. Kathy gets mail at a computer called student.tc.umn.edu on the Internet. Ŀ Composer []ͻ From: jenny@xray.med.umn.edu Outgoing Mail Date: 14-Oct-92 (*) To: kathy@student.tc.umn.edu  ( ) Cc: ellen@umnmor.bitnet ( ) Bcc:  Subject:Next Committee Meeting  We need to meet one more time to wrap up the discussion. How about 2 PM next Tuesday?  ͼ F2 View F3 Fetch F4 Send F5 Enclose F6 Group - POPMail / PC Version 3.1 30 - POPMail / PC Main Windows Ŀ Figure 13 Typical outgoing message To send the same message to more than one person, enter additional E-mail addresses separated one from the other by one or more spaces or commas. The message in Figure 12 is also being sent to: ellen@umnmor.bitnet (a recipient named ellen who gets her mail at a computer called UMNMOR on BITNET). You can send the same message simultaneously to as many recipients as you wish. 5.7 Specifying the Subject. You must fill in the Subject field. To move to this field, press the TAB key, or if you have a mouse, click in the field. Once your cursor is in the field, type a succinct one-line description of your message. Be wise; use this field to describe the contents of your message briefly and clearly. The subject of our sample message is "Next Committee Meeting". 5.8 Type the Message. The big field just below the Subject field is the Message field. This is where you will enter the body of your message. To move the cursor to this field, press the TAB key again, or if you have a mouse, click in the field. Once your cursor is in the field, type your message. Editing text here is easy. You can use the arrow keys or mouse to move around in the text and use the and keys to delete text. POPMail does word-wrapping at the end of each line; therefore, you only need to type the ENTER key at the end of paragraphs. You can also use the WordStar control key sequences for cursor movement. The body text is "plain-vanilla" text. For example, you cannot make text bold, italic or underlined in the message body. If you need fancy effects, you can use the "Enclose" feature to enclose a formatted document. - POPMail / PC Version 3.1 31 - POPMail / PC Main Windows 5.9 Sending the message. When you are done typing your message, press the F4 key or if you have a mouse, click on "Send" at the bottom of the screen. POPMail will put up a box informing you "Sending Message". The message will be sent to the recipients you specified. When the message has been sent to the mail-server you'll see a message confirming this. Click on the OK button or press the ENTER key to clear the confirmation box. That's all it takes to send a message with POPMail. - POPMail / PC Version 3.1 32 - POPMail / PC Advanced Topics 6. Sending Mail - Advanced Topics 6.1 In this Chapter In this chapter we discuss some more advanced mail sending features. You can probbaly skip this chapter until you become familiar with using POPMail's basic features. 6.2 Sending Carbon Copies. With POPMail you can send a message directly to some people and as a carbon copy to others. A "carbon-copy" is identical to a regular copy of the message, no fuzzier looking. It just denotes a somewhat lower or adjunct status to the recipient. You can also send "blind" carbon copies. A blind carbon copy goes to that recipient, but their name does NOT appear in the To: or CC: lists of messages going to the other recipients. To enter some cc: recipients, click on the CC: radio button at the top left of the Composer window. To enter BCC: recipients, click on BCC:. You can click as many times as you want between To: CC: and BCC: to enter recipient's names. 6.3 Sending Mail to a Group Sending POPMail to a group is as easy as sending a message to one person. With POPMail you can keep group lists. A group is simply a list of recipients (E-mail addresses) that have been given a one-word alias (identifier). For example, you could create a group called Marx composed of these three E-mail addresses: harpo@squeezebox.circus.umn.edu groucho@cigarbox.opera.umn.edu chico@bandbox.hollywood.umn.edu 6.4 Creating Groups To create a group alias name, select the "Groups..." item from the Setup menu. You'll see a box where you can enter the - POPMail / PC Version 3.1 34 - POPMail / PC Advanced Topics desired alias name and the recipients you want to include in the group. When you define a Group, you must type the group name first. In the example below, billionaires and auctioneers are group names. Ŀ [] Make Groups ͻ Enter group name followed by user names.ۺ Separate groups by a blank line. ۺ ۺ billionaires getty@my.oil perot@my.own.orgg ۺ bgates@ms.org onassis@ship.gc ۺ ۺ auctioneers gumpy@wash.auc.org jblow@abc.org ۺ ۺ ۺ ۺ ۺ ۺ ۺ Cancel OK ۺ ۺ ͼ The group names are followed by the user names of the members of the group. Within a group, each user name is separated from the next by one or more spaces (commas are optional). When you are finished entering the user names for one group, type the ENTER key twice before entering information to define another group. (Groups must be separated by a blank line.) When you have finished making groups, click on the oK button to save your changes. 6.5 Choosing a Predefined Group To send mail to a group you have already defined, press F6 or click on "Groups" at the bottom of the screen. - POPMail / PC Version 3.1 35 - POPMail / PC Advanced Topics Ŀ [] Select Group ͻ Group names: auctioneers  billionaires drivers phil project6 staff  [ Select ] [Cancel] ͼ Choose a group name with the up and down arrow keys or the mouse. Then click on the Select button. You'll see the members of that group added to the "To:" field of the Composer window. If you wanted the group to get carbon copies, click on "CC:" before choosing a group. - POPMail / PC Version 3.1 36 - POPMail / PC Enclosures 7. About Enclosures 7.1 In this chapter In this chapter we discuss sending enclosures with a mail message. This is a very useful feature but should be skipped until you are comfortable with POPMail's basic features. 7.2 Why Enclosures Sometimes you just wish to send off a simple note to someone. The standard E-Mail message is just fine for this. Standard Internet messages are very plain-- they are just raw text only. No bold or italic text or special fonts. No fancy formatting allowed. Often this is enough for simple messages. But sometimes you want to send something a bit more complicated than just a raw text message, something like a spreadsheet, or database file, or a formatted document such as produced by MS word. You cannot send these kind of things as a mail message, at least not directly. That is why POPMail has enclosures. An enclosure, in POPMail terms, is any kind of IBM PC or Macintosh file. With POPMail you can include any reasonable number of enclosures with your mail message. POPMail converts, or encodes the enclosures into a format that can be sent through Internet mail channels. If the recipients of your message use POPmail to read the message, their POPMail performs the reverse operation, converting the encoded enclosure back to the exact same file as you originally sent. Since enclosures are regular files, you can treat them as you would any other file; that is, if someone sends you an enclosure containing an executable program, you can run the program on your machine as well. In addition, an IBM enclosure containing graphics, italic or bold characters, or spreadsheets, will retain all its original characteristics. In short, sending IBM files as enclosures is really no different than transferring files from one machine to another using a diskette. - POPMail / PC Version 3.1 38 - POPMail / PC Enclosures 7.3 Sending Enclosures To send an enclosure with a mail message, first compose your mail message. It may be as simple as "I am enclosing the spreadsheet". Then click on the "Enclose" button at the bottom of the screen, or if you do not have a mouse, press F5. POPMail will then display a dialog box showing all the files on your disk (in the current directory). You can browse through this list by using the arrow keys, or manipulating the scroll bar to the right of the window with the mouse: Ŀ [] Choose file to enclose ͻ Name ARCHERY.DOC ݱ OK Files ARCHERY.DOC BACKUP.COM Cancel BUILDING.WKS BACKUP.EXE CARPAYMT.TXT BASIC.COM DANCER.DOC BASICA.COM Help FIRE.TXT CHKDSK.COM  C:\DOS\*.* 4201.CPI 6404 Apr 9, 1991 5:00am ͼ Figure 14 - Typical Enclose Dialog POPMail shows some more info about the currently highlighted file at the bottom of the dialog box. This helpful information includes: drive, path, and file name, the file size in bytes, and the date and time the file was last modified. If the file you want to enclose is not in the current directory, you'll have to change directories. You can do this in one of two ways: (1) Type the disk drive letter and directory name directly into the top box, then press ENTER. POPMail will then display the file names in that directory. - POPMail / PC Version 3.1 39 - POPMail / PC Enclosures (2) Navigate up or down the directories by clicking on directory names, or click on ".." to move up a directory. Click on the file name you wish to enclose and then click on the oK button. At this point, POPMail returns you to the Composer window. The enclosure file name shows up on the bottom of the Composer window (on the window frame) to remind you that you have selected an enclosure. If you hold down the shift key while you push the "Enclose..." button you will get a box identical to that shown in Figure 13, except that the dialog box will be retitled as "Choose a TEXT file to add to message". You can then choose an ASCII text file that will be appended to your message body when the message is sent. You can use this feature to send ASCII text files to others who are not using POPMail and cannot accept BINHEXed enclosures (the normal method POPMail uses to send enclosures). This is discussed at length below. 7.4 Sending multiple enclosures To add additional files to POPMail's enclosure list for the current outgoing message, click on Enclose again. You'll see a new dialog box. Click on the "Add..." button. Then POPMail will display the dialog box called "Choose file to enclose") on top of the Add/Remove Enclosures Dialog Box. Ŀ [] Enclosures ͻ File(s) to Enclose C:\POP\POP30B10\AAA-READ.   [Add...] [Remove] [Done] ͼ Figure 15 - Typical Add an enclosure dialog box For each enclosure you wish to send, repeat this sequence, choosing one file at a time, until you have chosen all the desired enclosures. If you find that you have selected an - POPMail / PC Version 3.1 40 - POPMail / PC Enclosures incorrect file, you can click on (highlight) the incorrect file name in the list shown in the Add/Remove Enclosures dialog box (Figure 13) and then delete it by clicking on the Remove button. When your list of enclosures is complete and correct, click on the Done button in the Add/Remove Enclosures Dialog Box, and POPMail will return you to the Composer window. 7.5 Enclosures for non-POPMail users Note: The above method sends the enclosed file in "BinHex" format. "BinHex" format means that POPMail sends your file not in its original form, but in an encoded format to ensure that all its content gets to the destination PC. If the recipient is reading mail with POPMail, they never see this encoding-- their POPMail recognizes the encoded enclosure and unencodes it back to its original PC file. However if the recipient reads mail in some other way, the receiving mail program probably will not recognize the "BinHex" enclosure and they'll see screens full of what looks like gibberish. Note the tradeoff: If you enclose a file by the default method, you can send ANY IBM-PC file: a text file, a formatted document, a spreadsheet, even a .EXE file, and it will get to any POPMail recipient intact. However anyone reading the message with something other than POPMail will get gibberish. 7.6 Pure text enclosure There is an alternative enclosure method that can be read by anyone-- the drawback is that you can only send very plain vanilla text files. You cannot send text with any formatting, fonts, or even special characters. To do this plain text enclosure, hold down the shift key while you push the "Add..." button in the Add/Remove Enclosures Dialog Box (Figure 9). You can then choose an ASCII text file that will be appended to your message body when the message is sent. You can use this feature to send ASCII text files to others who are not using POPMail and cannot accept BINHEXed enclosures (the normal method POPMail uses to send enclosures). File names which appear in upper case letters in the list box shown in Figure 9 will be sent as BINHEXed enclosures. File names which appear in lower case in the list box shown in Figure 9 are ASCII text files which POPMail will append to your outgoing message. - POPMail / PC Version 3.1 41 - POPMail / PC Enclosures 7.7 Quirks in Exchanging Documents Those who exchange documents with others (via POPMail or even floppy disk) using different versions of the same software soon learn that they cannot always save, open, read, or retrieve documents in the usual manner. New versions of the software can usually open or read documents created with older versions, but older versions do not recognize documents created with newer versions. However, newer versions of the software usually are backwardly compatible in that they contain an option for reading and writing documents in the old (obsolete) formats. Exchanging computer documents is generally straightforward when you and the recipient use exactly the same version of the same software; for example, when you both use WordPerfect 5.1. However, even in this scenario, if the recipient does not have the font you used to create the document, they probably will not be able to see the document as you intend it to be reproduced - either on the screen or on a printer. Whenever Microsoft Word users want to exchange documents but are unsure of the recipient's software, they should save the document as an RTF (rich text format) document. Documents saved in this manner are compatible with all versions of Word on the IBM and the Mac, as well as with some other word processing programs. 7.8 Exchanging MS Word documents Word 5.0 users will see the RTF document's name show up in the Transfer/Load menu if the document's name ends in .DOC. If the document's name does not end in .DOC, Word 5.0 users must type in its name to load the document. The newer Word 5.5 is more flexible; it has an option that lets you view a list of all documents regardless of their names. Note that sending a RTF file may not be enough... you may have to enclose some style sheets that your document refers to. You may also need to enclose any glossaries or user dictionaries that you used to create the document. Note that the recipient may not be able to print the document in its exact format if they do not have the same printer or printer fonts that you used in the document. 7.9 File converters Some software comes with built-in file converters. For example, Microsoft Word for Windows 2.0 includes converters for several word processing packages, such as Word for DOS, Word for Macintosh, Windows Write, WordPerfect 5.1, and WordPerfect 4.2. - POPMail / PC Version 3.1 42 - POPMail / PC Enclosures When you install Word for Windows this conversion feature is automatically copied to your working disk. Not all software makes using its conversion features so easy to use. Some software requires that you follow special installation instructions to use their converters. 7.10 Other considerations Finally, keep in mind that when you E-mail large documents or multiple enclosures, you can bog down a network. To avoid congestion, consider these strategies: send only one enclosure per mail message; break up large documents into smaller documents; and mail your documents during off-peak hours. As you can see, enclosing E-mail documents is not always straightforward. The less you know about the recipient's hardware and software setup, the more likely you are to run into unforeseen problems. 7.11 Getting Enclosures from a Mac Macintosh files are somewhat more complicated than IBM files. First, Macintosh files can have longer and more complicated file names, so if necessary, POPMail/PC will trim the original Macintosh file name to generate a valid DOS file name. Second, Macintosh files are divided into one or two forks (parts). Part One, called the "data fork," is similar to a regular DOS file. Part Two, if present, is called the "resource fork." The resource fork contains special Macintosh-only information. Actually, the information contained in the resource fork is not directly usable to you on the IBM. However, if you forward that file, both the data fork and resource fork are passed on to the Macintosh user. That is why POPMail saves the resource information on the PC even though PC's do not have any way of using Macintosh-style resources. 7.12 Sending Enclosures to a Mac It is possible to send enclosure files to a Macintosh, as well as receive them. In fact, many of the newer applications, such as Microsoft Excel, have compatible data formats. They achieve this by using only the data fork on the Macintosh and storing the data in exactly the same way on the Mac or PC. There is one glitch. If the file is to appear on the Mac with the correct icon, you have to give it a descriptive extension on the PC. - POPMail / PC Version 3.1 43 - POPMail / PC Enclosures On the Macintosh, files have an associated ICON, or file type and creator. If these are not right, it is difficult for the average Mac user to open that document with the correct application. For example, if you send a MS Excel spreadsheet under the IBM name of "DOLLARS.TXT" (acceptable name on the PC), the Mac will receive it with a MS WORD ICON and creator. This means when the Mac user tries to open that document, the Mac will open it with MacWrite, and get poor results. For this reason it is important that you, as the IBM PC user, use appropriate file name extensions (the three letters after the period), so the file arrives with a correct creator and icon on the Macintosh end. The following table summarizes the desireable extensions for several popular file types: Ŀ Use this To link with And use DOS EXT. Mac Application Mac Document Type ==== ========= =========== .XLS MS Excel 2.2 spreadsheet .WKS MS Excel 2.2 spreadsheet .WK1 MS Excel 2.2 spreadsheet .PAS Turbo Pascal 1.1 program source .TXT MacWrite II ASCII text .BAT MacWrite II ASCII text .C MS Word 4.0 ASCII text .CPP MS Word 4.0 ASCII text .DOC MS Word 4.0 internal .RTF MS Word 4.0 RTF... So before sending one of the above file types to a Macintosh, it is a very good idea to rename the file to have the appropriate file name extension. This will keep the Mac user happy and allow them to easily open and work with your enclosure. - POPMail / PC Version 3.1 44 - POPMail / PC The Viewer Window 8. The Viewer Window 8.1 In this chapter In this chapter we discuss the viewer window. This is an important chapter as you'll probably spend most of your time in POPMail in working with this window. 8.2 Background The viewer window is where you look at your incoming mail and your old mail messages. See Figure 15. The window has several areas, or fields: The To: field shows who this message was sent to. You'll see your name there, perhaps among others. If you are interested in seeing the whole To: list, you can scroll through this field with the arrow keys. The Subject: field shows the subject of this message. Just below the Subject field there is a display which will say "Message XXX of YYY". This tells you the number of the current message. The largest field shows the body of the message. If the message is longer than fits in this field, you can scroll down with the arrow keys, or if you have a mouse, you can use the scroll bar to the right of the body field. The Viewer window is resizeable. If you click in the lower right corner with your mouse, you can resize the window to be larger or smaller. From the keypard, you can choose the Window|Resize... menu option and then resize the window with the arrow keys. You have to press the Enter key to exit from window resizing mode. At the very bottom is a list of the functions that are available in the viewer window. You can click on these to perform the indicated function, or from the keyboard, you can press the associated function key. All this is described below. - POPMail / PC Version 3.1 46 - POPMail / PC The Viewer Window Ŀ INBOX Viewer [ ] Index []ͻ Fri, 2 Oct 1992 11:00:22 -0400 To: LOSR0001@stu.acns.nwu.edu From: Fiona Lasagna Subject: Do you have the assignment? Message 213 of 215 Hi. Could I please get the assignment for Tuesday?  Thanks.   F2 Compose F3 Fetch F4 Forw F5 Reply F6 Delete F7Prev Msg F8Next Msg Figure 16 - Typical viewer window 8.3 Fetching Incoming Mail Your incoming mail is held for you at the post-office server until you fetch it. When you fetch incoming mail, POPMail moves each message from the mail server to your PC. Incoming messages remain on your PC's disk until you explicitly discard them. To fetch mail, press the fetch button (F3). POPMail will fetch your mail from the mail server. POPMail will keep up a running total of the messages as it is receiving them by displaying "Receiving message XXX of YYY". When POPMail has fetched all your messages, it will display "Fetched XXX messages and YYY enclosures". 8.4 Paging through your messages Your messages appear in your INBOX folder. Initially they are in the order they were received. To move to the next message, press the F8 key. To view the previous message, press the F7 key. - POPMail / PC Version 3.1 47 - POPMail / PC The Viewer Window 8.5 Replying to Incoming Mail After reading a message, you'll often wish to respond to the person who sent it. You can easily do this pressing the "Reply" key (F5). You will see POPMail automatically takes the Subject: and From: information from the original message and puts them in the proper places in the Composer window. In addition, if you've chosen the "Include message in reply" option, POPMail puts the original message into the body of your reply. The original message is set off with ">" at the beginning of each line so your recipient can see what is the original message as well as your reply. Then you can type your reply into the body part of the message. When you are finished typing your reply, click the Send button or press F4 to send your message. 8.6 Forwarding Mail Sometimes you do not want to reply directly to a message, but pass the information on to someone else. To do this, click on the Forward button (F4). POPMail will move the message into a Composer window and fill in all necessary information automatically. The Composer will have the subject field prefixed with "Forwarded Message..." and the text in the body will be prefixed by a line indicating who wrote and sent the original message. All you have to do is enter the appropriate recipient into the To: field. 8.7 Viewing very long messages Sometimes you'll receive a message that is very long, over about 50,000 characters. POPMail can only display messages up to that length, so if you wish to view a longer message, you'll have to view it with some other text viewer or editor. The "EDIT" editor that comes with MSDOS and PCDOS 5.0 and newer is quite adequate for this. Each incoming message is saved to a file on your disk in the directory you specified in the Setup|Network box (see Figure 3A). The name of each file is stored near the end of the To: field along with the complete SMTP header. - POPMail / PC Version 3.1 48 - POPMail / PC Managing messages 9. Managing your messages 9.1 In this chapter In this chapter we talk about the "manage" menu, the main means of organizing and arranging your incoming messages. You do not really have to do this on your first pass through POPMail. 9.2 Background There are several ways you can manage or arrange your incoming messages. The simplest way is to do nothing. If you do this, all your incoming messages end up in a mail folder named "INBOX". Each incoming message will get added to this folder. As your messages accumulate, you may find this arrangement cumbersome. For this reason, POPMail lets you have multiple mail folders. A "mail folder", in POPMail, simply means a collection of messages. You give each mail folder a descriptive name. Some typical mail folders: JOKES HISTORY CONFER EDICTS INBOX Mail folder names are currently limited to 8 characters or less. 9.3 Going from folder to folder You can easily move from folder to folder, create new folders and delete unneeded ones with the "Manage|Go to folder" command. When you choose this command, POPMail presents you with a dialog box: - POPMail / PC Version 3.1 50 - POPMail / PC Managing messages ij [] Go to folder ͻ Folder: [ New... ] ANALYSIS  BITS [ Delete ] CONFER EDICTS INBOX NEWSTAFF [ OK ] SENSITIV SENTMAIL [ Cancel ] ͼ Figure 17 - Typical "Go To Folder" dialog box The box at the left lists all your mail folders. You can click on a folder to select it. Once you've clicked on a folder name, you can choose the OK button, which means you want to move to that folder. Or you can click on "delete" and POPMail will ask if you really want to delete that folder and its XXX mail messages. Or you can click on "new..." and POPMail will ask you to choose the name of a new, empty mail folder. We'll see how to use mail folders by looking at the typical mail flow: 9.4 Mail flow This is the typical mail flow: You press "Fetch". Incoming messages end up in the INBOX folder. You peruse these messages. You ponder and perhaps reply to these messages. You select and move messages to other folders. - POPMail / PC Version 3.1 51 - POPMail / PC Managing messages 9.5 The Message Index 9.6 Overview POPMail keeps an index of all the messages in each mail folder. The index is very useful if you are browsing through your messages. The Index shows you a summary of all the messages in your current mail folder. The display includes the name of the sender, the subject, and the message date. 9.7 Turning on/off the index display Since there is limited screen space the message index is normally off, giving you a full view of your messages. If you want to see the index, you can turn the index display on or off by clicking on the little check box at the top right of the viewer window: Ŀ INBOX Viewer [X] Index []ͻ From the keyboard, you can press Alt-I to to flip its current state. When the index is on, it obscures the From: information lines, but this info is partly duplicated in the index line itself. 9.8 Browsing through the index You can go to any message in the index by clicking on the desired line in the index, or by scrolling to it with the arrow keys. Only a few lines of the index are visible on screen. If you have more than 10 messages, you can browse through the index with the arrow keys, or by using the scroll bar to the right of the index. If you wish to see more or fewer lines of the index, you can change the size of the the index window by pulling up or down down on the divider line along he bottom of the index window pane. - POPMail / PC Version 3.1 52 - POPMail / PC Managing messages Ŀ INBOX Viewer [X] Index []ͻ Earl Spassky Where is the disk 29-Sep-92 Judy Rayburn Paychecks 30-Sep-92 Philip H. Kinkelhof Missing message from JT 30-Sep-92 Julius Anchilada Printers for IBM-Comp 30-Sep-92 Mark P. McCucheon important update e-mail 30-Sep-92 Dave Largoni Re: Missing Virtual 30-Sep-92 Mike Anderson Re: Server working now 1-Oct-92  Figure 18 - Typical Index 9.9 Browsing through the index Sometimes you want to browse through messages from a certain person, or on a certain subject. One way to do this is to sort the index by person or by subject. If you do this, then all that person's messages will appear one after another in the index, making it easy for you to browse through them. You can sort the index at any time with the "Manage|Sort..." command. POPMail will ask you to choose a sorting key You can choose to sort by the sender's name, the subject, or the date. Ŀ [] Sort Folder:ͻ Sort entries by: ( ) By arrival time [ OK ] (*) By subject ( ) By sender [ Cancel ] ͼ Figure 19 Sort Folder dialog box If you choose one of these and press OK, POPMail will sort the index. Note that sorting does not destroy any messages. It simply reorders them. - POPMail / PC Version 3.1 53 - POPMail / PC Managing messages 9.10 Managing messages With the "Manage" menu, you can mark messages to be moved, deleted, or copied to other mail folders. You can also sort the index by name, subject, or date. Note: In POPMail 3.1, only the first 300 messages in any one mail folder are displayed in the index. For this reason, and general cleanliness, you'll probably want to move related mail messages to separate mail folders instead of letting them all pool in the main "INBOX" folder. 9.11 Marking... Once you have the message index visible the screen, you can easily mark messages to be moved, deleted or copied. There are several ways to mark messages, as described below. 9.12 Marking one message at a time From the keyboard, you can press the space bar to mark a message. You'll see a small check mark appear to the left of the message line in the index. With a mouse, you can simply double-click on a line in the index to mark a message. If you change your mind and do not wish to mark a message after all, just mark it again to erase the check mark. 9.13 Marking many messages Sometimes you want to move or delete all or almost all messages in a folder. In this case you can choose "Mark all messages" from the Manage menu. Now you can unmark the few messages you do not want marked. - POPMail / PC Version 3.1 54 - POPMail / PC Managing messages Ŀ INBOX Viewer [X] Index []ͻ Earl Spassky Where is the disk 29-Sep-92  Judy Rayburn Paychecks 30-Sep-92 Philip H. Kinkelhof Missing message from JT 30-Sep-92 Julius Anchilada Printers for IBM-Comp 30-Sep-92 Mark P. McCucheon important update e-mail 30-Sep-92 Dave Largoni Re: Missing Virtual 30-Sep-92 Mike Anderson Re: Server working now 1-Oct-92  Figure 20 - Index with 3 messages Marked 9.14 Marking messages with... Sometimes you want to mark all messages that contain a word or phrase. "Mark messages with..." does just this. Ŀ [] Mark messages with.....ͻ Text to find: [ ] Case sensitive [ OK ] [Cancel] ͼ Figure 21 - Mark message with dialog box. For example, sometimes you want to mark all messages on a certain subject. This can be a tedious task if you have to inspect hundreds of messages and individually mark them. To make life easier, POPMail has a command that can help. The Manage|Mark messages with..." command will mark all messages that contain a phrase of your choice. For example, if you decide to move all the Ethnic jokes out of your "JOKES" folder, you could do a Manage|Mark messages containing..., and type "Ethnic" into the box. Then press OK. - POPMail / PC Version 3.1 55 - POPMail / PC Managing messages POPMail will scan all the messages in the current folder and mark those that contain the word "Ethnic". 9.15 Advanced mark with... Sometimes you may want to broaden or narrow your search. To broaden you search, you can use the special search word "OR". Searching for "beet or tomato or radish" will mark all messages that have either one of those words. You can also narrow the search with "AND". Searching for "beet and tomato" will only mark messages that contain both words. 9.16 Operating on marked messages Marking messages isn't much fun in and of itself. The real purpose of marking messages is to do something with the marked messages 9.17 Moving messages Once you've marked one or several messages, you can choose the "Manage|Move marked messages" command. this will move all the marked messages to the folder of your choice. POPMail puts up a dialog box to let you choose the destination folder: 9.18 Trashing messages Once you've marked one or several messages, you can choose the "Manage|Trash marked messages" command. This will trash all the marked messages. Note that we wrote "Trashed", not deleted. Trashed messages are moved to a special folder named "Trash". This gives you one last chance to retrieve the message. If you later find out you actually wanted to keep a message that you trashed, you can go into the trash folder and move the message to another folder. Periodically you may want to actually get rid of the messages in the Trash folder. You can easily do this with the Empty Trash menu item. Or you can delete the trash folder with the Delete button, in the Manage|Go to folder" command. Since messages in the Trash folder still take up disk space, you may want to empty the Trash folder periodically. - POPMail / PC Version 3.1 56 - POPMail / PC Managing messages 9.19 Copying messages Copying message works just like "Moving messages" above, except that the original message stays where it is, and a copy of it is made into the folder of your choice. - POPMail / PC Version 3.1 57 - POPMail / PC Reference - File 10. Command Reference Guide The following chapters describe each POPMail menu command. The commands are described in the order they appear in each menu. 11. The "File" Menu Ŀ File Ŀ Open... New Save Save As... Change directory... Ĵ Print Ĵ Exit Alt-X 11.1 Open... The "Open..." command lets you open an existing text file for viewing or editing. When you choose "Open..." from the File menu, POPMail asks you for the file name to open. It does this by bringing up the file name browser: - POPMail / PC Version 3.1 58 - POPMail / PC Reference - File Ŀ [] Open file ͻ Name *.*  [ Open ] Files AAA.DOC NULL.DOC [Cancel ] INSURANC.DOC PARTY.DOC JUNKER.DOC PUNCHES.DOC KINDER.DOC QUERY.DOC [ Help ] LANG.DOC LUNAR.DOC MANAGER.DOC NAUTILUS.DOC  C:\MEMOS\ AAA.DOC 966 Oct 8, 1992 1:20pm ͼ You can click on the file of your choice, or move to another disk or directory by typing in its name into the input box. 11.2 New The "New" command lets you create a new text editor window. POPMail opens up a new window into which you can type or Paste characters. 11.3 Save The "Save" command lets you save the current window to a file. You can save any text editing window. 11.4 Save As... The "Save As..." command lets you save the current window to a file of your choice. You can save the contents of the composer, the viewer, or any text editing window. POPMail asks you to enter a file name. - POPMail / PC Version 3.1 59 - POPMail / PC Reference - File 11.5 Change Dir... Change directory lets you move to a different directory. POPMail puts up a dialog box to let you navigate: Ŀ [] Change Directory ͻ Directory name C:\POP\POP30B10 ݱ Directory tree Drives  [ OK ] C:\ POP POP30B10 [Chdir ] C TESTS UTIL [Revert] OBJ [ Help ] ͼ 11.6 Print The "Print" command prints the current window to the currently selected printer. You select a printer in "Setup|Printer...". 11.7 Exit The "Exit" command takes you out of POPMail and back to the MSDOS or PCDOS command prompt. Use this when you are completely done using POPMail, or if you have to run some other program before continuing with POPMail. - POPMail / PC Version 3.1 60 - POPMail / PC Reference - Edit 12. The "Edit" Menu Ŀ Edit Ŀ Undo Ĵ Cut Shift-Del Copy Ctrl-Ins Paste Shift-Ins Ĵ Find... Ctrl-QF Replace... Ctrl-QA Search Again Ctrl-L Ĵ Clear Composer 12.1 Undo Undo undoes the last editing operation. If you deleted a character, Undo puts it back in. If you Cut some text, Undo restores it. If you Pasted some text, Undo removes it. Note that some editing operations, such as Search and Replace, are NOT undoable. Also, once you leave a window, any changes you have made are not undoable. 12.2 Cut "Cut" deletes the selected text and moves it to the Clipboard. You'll usually want to move the cursor elsewhere and do a Paste. 12.3 Copy Copy makes a copy of the selected text and puts the copy in the Clipboard. - POPMail / PC Version 3.1 62 - POPMail / PC Reference - Edit 12.4 Paste "Paste" inserts the Clipboard text at the cursor. 12.5 Find... Find... lets you search the current window for a word or phrase. POPMail puts up the Find dialog box: Ŀ [] Find ͻ Text to find ݱ [ ] Case sensitive [ ] Whole words only [ OK ] [Cancel] ͼ You can type any word or phrase you want to find into the input box. Usually its most convenient to not check any of the option boxes. This makes the search not care about capitalization and doesnt care about word boundaries. If you are sure you want to look for an exact upper/lower case match, or to look for whole words only, check the appropriate box. - POPMail / PC Version 3.1 63 - POPMail / PC Reference - Edit 12.6 Search and Replace... Ŀ [] Replace ͻ Text to find: ݱ New text: [ ] Case sensitive [ ] Whole words only [X] Prompt on replace [ ] Replace all [ OK ] [Cancel] ͼ Search and Replace lets you look for a word or phrase in your message and replace it with another word or phrase. Note that this is only useful in the Composer Window and any open File windows. You cannot change stored messages this way in the Viewer window. 12.7 Clear Composer "Clear Composer" discards any message you have started in the Composer window. - POPMail / PC Version 3.1 64 - POPMail / PC Reference - Manage 13. The "Manage" Menu Ŀ Manage Ŀ Go to folder... Sort folder... Ĵ Mark this message Mark All messages Unmark all messages Mark messages with... Ĵ Move marked message Alt-T Trash marked message Copy marked message Ĵ Empty trash Ŀ Manage Ŀ Go to folder... Sort folder... Ĵ Mark this message Mark All messages Unmark all messages Mark messages with... Ĵ Move this message Alt-T Trash this message Copy this message Ĵ Empty trash The "Manage" menu contains all the commands for marking and operating on your messages. The menu has two appearances. If you have not marked any messages in the message index, it appears as the first illustration above. The menu items refer to moving/Trashing/Copying the current message. If you have marked - POPMail / PC Version 3.1 66 - POPMail / PC Reference - Manage some messages, the menu appears as #2 above. It refers to moving/Trashing/Copying the marked messages. 13.1 Go to folder... Ŀ [] Go to folder ͻ Folder: [ New... ] AAAA  BBBB [ Delete ] CCCC EMPTY INBOX NUPOP [ OK ] SAVE SENTMAIL [ Cancel ] ͼ The box at the left lists all your mail folders. You can click on a folder to select it. Once you've clicked on a folder, you can choose the OK button, which means you want to move to that folder. Or you can click on "delete" and POPMail will ask if you really want to delete that folder and its XXX mail messages. Or you can click on "new..." and POPMail will ask you to choose the name of a new, empty mail folder. Ŀ [] New folder ͻ Folder Name: [ Cancel ] [ OK ] ͼ - POPMail / PC Version 3.1 67 - POPMail / PC Reference - Manage 13.2 Sort folder... Ŀ [] Sort Mailbox: ͻ Sort entries by: (*) By arrival time [ OK ] ( ) By subject ( ) By sender [ Cancel ] ͼ 13.3 Mark current message This menu item marks or unmarks the current message. There are other ways of doing this too. From the keyboard, you can press the space bar to mark a message. You'll see a small check mark appear to the left of the message line in the index. With a mouse, you can simply double-click on a line in the index to mark a message. If you change your mind and do not wish to mark a message after all, just mark it again to erase the selection. 13.4 Mark All messages Sometimes you want to move or delete all or almost all messages. In this case you can choose "Mark all messages" from the Manage menu. 13.5 Unmark all messages Sometimes you may want to start your selection process over. Choose "unmark all messages" to start over with no marked messages. 13.6 Mark messages with... Sometimes you want to mark all messages dealing with a certain subject. This can be a tedious task if you have to inspect hundreds of messages and individually mark them. To make life easier, POPMail has a command that can help. The Manage|Mark messages with..." command will mark all messages that contain a phrase of your choice. - POPMail / PC Version 3.1 68 - POPMail / PC Reference - Manage For example, if you decide to move all the Ethnic jokes out of your "JOKES" folder, you could do a Manage|Mark messages containing..., and type "Ethnic" into the box. Then press OK. POPMail will scan all the messages in the current folder and mark those that contain the word "Ethnic". Ŀ [] Select messages containing ͻ Text to find: ݱ [ ] Case sensitive [ OK ] [Cancel] ͼ Sometimes you may want to broaden or narrow your search. To broaden you search, you can use the special search word "OR". Searching for "beet or tomato or radish" will mark all messages that have either one of those words. You can also narrow the search with "AND". Searching for "beet and tomato" will only mark messages that contain both words. 13.7 Move marked messages This command moves the marked messages to the folder of your choice. 13.8 Delete marked messages Once you've marked one or several messages, you can choose the "Manage|Delete marked messages" command. This will trash all the marked messages. Note that we wrote "Trashed", not deleted. When you delete messages they are moved to a special folder named "Trash". This gives you one last chance to retrieve the message. If you find out you actually wanted to keep a message that you trashed, you can go into the trash folder and move the message to another folder. Every month or so you may want to actually get rid of the messages in the Trash folder. You can easily do this with the delete button, in the Manage|Go to folder" command. - POPMail / PC Version 3.1 69 - POPMail / PC Reference - Manage 13.9 Copy marked messages Copies the selected messages to the folder of your choice. 13.10 Empty Trash The Empty Trash menu command throws away any messages currently in the Trash. - POPMail / PC Version 3.1 70 - POPMail / PC Reference - Setup 14. The "Setup" Menu Ŀ Setup Ŀ Lines/screen F9 Ĵ Preferences... Signature... Network... Groups... Printer... Ĵ Trace... Alt-F10 14.1 Lines/screen Lines/Screen lets you choose between 25 clear lines of text on the screen, or 43/50 not-so-clear lines. 14.2 Preferences... Preferences lets you change some settings to your liking. Ŀ [] Preferences ͻ Preferences: [ ] Include mail text in reply [X] Add signature to outgoing mail [X] Save copy of outgoing mail [ ] Check for mail at startup [ ] Prompt for password [ ] 43/50 Line mode as default [ OK ] [Cancel] ͼ - POPMail / PC Version 3.1 72 - POPMail / PC Reference - Setup 14.3 Signature... Signature... lets you design a signature block of your choice. This signature text is appended to the end of each outgoing message if you have selected the "Add signature" option. The Normal Cut/Copy/Paste menu items are not available when editing your signature. But you can use the keyboard shortcuts for these important editing functions. 14.4 Network... Network... takes you to the main network configuration dialog. Ŀ [] Configure ͻ User Name phil Password ******* Host Computer staff.micro.umn.edu Microcomputer IP address 0.0.0.0 Subdirectory for Mail c:\philmail\ [Time Zone.] CST[Language.]English [Advanced..][ Test ] Gateways Name Servers 1st IP address 0.0.0.0 0.0.0.0 [ OK ] 2nd IP address 0.0.0.0 0.0.0.0 3rd IP address 0.0.0.0 0.0.0.0 [Cancel] 4th IP address 0.0.0.0 0.0.0.0 ͼ 14.5 User Name The User Name (sometimes called the account name, or login name) is the one assigned to you for use on the host mail server. This is usually a 1 to 8 letter abbreviation of your name. Take care to use the correct capitalization in your name. 14.6 Password The Password is the keyword that the host mail server uses to validate your user name. The person who sets up your account on - POPMail / PC Version 3.1 73 - POPMail / PC Reference - Setup the host mail server will assign you this password. Warning: Be sure to type in your password exactly as it was assigned, (again, be careful of upper- and lower-case considerations). Note that when you enter your password in the Configure dialog box, you will not see your actual password displayed on the screen. This is a security feature of the POPMail program, since it prevents people from viewing your password as you enter it. Be sure that the CAPS-LOCK key is not down, as you could inadvertently be entering an UPPER CASED password, which many mail hosts do not consider a match for its lower case equivalent. 14.7 Host Computer This is the name or IP address of the computer you are using as a host mail server. Ask the mail system administrator for the name of the mail host that you have your mail account on. Every computer on a TCP/IP network has a unique numerical address called an IP address. The IP address looks something like 128.101.63.1. In much the same way as the post office uses home addresses to distinguish one residence from another, the network uses IP addresses to distinguish one computer from another when delivering electronic mail. In addition to having an IP address, each computer on the network often has a name, e.g., vx.cis.umn.edu. You can enter either the host computer name or it's IP address. The advantage in using the name is that its easier to remember a name than it is to remember a series of numbers. 14.8 To enter these values To enter or edit Password, Host computer, or any of the other parameters in the Configure dialog box, use the TAB key (or Up and Down arrow keys) to advance to the appropriate parameter field. Then enter the appropriate parameter information. As a short-cut you can select any of the parameter names by holding down the Alt key while typing the highlighted character in that parameter name, e.g., type Alt-P to select the Password parameter name. Remember: In general, we use a capital letter to designate a highlighted letter within a dialog box. If your network administrators are providing BOOTP service, then you need not enter any further information. Ask if BOOTP is available on your network and at the PC's that you are going to be using. If BOOTP is not available, you have to enter more information as described below. - POPMail / PC Version 3.1 74 - POPMail / PC Reference - Setup 14.9 Entering other IP numbers If BOOTP service is not available you'll have to enter: Microcomputer IP address At least 1 Name server. If your mail host computer is not on the same physical network as your micro, you'll also have to enter: At least 1 Gateway. 14.10 Microcomputer IP address This is the IP address of your individual microcomputer or workstation. It is a number such as 128.101.95.33. See your network administrator for a microcomputer IP address assignment. Note: This number is almost always assigned to a specific PC at a specific location on the network. Using an occupied or random IP address will cause problems for you or for others on the network. If you move your PC to a different spot on the network, or if you move POPMail to a different PC, then the IP address MUST BE CHANGED. 14.11 Gateways A gateway is a device which gives your computer access to the outside world by transferring information from one type of network to another. If you want to use POPMail to send messages beyond your local area network (LAN), you must specify the IP address of one or more gateways to which your LAN has access. If more than one gateway is available to you, it is to your advantage to enter more than one, increasing the chance that you will find one that is up and running when POPMail needs it. A gateway moves your POPMail information off your LAN and routes it to the outside world. Contact your network administrator for the IP address of gateways accessible to your LAN. 14.12 Name Servers A name server is a computer that provides IP name lookup services. Type in the IP address of your name server in this parameter field (see your network administrator for the value to enter). If more than one name server is available to you, it is - POPMail / PC Version 3.1 75 - POPMail / PC Reference - Setup to your advantage to enter more than one IP address, increasing the chance that you will find a name server that is up and running when POPMail needs it. 14.13 Subdirectory for Mail POPMail needs a directory on your computer in which to store your incoming and outgoing messages. If you do not enter anything here, POPMail will use the directory X:\POPMAIL, where X is the letter of the disk that POPMAIL.EXE is on. In general, you should choose a disk that has at least several 100K bytes free. If you plan to carry your messages around with you on a diskette, then you should enter the name of the diskette, probably A: or B:. 14.14 Time Zone The Time Zone List Box allows you to specify your time zone. The Time Zone is used to correctly time stamp your outgoing messages. To enter your time zone, use the scroll arrows or the up-down arrow keys, to select your time zone from the list. Once your time zone is highlighted, press the ENTER key or click on the oK button. 14.15 Language The Language List Box allows you to indicate the human language (e.g., Swedish, English, etc.) you use to communicate. If the Language setting is incorrect, some language-specific characters, such as umlauted or accented letters will not display properly. To choose a language, use the scroll arrows or the up-down arrow keys to select your language from the list. Once you find your preferred language, press the ENTER key or click on the oK button. 14.16 The Test Button The Test button is a handy feature that checks out your network and network settings. When you click on the Test button, POPMail checks out all the IP numbers that you have entered. POPMail checks the reliability of your connection to the mail host - POPMail / PC Version 3.1 76 - POPMail / PC Reference - Setup computer and any name servers and gateways that you have specified, or that your network BOOTP service supplies. It also checks your connections to the POP server, the sendmail server and the finger server. Ŀ [] Test Results ͻ Computer Thruput -------- ------- Gateway #1 96 % Good Name Server #1 100 % Excellent Name Server #2 100 % Excellent Host Computer 100 % Excellent POP server (Port 109) 100 % Excellent Sendmail server (Port 25) 100 % Excellent Finger server (Port 79) 100 % Excellent [ Done ] ͼ In general, any percentages over 80% are acceptable. Anything lower indicates some sort of network problem or overcrowding. If there is a major problem with connecting, POPmail may put up some error messages in blinking red letters. These indicate serious problems with the network or, more likely, with your network IP number settings. 14.17 Groups... Groups... opens up the group definition dialog box. This is where you can enter new groups or edit existing ones. A window appears where you can enter a name for the group and the recipients you want to include in the group. This window is in a "free format". This means you are responsible for maintaining the correct layout. First you enter the group name you've chosen. Follow this with the user names of the members of the group. Within a group, user names are separated by spaces or commas. At the end of each group, leave a blank line between it and the next group. Example: Here are two groups named "marxes" and "bosses": - POPMail / PC Version 3.1 77 - POPMail / PC Reference - Setup Ŀ Marxes chico, harpo, zeppo, groucho bosses Nixon@san.clem.gov, Ford@palm.spr.gov, Carter@plains.misc, Bush@wh.gov, Mitterand@versailles.fr Thatcher@parlmt.uk, Major@whitehall.uk When you have finished making groups, click on the oK button to save your changes. 14.18 Printer... Printer... takes you to the printer setup dialog box. Here you can choose which printer device you wish POPMail's printed output to go to. You can choose between the most common DOS print devices, LPT1, LPt2, and LPT3. If you need to direct output to another port, such as COM1, use the DOS MODE command to redirect an LPT port to COM1. You can also choose a printer initialization string and a printer ending string. You can use these to send special sequences to change the printer's font, size, margins, etc... See your printer manual for details. If you need to enter control characters, you can enter them in the form ^X, where X is a letter, and ^ is the caret symbol, shift-6. If you need to enter the Escape character (decimal 27), enter shift-6 followed by "[" (left square bracket). 14.19 Trace... Trace... lets you set various tracing options. These are for the technically inclined who need to see what goes on when sending or fetching mail. - POPMail / PC Version 3.1 78 - POPMail / PC Reference - Window 15. The "Window" Menu Ŀ Window Ŀ Close Alt-F3 Resize/move Ctrl-F5 Next Window Alt-F6 Zoom Alt-F9 Cascade Ĵ Viewer Composer Show clipboard 15.1 Close The Window|Close command closes the topmost window or dialog box. The Alt-F3 or Esc key has the same effect. 15.2 Resize/move Resize/Move lets you change the size or position of most windows. If you have a mouse, you can move windows by dragging them by their top title bar. You can resize them by dragging their bottom right corner to the desired size. If you don't have a mouse, you can move and resize windows with the arrow keys. POPMail displays some hints on the bottom line. 15.3 Next Window Next Window brings the bottommost window to the top. There will always be the Composer and Viewer windows to flip through, plus any other windows or accessories you have opened. - POPMail / PC Version 3.1 80 - POPMail / PC Reference - Window 15.4 Zoom Zoom makes the window as large as possible, to fill the screen. Selecting Zoom again will restore the window to its previous size. 15.5 Cascade Cascade arranges the windows in semi-overlapping order: Ŀ 1Ŀ 2Ŀ 3Ŀ 4ͻ ͼ 15.6 Viewer Viewer brings the Viewer window to the top. 15.7 Composer Composer brings the Composer window to the top. 15.8 Show clipboard Show clipboard opens up the Clipboard window. The clipboard holds the last item that you have Cut or Copied. - POPMail / PC Version 3.1 81 - POPMail / PC Reference - Help 16. The "Help" Menu Ŀ Help Ŀ Index Shift-F1 Previous topic Alt-F1 Help on help The Help menu gives you access to help about POPmail. Choose "Index" to get a list of all the POPMail help items. POPMail also has context-sensitive help. This means that at any time you can press the F1 key, and POPMail will present you with some info about where you are and what you can do. 17. Sending to other mail systems Several electronic services are connected to the Internet, and have an ability to exchange mail with it. Some of them are: Ŀ America Online Applelink AT&TMail BIX CompuServe Connect Dialmail Econet MCI SprintMail To address Internet E-mail for these services you use the general form of "username@host". "user" can be an account number, user number, screen name or user name on the host. Typically, this is their moniker on that machine. "host" is the host or system name. The hostname is supplied for each of the services above in the examples below. The person - POPMail / PC Version 3.1 82 - POPMail / PC Reference - Other Mail Systems with whom you are corresponding should supply his/her full address. If he/she provides only a user name, then the address can be completed with the information below. 17.1 America Online screenname@aol.com The addressee must supply his "screen name" or username, which is prepended to "@aol.com" First name and initial of last name or last name and first initial of first name are commonly used. 17.2 Applelink address@applelink.apple.com The addressee must supply his address or username, which is prepended to "@applelink.apple.com" 17.3 AT&TMail lastname@attmail.com The addressee's last name (or combination of first and last) is used as the username and prepended to "@attmail.com". First initial and last name are commonly used as a username. 17.4 Bitnet address@system_name.bitnet address%system_name@gateway There are two formats for Bitnet addressing. The first is a standard Bitnet address with ".bitnet" tacked onto the end. This ".bitnet" modifier routes the message to a gateway machine connected to both Internet and Bitnet. If you already know or are provided with the gateway address, you may use the second form. The first form does work at the U of M, but may not work everywhere else. 17.5 BIX username@dcibix.das.net - POPMail / PC Version 3.1 83 - POPMail / PC Reference - Other Mail Systems The addressee must supply his username, which is prepended to "@dcibix.das.net" 17.6 CompuServe 70000.123@CompuServe.com The addressee supplies his CompuServe account number, which normally has a embedded comma "," in the middle. Switch the comma to a period and prepend the modified account number to "@compuserve.com". 17.7 Connect address@dcjcon.das.net The addressee must supply his username or address, which is prepended to "@dcjcon.das.net" 17.8 Dialmail address@dial.com The addressee must supply his address, which is prepended to "@dial.com" 17.9 Econet address@igc.org The addressee must supply his address, which is prepended to "@igc.org" 17.10 MCI user_number@mcimail.com The addressee must supply his user number, which is prepended to "@mcimail.com": - POPMail / PC Version 3.1 84 - POPMail / PC Reference - Other Mail Systems 17.11 SprintMail firstname.lastname@orgname.sprint.com This one is self explanatory. "orgname" is the name of the company or organization. 17.12 Summary Heres a summary of all the above services. In the following example, we'll try to addess mail to "Jane Doe" or 1234,5678 who works at jiffylube at various services: Ŀ Mail Service: Jane's Address: America Online jdoe@aol.com Applelink janedoe@applelink.apple.com AT&TMail jdoe@attmail.com Bitnet jdoe@jiffylube.bitnet BIX jdoe@dcibix.das.net CompuServe 1234,5678@CompuServe.com Connect jdoe@dcjcon.das.net Dialmail jdoe@dial.com Econet jdoe@igc.org MCI jane@mcimail.com SprintMail jane.doe@jiffylube.sprint.com 17.13 Other mail services There are cases where the above formulas will not provide a complete E-mail address. In these cases the fastest and most efficient method is to call the individual and ask for her/his address, or have them send E-mail to you. In each case you will obtain their address. - POPMail / PC Version 3.1 85 - POPMail / PC Reference - Preferences 18. Setting POPMail Preferences POPMail is designed so that you can customize the program to meet your needs. To customize POPMail, select "Setup|Preferences...". The Preferences box shown in Figure 22 will appear. Use the mouse to click in the little box to the left of each option in order to switch the preference ON or OFF (when an X appears in the box to the left of preference, it is turned ON). Ŀ [] Preferences ͻ Preferences: [ ] Include mail text in reply [X] Add signature to outgoing mail [X] Save copy of outgoing mail [ ] Check for mail at startup [ ] Prompt for password [ ] 43/50 Line mode as default [ OK ] [Cancel] ͼ Figure 22 - The Preferences dialog box. Using the keyboard you can toggle a preference by pressing the Alt key together with the letter that is highlighted for the preference in question, or press the TAB key repeatedly until the desired preference is selected [highlighted] and then press the Spacebar to toggle that preference ON or OFF. The default values are pre-set by POPMail to the values shown in Figure 22. If you do not like these default values, you are free to change them at any time. POPMail permanently remembers your settings. - POPMail / PC Version 3.1 86 - POPMail / PC Reference - Preferences 18.1 Include message in Reply When this option is ON, POPMail includes the original message body in your reply. The incoming message will appear before your reply with a leader line stating, " On [such and such a date] [so and so] writes: ". POPMail also places a greater than (>) symbol before each line of the incoming message. You then type your reply following or intermixed with this reference text. This feature is useful because it allows each recipient of your reply to consider your reply in the context of the original incoming message. 18.2 Add signature to outgoing mail When this option is ON, POPMail will automatically end each of your outgoing messages with a signature block of your choice, as shown in the John Doe example. 18.3 Save copy of outgoing mail When this option is ON, POPMail will automatically place a copy of each outgoing message into the SENTMAIL folder. This convenient feature saves a record of every message you send. 18.4 Check for mail at startup When this option is ON, POPMail automatically fetches any mail waiting for you when you start POPMail. 18.5 Prompt for password When this option is ON, POPMail will require you to enter your password every time you fetch or send mail. The password will not be stored in the configuration file. 18.6 43/50 line mode as default When this option is ON, POPMail will start with the program in the highest resolution mode allowed by your computer's video display adapter. This 43 or 50 line mode puts more information on the screen, at some sacrifice in clarity. You can always use POPMail's Setup|Lines/Screen to switch between screen modes as often as you wish. - POPMail / PC Version 3.1 87 - POPMail / PC Reference - Desk Accessories 19. Desk Accessories POPMail has several desk accessories (small programs that you can run while you are running POPMail). The POPMail desk accessories are: calculator, calendar, ASCII table, IP finder, U of M address Book, and Global Address Book. You activate a desk accessory by selecting the appropriate item in the = (system) menu. 19.1 Calculator The calculator is a simple four-function calculator. Numbers and operations are selected by clicking on the calculator buttons or by using the keyboard. Ŀ [] Calculator ͻ 0 [C][][%][] [7][8][9][/] [4][5][6][*] [1][2][3][-] [0][.][=][+] ͼ 19.2 Calendar The calendar is a simple electronic calendar. The current month appears automatically, but you can use the arrow keys or the calendar buttons to move to a future or past month. You can open up several copies of the calendar to view several months at a time. You'll have to move the calendar on top to see the other ones. - POPMail / PC Version 3.1 88 - POPMail / PC Reference - Desk Accessories Ŀ [] Calendar ͻ October 1992 Su Mo Tu We Th Fr Sa 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 ͼ 19.3 ASCII Table Use this desk accessory to look up the ASCII codes for any character, including special foreign language characters. You "language" setting does not affect this chart in any way. Ŀ [] ASCII Chart ͻ !"#$%&'()*+,-./0123456789:;<=>? @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_ `abcdefghijklmnopqrstuvwxyz{|}~ ڱߺ Ķ Char: Decimal: 0 Hex: 00 ͼ 19.4 IP Finder This desk accessory will look up the IP address of any internet name. - POPMail / PC Version 3.1 89 - POPMail / PC Reference - Desk Accessories Ŀ [] Find IP ͻ Computer Name: IP Address: [ Get IP ͼ 19.5 U of M Address Book; At the University of Minnesota, you can use this as an electronic phone book. For example, to look up all people with the name Hickman at the University of Minnesota, you would type in HICKMAN. You'll see all information pertaining to Hickmans in the University phone book. Ŀ [] U of M Address Book ͻ Who [Get info] Info  ͼ Often their information will include an E-mail-address. You can copy this address from this window and paste it into the To: area of a message. If there is no E-mail address listed, then that person may have asked that that info not be given out. This address book can be configured to get info from other address servers. - POPMail / PC Version 3.1 90 - POPMail / PC Reference - Desk Accessories 19.6 Flexible address book The "U of M" address book can be changed to talk to an address server at other sites. You can do this by setting 3 environment variables in DOS: Ŀ * Set "POPDNAME" to the name you want instead of "U of M" * Set "POPCNAME" to the name of computer to interrogate. * Set "POPCPORT" to the port number to connect to. For instance, if you have a finger-style server running on a computer named "admin.moo.umn.edu" at "MooTown College" on port 666: Ŀ C:\> SET POPDNAME=Mootown College C:\> SET POPCNAME=admin.moo.umn.edu C:\> SET POPCPORT=666 The server must use the general "finger" style protocol. i.e. the client sends a query string, and the server responds with an arbitrary amount of text. 19.7 Ping "Ping" lets you check to see if another computer can communicate with yours. Type in the name of another computer and click on "Ping". POPMail will send up to 100 echo requests to that computer and report the percentage of them that make it back to your computer. Ŀ [] Ping ͻ Computer Name: Thruput: [ Ping ] ͼ - POPMail / PC Version 3.1 91 - POPMail / PC Reference - Desk Accessories This is useful in diagnosing network problems. A thruput below 80% may indicate some problem in the intervening network. 19.8 Webster The Webster accessory lets you look up word definitions in a dictionary. The dictionary is kept on some central server. Your local net admins may be able to give you the name of a Webster server. To use Webster, type in the word into the "Look up:" box. Then choose one of the buttons. The Define button retrieves the definition of the word. The thesaurus button retrieves synonyms of the word. The Spell button verifies the spelling of the word. The Cross-Ref button retrieves the definitions of the word and its synonyms. [] Webster []ͻ Look up: archetype Define Thesaurus Server Name knowledge.all.edu Spell Cross-Ref Query Results: ar-che-type \'a^:r-ki-,t[]^-p\ n  [L archetypum, fr. Gk archetypon, fr. neut. of archetypos fr. archein + typos type] (1605) 1: the original pattern of ch all things of the same type are representations or copies: PROTOTYPE; also: a perfect example 2: IDEA 1a 3: an inherited the psychology of C. G. Jung that is de experience of the race and is present   - POPMail / PC Version 3.1 92 - POPMail / PC Reference - Other Features 20. Other Features 20.1 Text Editor The editor is a simple ASCII text editor that lets you open up multiple windows for the purpose of importing and editing ASCII text. You can use Cut, Copy, Paste, New, Open and Save, as well as Find and Replace commands located in POPMail's main menu bar. 20.2 Moving a Window You can move the Viewer and Composer windows as well as dialog boxes by using a mouse or the keyboard. Using a mouse, place the mouse cursor on the top bar of the window frame, press the left mouse button, and continue to hold the mouse button down while dragging the window to a new location, then release the mouse button. Using the keyboard, press Ctrl-F5 or select "Resize/Move" from the Window menu and use the four arrow keys to move the window. Press ENTER when done 20.3 Resizing windows Most windosw can be resized as well as moved. To resize a window using the mouse, grab the lower right corner of the frame and hold the left mouse button down, dragging the mouse until the desired size is achieved. Using the keyboard, select "Resize/Move" from the Window menu and use the arrow keys while holding the Shift key down. Press ENTER when done. 20.4 Zooming Windows You can Zoom a window to fill the screen in one of two ways. You can choose "Zoom" from the Window menu. - POPMail / PC Version 3.1 94 - POPMail / PC Reference - Other Features Or you can click on the zoom box (the little square in the upper right-hand corner of the window) to change the window from full screen to half-screen. 20.5 Trace Facility POPMail has a built-in trace facility to assist network administrators in trouble-shooting when POPMail fails to Fetch or Send properly. If your network administrator is unsuccessful in trouble-shooting the problem, we can be more helpful if we receive trace output. When tracing is turned ON, POPMail will write a detailed log of the transactions between the PC and the host mail server when messages are fetched or sent. Then your network administrator can use this log to help locate the source of the problem. You press Alt-F10 to display the Trace Options dialog box, as shown in Figure 12. Ŀ [] Trace Options ͻ Trace.. (*) .. off ( ) .. to trace window ( ) .. to File: POPTrace.Txt [X] TCP layer [X] Client/server interactions [X] Show body: receive [X] Show body: send [ OK ] [Cancel] ͼ Figure 23 The Trace dialog box. By default tracing is turned off. You turn tracing on by selecting a trace destination, either to the trace window or to a file. To direct the trace output to a Trace window, choose the ".. to trace window" radio button and then clicking on the oK button. Then a movable and resizable Trace window is made visible and active. You can scroll back through this window to see earlier messages. (The Trace window can only hold about 4,000 - POPMail / PC Version 3.1 95 - POPMail / PC Reference - Other Features characters). All new messages are always added to the bottom of the window. If the Trace window gets covered by the Viewer or Composer windows, you can bring it to the front by pressing ALT- F6 (Next Window) repeatedly until the Trace window appears on top of all other windows. To close the Trace window, click in the close box in the upper left-hand corner of the window or press the key. Even if the Trace window is closed, transactions will still be recorded to the trace window, you just won't be aware of them. Remember, if you have closed the Trace window you can make it visible again by pressing Alt-F10. To direct Trace output to a file, select the "..to file" radio button, type the name of the file in the input box just to the right of this radio button, and then click on the oK button. By default, POPMail uses the file name "POPTRACE.TXT". If you enter PRN for the filename, the trace output will go to your printer. The values you enter into the Trace dialog box are transient. They are forgotten once you quit the POPMail program. The Trace dialog box initial (default) settings are shown in Figure 22. The check boxes let you control the level of detail included in the trace output. - POPMail / PC Version 3.1 96 - POPMail / PC Reference - Advanced Configuration 21. Advanced configuration Most users will not have an occasion to use the Advanced... software button in the Configure dialog box. POPMail has default parameters which are appropriate for most network environments. However, if you encounter problems in installing or using POPMail on your network, consult your network administrator to see whether it might be helpful to alter the Advanced configuration parameters described in the next section. The Advanced Configuration Parameters dialog box is designed to provide network administrators with more advanced and specialized configuration parameters in case they are needed to install POPMail on network environments which have unique or unusual requirements (see Figure 4). Network administrators can set these specialized parameters by activating the Advanced... software button found within the Configure dialog box. POPMail has appropriate default settings for these advanced parameters which in our experience are suitable for most networks. However, if you encounter problems in installing or using POPMail on your network, your network administrator may need to alter the Advanced configuration parameters. When you press the Advanced... button you'll see: Ŀ [] Advanced ͻ a. Preferred full name b. Reply-to address c. Net mask 0.0.0.0 d. Domain request timeout (sec) 5 e. Connect timeout (sec) 1 f. I/O timeout (sec) 1 g. Retransmit timeout (sec) 1 h. Max transmit unit in bytes: MTU 2047 i. Max segment we can receive: MAXSEG 1024 j. Most bytes we can receive without ACK 2048 l. POP port 109 m. Finger port 79 [ OK ] [Cancel] ͼ Figure 4: Advanced Configuration Parameters - POPMail / PC Version 3.1 98 - POPMail / PC Reference - Advanced Configuration 21.1 Preferred Full Name POPMail usually gets your full name from the SMTP server so you should be able to leave this field blank. But some SMTP servers cannot or won't return your name. In this case you can use this field to override the information returned by the server. Enter your full name in real life, e.g. Jane A. Doe. 21.2 Net mask The net mask parameter has to do with how your local area network is configured and connected to the backbone network at your worksite. Your network administrator will know the correct value to enter here. Most sites are configured to use a net mask of 255.255.255.0 (the default value). You need not enter anything here if your network administrator has set up BOOTP service. 21.3 Domain request timeout This parameter sets the maximum number of seconds allowed for the name server on the network to convert your computer's host mail server name to an IP address. The default value is set to 20 seconds. If an error dialog box is displayed stating "Domain name request failed" when trying to send or fetch messages, you may need to increase this value. 21.4 Connect timeout When POPMail attempts to connect to the host mail server, this parameter sets the maximum number of seconds POPMail will wait before the host mail server will acknowledge your attempt to connect. The default value of 20 seconds is sufficient for most mail servers. If an error dialog box is displayed stating "Open failed" when trying to send or fetch messages, try increasing this value. 21.5 I/O timeout This parameter sets the maximum time allowed for POPMail to send and receive data from your computer to the host mail server. With the default value of 20 seconds, POPMail will wait 20 seconds for a response from the host mail server. If a response does not come through within 20 seconds, POPMail will present an error dialog box stating "error reading from network" or "error writing to network" and will abort the Send or Fetch operation in - POPMail / PC Version 3.1 99 - POPMail / PC Reference - Advanced Configuration progress. Again, if your host mail server is slow and frequently times out, you may need to increase this value. 21.6 Retransmit timeout This parameter sets the length of time in seconds POPMail will wait before retransmitting a packet whose earlier transmission was not acknowledged. The default is one second. This is a good choice if you are on a reasonably fast network, such as EtherNet or even LocalTalk. If you know you are on a slow network, such as a SLIP modem link, you may want to increase this number to 10- 20 seconds. This will lower the number of unnecessary retransmits and your mail will get through faster. 21.7 Max transmit unit in bytes This parameter specifies the maximum allowable packet size that POPMail will transmit in bytes. The default is 1024 (1K) bytes. This is okay for most networks. If you know your network is unhappy with packets of that size, you can adjust this number up or down as necessary. 21.8 Max segment we can receive This parameter specifies the maximum size packet in bytes that a host mail server is allowed to transmit to POPMail. The default is 1024 (1K) bytes. This works well on many networks. If your network needs smaller or larger packets, you can adjust this value as needed. 21.9 Most bytes without ACK This parameter sets the maximum send/receive TCP window size in bytes. The default is 2048 (2K) bytes. If you are using a 3C501 card, you should set this to the same value as your MTU above. The 3C501 card has problems receiving 2 packets right after one another, and setting this value to the same as the MTU will prevent this from happening. 21.10 POP port This parameter specifies the port POPMail will use to connect with the POP server. The default value is port 109. This is the - POPMail / PC Version 3.1 100 - POPMail / PC Reference - Advanced Configuration default POP2 port. If you are using a mail server that uses the POP3 protocol you will probably need to change this value to 110. 21.11 Finger port This parameter sets the port the Address Book (also known as "finger" to Unix users) command will use when using the Address Book desk accessory. The default value is port 79. - POPMail / PC Version 3.1 101 - POPMail / PC Reference - Program options 22. Program Switches The POPMail program has several optional parameters called program switches. These switches affect the operation of POPMail for just that run. 22.1 The /PATH option The /P or /PATH option allows multiple users to use the same copy of POPMAIL.EXE, but each can have their own configuration information. POPMail keeps several files related to each POPMail user. For each user POPMail keeps: Ŀ POPMAIL.CFG Contains your user name, password, net info POPMAIL.PLY Contains your current Composer window data. POPMAIL.SIG Contains your signature info. Unless told otherwise, POPMail puts these files in the same directory as POPMAIL.EXE. This works out well if only one person is using this copy of POPMAIL.EXE. If you want several different people to use the same POPMAIL.EXE, perhaps at the same time, then this scheme will not work. What you have to do is to have each user have a separate directory to contain their POPMail files. For instance, if you have 3 naive POPMail users, Joe, Sue, and Ken, you could do the following: create 3 directories: C:\JOE C:\SUE C:\KEN create 3 files: JOE.BAT containing the line: POPMAIL /PATH C:\JOE KEN.BAT containing the line: POPMAIL /PATH C:\KEN SUE.BAT containing the line: POPMAIL /PATH C:\SUE Then you can instruct each user to type their name to enter POPMAIL. As a convenience you'll probably want to do this yourself once and set up their user names and passwords and mail servers. - POPMail / PC Version 3.1 102 - POPMail / PC Reference - Program options 22.2 The /BATCH option Sometimes you might wish to find out if you have any new incoming messages without having to enter POPMail. You can do this with the /BATCH option. When you type POPMAIL /BATCH, POPMail runs in a non-interactive mode; that is, POPMail simply reports the number of messages waiting for you and then quits. POPMail sets the DOS variable %ErrorLevel% to the number of messages waiting. In batch mode you can also redirect this output. You can use this option in a batch file to check whether any messages are waiting in your mailbox and if there are, run POPMail in interactive mode to retrieve and read them. For example, to have POPMail use the configuration file in directory C:\POP77 and run in a batch file so POPMail will report the number of messages waiting, you would use the following command at the DOS prompt when starting POPMail: POPMAIL /BATCH /PC:\POP77 This sample batch file runs POPMail in interactive mode only if there are messages waiting: Ŀ @POPMAIL /BATCH >NUL @IF NOT ERRORLEVEL 1 GOTO :QUITNOW @POPMAIL :QUITNOW 22.3 The /MEM option If you run POPMail with the /MEM option, you'll see two numbers at the top right of the screen. The first number is the size of POPMail's internal "heap". The second number is the amount of memory unused by POPMail. These numbers are generally of interest only to POPMail developers and installers. 22.4 The /D option Turning on the /D option is equivalent to doing /MEM and setting Tracing to ON, directed to the COM1 port. This is usually only needed to debug strange POPMail or network problems. - POPMail / PC Version 3.1 103 - POPMail / PC Reference - Program options 22.5 The /NOEMS option POPMail normally uses some EMS for temporary storage if your computer has EMS available. If for some reason you do not want POPMail to use any EMS, use the /NOEMS option. 22.6 The /MONO option POPMail normally uses a default set of screen colors. These colors are optimized for legibility when using a color monitor. If you have a monochrome monitor, or just prefer seeing things in black and white, you can use the /MONO option to tell POPMail to use just black and white, and extra-bright white characters on the screen. POPMail automatically selects /MONO if you have issued a "MODE MONO" command in DOS. 22.7 The /GRAY option POPMail normally uses a default set of screen colors. These colors are optimized for legibility when using a color monitor. If you have a gray scale monitor or just prefer seeing things in shades of gray, you can use the /GRAY option to tell POPMail to use just shades of gray. - POPMail / PC Version 3.1 104 - POPMail / PC Reference - Multi Buttons 23. Multi- function Buttons Some buttons perform a different function if you hold down the Shift key when you press the button. 23.1 Shift-Send Shift-Send will cause POPMail to make a copy of your outgoing message regardless of the setting chosen in the Preferences dialog box. 23.2 Shift-Discard Shift-Discard will discard a message without further prompting. Normally POPMail asks you to verify that you really want to trash this message. If you hold the shift key down, POPMail won't ask. 23.3 Shift-Enclose Shift-Enclose will enclose a file as straight text instead of sending a "binhex" encoding of the file. 24. Acknowledgments POPMail/PC was originally written by Kim Pearson and Earl Schleske. Version 3.1 was largely done by Earl Schleske and George Gonzalez. There was also considerable assistance from Steve Collins, Dan Torrey, and Philip Kachelmeyer. This manual was written by Earl Schleske and George Gonzalez. Thanks also to managers S. P. Yen and Mark P. McCahill for their continued support. POPMail Version 3.1 uses Borland's TurboVision, an object- oriented library of special-purpose routines provided with Borland's newest release of Turbo Pascal, Version 6.0. Thanks to Borland International of Scotts Valley, California, for the excellence of their products. - POPMail / PC Version 3.1 106 - POPMail / PC Reference - Multi Buttons For the use of the Packet Drivers, the foundation on which our network products are based, we gratefully acknowledge FTP Inc, the developers of the packet driver standard, and Clarkson College of Potsdam, New York and Dr. Russ Nelson for developing, organizing and distributing many public-domain packet drivers. For many helpful comments and ideas as well as selected code segment contributions, we would also like to thank Phil Burns of Northwestern University. Special thanks to all the POPMail users and testers that made most of the suggestions that shaped POPMail Version 3.1. - POPMail / PC Version 3.1 107 - POPMail / PC Reference - Tech issues 25. Miscellaneous Technical Issues 25.1 Network card Drivers POPMail is designed to work with packet drivers. We suggest that you configure all your network software to use the packet drivers, if possible. The advantages of this are described above in section xxxx. 25.2 POPMail and Lan Manager If you are using IBM's or Microsoft's Lan Manager, you'll need an accessory program to use the packet drivers with Lan Manager. The accessory is called DIS_PKT; it forms an interface between the packet drivers and Lan Manager. We quote from the DIS_PKT documentation: Ŀ File DIS_PKT.DOC 3 Nov 1991 From: Joe R. Doupnik Utah State University Logan Utah 84322 jrd@cc.usu.edu (801) 750-2982 voice (801) 750-2992 fax What DIS_PKT.DOS does: It provides an Ethernet or a Token Ring Packet Driverinterface to programs built to operate over Packet Drivers. It talks to NDIS (3Com/Microsoft) instead of to a lan board directly. It shares the board with NDIS users. We call this a "shim", sitting between the normal applications program (NetWare shells, TCP/IP, etc) and the more hardware specific portions (NDIS in this case). You can find a copy of DIS_PKT in /pub/pc/packet-drivers/drivers on boombox.micro.umn.edu. 25.3 Using its own TCP driver POPMail is also designed to use its own internal TCP driver. In an ideal world, there would be just ONE TCP driver that all - POPMail / PC Version 3.1 108 - POPMail / PC Reference - Tech issues programs would call on. Ideally, this TCP driver would be "free" and available to everyone at low or no cost. In reality, many programs have their own TCP driver built in, or they require a separate TCP driver, such as the one available from FTP Inc. While these other drivers may be good pieces of software from good companies, there are problems with using these drivers: In a university environment, our users cannot each afford to buy a copy of the driver. The driver takes up precious RAM all of the time, even when non- network programs are running. So for POPMail, we prefer to have it use its internal TCP driver. 25.4 Using FTP Inc's Driver However, POPMail does have some limited, unsupported capability to work with FTP's PC/TCP driver. This ability was added by other developers and the U of M cannot test, verify, update, or enhance this capability. The way it works is automatic-- if POPMail detects that FTP's TCP driver is loaded and running, POPMail will try using FTP's driver instead of its own. This capability exists but has not and will not be extensively tested. 25.5 PCNFS and other TCP drivers There is a way to use POPmail while running other TCP drivers, such as Sun's PCNFS. Normally this will not work as POPMail's TCP driver will fight with Sun's TCP driver and neither one will work very well. There is a piece of software that can allow these two to coexist. IT is called "PKTMUX". It is a packet driver multiplexor. That means it allows one packet driver to be shared among several TCP drivers. We did not write and do not support this particular piece of software, but some POPmail users have had success in using PKTMUX and POPMail. Again, we cannot answer any questions or fix any problems relating to PKTMUX. 25.6 POPMail and Novell NetWare You can use POPMail at the same time you have Novell NetWare running. There are two ways to do this: you can configure - POPMail / PC Version 3.1 109 - POPMail / PC Reference - Tech issues NetWare to use the packet driver, or you can configure NetWare to use the NetWare ODI driver and use the ODI packet driver. 25.7 NetWare & packet driver First, you must generate a special IPX that uses a packet driver. You have to SHGEN or WSGEN a new IPX program using the driver from BYU to create the interface between the packet driver and NET3/4/5/X. The BYU_IPX is a generic IPX that works with any of the boards that use the packet driver, so if you have a mixture of 3COM, Novell Ethernet, and other boards you just need the appropriate packet drivers and the BYU version of the IPX. 25.8 NetWare & ODI NetWare can be configured to use an ODI driver. An ODI driver is very similar in concept to a packet driver. Once NetWare is using ODI, you can use the ODI packet driver. This packet driver is actually a "shim", it fits over the ODI driver and makes it look like a packet driver. In the end, everyone is happy-- NetWare can talk to the network thru its ODI driver, and POPMail and other packet driver apps can talk to the network thru the ODI packet driver (which talks to the ODI driver, whcih talks to the network). 25.9 POPMail and Windows 3.0 Version 10.x of the Clarkson/Crynwr packet drivers will work with Microsoft Windows 3.0 and 3.1. To configure the packet driver to work with Windows 3.0 or greater, add the -w switch to the command line immediately after the command to invoke the driver, before any other parameters. This allows you to use Windows to invoke POPMail, Telnet, ftp, or tn3270 directly. For example, to invoke the packet driver for the 3COM 503 board, allowing for use with TCP/IP and to work with Windows 3.0, you would use the following command: Ŀ 3c503.COM -w 0x60 3 0x300 If you want to use Windows and Novell NetWare together, your command lines would look like this: Ŀ 3c503.COM -w 0x60 3 0x300 BYU_IPX.COM - POPMail / PC Version 3.1 110 - POPMail / PC Reference - Tech issues In addition, you will need to set up a separate Windows .PIF file for each of the applications (POPMail, Telnet, ftp, and tn3270) with the following options so that Windows can run these packet- driver-dependent applications correctly: Ŀ Full screen ON Background execution ON Close Window on Exit ON Under "Advanced...": Background priority 100 Detect Idle Time OFF Lock Application Memory ON Video Memory TEXT Monitor Ports OFF (i.e., all boxes off) Retain Video Memory ON The .PIF file should point to the .EXE files for each of these programs. - POPMail / PC Version 3.1 111 - POPMail / PC Reference - Character sets 26. Character sets 26.1 Introduction POPMail supports many special character sets. Many languages require characters that are not part of the "standard ASCII" subset. For instance, many languages use umlauted and accented vowels. These characters are displayable, because the IBM PC and Macintosh have assigned some non-standard display codes to them. But the standard mail path is only guaranteed to pass the lower 128 of the full 256 character set. To get around this problem, some of the less used characters are assigned different roles. Since there are only a few of these less-used characters available, there are not enough to go around for all languages. This means that when you write a message in Swedish, and use swedish characters, POPMail has to send along with the message some indication that the characters should be interpreted at the receiving end as Swedish. 26.2 In depth Your computer stores each character in an eight-bit chunk called a byte. Depending upon the number stored in a byte, the byte can represent one of 256 characters. A standard called ASCII has standardized the first 128 numbers to represent each of the characters necessary for the English language plus important symbols such as the dollar sign, period, and comma, and each of these numbers has been assigned a number. For example, the number stored in the byte representing the dollar sign has been assigned the number 36. This number is the same across all manufacturers, and this consistency makes it possible to exchange characters accurately from computer to computer. Unfortunately, there is no standard for representing characters used in many other languages. Since computer manufacturers want to sell computers to people who need other characters in order to communicate in their own languages, each manufacturer picks some arbitrary number beyond the first 128 numbers reserved by ASCII to represent each foreign character. For example, the Swedish language uses a character called an "umlauted a" (an "a" with two dots over it). An IBM computer uses the number 132 to represent - POPMail / PC Version 3.1 112 - POPMail / PC Reference - Character sets a lower-case umlauted "a", whereas a Macintosh uses the number 221 for this same character. Obviously, this difference causes a problem when transferring text between an IBM PC and a Macintosh, but there is even a larger problem. When you send mail electronically, many mail programs will ignore any characters that are not part of the first group of 128 characters defined by the ASCII standard. For this reason many countries like Germany, France, and Sweden have decided to sacrifice certain ASCII characters in order to re-map or re-define these characters to accommodate the letter characters they need. For example, the tilde character (~) is mapped to represent an umlauted "u" (a "u" with two dots over it) for the Swedish language character set. POPMail makes the conversion automatically so that two people using POPMail can exchange E- mail written in Swedish without having letter characters appear as tildes or curly brackets at the other end. 26.3 How POPMail does it POPMail has two different character set challenges. First, how to map the characters when sending and fetching mail, and second how to recognize the character set of incoming mail. 26.4 With outgoing mail POPMail has an option on the "Setup|Network" dialog that lets you choose a language character set. When you click on "Send" to send your message, POPMail does two things. First, it looks at your language setting and converts any language specific characters to their network-compatible equivalents. For example, an umlauted a might be mapped to "[". Secondly, POPMail appends a line something like "X- POPMail-Charset: Swedish" to the message header for the benefit of the recipient. 26.5 With Incoming mail POPMail reads an incoming message and looks at the header. It looks for a line something like "X- POPMail-Charset: XXXXXXXX". If the language XXXXXXX is known to POPMail, it converts the network-compatible characters to their displayable equivalents. For example, if the language is Swedish, POPMail might convert every '[' in the message to an umlauted a. - POPMail / PC Version 3.1 113 - POPMail / PC Upgrading to this version 27. Upgrading 2.XX to 3.1 It is easy to move to POPMail version 3.X from older versions. Basically you need to get the new POPMAIL.EXE and POPMAIL.HLP files. The first time you run POPMail version 3, it automatically does some things for your convenience: POPMail converts your old configuration file, POPMAIL.CFG, to the new version 3 configuration file POPMAIL.CNF. POPMail moves all your version 2 messages into the incoming mail folder "INBOX". This means you should be up and running with all your old mail messages accessible to the new POPMail. 27.1 Changes from version 2.XX We've made some changes in the user interface in version 3 that version 2 user's will have to learn. The philosophy behind the changes was to add features without adding complexity or confusion. The "Fetch", "Send", and "Enclose" buttons which used to be on screen buttons have now been moved to the bottom line of the screen. The "Fetch", "Send", and "Enclose" shortcut keys had to be removed to be more compatible with common usage in Windows. They are now available as function keys, or as Alt-G ("Get") and Alt-P ("Post"). The menus have been rearranged to be more consistent and easier to understand. The Viewer and Composer windows have been redesigned to be easier to use and easier to understand. - POPMail / PC Version 3.1 114 - POPMail / PC Enhancements 28. Future Enhancements Many of you are interested in the future of POPMail. We get lots of mail about suggested new features and enhancements. To forestall some of this mail, we list below some areas that we are investigating. Note that we cannot promise that any or all of these features will appear, or when they will appear. The list is not in any particular order. Support for IMAP protocol. Support for MIME format messages. Better printer support. Support for ISO-8859 character set. Much larger message index. Automatic message routing to folders. Configurable message ordering. Boilerplate text library. Personal address book for frequently used addresses. Improved, hierarchical group structure. E-mail address verification without sending. Multiple composer windows. Queued message sending for better SLIP line usage. All text changeable to other languages. All colors configurable. - POPMail / PC Version 3.1 116 - POPMail / PC Reference - Q & A 29. Questions & Answers 29.1 Not enough memory What can I do if POPMail says "Not enough memory to run POPMail"? The current version of POPMail needs at least 512K of free memory. If you have a lot of TSRs or your network software has a large resident portion, then POPMail will have trouble running. Run the "chkdsk" or "mem" commands to see how much free memory is left for applications. You may need to remove some device drivers, do a "loadHi" for some drivers or TSR's or reduce the number of files or buffers. 29.2 Defining groups How do I define a group in the "Edit Groups" window? Groups are defined by listing a group name, followed by one or more spaces, followed by a group member's mail address, followed by one or more spaces, followed by another group member's mail address, etc. Put a blank line after the group to separate it from the other groups you have defined. 29.3 POP3 servers We are running a POP3 server on port 110. Can we use POPMail with this POP port? Yes. To have POPMail use a port other than the default 109 port, simply specify the desired port in the Advanced Configuration Parameters dialog box (access this dialog box by activating the Advanced... software button in the Configure dialog box). 29.4 "TCP did not load" error I just FTP'd POPMail/PC and tried to run the program. I get the error message "TCP Driver did not load". What is wrong? This can happen if you forget to specify binary mode when doing the ftp. Before you enter the "get" command, enter "binary." - POPMail / PC Version 3.1 117 - POPMail / PC Reference - Q & A Sometimes we also see this problem if there are too many gateway hops, resulting in the file getting mysteriously truncated along the way. For some reason, we've seen this problem frequently when people ftp POPMail from our server to their site in Canada. Other than forgetting to specify binary mode, we still are not sure why this phenomenon occurs. Often subsequent attempts will succeed where the first try failed. After you ftp, just make sure that you have the complete file by checking that you received the correct number of bytes as shown by the directory command (ls). 29.5 Manual format In what format is the POPMail/PC manual? The manual is in 2 formats: (1) MAN.RTF is in RTF (rich text format), so you should be able to download and read this file with any version of Microsoft Word for the IBM; and (2) man.txt is a straight-ASCII version of the manual. 29.6 BOOTP support Does POPMail support BOOTP? We do support automatic configuration through BOOTP. BOOTP is a protocol that lets you define all the parameters, IP address, gateways, and name servers at one central server. POPMail/PC interrogates the BOOTP server if the microcomputer IP address is 0.0.0.0. In this way new users can just start up POPMail without knowing any IP numbers and POPMail will configure itself. 29.7 Multiple packet drivers I have more than one Packet Driver loaded. POPMail cannot seem to find the correct packet driver. What's going on? POPMail uses the first packet driver it finds. Make sure the packet driver POPMail needs has the lowest interrupt number. You can ensure success by assigning it the lowest possible interrupt number: 0x60. 29.8 3c503 problems When I tried to use the 3C503 packet driver I was required to change the jumpers on the 3C503 to allow shared memory. This allowed me to run POPMAIL which looks like a real good product. - POPMail / PC Version 3.1 118 - POPMail / PC Reference - Q & A However when I reconfigured the PC to boot with PC-NFS it wouldn't work unless I set the jumpers on the 3C503 back to "memory disable" (note: I didn't try to load 3C503 packet driver). The packet driver for this particular hardware requires memory sharing, while PC-NFS disallows it. One of our users recently learned from SUN of an undocumented "switch" (/m4) that can be used when loading the PC-NFS drivers for the 3c503 card. For example, when you boot up for PCNFS, you load the following: Ŀ Device= \NFS\DRIVERS\VECIE6.SYS /I2 /T2 /M4 This switch allows the PC-NFS drivers to use the 3c503 card jumpered for shared memory. This way one can use either the Clarkson/Crynwr drivers for telnet or POPMail or the PC-NFS drivers. Of course, one cannot use them at the same time; separate reboot sequences are still necessary. But at least one needn't re-jumper the card to alternate between the two usages. 29.9 POPMail as a TSR Can you make POPMail a TSR? A POPMail TSR would be nice in theory, but it would take up about 80k of RAM. Most users do not want to or cannot lose 80k without wreaking havoc upon their main applications. So while it would be an interesting exercise in programming, it's not too practical on DOS machines. However, POPMail does have a batch mode that you can use to have POPMail report the number of messages waiting for you on the server (see the manual for further information). 29.10 POP2 described Where are the POP2 protocols described? The description of the POP2 protocol is in RFC937. 29.11 Password encryption Does POPMail use password encryption? We added DES encryption to the login sequence. Our POP2 server makes up a random key and sends it to the client. The client encrypts the password with the key and sends it to the server. The server can then unencrypt the password and check it. By - POPMail / PC Version 3.1 119 - POPMail / PC Reference - Q & A choosing the right defaults, we can keep the server and clients interoperable, i.e., the client can recognize our "extended" POP2 server by the presence of a key in the server's welcome message. Therefore the client sends encrypted passwords to extended servers, and regular clear passwords to plain POP2 servers. Similarly, our server accepts both encrypted and clear passwords interchangeably. Therefore you can mix and match. Our clients can talk to a standard POP2 or POP3 server, and other clients such as Eudora can talk to our server. As another level of security, if our client determines that it is talking to a standard POP2 server and must send the password in the clear form, it sends the password 1 character per packet with long random delays between packets instead of sending it all in 1 packet. This disguises the password from all but the most knowledgeable of network peekers. You can get our extended POP2 server by anonymous FTP from boombox.micro.umn.edu. It is in /pub/POPMail/unix. 29.12 Where are packet drivers Where is the complete collection of the packet drivers? A complete collection is available via anonymous ftp from wuarchive.wstl.edu in directory mirrors/msdos/pktdrvr. 29.13 Connection problems I am trying to install POPMail and I cannot seem to connect to our POP server. What's wrong? It's hard to say. In order to tell whether something is wrong with the way your POP server is configured, try connecting to our POP server first. We have an account on our POP server which is specifically designated for testing POPMail. Our POP server lives on boombox.micro.umn.edu. User Name is testmail and Password is testmail. 29.14 Dialup mail Is there a version of POPMail that allows you to get your mail via a dialup connection? I'm not interested in something that works on dialup SLIP, but rather something that just establishes a clean datapath between the PC and the pop and smtp mail servers...much like Eudora for the Macintosh allows you to do. - POPMail / PC Version 3.1 120 - POPMail / PC Reference - Q & A The answer to your question is, "No, you cannot do what you ask." POPMail works over a SLIP connection for dialup use. SLIP allows you to use network applications (POPMail, internet gopher, telnet, ftp, etc.) from home with exactly the same user interface as when running these over a LAN connection. Another advantage with SLIP is that you have end-to-end error detection (something not true of Eudora's dialup access method). 29.15 No Full Name I've installed POPMail for testing and I noticed that in the initial setup ( configuration ) I do not get a prompt for 'Full Name'. Is this normal? That is normal. POPMail gets your full name from the SMTP server. This is to discourage forged mail. 29.16 Implementation Language What computer language is POPMail written in? Turbo C version 1.5, Turbo Assembler 1.0, and Turbo Pascal 6.0 30. For more Help If you run into difficulties when installing or using POPMail, you should first contact your local network administrator. If you have questions, bug reports, suggestions, or general comments about POPMail you can send E-mail to us at: Ŀ popmail@boombox.micro.umn.edu or if you prefer paper mail: Ŀ POPMail Project University of Minnesota Room 190 Shepherd Labs Minneapolis, MN 55455 U.S.A. In all of your mail about POPMail, please: - POPMail / PC Version 3.1 121 - POPMail / PC Reference - Q & A Indicate your POPMail version number. Indicate your operating system and version number. If possible, send us a diagnostic record of your POPMail session. (See the "Trace Facility" section for further details.) 30.1 If you like POPMail If you like POPMail, and would like POPMail to continue to develop, it would not hurt to drop us a note saying so. Your opinion carries some weight with the people who allocate funds for program development. If you like POPMail and would like it to continue to improve, a brief testimonial would be helpful. You may send it to one of the above addresses. - POPMail / PC Version 3.1 122 - POPMail / PC Reference - Error Messages 31. Error Messages Below we list all the POPMail error messages. The error messages are listed in alphabetical order. For each message, we give the error message, an explanation of what the message means, plus what to do if you get that message. -Can't Access ARP handle Some other network program has grabbed the packet driver and is not allowing POPMail to do so. Reboot and don't load the other conflicting software. The other software is some program that uses the network, such as PC-NFS. -Can't access IP handle Some other network program has grabbed the packet driver and not allowing POPMail to do so. Reboot and don't load the other conflicting software. The other software is some program that uses the network, such as PC-NFS. -Can't get IP info from setup dialog or BOOTP You did not specify an IP number for your personal computer, or a gateway or name server. POPMail tried to ask the BOOTP server for that information, but did not get back any information. Check your network connection. Check with your network administrator to see if the BOOTP server is available and is working. -Can't save outgoing message, can't make SentMail.MBX POPMail could not create a directory for your mail. - POPMail / PC Version 3.1 124 - POPMail / PC Reference - Error Messages Check your disk to ensure it is not full or write-locked. -Can't write to index file XXXXXX POPMail could not create a index file for your mail. Check your disk to ensure it is not full or write-locked. -Cannot connect to xxx server on host yyy. POPMail could not sucessfully connect to the xxx server on the computer yyy. Check your network connection. Check with your network administrator to see if computer yyy is working properly. Try the "Test" button to check out the network. -Cannot find TCP driver POPMail could not find its TCP module which is appended to the POPMAIL.EXE file. Get a fresh copy of POPMAIL.EXE. Some virus checkers may trim off the appended modules. -Checksum error POPMail has received a bad packet. Check your network connection if this persists. -Collection Index out of range Should never happen. Report this error to popmail@boombox.micro.umn.edu. - POPMail / PC Version 3.1 125 - POPMail / PC Reference - Error Messages -Collection Overflow Error Should never happen. Report this error to popmail@boombox.micro.umn.edu. -Connect failed POPmail was unable to form a connection to your mail server. Check your network connection hardware. Try the "Test" button on the configuration dialog to help diagnose network problems. -Could not initialize hardware level network driver POPMail could not connect to the packet driver. Check the packet driver to see if it is loading properly. -Destination unreachable POPMail cannot reach the IP address specified for the mail server or other service. Check the values entered for Mail Host under "Setup|Network...". -Enclosure truncated POPMail tried to read an enclosure, but could not find the end. The enclosure somehow got truncated in transit. Some BITNET mail servers may do this. Ask the sender to send the enclosure again. -Error deleting message POPMail could not delete a message from your disk. - POPMail / PC Version 3.1 126 - POPMail / PC Reference - Error Messages Check your disk with "chkdsk" or other disk fixing tool. Make sure the disk is not write-locked. -Error reading enclosure POPMail tried to read an enclosure, but encountered some gibberish in the message. Ask the sender to send the enclosure again. -Error Saving Composer Message to File POPMail could not create a directory for your mail. Check your disk to ensure it is not full or write-locked. -Error sending enclosure POPMail tried to send your enclosure, but got a network error while doing so. Try sending it again. Check your network connection. Check with your network administrator. -Invalid data fork in enclosure POPMail tried to read an enclosure, but encountered some gibberish in the message. Ask the sender to send the enclosure again. -Invalid header on enclosure POPMail tried to read an enclosure, but encountered some gibberish in the message. Ask the sender to send the enclosure again. - POPMail / PC Version 3.1 127 - POPMail / PC Reference - Error Messages -Invalid resource fork in enclosure POPMail tried to read an enclosure, but encountered some gibberish in the message. Ask the sender to send the enclosure again. -IP packet with options received POPMail received a special kind of packet that it cannot handle. Check with your network administrator. -IP: fragmented packet received, frags not supported POPMail cannot handle fragmented packets. Try turning the MTU size down in "Setup|Network|Advanced..." down to 256. -Local host or gateway not responding POPMail cannot talk to anything on your network. Check your network connection. Check the values for Gateways and Name Servers under "Setup|Network...". -Mail server complained: "Bad Login" or "Incorrect login" You local mail server computer did not accept your username or password. Check to make sure you are specifying the correct username, password, and mail server in the "Setup|Network" dialog box. - POPMail / PC Version 3.1 128 - POPMail / PC Reference - Error Messages -Mail server name lookup failed POPmail tried but could not look up the name of your mail host. Either the name is wrong or name servers are not working. Check with your network administrator, ask if name servers are working. -Message too big to show completely. Complete message saved as file XXXXX. POPMail can't diplay more than 50,000 characters in its viewer window. Use some other text editor to view file XXXXXX. -Name not found: NNNNN One of the computer names you entered does not seem to exist. Check the "Setup|Network... values for typos. Check with your network administrator to see if the Name Servers are working. -Name server failed, unknown reason POPMail tried to look up an IP name, but did not get a good result back from the name server. It is likely that the name does not exists or is misspelled. Check the machine name for typos. -Network error POPMail tried to send your enclosure, but got a network error while doing so. Try sending it again. Check your network connection. Check with your network administrator. - POPMail / PC Version 3.1 129 - POPMail / PC Reference - Error Messages -Network read error while receiving enclosure POPMail tried to get your enclosure, but got a network error while doing so. Try fetching it again. Check your network connection. Check with your network administrator. -No Packet Driver found POPMail searched, but did not find a packet driver. Check your AUTOEXEC.BAT file and packet driver. -Not enough memory for TCP Driver. POPMail could not get enough RAM to load its TCP driver module. Free up some RAM memory by not loading so many TSR's, disk caches, and drivers. -You have over 300 messages in this folder. Please move some to another folder. POPMail currently only indexes the first 300 messages in a folder. Create some new mail folders and move some messages to those folders. -Out of memory Should never happen. Report the error to popmail@boombox.micro.umn.edu - POPMail / PC Version 3.1 130 - POPMail / PC Reference - Error Messages -Out of memory in TCP driver Should never happen. Report this error to popmail@boombox.micro.umn.edu. -Packet driver error on driver_info POPMail found the packet driver, but the packet driver could not return some information. Check your packet driver to make sure it loaded okay. -Packet Driver is not loaded POPMail can't find the packet driver. Check your AUTOEXEC.BAT file and packet driver to make sure it is getting loaded properly. -RARP failed POPMail tried to get some information by the RARP method, but did not succeed. Check your network connection. Check with your net+owork administrator about the health of the network. -Requested packet class does not match driver class POPMail cannot get the proper access to the packet driver. Check to make sure you are loading the correct packet driver. -The conflicting machine is using the same IP number Some other computer on your same physical network has the same IP number. - POPMail / PC Version 3.1 131 - POPMail / PC Reference - Error Messages Check your IP number under "Setup|Network". You should only be using a number assigned to you by the local network administrator. -The directory for mail xxx can't be created. POPMail tried but could not create the mail directory to store your mail messages. Check the "Setup|Network|Subdirectory for mail" path for a valid disk drive. Check your disk to make sure it is not full. -Time Exceeded on Packet POPMail got a very old packet from the network. Check with your local network administrator. -Timed out while reading from network POPMail tried to read from the network, but never got the correct response. Try again. Check your network connection. Try the "Test" button under "Setup|Network...". -Timed out while reading from the network POPMail tried to read from the network, but got a response. Try it again. Check your network connection. Check with your network administrator. -Timed out while writing to network POPMail tried to send something to the network, but never got the correct response. - POPMail / PC Version 3.1 132 - POPMail / PC Reference - Error Messages Try again. Check your network connection. Try the "Test" button under "Setup|Network...". -Unable to Fetch Mail - Directory XXXXX can't be created. POPMail could not create a directory for your incoming mail or enclosures. Check your disk to ensure it is not full or write-locked. -Unknown email address: XXXX POPMail could not locate the email address XXXXX. Double check the address. -Unsupported packet driver class: not Ethernet, Slip, or LocalTalk The packet driver you loaded is not a Ethernet, SLIP, or LocalTalk flavor packet driver. POPMail only knows how to talk to those types of networks. Change your packet driver and network connection to one of the above flavors. -You may view messages, but not send or fetch. POPMail thinks that you don't have a packet driver loaded. POPMail needs a packet driver to fetch or send messages. Check your AUTOEXEC.BAT file to see if it is loading the packet driver. Check to make sure your packet driver file (XXXXX.COM) is still on your disk. -You must specify a recipient. You tried to send mail, but did not list any recipients. - POPMail / PC Version 3.1 133 - POPMail / PC Reference - Error Messages Specify at least one recipient. -Zero length message body POPMail read a message, but it was empty. This should never happen. Check with your mail server administrator. - POPMail / PC Version 3.1 134 Alt-F10...................95 Alt-Spacebar...............7 America Online............82 Anonymous FTP.............17 32. Index Applelink.................82 ASCII.....................89 %ErrorLevel%.............103 ASCII text................40 .DOC......................42 AT&TMail..................82 .EXE file.................41 AUTOEXEC.BAT..............20 .PIF.....................111 Backspace.................31 /BATCH...................103 Backspace key.............12 /D.......................103 BCC /GRAY....................104 BINARY mode...............18 /MEM.....................103 BinHex....................41 /MONO....................104 BINHEXed enclosures.......40 /NOEMS...................104 BIX.......................82 /P.......................102 Blinking red..............77 /PATH....................102 Body field................46 11.6 Print................60 Boombox.micro.umn.edu.....17 11.7 Exit.................60 BOOTP................24, 118 14.13 Subdirectory........76 Borland..................106 18.2 Add signature........87 Browser...................58 18.4 Check for mail.......87 Button.....................9 2.13 Editing Text.........12 BYU_IPX..................110 21.10 POP port...........100 Caching...................15 21.11 Finger port........101 Calculator................88 21.3 Domain request timeout99 Calendar..................88 21.4 Connect timeout......99 Cancel.....................9 21.5 I/O timeout..........99 Capitalization............23 21.6 Retransmit timeout..100 CAPS-LOCK.................23 21.7 Max transmit unit...100 Carbon-copy...............34 25.5 PCNFS...............109 Cascade...................81 27. Upgrading............114 CC 3.10 Installing...........20 Change directory..........60 3.7 Redistributing........17 Character sets...........112 3C501....................100 Check boxes...............10 3C503....................119 Check mark................54 4.8 Microcomputer IP address CICNET, .i.NSFNET..........3 24 Clarkson College.........107 5.9 Sending the message...32 Clear Composer............64 7.6 Pure text enclosures..41 Client.....................3 7.7 Quirks................42 Close.....................80 8.5 Replying..............48 Command...................58 8.6 Forwarding Mail.......48 Composer..................28 9.12 Marking..............54 Composer Window...........28 9.8 Browsing..............52 CompuServe................82 Accented letters..........26 Computer name.............23 Account name..........23, 73 Configuration.............22 Add/Remove Enclosures.....41 Connect...................82 Address Book..............90 Connectivity...............3 Advanced..................98 Context-sensitive help....82 Advantages................15 Control characters........78 Alt-K......................9 Copy......................62 Alt-P.....................24 Copying...................57 Creator...................44 Hints.....................80 Ctrl-F5...................94 Hot spots..................8 Current message...........46 ICON......................44 Cut.......................62 Identifier................34 Data fork.................43 IMAP.....................116 Database..................38 INBOX.....................50 Default values............86 Incoming mail.............46 DEL.......................31 Input boxes...............10 DEL key...................12 Install...................14 Desireable extensions.....44 Internet...................2 Desk accessories..........88 IP address................23 Destination folder........56 IPX......................110 Dialmail..................82 Keep......................56 Dialog box.................8 Keyboard...............9, 54 Directory.................25 Lan Manager..............108 DIS_PKT..................108 Language..................26 Diskette..............25, 76 Lines/Screen..............72 Double-click..............54 List box..................11 E-mail address............30 Local area network........25 Econet....................82 LocalTalk............14, 100 EDIT......................48 Login name............23, 73 Editing text..............31 Long messages.............48 Electronic mail............2 Lower-case................23 Empty mail folder.....51, 67 Macintosh..................2 Empty Trash...............56 Macintosh file............38 EMS.......................15 MacWrite..................44 Enclose...................31 Mail flow.................51 Enclosures................38 Mail folder...............50 Encoded enclosure.........38 MailStop..................16 EtherLink XXX.............18 Mark......................68 Ethernet..................14 Mark all..................54 Exchanging Documents......42 Mark all messages.........68 Expanded..................15 MCI.......................82 F10........................7 Menu bar...................6 F4........................48 Message field.............31 F5....................39, 48 Message index.............52 F7........................47 Microsoft Excel...........43 F8........................47 Microsoft Word............42 Fancy effects.............31 MIME.....................116 Fetch mail................47 Monochrome................16 File converters...........42 Mouse.............16, 54, 94 File name extensions......44 Move......................50 File types................44 MRNET......................3 Find......................63 MS Excel..................44 Finger server.............77 MSDOS.....................14 FTP.......................17 Name server...........25, 75 Fun.......................56 Navigate..............40, 60 Gateway...............25, 75 Net mask..................99 Graphical user interface...2 NetWare..................109 Group.....................34 Network cards.............15 Groups....................35 Network configuration.....73 Help......................82 Network...................73 HICKMAN...................90 New.......................59 Highlighted................9 Next Window...............80 Novell NetWare......109, 110 TCP driver...............108 OK.........................9 TCP window...............100 Open......................58 Telnet...................110 Organizing................50 Test button...............76 Packet driver.............15 Text edit windows.........28 Password..............23, 73 Time Zone.................25 Paste.................12, 63 Tn3270...................110 PATH......................20 To PCDOS.....................14 Tracing...............78, 95 Phil Burns...............107 Trash.....................56 Ping......................91 TSR......................119 PKTMUX...................109 Umlauted.............26, 113 POP2.......................3 Undo......................62 POP3.......................3 University of Minnesota....2 POPMAIL.CFG..............102 Unix......................16 POPMAIL.PLY..............102 User Name.............23, 73 POPMAIL.SIG..............102 Username@host.............82 Preferences...............86 UX........................16 Printer ending............78 Video display.............87 Printer initialization....78 Viewer................28, 46 Printer setup.............78 Viewer Window.........28, 46 Pull-down..................6 Whole words...............63 Radio buttons.............11 Windows 3.0..............110 RAM.......................16 Word......................44 Recipient.................30 Word-wrapping.............31 Reliability...............76 WordPerfect...............42 Requirements..............14 WordStar..............12, 31 Resize................80, 94 Zoom......................81 Resource fork.............43 Retrieve..................56 Rich text format..........42 RTF.......................42 Save......................59 Save As...................59 Screen modes..............87 Search and Replace........64 Security..................74 Select....................12 Selected text.............12 Sendmail..................77 Server.....................3 Settings..................72 Shift-Discard............106 Shift-Send...............106 Shift-TAB..................9 Signature.................73 SLIP................100, 116 SMARTDRV..............15, 16 Sort the index............53 Sorting key...............53 Spreadsheet...............38 SprintMail................82 Student.tc.umn.edu........30