ßÛßßßßÛ ÛßßßßÛ ßÛßßßßÛ Û Û Û Û Û Û Û ÛÜÜÜÜÛ Û ÛÜÜÜÜß ÛßßßßÛ ßßßßßÛ ÛßßßÛ ÛßßßßÛ Û Û Û Û Û Û ÛßßßßÛ Û ß Û Û ÜÛÜ ÛÜÜÜÜÛ ÜÛÜÜÜÜÛ ÛÜÜÜÜÛ ÛÜÜÜÜÛ Û ÛÜÜÜÜÛ ÜßßÜ ß Û Üß Üß ÛÜÜÜÜÜ Ûßßßßß ÛßßßßÜ Û Ü Û Û ÛÜÜÜ ÛßßßÛ ÛßßßßÛ ÛßßßßÛ ÜÜÛÜÜ Û Û ÛßßßßÛ ÛßßßßÛ ÛßßßÛ Û Û Û Û Û Û Û Û Û Û Û Û Û Û ß Û Û ÛÜÜÜÜÛ Û Û ÛÜ ÛÜÜÜÜß ÛÜÜÜÜÛ ÛÜÜÜÜÛ Û ÛßßßßÛ Û ßÛ Û ÛßßßßÛ ÛßßßßÛ Ûßßßßß ÛßßßßÛ Û ÛßßßßÛ Û Û Û Û Û ÛÛÛÛÛÛ Û Û Û ÛÛÛÛÛÛ ÛÜÜÜÜÛ ÛÜÜÜÜÛ Û Û ÜÜÜÜÜÛ ÛÜÜÜÜÛ ÜÛÜ ÛÜÜÜÜÜ Version 1.3 Brought to you by Tom Carroll and Dataware Software Copyright (C) 1992-93 by Tom Carroll All rights reserved The Data Shop BBS (509)582-9493 (16.8k HST/DS) Kennewick, WA FIDO address (1:3407/1) MAGIC FILE NAME: PCB2FDC ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ INTRODUCTION ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This program only supports PCBoard systems that run FrontDoor (FD) and InterMail (IM). This is not a statement by me that either one is the best mailer out there, it just says that I use FD on my system and IM has the same structures as FD. I decided to write a program that writes directly to the mailer console, but I found an easier way after I downloaded the FD Developers info packet. It seems FD (and IM) uses semaphore files so other applications can communicate with them. Well, I was able to figure out that I could write info to the LASTCALL.xx file and therefore place the last BBS caller info into the last mail To: record. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ DISCLAIMER ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This software is provided without any guarantee or warranty either expressed or implied. I will not be held responsible for ANY damages that may result in the use of this program. "ANY" means if you install it, run it, and it eats your programs that you've been working on for 2 years without a backup, IT'S NOT MY FAULT!!! PCB2FDC software and this document is Copyright (C) 1992-93 by Tom Carroll, All rights reserved. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ LICENSE ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This program is being released as FREEWARE. The source code will remain the property of the author unless otherwise released by him. You are free to use this version of the program without any cost of registration. This however, may change at any time with a new version release. (If this should happen, a one time registration fee will be asked) No one may alter, modify, or reverse engineer PCB2FDC for any reason, including but not limited to decompiling-compiling, patching, or disassembling. You may freely distribute & copy this program for others subject to the above restrictions and the following: þ PCB2FDC is copied in unmodified form including this file. þ There is no charge for copying except for the cost of disks. þ PCB2FDC is not included in another software package without the express written permission of Tom Carroll. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ SUPPORT ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ If you should find any problems with this program, or you have any requests or recommendations, you may reach me on my BBS, or at the FIDO address listed on the front cover. I may also be reached in the QUIK_BAS & PCBNET FIDO echo's, UNI', ILink, and Global Link Sysop conferences, or on SaltAir. PCB2FDC v1.3 Page 2 ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ THE AUTHOR ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ I have been writing in BASIC for about 8 years, and I really like it, but I've been planning on taking a course in "C", but still haven't... I am presently active duty in the U.S. Coast Guard, and have been a "Sysop" for their computer systems at my duty stations for about 7 years. I would like to thank my wife, who always says "Are you coming to bed, or are you going to keep PLAYING on that computer?" ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ FILES ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Files included in this archive: FILE_ID.DIZ - Description file for PCB2FDC PROGRAMS.DWS - List of Dataware Software products PCB2FDC.DOC - Documentation for PCB2FDC PCB2FDC.EXE - PCB2FDC Executable. PCB2FDC.HIS - PCB2FDC History notes. I originally compressed this program as P2FDCnn.ARJ, but it may be compressed with any other archive program you wish to use as long as all the above listed files are included within the new archive. The latest version will always be available on my BBS using the magic filename of PCB2FDC or in conference #1 (Dataware Support). Sometimes, there may be a need for debug code to be released. This code is used to track down specific problems which aren't normally encountered on my system. I have a 386/sx-25 w/4megs of RAM, and DOS 5.0, which should be pretty standard and generic, but sometimes this doesn't present an optimal testing environment, so please, if you're having problems, and debug code is available, feel free to FREQ P2FDEBUG from me, or if you're registered on my BBS call and download PCB2FDC.ARJ from conference #1. If it's not available, then you're the first person that has reported a problem, so please leave me your specifics, and any config files so I may be able to trouble shoot the problem. Now, on with the installation... PCB2FDC v1.3 Page 3 ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ SETUP ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ All you need to do is add the following command line to your $$LOGON.BAT file: PCB2FDC C:\PCB\MAIN\USERS C:\FD\LASTCALL.xx /IN (note: xx should be replaced with FD or IM) Now enter this line in your $$LOGOFF.BAT file: PCB2FDC C:\PCB\MAIN\USERS C:\FD\LASTCALL.xx (note: xx should be replaced with FD or IM) Copy the PCB2FDC.EXE file to your PCBoard directory and you're all done! ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ OPERATION ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ PCB2FDC will read the PCBOARD.SYS upon logon, and then upon logoff, it will read the users record using the USERNUMBER field originally retrieved from the PCBOARD.SYS file and update the LASTCALL.xx file. When PCB2FDC initially reads the PCBOARD.SYS record, it retrieves the USERNUMBER, and the time logged on (seconds since midnight) info. It will append this information to the end of the PCB2FDC.EXE file so you won't have to worry about a config file. (NOTE: This may confuse people if they try and determine if the program they are using is the latest by comparing the date/time stamp of the file. The file is a self-modifying .EXE and it will always have a current date. To determine what version see the notes section later on.) After the user logs off, the info will be read from the PCB2FDC.EXE file and then it opens the USERS file to retrieve the users full name, city, security, and number of times on. This info will be shown along with the elapsed time online, and the date/time they logged off in the To: record of the LASTCALL.xx file. Here is an example of what will be displayed, and the location of each piece of information: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ÚÄÄÄÄÄÄÄÄ¿ ³ v v ³ ³ To : Tom Carroll <ÄÄÄÄÄÄÄÄÄÄÄÄ¿ 110:186/20 <¿ ³ ³ 12-23-92 16:53 <ÄÄÄÄÄÄÄ¿ ³ Kennewick, WA ³ ³ ³ ³ ³ ÄÄÄÄÄÄÄÂÄÄÄÄÄ ³ ³ ³ ³ ³ ³ ³ ³ ³ Date/Time user logged off.Ù ÀÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ³ ³ ³ Users name, formated to Upper/Lower case.Ù ³ ³ ³ ³ Users City and State Upper/Lower.ÄÄÄÄÄÄÄÄÄÄÙ ³ ³ ³ Users Elapsed time on-line.ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³ ³ Number of times on (for new users).ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³ Callers security level.ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ PCB2FDC v1.3 Page 4 PCB2FDC should retain all info from the previous call should a newuser fail to register on your BBS. It will also work on doors that allow the caller to hang up while inside of it. (such as mail doors) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ NOTES ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ To determine the current version you are running, you may type the following command line: PCB2FDC /VER which will print the following info to your screen: Program - PCB2FDC Version - Compiled - Another switch is available for my debugging purposes. If you find that the software isn't working properly, please include the /DEBUG command line switch. This will creadte a file called PCB2FDC.DBG and it needs to be copied before the program executes again, otherwise it will be overwritten. Be sure to send me this file when you call, which will help in tracking down the problem. I don't know if PCB2FDC will work in a network, Desqview, or multi-node environment so I have no idea if it will operate on your system. However, you will have to have SHARE.EXE loaded for it to operate correctly. I do not know of any other limitations of PCB2FDC, but if you should have a problem, please let me know. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ DONATIONS ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This version of software is free for the taking, but if you feel compelled to make a donation, you may send whatever contribution that you feel is reasonable to the following address: Dataware Software 1922 W. 4th Avenue Kennewick, WA 99336 I will be transfering in the summer or fall of 1993. If you call my BBS and do not get an answer, you may leave me mail in one of the networks listed above, or contact one of the following these BBS's for a tech support account. The One Stop PCBoard Arid Acres Gary Hedberg John Allen (509)943-0211 (509)544-0116 (v.32bis) (v.32bis) PCB2FDC v1.3 Page 5