**************************************************************************** * * * HappyMail * * * * Version 1.18 Release Notes * * * * HappyMail is a Windows based e-mail client for the Banyan Vines * * Mail System. The client was originally designed for the 4.11 * * release of Vines, but has recently been modified to take * * advantage of some of version 5.5's improvements. In addition, * * HappyMail features several enhancements such as a spell-checker, * * a text search capability, a sorting capability, and a WordPerfect * * text viewer. * * * * * **************************************************************************** Contents ======== 1. Disclaimer Notice 2. File Listing 3. Installing HappyMail 4. Setting up the User 5. Undocumented Features Documented 6. Who to complain to ---------------------------------------------------------------------------- 1. Disclaimer Notice ===================== THE HAPPYMAIL PROGRAM AND THE INFORMATION PROVIDED HEREUNDER (COLLECTIVELY REFERRED TO AS "SOFTWARE") IS PROVIDED AS IS WITHOUT SUPPORT OR WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE DEVELOPER OR THE FINANCIAL MANAGEMENT SERVICE BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF THE DEVELOPER OR THE FINANCIAL MANAGEMENT SERVICE HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. This Software may be copied and distributed royalty-free subject to the following conditions: 1. You must copy all Software without modification and must include all source code and documentation, if the Software is distributed without inclusion in your software product. If you are incorporating the Software in conjunction with and as a part of your software product which adds substantial value, you may modify and include portions of the Software. 2. You must place all protective disclaimers and notices contained on the Software on all copies of the Software and your software product. 3. Unless the Software is incorporated in your software product which adds substantial value, you may not distribute this Software for profit. 4. You may not use the developer's or the Financial Management Service's name, logo, or trademarks to market your software product. 5. You agree to indemnify, hold harmless, and defend the developer and the Financial Management Service from and against any claims or lawsuits, including attorneys' fees, that arise or result from the use or distribution of your software product and any modifications to the Software. ---------------------------------------------------------------------------- 2. File Listing ================ HappyMail requires the following files to run correctly: BWCC.DLL COMMDLG.DLL VNSMAIL.DLL HMSPELL.DLL HAPEMAIL.EXE HMHELP.HLP HMCONFIG.INI DICT.D DICT.S DICT.I DICT.APP WORDDOS.XTD WORDWIN.XTD WPERFECT.XTD Two other files are included with the HappyMail system, this file, README.TXT, and a user guide, HMUSER.DOC. The user guide is in Microsoft Word 2.0 format. When a user opens HappyMail for the first time, one additional file is generated, HAPEMAIL.INI. This file is used to store all the user-defined options, window sizes and placements, and all the HappyMail AddressBook entries. ---------------------------------------------------------------------------- 3. Installing HappyMail ======================== Standard Warning ---------------- Before installing HappyMail on your Network, please read the rest of this file (especially the first four sections). It will surely answer some questions, and it will definitely save you some headaches. Network Install --------------- HappyMail is designed to run from a shared network drive. All the files listed above should be placed in a single directory on a shared file service with Read Only access for end-users. A SETDRIVE command for the file service should then be added to the end-user's profile (or preferably the sample profile). Each end-user should then have an item added to one of their Program Manager groups which points to the network drive and directory of HappyMail. HMCONFIG.INI ------------ The HMCONFIG.INI file is used to set some global parameters, and should be manually modified before allowing users access to HappyMail. The file may be modified with any text editor or with the Windows Notepad program. The initial configuration of the file is as follows: [Options] INI File Directory=P:\SETUP Default Save Directory=P:\ The 'INI File Directory' setting is used to define the default location of the HAPEMAIL.INI file. Optimally, this parameter should be set to a directory on a network file service which is dedicated for individual use. Doing so will offer two major benefits. First, the user-defined options and the HappyMail address book will be available from any workstation a user happens to login on. Additionaly, this means the INI file settings can be reviewed by an administrator without being physically present. This can be helpful in debugging user problems. The 'Default Save Directory' setting defines a default drive and directory for saving attachments. This setting is designed for novice users who expect to always see attachments saved to the same place. For more experienced users, this default setting may be overriden by selecting 'Default Directory' from the Options menu. ---------------------------------------------------------------------------- 4. Setting up the User ======================= Minimum Client Requirements --------------------------- The following is a set of MINIMUM system requirements for HappyMail. However, this is not necessarily a recommended setup. In fact, I personally would never run Windows on a machine with 2M of RAM, or a VGA monitor, but it can be done. So, with that in mind, the minimums are: - an 80386 based microcomputer - two megabytes of RAM - a VGA monitor. - DOS 3.2 - Banyan Vines 4.11 - Windows 3.1 Network Support --------------- Before a user can begin to use HappyMail (or any other network based app), the network support should be enabled in their Windows setup. If a machine does not display the Banyan Logo during Windows startup process, then most likely the Banyan Network Support has not been implemented. The following is a quick overview of the steps necessary to enable this support. To setup the network support follow these steps: 1) If you are in Windows, exit out. 2) Login to the LAN. 3) Move to the Windows sub-directory (usually C:\WINDOWS). 4) Run SETUP.EXE. 5) Follow the on-screen directions to change the Network line to Banyan Vines (Version 4.1). 6) Highlight "Accept the above configuration" and press [ENTER]. (The next steps apply to Vines 5.50 or greater) 7) When you return to the DOS prompt, run Windows. 8) After Windows loads the Banyan driver it will detect it is not the current version and ask your permission to upgrade. Select the [INSTALL] button to begin the automatic update process. SYSTEM.INI Changes ------------------ Once network support is enabled in Windows, one final change is necessary. The SYSTEM.INI file has a setting which should be modified or added. Under the [386Enh] Section is a setting called EmmExclude. This setting prevents Windows from using the specified block of memory. Any upper memory which is in use by add-on hardware (ie your network card), should be specified with this parameter. For example, if your network card uses c800-cbFF then add the line EmmExclude=c800-cbff. Some folks suggest excluding the whole upper memory range (a000-fffe). While this is the easiest method of eliminating memory problems, it can cause some DOS programs not to run under Windows. Therefore, I suggest excluding the whole range only when trying to diagnose a problem machine. Adding the HappyMail Icon to Program Manager -------------------------------------------- This section will briefly describe how to add the HappyMail program to a group in the Program Manager. If you are familiar with this process already, you should skip on to the next section. Before adding the icon to a users desktop, you will need the full pathname of the HappyMail executable. The following directions assume the HappyMail files were placed in the N:\HMAIL directory, and so the pathname is: N:\HMAIL\HAPEMAIL.EXE. You must substitute the proper pathname when executing these directions (step 5). 1) Login to the LAN, then run Windows. 2) Select the Program Manager group, you wish to add HappyMail to, by moving the mouse cursor over the desired group icon or window and clicking the left mouse button once. 3) Execute the File | New command from the menu bar in Program Manager. This will cause a "New Program Object" window to appear. 4) Select the "Program Item" choice, then select the [OK] button. Now a "Program Item Properties" window will appear. 5) Complete the fields in the Program Item Properties window as shown below: Description: HappyMail Command Line: N:\HMAIL\HAPEMAIL.EXE Working Directory: Shortcut Key: None Note that the Working Directory field is intentionally left empty. Once you have completed filling in these fields, select the [OK] button. A HappyMail icon will now be added to the selected Program Manager group. ---------------------------------------------------------------------------- 5. Undocumented Features Documented ==================================== Due to time considerations, not all of the HappyMail features are documented in the HappyMail User guide. This section attempts to briefly cover these features. Text Search ----------- The HappyMail text search, located on the Options Menu, will search envelopes or full messages in one or more folders, for a specified text string. Hits are then displayed in the Search Window as they are found. Once the search has been completed (or aborted) the messages may then be read. The message will appear with the first hit in the message highlighted. The search string may include mulitple words separeted by blanks. Additionally, the '&' operator may be used to indicate a search for two unconnected strings in a single document. A search may be aborted at any time by clicking on the [ABORT] button. This will stop the search, but still display all matches found up till that point. Command Line Switches --------------------- HappyMail incorporates one command line switch, /q or /Q (q as in quiet). Using this switch causes HappyMail to bypass the display of the HappyMail logo when first opened. This feature is designed to speed up access for remote users over dial-up lines (eg PC-Anywhere or Chatterbox users). However, since the logo does not implement any time delay, there is no advantage for directly connected LAN users to use this switch. Window Sizing and Placement --------------------------- HappyMail will store its own size, position, and icon placement, whenever it is closed or exited. These values are then restored when the program is restarted. Because HappyMail 'remembers' the previous icon position, it will overlay another icon if that icon is now in the position HappyMail previously occupied. This can cause some confusion for those folks not expecting it. I recommend having users place the HappyMail icon in a prominent place (ie NOT the left bottom corner), then close HappyMail to save the new position. HappyMail also stores the size, names, and positions of all open folders. These folders are then re-opened and re-positioned whenever HappyMail is re-started. Finally, HappyMail will also store the size of the top-most read window, if, and only if, HappyMail is closed while a read window is open. Note that the positioning is not saved, only the size. ---------------------------------------------------------------------------- 6. Who To Complain To ====================== First, remember that HappyMail is not officially supported and no guarantees or warranties are offered. With that in mind, I do encourage bug reports, enhancement suggestions, and general comments, so, send your e-mail to: X.400: N=DAVID RITCHIE/C=US/A=TELEMAIL/P=GOV+FMS Internet: DAVID.RITCHIE@FMS.SPRINT.COM And, if all else fails... David Ritchie Financial Management Service 3700 East-West Highway Hyattsville, MD 20782 ----------------------------------------------------------------------------