Internet Mailer Version 2.0 2/96 (C) 1994,1995,1996 K W Risser All rights reserved. *** See the end of this document for the changes in this version. OVERVIEW This software maintains public and private internet address lists for users of TBBS systems with internet e-mail services. It allows the user to easily select the intended recipient(s) of internet e-mail from their own private or the shared public list. An sample public list is provided with the program. FEATURES This program features a full-screen ANSI interface. ANSI capability is required. Reduces internet address entry errors. Lists may be viewed in NAME or MESSAGE FREQUENCY order. Viewing the public list in frequency order interests users by showing which public figures receive the most mail. Encourages participation in the political process using repre- sentatives' addresses in public list to voice opinions. This program was written, tested and developed in and around a heap o' cats. Users may download their private (and public, if allowed by the sysop) address list in either ASCII or dBASE compatible format. In addition, an "Import" format may be selected which formats the download file as required when uploading a file to be imported. See section on "Import". Sysop maintenance menu features selective deletion of users, packing of databases, importation of data from file format used by Ben Cunningham's useful program Internet Address Book, as well as a number of program run time options. These options include the name (on your TBBS system) of the mailbox to be used for internet e-mail; the name of the optional text file to be dis- played when the user types a second consecutive question mark for help; whether to allow users to add new public addresses, or to edit existing public addresses; whether to allow users to down- load the public address list. Sysops may also choose to disable the shared public list entirely, using private lists only. The new tagging features may be enabled by user privilege level. CAVEATS TBBS stores the address of an email message in a field which is too small to accommodate some long internet addresses. The Internet Mailer is therefore limited in its ability to send mail to long internet addresses. In December 1995, Casey Sprangel of eSoft Technical Support shared his understanding of this situation: "The message file structure which is used by TBBS is accept- able for the application it was designed for; local mail. Since 1981 this has been fine. The addition of networked mail has changed the needs so the Newsreader option module was designed. This is an option module which will use a separate message base with vastly expanded limits on just about everything involved. It should be available the first part of 1996." INSTALLATION Create or choose a subdirectory for the Internet Mailer files to reside. It is best, but not absolutely necessary, to make a separate subdirectory for the program to use exclusively. Make a menu selection in a TBBS .SDL file, for example: Entry: @Cpos(7,50)[I] Internet Mailer Type=200 Key=I Opt Data=d:\tbbs\abook\abook /q && %BPS% Recompile the .SDL file and place all the program files into the subdirectory that you are going to use. If importing data from IAB.DBF, put that file into the subdirectory also. Note the use of the TBBS %BPS% parameter at the end of the Type=200 line. This allows the Internet Mailer to behave a little differently for users of slower modems (2400 and under). The Internet Mailer should not be installed such that it becomes the only method by which users can send internet mail, because users with very slow modems or non-ANSI terminals will be restricted. OPERATION The user is presented with a screen containing a window. The window contains a list of either public or private internet addresses. As users scroll up and down through the list using arrow keys or their ^E, ^X equivalents, the comment line(s) for that entry appear at the bottom of the screen. Below the comment(s) is a command bar, with the letter of each available command highlighted. Command bar keys P Toggles between PUBLIC and PRIVATE lists. F List by message frequency. B Go to bottom of list. 1 Go to top of list. E Explode record so details can be reviewed, and edited if private (and public also, if permitted by the sysop) A Add a new address to the list. Prompts user to choose between public and private before adding. Records who added and when for public list entries. Addresses are limited to 60 characters in length until TBBS allows the use of longer addresses. S Search the list. Searches for first occurrence if regular search if performed by simply entering the addressee's name. Searches for specified string anywhere in name or comments if preceded by an equals sign. Search resumes to next occurrence using the = key. = Repeat or resume previous search. If last search was a regu- lar search, finds first occurrence. If last search was an ex- tended search (search string was preceded by =), finds next occurrence. If search is unsuccessful, highlighted entry is not changed. ? Displays a brief help summary where the comment(s) are usually displayed. If ? is pressed twice consecutively, and the help text file specified in the maintenance menu options is present, it will be displayed. D Downloads the list, in either ASCII or dBASE compatible for- mat, to the user's computer. Public list downloads are allowed only if they have been so permitted by the sysop via the mainte- nance menu program options. ENTER Pressing enter selects the highlighted entry as the ad- dressee for an internet e-mail message. Redraws the screen. K (Maintenance access level users only) Kills an entry without having to edit the entry first. V Display version number and licensee information. (New in version 1.5; used to be at program exit.) MAINTENANCE MENU ! Invokes the maintenance menu, for sysop use. Access to this menu is restricted according to the maintenance menu level speci- fied. Displayed at the bottom of the screen is a string where each character represents a possible tbbs line. A period means that the line is not using the Internet Mailer program, or no modem is connected. An X indicates that the user on that line is currently using the program. The line is updated while the program waits for a menu selection. Many of the menu options are not available if any other user is using the Internet Mailer (i.e., more than one X), as they require exclusive access to the data files. Maintenance menu keys 1 Deletes a specific Internet Mailer user and their personal addresses. D Delete users and addresses for users who have not used the program for more than a specified number of days. After specify- ing the number of days, the program will tell you how many users meet that criteria and ask whether to delete them. A bug in this function has been fixed in version 1.5. A Deletes ALL users and addresses. No backups, no safety after you type YES to proceed. Zap! O Program options * Specify the name of Internet e-mail box, as used in your tbbs installation. This is case-sensitive. * Specify the name of a text file for extended help, to be displayed when the question mark key is struck twice consecutive- ly. This feature allows the sysop to customize the extended help screen as desired. This file may contain ANSI codes. If this file does not exist, the second question mark has no special function. * Specify whether to allow users to edit any address in the public list. This does not effect users' ability to add new public entries, or to edit public entries that they added. Yes or T for True, No or F for False. * Specify whether to allow users to download the public ad- dress list. Yes or T for True, No or F for False. P Packs databases by removing deleted records. This improves performance and conserves disk space. Choose this option to repair damaged index files, if needed. L Allow specification of the privilege level for unrestricted access to the program, allowing access to the maintenance menu and exemption from restrictions. I Imports data from IAB.DBF. This allows users of Ben Cunningham's useful Internet Address Book program to move their data into this Internet Mailer program. Usually this option is not selected to accomplish this. When the address book program is run for the first time, if the file IAB.DBF exists in the same directory, the data will automatically be imported. NOTES The program requires the presence of ABLISTS.DBF, ABUSERS.DBF and ABSETS.DBF. If the .NDX files are not present or have been deleted, the program will re-create them. In fact, if the index files are damaged due to unexpected system or power failure, they can be deleted. If you do delete the index files, make sure no one else is using the program at the same time. All the indices have the .NDX extension. If the program crashes, the next time it is executed, the indexes will be rebuilt automatically. ORDERING INFORMATION Version 1 of the Internet mailer is available for $29.95 from Chuck Burke at (502) 583-8223. Or call The Dance of Shiva with your modem, at (502) 583-9404. Or you may contact the author directly at (502) 636-1460 (voice). Or you can send $29.95 directly to Kurt Risser, 1270 South Floyd Street #1, Louisville, KY 40203. All orders placed by mail are shipped promptly. Other titles in the Heap O' Cats collection are The Online Purity Test, the Event Calendar, SLIPTUNE, an internet service provider client software automated setup utility for the IPAD, and the PIQUE internet .BAG file preprocessor. HISTORY UPGRADES and PRODUCT SUPPORT Registered users of this software should contact the author and supply their voice phone number, e-mail and mailing address- es. This information will enable us to let you know about pro- gram updates. Registered users may download updates to version 1 of the program if they are released. If you contact the author with this information, we can make sure you always have the most recent version. Kurt Risser (502) 636-1460 (voice) kurt@shivasys.com 1270 South Floyd Street #1 Louisville, KY 40203. VERSION 1.2 CHANGES This version limits users to 30 characters for internet ad- dresses, because TBBS does not allow passing of addresses longer than this. TBBS will truncate any characters after 30. When the Internet Mailer 1.1 is used with an address in excess of 30 char- acters, the internet message was sent anyway, resulting in the sending of internet mail with invalid addresses. The 1.2 version does not allow users to specify internet addresses greater than 30 characters, unless... VERSION 1.3 CHANGES Sysops now can delete (kill) an address entry from the selec- tion screen without having to edit the entry first. Sysops can Move a public entry into the private list of the user who added the entry. Screen speed improvements for all users, and special handling of users with slower modems. The program may be passed the %BPS% parameter via the TBBS Type command Opt Data line (see installa- tion example) for speed sensitivity. In order to make users more aware of what kind of address they are adding, users are now prompted to explicitly choose private or public. VERSION 1.4 CHANGES Automatic rebuilding of indices if program has previously crashed. Change in demo version registration information. VERSION 1.5 CHANGES A new program option has been added. Sysops may set whether or not users may ADD entries to the public address list. This is in addition to the existing option, which determines whether or not users can edit public entries. Note that if users are not allowed to add public entries, then they will not be able to edit public entries, unless they are the user who originally added the public entry or have maintenance level access (sysop). The advantage formerly conferred upon the program by the use of ASR's host monitor TSR product has been added without the use of that product. In other words, the Internet Mailer now has the same TBBS-imposed limits on the length of an address that it did before when using the ASR product, which is 60 characters. Formerly, the Internet Mailer address length limit was 35 charac- ters when not using ASR's host monitor TSR program. A bug which prevented sysops from deleting inactive users has been fixed. A bug which prevented users from Quitting when prompted for the type of file they wish to download has been corrected. A bug caused the program to crash after pressing 'B', then using the up arrow to scroll all the way back to the top of the list. This has been fixed. The exit screen, with the licensed BBS name and the author's name, no longer is displayed when quitting the program. This screen may now be invoked by pressing 'V' when running the pro- gram, so that program version identification can be made. VERSION 2.0 brought a message recipient tagging system and allows user up to 24 'extra' private lists. It also features addition- al sysop Options such as switching on or off the public list, allowing & disallowing users to edit public addresses independ- ently of whether they are allowed to add public entries; simple file statistics for sysops. This new version of the Internet Mailer is now available for $59.95, or as an upgrade to version 1 customers for a charge of $30.00 ($25 before 03/01/96) Registered users of version two are eligible to download free updates, as and if they become available, for no additional charge.