PCB Freedom version 1.0 Copyright (C) 1992 Gregg Hommel - All Rights Reserved PCB Freedom is distributed as Shareware. This means that users are encouraged, subject to restrictions described in the License Agreement, to share copies of this program with friends, associates and bulletin boards. Please remember that if you use this software you are required to pay the registration fee of $20 as described in the file LICENSE.WRI. What is PCB Freedom ? PCB Freedom v.1.00 is a mail server, for handling and managing mail packets from multiple bulletin boards. I deal with mail packets on several bulletin board systems, and wanted a script which would allow me to upload REP files and download QWK files from all of the systems I deal with, as automatically as possible. The result is PCB Freedom v.1.00. It will manage mail on any PCBoard system running a Qmail, Cam-Mail, MarkMail, Kmail or Rosemail mail door, or on a WildCat system running a TomCat mail door. It will automatically upload any REP file, and delete it for you after a successful upload (so that you don't try to upload the same messages later), and, if so requested, will download a new QWK, storing it in a selected directory after it is downloaded, renaming it in the process to one of two different renaming schemes. Eventually, in future versions of PCB Freedom, I also envision the ability to scan for new files on a system, to download a pre-determined list of files, and even to upload a pre-determined list of files with descriptions. Some of this is already begun, even though v.1.00 is not even released as I write this. I do not intend letting Freedom sit where it is.... I hope to make it even more useful in future versions. Thus, the name Freedom, since I hope that it will free a user from dealing directly with systems set up under it. Support and questions Technical support is available at no charge by sending electronic mail to 72537,552 on CompuServe, or to Gregg Hommel on various e-mail nets (Intelec, RIME, ILink) in the ProComm conferences or Window conferences, or by sending regular Mail to : Gregg Hommel, Computer etceteras/WiGuys Software 19 Rushbrook Drive, Kitchener, ON Canada N2E 3C1 I am also available by phone irregularly at (519) 745-9717 (mostly evenings). I will also run my system, using ProComm for Windows Host mode, from midnight to 6 AM EST/EDT, every night. If you have questions, or would like to check for maintenance releases, you may do so through ProComm's Host mode. The number is the same, (519) 745-9717, except that it will be the Host mode answering the phone after midnight. You will be restricted to messaging only until validated (information on being validated is in the Help file, and New User file), which should normally take two or three days. If you wish immediate access, simply call me voice before I put up the Host mode, and arrange validation that way. Registered users have priority but I will try to answer all questions. System Requirements : - Windows 3.0 or Windows 3.1, with ProComm Plus for Windows 1.00 or 1.01. The preferable requirements are Windows 3.1 and ProComm Plus for Windows 1.01. PCB Freedom also requires VGA (640x480) resolution or better to run. Operational requirements : PCB Freedom related files contained in FREEDOM1.ZIP are: - README.TXT introductory information - LICENSE.WRI License Agreement/Warranty - FREEDOM.WRI documentation for installation, registration and operation (this file) - FREEDOM.WAX the compiled script file - FREEDOM.NIL an icon library file needed for the toolbar - FREEDOM.ICO a single icon to be used as the desktop icon. - FREEDMxx.HLP help files used in various dialogs. The xx is a number which Freedom uses to find the help file. PCB Freedom related files created and maintained after installation : - FREEDOM.INI a private INI file stored in the default \WINDOWS directory - FREEDOM.CFG a configuration file listing all systems currently set up for operation under PCB Freedom - FREEDIAL.CFG a configuration file listing those systems currently set up to be dialed by PCB Freedom The latter two files will be found in the same directory where you install and run PCB Freedom from (i.e. the default \PROWIN\ASPECT subdirectory). These three files are critical to correct operation of PCB Freedom, and should never be deleted or edited manually. The files are maintained by PCB Freedom as necessary, and manual editing should not be necessary. There is one other file that is temporary, being in existence only during the current "session" of PCB Freedom. This is the file, FREEDOM.LOG, also found in the default \PROWIN\ASPECT subdirectory. It is a log of the on line activity during the current "session" and is deleted at the end of that session, however, since as it stands now, with timed dials, etc., a "session" might last for days, you just may notice the file. If you do, please don't delete it, or try to manually edit it. A note about WildCat/TomCat systems On some WildCat/TomCat systems, there are two "quick" log in features available at the sysop's discretion. These are "codes" which precede your name, and force WildCat to quickly go to corresponding areas. These two codes are the characters, " * " and " ! " preceding a user ID. PCB Freedom will work with the first of these ( " * ", i.e. *Gregg Hommel), which is the equivalent of the "N Q NS" command in PCBoard, and skips the news and other log in files, going directly to the main menu. The other code ( " ! ", i.e. !Gregg Hommel), goes directly to the TomCat menu, bypassing all WildCat menus, and will NOT work with PCB Freedom, since Freedom must "see" the main menu in WildCat in order to set certain flags allowing it to continue. Installation: Installation of PCB Freedom 1.00 is as simple as I could make it. 1) The first step is to simply copy all of the FREEDMxx.HLP files, the compiled script file, FREEDOM.WAX, and the two icon files, FREEDOM.NIL and FREEDOM.ICO, to your ProComm for Windows Aspect subdirectory. 2) After you have copied the files to your Aspect directory, I would recommend setting up an icon for PCB Freedom on your desktop. You could put this in your Datastorm group, or Accessories, or wherever you'd like. NDW users can place it right on their desktop. To do this, select File...New from the Program Manager menu (NDW users, from the main NDW menu), or simply "drag" the FREEDOM.ICO file from File Manager to your desktop. 3) Once the icon is on your desktop, you will need to set it up properly to run PCB Freedom. To do this, select File... Properties from the Program Manager menu. In the first box, labeled "Description", type in something like "PCB Freedom". Then, in the "Command line" box type "C:\PROWIN\PW.EXE FREEDOM.WAX", replacing the "C:\PROWIN" with whatever is appropriate for your system. Then click on OK, so that Program Manager will save the information. This should result in a PCB Freedom icon on your desktop. 4) Double click on the PCB Freedom icon. This should start ProComm for Windows, with PCB Freedom running on top of it. You should be able to tell that Freedom is running because it will replace the ProComm icon bar with it's tool bar, and change the window title to "PCB Freedom 1.00". 5) The first thing that will happen when PCB Freedom loads, is that it will scan your system for various files it requires to run. There are two of them, an INI file in your Windows directory, and a CFG file, in your \PROWIN\ASPECT subdirectory. If Freedom cannot find these, it assumes that you are a new user, and will create them with the correct startup data. 6) Next, Freedom will bring up a dialog box which will ask you for certain information, such as your birthday, etc. This information is stored in the INI file, in case a WildCat system which you use requires any of it for validation. WildCat systems will, on occassion, ask for the city you are calling from, your voice telephone number, your birthdate, or your mother's maiden name. To take care of answering these validation requests, PCB Freedom will ask you for the data via this dialog box, and then stor it in it's INI file for future reference. 7) Next, Freedom will ask if you would like to register your copy. If you are evaluating the software, simply answer no to this dialog. You can always enter any registration information (your name and number) later via the HELP screen (if Freedom is not registered, it has a button labelled "Register" that you can use.) If you are registered and wish to enter your registration information now, simply click on YES and then follow the prompts. 8) The last item for an initial running of the software will appear after the "Do you want to register" dialog... a help dialog box. This will show a basic help file for PCB Freedom, which you can scroll through and read to learn some basic information on the "care and feeding" of Freedom. When you are finished with this help dialog, click on the Done button, and you will be in the main PCB Freedom Window. "Un"Installation: Although I can't see any reason why you might wish to , "un" installing PCB Freedom is quite as simple as installing it, if not more so. You will need to remove the following files to "un"install Freedom : 1) In the \PROWIN\ASPECT subdirectory (or wherever you store your script files) - - FREEDMxx.HLP - the help files, with the xx replaced by a number (from 0 to 12 in version 1.00) - FREEDOM.NIL - FREEDOM.ICO - FREEDOM.CFG - FREEDIAL.CFG - FREEDOM.WAX 2) In the \WINDOWS directory (or wherever your main Windows directory is) - - FREEDOM.INI That's it. With those files removed, PCB Freedom will completely "un"installed from your system. Running PCB Freedom When you start PCB Freedom by clicking on the icon you created during installation, it also starts ProComm Plus for Windows. However, ProComm will not start with the normal screen usually seen, but with PCB Freedom's screen, which replaces the "standard" ProComm icon bar with PCB Freedom's tool bar. This PCB Freedom tool bar contains several icons, each representing some action taken by a user in PCB Freedom, or an indication of what Freedom is doing or has done. The first six icons are actually icon buttons, and are actions that you, the user can take. These icon buttons are : #1 - ADD - the white plus sign on a green circle is the icon you click on to add a new system to your PCB Freedom configuration. This routine will scan your dialing directory and prepare a list of all systems contained in it, so that you might decide which ones to configure under PCB Freedom. When you select the ADD icon button, you will see a dialog box containing several items. At the top is a help file which you may scroll through for information on adding a system. Below that will be two list boxes. The one on the left will show a listing of the names of the entries found in your dialing directory. The first time that you select the ADD icon button, the list box on the right will be empty. This is a list of systems which you have configured for use under PCB Freedom, and since this is the first time, there should be nothing there. To add a system to your Freedom configuration, simply select it in the left side list box, and then click on the Add push button. This will bring up another dialog box. It is this dialog where you will configure the settings under PCB Freedom. When it appears, you will notice that sample entries are made in each edit box. Study these as long as you'd like, as they are only samples. You will also notice that they are "grayed" out, meaning that the boxes are inactive. Actually, the only thing active in the dialog at this point is the icon button reading "UserID" under it. To begin setting up a system under PCB Freedom, you must first click on that icon button, and enter the UserID which Freedom will send to that board during log in. Once you have done this, the edit boxes will clear and become active. I find it useful to immediately click on the icon button reading "Password" under it, and enter my password for that board. This will be stored in Freedom's INI file, however, it is stored in an encrypted form which only Freedom can read. This is one of Freedom's security features, to prevent your password being stolen and used by someone else. After this is entered, you can begin entering the rest of the data needed, such as mail storage directory, conference to join, etc. There are help files which will appear in the left hand help box when certain selections or actions are taken. You can refer to these for help in setting up the system data. #2 - REMOVE - the white minus sign on a red circle is used if you want to remove a system from your PCB Freedom configuration. Once you have done this, you cannot use PCB Freedom for that system unless you ADD it again. However, any settings made prior to removing a system will remain stored in Freedom's INI file. Thus, if you do ADD the system back into your configuration, you won't need to reset all of the data for it. #3 - EDIT - this is the poor disembodied hand writing a note. Clicking on this icon will call up a dialog box where you may pick a currently installed PCB Freedom system, and modify the settings for it. The dialog box here will be the same one you saw in ADD, however, the drop down box at the top will list all of your configured systems, and when you select one, the entries you have previously made for it (setting up the parameters for Freedom to use when calling that system) will appear in the various edit boxes, so that you make any changes necessary. One example of needing this icon might be if you change your password. You would then use the "EDIT" icon to call up the settings for that system, and click on the Password icon to change PCB Freedom's stored password for that system. You also might want to use edit if you decide to change the directory where you want Freedom to store mail for that system. #4 - DIAL CONTROL - the icon which looks like a Rolodex card holder is used to tell PCB Freedom which of the configured systems you wish to dial in a run. The dialog consists of several items, the first being a HELP box at the top of the dialog. As in other dialogs, this box will tell you a little about what you can do here, and how to do it. Below this are two list boxes (again) beside each other. The box on the left lists all of the systems configured to run under PCB Freedom. The box on the right lists those systems currently set up to be dialed. To add a system to the DIAL LIST, simply click on it's name in the left box (if you click on the name of a system already in the right box, nothing will happen). When you click on a system in the left box, it will be added to the DIAL LIST. To remove a system from the DIAL LIST, simply click on it's name in the right box. This will remove it from the current list. There are two other items of interest, a checkbox and a small edit box. The checkbox is labelled "Dial minimized". Checking it will cause Freedom to dial your DIAL LIST in an iconized state. When iconized internally (such as by checking this box), Freedom turns off the dialing box and any dialogs which appear while on line with a system. If it didn't, these would pop up over whatever you are doing in Windows, and be very annoying. The small edit box is labelled "Dial Time :". This box allows you to set Freedom to do your next run (and all runs thereafter) at a pre-set time. The time entered in this box must be in 24 hour format, and must contain all 5 "digits", including the colon (i.e. 6 AM is "06:00", 10:30 PM is "22:30"). If you decide later that you do not want the run to be "timed" simply delete everything from the box, or enter the word "now". Either entry will cancel a dial time. No matter what you have the "Dial minimized" checkbox set as, if you preset a dial time, Freedom will do the run in a minimized state, with dialing boxes and dialog boxes turned off. Thus, when you preset a dial time, and tell Freedom to dial (the dial time is not active until you tell Freedom to dial), Freedom will get itself and it's boxes out of your way while it waits for, and does the run. After a timed run is completed, Freedom will automatically begin another, waiting once again for the dial time to arrive. To cancel a running "timed" dial, click on the comm status icon (see below... the standard ProComm icon of a telephone). You can tell when a timed dial is "running" because the working status icon (see below also) will be a clock. Once you have set everything for your run as you want it, either click on Done to save the settings and return to PCB Freedom's main window, or click on Dial to start a "run" (based on the settings made here) immediately. Once a run is complete, the information remains on file until next you run the "DIAL CONTROL" utility. As a result, once you have set a particular run, you only need use the "DIAL CONTROL" icon if you want to change the systems that you are calling or how the call is made. #5 - DIAL - Guess what the icon of a somewhat funny looking telephone (actually, it is a "Contempra" style desk model, but I'm not known for my artistry ) is for? Clicking on this icon will start a run based on the boards you last set using the "DIAL CONTROL" icon. #6 - STOP - Again, this one is fairly straightforward. When you are finished working with PCB Freedom, and want to exit, either back to ProComm, or completely back to Windows, click on the "STOP" icon. You will see a dialog asking what you want to do, exit just Freedom, or exit ProComm altogether. Select one of the radio buttons, then click on OK. That's all there is to it. After this group of six icons, there are three "status" icons.... The first only appears after you have begun a dialing run, either timed or not. It is the log status icon (the log contains details of what Freedom did during a run, including the fact, if set, that it waited for a particular time to begin the run), and will show in one of two forms. The first, with a page of text viewed through a magnifying glass, means that the log file exists, and can be viewed by clicking on the log status icon. The second form is also a magnifying glass over a page of text, but this time with no text visible in the glass, and a red X drawn through it. This one means that the log file is present, but can't be viewed because it is being frequently written to. Clicking on this icon will do nothing. When it returns to the non-X'ed magnifying glass, you will once again be able to view the log file. The second icon is the working status icon. This will show a representation of what you are doing in Freedom, or what Freedom is doing on it's own. It will be one either one of the other "major" icons (when you are doing something under that icon button), a clock (telling you that Freedom is delaying a run until a preset time), or the PCB Freedom icon (when you are in the "main" Freedom window, and you or Freedom are not doing anything). This icon is simply a status icon, and has no "hot spot" to click on, except in one single case. If the icon showing here is a clock (i.e. Freedom is waiting to perform a delayed run), clicking once on the clock icon will result in an immediate "Quick" dial of the current set up. It will not be minimized, and all dialing boxes and dialogs will appear. This will allow you to call your list outside of the scheduled time, with Freedom returning to waiting for the scheduled time after the "Quick" dial is done. The third icon is the comm status icon. It will be either the "standard" ProComm telephone icon with the receiver hung up (when Freedom is off line), or the "standard" ProComm icon of a telephone with the receiver up (when Freedom is dialing or on line). Whenever the working status icon is either a clock or the Freedom "funny" telephone, there will be a "hot spot" under the comm status icon. When either of those two working status icons are visible, clicking on the comm status icon will stop whatever dial run Freedom is engaged in. If it is a timed dial run (the clock working status icon is visible), a mouse click here will stop the timer, and the scheduled run. The last iconbutton in the toolbar, HELP, is on the far right side of all the other icon buttons and status icons. This one does exactly what you might think... it calls up this help file from within Freedom. At the bottom of the dialog box with this help file are two pushbuttons... "Done" will take you back to PCB Freedom's main screen, and "About..." will bring up another dialog with some information about PCB Freedom. The EDIT dialog box Some settings in this dialog box may require some explanation, so : 1 - "Mail Board ?" - checking this box will set up the system as one which Freedom will make mail runs on, i.e. Freedom will log on, open the mail door, and handle REP and QWK packets. 2 - "Graphics Board ?" - By default, this is checked. Leaving it set that way will result in a yes response to the PCBoard prompt about using ANSI graphics. If you uncheck this, PCB Freedom will respond to that prompt with a no. 3 - "Conference to Join ?" - This is optional, and allows you to tell PCB Freedom that, on this system, if you elect to stay on line after handling the mail, you may also tell it to join a conference other than the "MAIN" one. If you leave it empty, that option will not be available to you. 4 - "QWK packet name ?" - Every system has a particular "name" for the mail files it sends and receives. This "name" is the same for both QWK files and REP files. As example, one system that I use is Canada Remote. It's mail files are called CRS.QWK and CRS.REP. So, for the "QWK filename" field, I would enter "CRS" (case is not important here, as PCB Freedom will take care of that). 5 - "Open door # (name) ?" - Every system has a door name or number that must be "opened" in order to get your mail. PCB Freedom needs the name or number of that door entered here. PCB Freedom will add the "open" command to whatever you enter here, so please don't include it with the door name or number. 6 - "Mail directory ?" - This is the directory where you want PCB Freedom to "store" your packets after they have been downloaded and renamed. The default "standard" renaming option requires that the mail directory and the ProComm download directory be different. On my box, the ProComm download directory is F:\DOWNLOAD, and I have set my mail reader to look for mail packets in F:\MAIL. For my setup, I would enter F:\MAIL in this box. If the directory you have entered does not exist, PCB Freedom will ask you if you want it created. Some last things to remember : There are a couple of things to remember while running PCB Freedom.... 1) A timed, or delayed dial, is ALWAYS done minimized, with the dialing box and dialog boxes hidden. This means that a delayed dial can only be done with default settings of a) upload any REP found, b) download a new QWK, and c) log off the system once b) is done. The setting of the "Dial minimized" checkbox does NOT affect this.... a delayed dial is done minimized no matter what setting is in the "Dial minimized" checkbox. 2) If you check the "Dial minimized" check box, like a delayed dial, the next and future runs will be done minimized, with all dialing boxes, and dialog boxes hidden and default settings in effect. Any dial run will be done this way, until you uncheck the "Dial minimized" check box. 3) The "quick" dial feature will interrupt a delayed dialing run, and dial the current list of systems in "default" mode, i.e. dial right now, not minimized, with all dialing boxes and dialog boxes enabled. Once the "quick" dial is completed, the system will go back to waiting for the next scheduled delayed run. Future Enhancements Later versions of PCB Freedom are planned to include : 1 - File Downloading ability - Using a set of filenames defined by the user prior to the run, PCB Freedom will join the appropriate conference, and download a list of files to your system. 2 - Presetting the "options" for each system set up in a given run. 3 - File Searches - There are two possibilities here and time will tell which will be the more practical... a) PCB Freedom will log on, search for files based on user preset parameters, and capture the results of the search to a file. Later, you can view the capture, and tell PCB Freedom which files to get. b) The user will preset a search parameter, and PCB Freedom will log on, search for files matching that parameter, and download any that it finds. (ProComm, ProComm Plus, and ProComm Plus for Windows are registered trademarks of Datastorm Technologies Inc., Windows is a registered trademeark of Microsoft Corporation. The trademarks for PCBoard, Qmail, MarkMail, Cam-Mail, Kmail, Rosemail, WildCat and TomCat are hereby acknowledged.)