Beijing Paradise BBS Backup

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

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / EZMAI110.ZIP / EASYMAIL.DOC < prev next >

Wrap

Text File | 1996-06-07 | 15.6 KB | 339 lines

┌───────────────────────────────────────────────────────────────────────────┐ │ Copyright Notice and Program Disclaimer │ └───────────────────────────────────────────────────────────────────────────┘ This software is Copyright 1995 and owned by G.A.C. Computer Services. G.A.C. Computer Services grants to the user a nonexclusive license to use this software solely for its internal business purposes. The user may not commercially distribute, sublicense, resell, or otherwise transfer for any consideration, or reproduce for any such purposes, the software or any modification or derivation thereof, either alone or in conjunction with any other product or program. Further, the user may not modify the software or its support files for any purpose. THIS SOFTWARE IS PROVIDED TO THE USER ''AS IS.'' G.A.C. COMPUTER SERVICES MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS SOFTWARE AND/OR ASSOCIATED MATERIALS PROVIDED TO THE USER, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR AGAINST INFRINGEMENT. G.A.C. COMPUTER SERVICES DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET YOUR REQUIREMENTS, OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE SOFTWARE WILL BE CORRECTED. FURTHERMORE, G.A.C. COMPUTER SERVICES DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE SOFTWARE OR ANY DOCUMENTATION PROVIDED HEREWITH IN TERMS OF THEIR CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY G.A.C. COMPUTER SERVICES OR A G.A.C. COMPUTER SERVICES AUTHORIZED REPRESENTATIVE SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY. LIMITATION OF LIABILITY -- G.A.C. COMPUTER SERVICES AND ITS LICENSORS ARE NOT LIABLE FOR ANY CLAIMS OR DAMAGES WHATSOEVER, INCLUDING PROPERTY DAMAGE, PERSONAL INJURY, INTELLECTUAL PROPERTY INFRINGEMENT, LOSS OF PROFITS, OR INTERRUPTION OF BUSINESS, OR FOR ANY SPECIAL, CONSEQUENTIAL OR INCIDENTAL DAMAGES, HOWEVER CAUSED, WHETHER ARISING OUT OF BREACH OF WARRANTY, CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY, OR OTHERWISE. ┌───────────────────────────────────────────────────────────────────────────┐ │ List of included files in the Archive │ └───────────────────────────────────────────────────────────────────────────┘ EASYMAIL.EXE - The Main executable EASYMAIL.DOC - This Documentation file ADDRESS.SAM - Sample file of new address book addresses FILE_ID.DIZ - A short description of Easy Mail REGISTER.DOC - A Registration form for G.A.C. Computer Services Products. UPGRADE.DOC - Step by Step Upgrade Instructions for upgrades HISTORY.DOC - File explaining what has changed in Easy Mail NOTE: EASYMAIL will make MANY small files when it executes. EZ[#].ADD - These files are created for each user in the Easy Address directory ┌───────────────────────────────────────────────────────────────────────────┐ │ Description of Easy Mail TM │ └───────────────────────────────────────────────────────────────────────────┘ This program is quite possibly one of the best utilities written for BBSs. It is an address book for use with Internet E-mail, and/or Fidonet NetMail. It should make the sysop's and users' experience with NetMail much easier and faster. No longer do you have to type in long or hard to remember e-mail addresses, rather you and your users will store those addresses in your personal e-mail address book. Carbon Copies are supported, and there is support for several network addresses, RIP and more. Easy Mail was written with the Open Doors programming library. It's predecessor, Easy Address, is in use all over the world by Synchronet SysOps. Easy Mail is now here for everyone else running BBS systems and it is easier to setup than ever before thanks to a built-in configuration program. It also has all of the features that SysOps expect to find in a well built program. Some of it's greatest features are: - an easy to use configuration program - allows users to address e-mail messages with one keystroke - Supports carbon copies that may have internet and fidonet style addresses in the same message! - Supports internet<->fidonet gateways (GUUCP or GIGO) automatically with no effort on the part of the user or SysOp. - allows users to store hundreds of addresses with personalized notes about each address (if the he/she desires) - allow SysOps to configure a file of default addresses that are loaded into the users address book the first time they use Easy Mail. - Allows SysOps to configure their network addresses and names, so users will be able to see what their address is any time they press H for help. - allows SysOps to customize the colors used in the program - Support for external editors - Supports DSZ, GSZ, or CEXYZ for file transfers (if the SysOp is allowing File attaches) - Support for FOSSILS and NON-STANDARD IRQ settings. - Simple RIP support for clickable menus - Support for DOOR.SYS, CHAIN.TXT, SFDOORS.DAT and EXITINFO.BBS drop file types. The door will run with other drop file types, but the listed types include the USER NUMBER, which is NECESSARY for keeping track of the address books. Another method may be used later, if anyone requests a different drop file type be used. As you can see Easy Mail is an excellent addition to any BBS System. ┌───────────────────────────────────────────────────────────────────────────┐ │ Installation of Easy Mail │ └───────────────────────────────────────────────────────────────────────────┘ To set up Easy Mail follow the instructions given below. They include setting up Easy Mail in your BBS System, and using the CONFIG command line parameter to configure Easy Mail. 1. Create a directory for Easy Mail e.g. mkdir c:\sbbs\xtrn\EASYMAIL <ENTER> 2. Copy ALL of the archive files to this directory. e.g. copy *.* c:\sbbs\xtrn\EASYMAIL <ENTER> 3. Use the CONFIG parameter to run the Easy Mail configuration e.g. EASYMAIL CONFIG <ENTER> Most options are self-explanatory, but the following need to be remembered when configuring Easy Mail: - The internet option must be one of the following: The FULL fidonet gateway (GUUCP or GIGO) address that you use to send internet e-mail e.g. 1:13/10 If you do not know about GUUCP addresses, look in the archive GUUCP.ARJ for more information. NONE - if you want to diable the internet e-mail option. - The Use GIGO Format refers to if you want Easy Mail to address internet gated messages in the older GIGO format or the newer GUUCP format. This allows support of both types of addressing schemes listed below. e.g. Older GiGo Style (Use Gigo = YES) To User- UUCP To Address- 1:13/10 First Line of Message text- To: campbel@onramp.net Newer GUUCP Style (Use Gigo = NO) To User- campbel@onramp.net To Address- 1:13/10 Message Text is normal - The configuration options that allow you to specify what your fidonet, or internet addresses require that you ONLY specify the domain portion of the addresses, and NOT include a user name. Easy Mail will display the users name and @ sign where appropriate. If you do not have one of these addresses use NONE. e.g. I would just use 1:124/8047 for my fidonet address - For the external editor configuration, you should enter the command line to run the editor, and may use the following symbols. %% - PErcent sign %# - Node Number %A - User's Name %B - Baud Rate %F - Filename %I - IRQ Number %P - Comport Number %U - UART Address 4. You will need to setup Easy Mail as two seperate Door Programs on your BBS if you want to use it to send E-mail and Files. Since this process varies from one BBS to another, I will just describe the batch files to use here. If your BBS supports it, have the BBS swap out of memory when running Easy Mail. Setup one door to run Easy Mail in E-Mail mode, have it run the batch file EZMAIL and pass the node number to this batch file. The EZMAIL.BAT file should look like: c: cd\DOORS\EASYMAIL EASYMAIL EMAIL %1 cd\BBS Setup another door to run Easy Mail in File Attach mode. Have this door run the EZFILE.BAT file and again pass the node number to the file. The use of two different setups allows you as a SysOp to limit who has the ability to send files on your system. The EZFILE.BAT file should look like: c:\ cd\DOORS\EASYMAIL EASYMAIL FILE %1 cd\BBS NOTE: If you do NOT place the drop file in the Easy Mail directory, specify it as the third command line parameter in the batch files. e.g. EASYMAIL EMAIL %1 c:\bbs\ That is all there is to the setup, now whenever your users run the Easy Mail door, they will have an excellent address book and a much easier time sending e-mail through fidonet BBSs or the internet. ┌───────────────────────────────────────────────────────────────────────────┐ │ Optional Setup to Create a Custom List of Addresses for Your Users │ └───────────────────────────────────────────────────────────────────────────┘ The file ADDRESS.SAM is included in the Easy Mail archive. This file needs to be copied to ADDRESS.DAT to be used with Easy Mail. If the file ADDRESS.DAT does not exist, then users will be given two default addresses for their address book, these addresses are my Fidonet and Internet addresses. The file ADDRESS.DAT may contain as many addresses and notes about the addresses as you want to include. This is an excellent way for you as SysOp to get your users familiar with NetMail. The file must follow a simple, but strict format, that is one line for the address and the next line for the note about that address. If this format is not followed, your users will have a mixed up address book. e.g. Gregory Campbel@1:124/8047 (1st line) Author's Fidonet Address (2nd Line) campbel@onramp.net (3rd Line) Author's Internet Address (4th Line) noname@company.net (5th Line) None (6th Line) As you can see above, if you do not want to enter a note about an address, simply put the word None on that line (as in line 6). Save the file, and the next user that enter's Easy Mail for the FIRST time will receive your list of addresses. ┌───────────────────────────────────────────────────────────────────────────┐ │ Optional Setup to Incorporate Easy Mail into the NetMail Menu │ └───────────────────────────────────────────────────────────────────────────┘ The way I prefer to run Easy Mail on my system is to have it incorporated into my NetMail menu. With Synchronet, this is done through a modification in the .SRC files which control our menus. Most BBS Systems allow you to add External Programs (Doors) to a menu. It is best if you can setup Easy Mail this way, since it will become seemless to your user, and be easier than going to a Door menu to send NetMail. I use: N - Send NetMail A - Attach a File to the message ┌───────────────────────────────────────────────────────────────────────────┐ │ Optional Setup to Use the Internet<->Fidonet Gateway at 1:13/10 (GUUCP) │ └───────────────────────────────────────────────────────────────────────────┘ GUUCP is a flag given to certain fidonet systems which designates them as liasons between the internet and fidonet. These systems allow fidonet users to send e-mail to and receive e-mail from the internet. To use the GUUCP gateway, you must first be running a fidonet compatible system and be listed in the fidonet nodelist. It is also important that you understand the rules of the gateway. If you decide that you want to use Easy Mail with this gateway to send and receive internet e-mail, you will have to register at the gateway. You also need to note that all of your incoming internet e-mail will be placed on HOLD for you and you must poll the system at 1:13/10 to pick up the e-mail at least twice a week, but the gateway use is free. To setup Easy Mail to use this gateway, do the following: - File Request FAQ from 1:13/10 and read all the files. - File Request REGISTER from 1:13/10 to register your system with the gateway server. - Setup your system to poll 1:13/10 twice a week (or more). - Run EASYMAIL CONFIG - Place 1:13/10 in the internet option (this is your full GUUCP address) - Place your assigned internet domain address where the config program asks. That's it, there is no need for your users to worry about how to address the internet messages, as long as they use valid internet addresses. Easy Mail will make sure the e-mail is sent through the gateway in the correct format. ┌───────────────────────────────────────────────────────────────────────────┐ │ Command Line Parameters for Easy Mail │ └───────────────────────────────────────────────────────────────────────────┘ NOTE: If you just type EASYMAIL from the DOS prompt, a list of the necessary command line parameters will appear. Parameter 1 - EMAIL or FILE (determines the mode of operation) or CONFIG (to configure the program) 2 - The Node Number 3 - LOCAL (to force LOCAL operation of the program) or FULL path to the BBS drop file (optional) ┌───────────────────────────────────────────────────────────────────────────┐ │ Registration and technical support │ └───────────────────────────────────────────────────────────────────────────┘ Registration cost is $10.00 U.S. for Easy Mail. See the enclosed REGISTER.DOC file for instructions on how to register. For technical support, bug reports, comments AND suggestions please contact me in one of the following ways: Send me NetMail: Gregory Campbell@1:124/8047 Send me Internet E-mail: campbel@onramp.net World Wide Web: http://rampages.onramp.net/~campbel/ Call my BBS: 214-527-6811 (login as Guest) Call me voice: 214-517-3692 (10am-9pm CST, M-F) Or Ask me a question On Synchronet SysOps in DOVE-Net, my Alias is The.Tramp ┌───────────────────────────────────────────────────────────────────────────┐ │ Acknowledgements │ └───────────────────────────────────────────────────────────────────────────┘ Special thanks go to all those people that helped with the alpha and beta testing of this product. Specifically the following people need to be acknowledged: All the registered users of Easy Address that helped with the development and final creation of Easy Mail. Brian Pirie - For creating the Open Doors library of functions, distributing and selling it as shareware. Easy Mail is a trademark of G.A.C. Computer Services