W i n N E T (TM) M a i l a n d N e w s Copyright (c) 1994 by Computer Witchcraft, Inc. ALL RIGHTS RESERVED Computer Witchcraft, Inc. Post Office Box 4189 Louisville, KY 40204 Telephone: (502) 589-6800 Fax: (502) 589-7300 Internet Mail: winnet@win.net CompuServe Mail: 76130,1463 Note: This file assumes that you are *not* planning to use Computer Witchcraft, Inc., as your Internet/Usenet service provider. If that is not the case, please read the file READ_1ST.TXT instead of this file for introductory information. (ALT.TXT) Please read this file *carefully* before installing or attempting to use WinNET Mail. Getting WinNET set up on your system is quite straight-forward, but if you don't read this file before getting started, you will overlook important information necessary for proper operation of the software. C o n t e n t s What is WinNET? What you need to run WinNET Registration fee for WinNET Setting up WinNET Mail on Your System Upgrading From an Earlier Version of WinNET Distribution of WinNET Mail W h a t i s W i n N E T ? WinNET Mail (TM) is a Windows 3.1 application for sending and receiving Electronic Mail and News articles with the world-wide Internet and Usenet networks using just your Windows system and a modem. You can set up WinNET to work in conjunction with any system providing UUCP services, including commercial providers, your local University systems, or your UUCP network at your place of work. When WinNET is used with an alternative UUCP provider (i.e., if you will not be a Computer Witchcraft service client), WinNET is shareware software with a registration fee of $39.95 W h a t y o u n e e d t o R u n W i n N E T 1. Intel 80386/486/Pentium system with a minimum of 2 Mbytes RAM. 2. Microsoft Windows 3.1, Windows for Workgroups Microsoft Windows NT, or OS/2. 3. A Hayes compatible modem. 4. A UUCP provider -- For WinNET to be able to communicate with the rest of the Internet, you need to have a UUCP service provider (unix-to-unix-copy). R e g i s t r a t i o n F e e f o r W i n N E T WinNET is *NOT* freeware when used with alternative service providers; instead, it is a shareware program with a registration fee of $39.95. If you find WinNET useful, please take the time to read through the file REGISTER.TXT which explains how to register WinNET, and please contact us to register the product. S e t t i n g u p W i n N E T M a i l o n Y o u r S y s t e m Introduction For WinNET to be able to successfully communicate with your service provider, you need to have gotten in touch with your provider to obtain the following information: 1. Provider's service telephone number (modem). 2. Connection characteristics of your provider's communication equipment (maximum connect speed, etc...) 3. Your assigned login name 4. Your assigned password. 5. Your assigned UUCP system name. 6. Your provider's server's uucico "machine" name. 7. If you wish to use the automatic newsgroups signup procedure, the email address of the news administrator. 8. The login sequence to your provider's server. (Many providers can provide a sample login script that shows what prompts and responses are required). If you have just acquired WinNET from CompuServe or some other electronic bulletin board, you may not as yet have a service provider, or may not yet know the details about your account. Even so, you may still be curious to see how the program works, and it is fine to set up the software without having your account information ready so that you can experiment with the software. You can just make up the information required by the setup program if you don't know it yet. Then, when you have bona fide information from your provider, you can set up the software again. STEP 1. If you received WinNET from CompuServe or some other electronic bulletin board, create a temporary directory and copy the wnmail.zip file to this directory. Run the pkunzip program (commonly available shareware from PKWARE) to unzip the wnmail.zip file in this directory. If you received WinNET on a diskette, insert the diskette in drive A: or B: of your computer system. STEP 2. From the Windows program manager File menu, or directly from the Window's File Manager program, run the SETUP.EXE program supplied with the WinNET distribution. Use the More Information button to get more information on each screen. Most of the selections you need to make are not difficult, but the screen that asks you about UUCP names is an area where you may need to don your "thinking cap" for some moderate intellectual exercise. Please press the 'More Information' button when you get to this screen, and print out the setup help file when it comes up. If you make a mistake here, you can rectify it later by re-running the installed version of SETUP.EXE and making the required changes. When you have finished making your selections and entering required information, setup will copy the WinNET program files to the directory you specified and ask if you want to create a Program Manager group for the installed programs. It is recommended that you create a Program Manager group. Also, the setup program will generate a file called CHAT.RC in the directory with the rest of your programs. This file will contain a simple script that the communications program uses to negotiate the login sequence after it connects to your UUCP provider. This chat.rc file will work unmodified for many systems, but in other cases additional configuration of this file may be required. (The file CHAT.TXT documents the syntax and contains pointers about working properly with login issues, and should make your life much easier if the default script doesn't work for logging in to your service provider's system). STEP 3. After the software has been installed, test to see if you can connect to your UUCP provider's server. To do so, first make sure that your modem is properly attached to your computer and powered on, etc. Next, start the main WinNET program (wnmail.exe -- its icon is labeled "WinNET Mail" in your Program Manager group) and click the picture of the silver telephone labeled "Call" on the toolbar. After doing this, select "Switch To" from the WinNET Mail system menu (located in the upper left hand corner of the title bar) and select "UUCICO -- File Transferer" from the "Task List" that comes up. You will then see the display of the communications program. The display shows numerous statistics but you should direct your attention to the two text fields at the bottom of the screen, labeled "Latest Error" and "Latest Event". If your system is configured properly, you should see the following messages in the field labeled "Latest Event": Port Opened Successfully Connected to Server Establishing Protocol Protocol Set If you already have messages waiting at your provider's server, you would then see the message(s): Reversing Role, becoming Receiver Receiving file File successfully received etc... for as many messages as are queued for you. If you have no messages waiting, you will see: Closing connection with remote The sequence outlined above indicates that your WinNET software is successfully installed, and you should give yourself a "high-five". If you aren't tired yet, go ahead and experiment more with the main program "WinNET Mail", and browse through the on-line help (F1), which contains full documentation for WinNET aside from setup procedures. If you didn't have the results outlined above, please read the section below regarding connection problems and how to resolve them. WHAT TO DO WHEN WINNET WON'T CONNECT Most of you will have to read this section at least once, as Murphy's Law operates extensively everywhere and at all times. Debugging your Installation The other field in the communication's program's display that was mentioned above was "Most Recent Error". Here are some of the more common error messages that occur and some pointers on getting past them. "No OK from modem" This error indicates that the communications program is not able to work properly with your modem. This may be because the modem is not turned on, or because the incorrect port has been selected when you configured communications. Please see the file "TROUBLE.TXT" for an explanation of how to use the "Terminal" program, supplied with Windows, to determine the correct communications port for your modem. Another potential source of this error is your having input a Hayes AT command that your modem does not recognize in the communication's section of setup. Please review your AT command strings and check with your modem manual to make sure that the AT commands you've included are supported by your modem. Also, if you are using a Telebit modem or a U.S. Robotics modem, please see TROUBLE.TXT for some suggested settings for configuring these modems properly for use with WinNET. One other possibility: make sure that the interface speed you selected during setup is not to great for you modem to handle. This should be documented in your modem manual. "No "connect" -- busy or no answer" This message means that, although your modem attempted to dial, it never connected with a modem at the server's site. This could be for the reasons given, "busy or no answer", and it may be necessary to wait for a time before attempting to call again. It may also indicate that you have entered your service provider's telephone number incorrectly. In this later case, run the installed copy of SETUP.EXE and make the necessary correction. If, however, you hear your modem connecting to another modem, and still get this message, it means that the two modems were not able to properly agree or sync on a common modem protocol. In this case, please consult with your provider and/or modem manufacturer about modem compatibility issues. (This can also happen when you connect to a fax machine, or if the hardware connection between your modem and computer system is loose or faulty). "login failed, suspect line noise" This error message indicates that something went wrong while logging in. Once you have a working installation, this problem usually occurs because of line noise conditions, but at this point (just after installation), it is much more likely that your CHAT.RC configuration may be faulty. As you will recall from the earlier discussion, the CHAT.RC file is a script which controls the initial login sequence on your provider's system. Please carefully read "CHAT.TXT" at this point to work with login issues. "UUCP login failed" This error message usually occurs when the login process is successfully passed, but the remote server doesn't accept either your login name or your password, and refuses to start its corresponding communication's process (UUCICO). This is usually because one of these two names is incorrect, or because your account is not yet set up on your provider's system. One other possibility is that you have entered the remote server's "machine" name incorrectly in the setup UUCP names section of the setup program. Please double-check to make sure you've entered this information correctly. (Please see the file SETUP.009) for more information. "UUCP System Recognition Failed" This error occurs because the provider's server doesn't recognize or acknowledge the validly of your "machine"/"system" name. Please double check to make sure that you have entered this correctly. Please call Computer Witchcraft's technical support staff for help if you continue to have problems getting your copy of WinNET installed and working properly. U p g r a d i n g f r o m a n e a r l i e r v e r s i o n o f W i n N E T The instructions for upgrading a previous version of WinNET are basically the same as outlined in the above steps describing a new installation. Make sure that you put the distribution .zip file wnmail.zip in a *temporary* directory before you start (NOT the directory that currently contains WinNET) and run setup from this temporary directory. When you are asked to specify the directory where WinNET should be installed, specify the same directory where your old copy of WinNET was installed. This will cause the setup program to overwrite the old WinNET files with the files from the new version. Your old setup parameters will be detected and appear as the defaults in the setup process. FOR THOSE WISHING TO DISTRIBUTE WinNET MAIL (TM), PLEASE READ ON. D i s t r i b u t i o n o f W i n N E T M a i l (TM) COMPUTER WITCHCRAFT, INC., UNCONDITIONALLY RETAINS ALL RIGHTS PURSUANT TO THE COPYRIGHT LAWS OF THE UNITED STATES. That said, we very much encourage distribution of this product, under the following conditions: 1. Any person serving as a distributor of WinNET Mail (TM) must retain exactly the original form of the Computer Witchcraft, Inc., distribution by including ALL files in unmodified condition. The following files that are included with the WinNET Mail (TM) distribution: READ_1ST.TXT SETUP.007 QUEUED.EX_ TERMS.TXT SETUP.008 CLEANUP.EX_ TROUBLE.TXT SETUP.009 MEGAED.DLL VENDOR.TXT ACCOUNT.001 BWCC.DLL CHAT.TXT SETUP.EXE WNMAIL.HL_ ALT.TXT VIEWER.EXE CLEANUP.HL_ SETUP.001 WNMAIL.EX_ QUEUEED.HL_ SETUP.002 UUCICO.EX_ SOURCE.DAT SETUP.003 MAILMAN.EX_ ENCODE.EX_ SETUP.004 ACCOUNT.EX_ DECODE.EX_ SETUP.005 MAILCALL.EX_ FILE_ID.DIZ SETUP.006 DAEMON.EX_ REGISTER.TXT 2. Owners or operators of Electronic Bulletin Boards (EBB's), such as CompuServe, may acquire or accept, and then distribute copies of WinNET Mail (TM) through their EBB service, subject to the conditions above, and may further do so in the context of charging subscribers to their services a general fee for belonging to the membership of the service, and/or for time on-line, as long as these charges are not specifically related to overt sale of the WinNET Mail (TM) product. This should in no way be construed as relinquishment, by Computer Witchcraft, Inc., of its copyright protection and sole ownership of WinNET Mail (TM). 3. Persons wishing to contact Computer Witchcraft, Inc., for the purpose of negotiating limited distribution rights for WinNET Mail (TM) should review the file VENDOR.TXT, included with this distribution, which contains an application form that distributors may use to initiate the process. 4. Any persons possessing a bona fide copy of WinNET Mail (TM) as originally distributed by Computer Witchcraft, Inc., may freely copy and distribute the product to whomever they like, as long as exactly the original form of the distribution is retained, by including ALL files, in unmodified condition, especially but not limited to all documentation files, as long as they assess no fees beyond those required for materials needed in distributing the product, i.e., matching exactly the cost of floppy disks, mailing materials and costs, or long-distance phone charges relevant to electronic distribution. 5. With the exceptions of EBB operators, under the conditions described above, and that of persons entering into written contractual distribution agreements with Computer Witchcraft, Inc., other persons engaged in the distribution of software for profit ARE EXPLICITLY PROHIBITED from marketing or selling, in any form, any files or parts of files, or modified versions of files, that are part of Computer Witchcraft's distribution. 6. Developers of software products who incorporate ANY portion of the binary portions of the author's product, or who copy features or aspects of the user-interface of the product subject to protection by the laws of copyright, SHALL BE PROSECUTED, unless they have the express, written permission of Computer Witchcraft, Inc., to do so.