Beijing Paradise BBS Backup

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

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

Wrap

Text File | 1992-05-30 | 47.8 KB | 1,049 lines

┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ┌════════════════════════════════════════════════════════════════════┐ │ ┌────────────────────────────────────────────────────────┐ │ │ │ ┌────────────────────────────────────────────────────┐ │ │ │ │ │ PonyROM CD-ROM File Transfer Door │ │ │ │ │ └────────────────────────────────────────────────────┘ │ │ │ │ POWER BUSY AUDIO │ │ │ │ ┌──────────────────────────┐ ┌───────┐ COMPACT │ │ │ │ │ ▀▀ ▀▀ ▀▀ │ │ ▄ │ DISC │ │ │ │ └──────────────────────────┘ └───────┘ │ │ │ │ ╔══════════════════════════════════════╗ │ │ │ │ ║ ░════░ ║ ┌── ▀ │ │ │ │ ║ ░════░────────────────────────║ │MIN MAX │ │ │ │ ║ ░════░ CD-ROM CARTRIDGE ║ └── ▄ │ │ │ │ ╚══════════════════════════════════════╝ │ │ │ │ │ │ │ └────────────────────────────────────────────────────────┘ │ ├────────────────────────────────────────────────────────────────────┤ │ (C) Copyright 1991 by Sun Country Software, All rights reserved │ └────────────────────────────────────────────────────────────────────┘ Featuring: ────────── ■ Updates BBS DL Counts/Bytes ■ Works with ALL Popular cdrom discs ■ 9999 Directories Each Dbf ■ 15350 Files Each Dbf ■ COM 1-4,115200 bps ■ COM 1-4,115200 bps ■ Text Search ■ FileName Search ■ File Viewer Hook ■ Works with and updates Wildcat 3.0+, PCBoard 14.5, Remote Access 1.10 ■ Optional Copy from CDROM to hard drive & add and/or remove Comments ■ Supports up to 15 External Protocols, Includes PonyTRAN file protocol transfer module for most popular protocols with a graphical display. With Registered License Key This Door Also features: ──────────────────────────────────────────────────── ■ File Locking ■ Run 9 CDROM DISCS/DBF from 1 door with Access Security ■ Removes first screen and logon delays ■ LogOff Registration Notice PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 1 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ╓─╥─╖ ╥ ╓ ╓──╖ ╓┐ ╓──╖ ╓ ╓ ║ ╓─┬ ╟─╖ ║ ╓─╖ ║ ║ ╫ ║ ╓─╖ ╖─╖ ─╫─ ╓─╖ ╖─╖ ─╫─ ╓── ▀ ╨ ╙─┴ ╙─╜ ╨ ╙── ╙──╜ ╨ ╙──╜ ╙─╜ ╜ ╜ ╨ ╙── ╜ ╜ ╨ ──╜ ▀ ────────────────────────────────────────────────────────────────────── Purpose of this Program .......................................... 3 Legal Statement .................................................. 3 Getting Started .................................................. 4 PonyDBF .................................................... 4 Customizing ANSI Screens ................................... 5 PonyProt.Def ............................................... 6 PonyRom.Cfg ............................................... 6 Download Batch Files ...................................... 7 Programs residing/created ....................................... 8 Setting up under Desqview ....................................... 9 BBS Door Setups ................................................. 10 Registered License Key .......................................... 10 Unregistered Limitations ........................................ 11 Future Updates .................................................. 11 PonyRom Errors .................................................. 11 Extra Added Utilities Available ................................. 12 PonyFind .................................................. 12 RIABCONF .................................................. 12 PonyEdit .................................................. 13 PonyTRAN .................................................. 13 Common Solutions to Common Problems ............................. 15 Sample Example Quick Installation Checklist ..................... 16 Support Boards .................................................. 16 Thanks .......................................................... 16 PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 2 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ■ ──── Purpose of this Program ───────────────────────────────────── ■ This program, like most others, was born out of frustration of the time and speed of which most BBS software and cdrom doors handle cdroms. This is not to say that the way in which they accomplish their tasks of using cdroms is not done well or even better than we do, you can be the judge of that, only that we found a personal need to "do it our way" the best way we knew how, in a way that would handle any cdrom, in fastest possible way, for all the most popular bbs systems. As time goes on, more features and BBS software types may be added. We hope you and your users find this door and it's utilities useful and it helps make your job of a SysOp a little faster and little easier than the present way you offer your cdrom downloads. Thank you for your interest, Craig Barnett and Doug Preston, Sun Country Software ■ ──── Legal Statement ───────────────────────────────────────────── ■ User of program(s) assumes ALL risk of software. Author, or anyone else in the world WILL NOT be held responsible in any way, shape, or form for use or misuse of this software. If you, the user, don't want to be held responsible, then DON'T bother to use the program(s). There is NO CLAIM that this software will work with any or all the computer configurations that may or may not exist. This program is NOT guaranteed to work with your setup. We will not refund any registrations. If you fail to properly setup your system to run PonyROM, then do not register or use PonyROM. This version replaces any prior versions. Please update to the latest version prior to reporting any problems. Updates, if any, are made available for download to registered license purchasers, and not for an ongoing extension of your 30 day license. You are granted limited license to use this software for up to 30 days at which time you are expected to either register the software or remove the program(s) from your system. PonyRom and all it's utility programs are protected by the copyright laws of The United States of America that pertain to computer software. PonyRom must only be distributed in absolutely unmodified form, including all program and documentation files; PonyRom may not be included with any other product for any reason whatsoever without a permission from the Authors. Bulletin Board system operators may post the DEMO version of PonyRom on their BBS for downloading without written permission providing that no specific fees are levied to access the PonyRom files. It is illegal for you to distribute the file named "PONYROM.KEY" to any other person. This file is your "electronic identification" that you have purchased a licence to use Ponyrom. PonyRom and all it's utilities, (c) Copyright 1991,92 Sun Country Software and Craig Barnett and Doug Preston and is supported by them. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 3 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ PCBoard is copyrighted programs of Clark Development Company and CDC does not support PonyRom. Wildcat is copyrighted programs of Mustang Software Inc. and MSI does not support Ponyrom. Remote Access is copyrighted programs of Andrew Milner and Continental Software and does not support PonyRom. Other brand and product names are trademarks, registered trademarks, and copyrighted programs of their respective holders, and do not support this program. ■ ──── Getting Started ───────────────────────────────────────────── ■ Before trying to install this software you need to make sure you have at least 3.0 MB disk space free. The amount of disk space required for installation and setup can be up to 2.5 MB. The final size of disk space required can vary from 1.5 MB or less per CD-ROM. Notice: PonyROM will not properly run under systems that manipulate the door files that we read. It will only run under original files created by your BBS software. This means that you can not use any door file converters or programs such as Livecat or Superdor to run PonyROM. This Software comes with several programs designed to make installation and use easy and fast as possible. 1 - PONYROM.EXE Main Door Program 2 - PONYPATH.EXE (Optional) Creates a download path file (.PTH) in order to be able to exclude or add certain directories available for downloading from. Run prior to PONYDBF.EXE if selective/custom download directories are desired. (REQUIRED TO BE USED BY SYSTEMS RUNNING DOS VERSIONS PRIOR TO 4.0! BEFORE YOU RUN PONYDBF!). 2 - PONYDBF.EXE Creates DBF file for PonyRom (DBase III) and a Download PTH file, if none is found. 3 - PONYCFG.EXE Creates CFG file for PonyRom 4 - RIABCONF.EXE (Optional) Splits RIAB_V31's CDMASTER.DIR into separate File area lists. (For RIAB disc Only) 5 - PONYFIND.EXE (Optional) SysOp Utility - Used to FIND and DOWNLOAD any file found in the .dbf to the current directory. 6 - PONYTRAN.EXE External Graphical Multi-Protocol modual of PonyROM. We will discuss them in the order that they should be used. There are also additional sample files that you need to modify or create your own. You will first have to create a directory for PonyRom. Put all of the files that came with PonyRom into this directory. ■ ──── PONYPATH ──────────────────────────────────────────────────── ■ The first program you should run is PONYPATH.EXE which creates the download directory location path list used by PonyDBF. Updated MAKEPTH program for PonyRom Ver 2.0+. To use type PONYPATH d: > CDNAME.PTH where d: = Drive letter followed by a colon. CDNAME.PTH = NAme of CDROM.PTH file. This name should be the same name as CDROM.DBF name you are going to create. ■ ──── PonyDBF ───────────────────────────────────────────────────── ■ The second program you should run is PONYDBF.EXE which creates the Database for PonyRom. !!! MAKE SURE YOU HAVE AT LEAST 3.0 MB FREE DISK SPACE. !!! Before you run PonyDBF you need to create an Ascii file with the following information in it. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 4 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ CD-ROM name CD drive designation Sample CDROM.CNF contents: RIAB_V31 K: If your cdrom disc has more than 15350 files on it, you will need to split up your .Pth file in to 2 or more parts, as the search routines currently support up to that amount. You can then create 2 .dbf files and setup for multi cdroms. (Registered licence key required). To run PonyDBF and create the database all you have to do is while in your PonyRom directory type: PONYDBF CDROM.CNF This program can take up to 30 minutes if not longer to create your database. You do not need to input or do anything once it starts so time to go to lunch or dinner. Once this program has completed you will have your database for PonyRom. Your next step will be to create file lists for each of the areas on your CD-ROM. If your CD-ROM has separate file lists already made and in place for each area on the CD then all the better. They can stay where they are (even if they are in text format on the cdrom). The exact name of the files is not important. But you will need to know the names later. Your lists should be setup like the sample RIAB027. File size and Date are not needed in the list, just in case yours just happen to not have them. If you run RBBS-in-a-Box then you may wish to use the enclosed RIABCONF.EXE program to create your lists. The next step would be to create an AREA LIST file with the path and name of each file list file. I would recommend naming this file with the CD-ROM name. See the sample RIABFILE.LST. example: K:\DIR001\AREA001 ─┐ K:\DIR002\AREA002 ─┼─ Download Area Text Files K:\DIR003\AREA003 ─┘ That should give you an idea of the format for this file. ■ ──── Customizing Ansi Screens ──────────────────────────────────── ■ Next you need to make your Menu Files. These can be made with your favorite Ansi screen maker. THEY MUST BE SAVED WITH MAXIMUM LINE WIDTH SET TO NONE. If they are not saved this way they will not properly display within the door, They will more than likely only show part or half the screen. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 5 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ Using Thedraw(tm) v4.01 as an example: Set the Maximum Ansi line length: to NONE on the configuration page 2 ┌────────────────────────────────────────────────────────────────────┐ │ TheDraw Default Options Configuration (page 2 of 2) │ ├────────────────────────────────────────────────────────────────────┤ │ .... │ │ .... │ │ .... │ │ .... │ │ .... │ │ Reset colors to white on end of Ansi files? YES │ │ Default Ansi video preparation: NONE │ │ Default Ansi slow down factor: 0 │ │ Maximum Ansi line length: >>>>>>>>>>>>>>>>>>>>>>>>>>>> NONE │ └────────────────────────────────────────────────────────────────────┘ Your Ansi drawing program may vary. See the sample RIABMENU.BBS and RIABMENU.SCR files. Area one on the menu must coincide with the first file list file in your AREA LIST file. ■ ──── Ponyprot.Def ──────────────────────────────────────────────── ■ You next need to edit PONYPROT.DEF to add or remove any protocols you wish to use. You may use up to 15 Protocols. The format of this file is : X,XMODEM,S Y,YMODEM,B Z,ZMODEM,B G,YMODEM-G,B First Letter used in SEND_?.BAT and used to pick the Protocol. Second is the name of protocol Third letter is 'S' for Single, 'B' for Batch protocol. NOTE THE COMMA SEPARATOR. It must be used! ■ ──── PonyCFG ───────────────────────────────────────────────────── ■ The next step would be to run the PONYCFG.EXE program. This program will create the needed CFG file for PonyRom. This program is the next step in your PonyRom setup. This program will take a command line parameter for CFG file name. If no command line parameter is passed it will default to PONYROM1.CFG, When you enter this program you should fill in all the information requested. For single node you can just type PONYCFG For more than one node, you would run it as: PONYCFG PONYROM1.CFG PONYCFG PONYROM2.CFG PONYCFG PONYROM3.CFG etc... PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 6 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ Sample screen: INSERT OFF PonyCFG (c) 1991, 1992, Sun Country Software First Name : Craig Last Name : Barnett BBS Name : PrimeNet(tm) BBS Type : Wildcat Door Info : C:\WC30\WCWORK\NODE1\DOOR.SYS Number of Areas : 33 Name of DBF File : CARRS Default Ext : ZIP Name of CFG : PONYROM1.CFG Copy File? : N <F1> to Save and Quit, <F2> to Save and Create Another CFG File <F5> to Edit Security Def Files, <F10> To Quit and Dump Info F5 will bring up the CD security def menu, you will need to create a CDxxxx.Def (xxxx=sec level) file for EACH access level INCLUDING the SysOp, and which cdroms you want those access levels to have access to. If no CDxxxx.Def file is found for someones security level, it will default to the default cdrom name you entered in PonyCFG. (Only if using multi cdrom discs and registered license key is found). FOR MULTI-NODE SYSTEMS IT IS VERY IMPORTANT THAT YOU SPECIFY FULL PATH TO DOOR.SYS INCLUDING NODE DIRECTORY. AGAIN IF YOU RUN MULTI-NODE DO NOT COPY ANY FILES!!!! We write temporary files to the same directory as your Door.sys, we also need to find the file that your BBS software reads back in after a door in this same directory so we can update users download records. For Wildcat Ver 3.xx this file is called USERINFO.DAT For PCBoard Ver 14.5+ this file is called USERS.SYS For Remote Access Ver 1.10+ this file is called EXITINFO.BBS For all other BBS Software we do not update user records yet. We will add other BBS Type support if interests warrant it. We require a DOOR.SYS to run under any type of BBS except Remote Access which uses DORINFO1.DEF. The next thing you need to do is create your batch files. The proper way to call PonyRom is as follows: This of course is if your CFG file name is PONYROM1.CFG PONYROM PONYROM1.CFG See sample PONYROM1.BAT and BBS setup section at end of this doc. ■ ──── Download Batch ────────────────────────────────────────────── ■ Download Batch files should be created using the following variables we pass to the download batch files. See Sample SEND_?.BAT files. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 7 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ We pass 5 variables at this time to batch file. They are: Single Protocol: %1 = Port %2 = DTE Rate %3 = FileName %4 = Time Left %5 = Baud Batch Protocol : %1 = Port %2 = DTE Rate %3 = @dlfiles.lst %4 = Time Left %5 = Baud ■ ──── Programs residing/created ─────────────────────────────────── ■ The Following is a list of files that should reside in PonyRom directory. PONYROM.EXE ; Main Door Program PONYDBF.EXE ; Used to create the .dbf file PONYCFG.EXE ; Used to create/edit cfg file PONYFIND.EXE ; (Optional) For local SysOp downloads outside door. PONYCNF.EXE ; (Optional) Used to create RIAB.### area listings PONYPATH.EXE ; (Optional) Used to create a selective download XXXXXXXX.PTH. (REQUIRED IF USING DOS PRIOR TO 4.0!) XXXXXXXX.CFG ; XXXXXXXX = what ever you named your cfg. XXXXXXXX.DBF ; XXXXXXXX = what ever you named your dbf. XXXXXXXX.PTH ; XXXXXXXX = what ever you named your dbf. XXXXXXXX.BBS ; XXXXXXXX.BBS = Name of ASCII menu XXXXXXXX.SCR ; XXXXXXXX.SCR = Name of ANSI menu XXXXXXXX.LST ; XXXXXXXX.LST = Name of Area List File PONYPROT.DEF ; Protocol Definition File SEND_?.BAT ; Protocol batch files CDxxxx.DEF ; XXXX = Security Access Level. Defines access to CDROM's create using PONYCFG and hit [F5]. (Multi-CDROM discs) PONYROM.KEY ; Registration Key file (if Registered) CDWELCOM.BBS ; ASCII Welcome Screen CDWELCOM.SCR ; ANSI Welcome Screen ?-HELP.BBS ; ? = Menu Letter, ASCII Help Screen ?-HELP.SCR ; ? = Menu Letter, ANSI Help Screen PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 8 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ■ ──── SETUP UNDER DESQVIEW ──────────────────────────────────────── ■ This is our setup for Node 3 running under DESQview. We have Writes Directly to Screen turned on because I used to run a lot of Doors that wrote directly to the screen. This door is no exception. We may add DESQview screen support in a later release. For now you will want to make sure that your setup has Direct screen write turned on and Virtualize Text\Graphics set to T. Change a Program Program Name............: [NODE 3] Keys to Use on Open Menu: N3 Memory Size (in K): 500 ────────────────────────────────────────────────────────────────────── Program...: runwc3.bat Parameters: Directory.: E:\WC30 ────────────────────────────────────────────────────────────────────── Options: Writes text directly to screen.......: [Y] Displays graphics information........: [N] Virtualize text/graphics (Y,N,T).....: [T] Uses serial ports (Y,N,1,2)..........: [N] Requires floppy diskette.............: [N] Change a Program Advanced Options System Memory (in K)....: 0 Maximum Program Memory Size (in K) : 800 Script Buffer Size......: 0 Maximum Expanded Memory Size (in K): 1024 Text Pages: 1 Graphics Pages: 0 Initial Mode: Interrupts: 00 to FF ────────────────────────────────────────────────────────────────────── Window Position: Maximum Height: 25 Starting Height: 25 Starting Row...: 0 Maximum Width.: 80 Starting Width.: 80 Starting Column: 0 ────────────────────────────────────────────────────────────────────── Shared Program Pathname..: Data......: ────────────────────────────────────────────────────────────────────── Close on exit (Y,N,blank)..: [N] Uses its own colors.............: [Y] Allow Close Window command.: [Y] Runs in background(Y,N,blank)...: [Y] Uses math coprocessor......: [Y] Keyboard conflict (0-F).........: [0] Share CPU when foreground..: [Y] Share EGA when foreground/zoomed: [Y] Can be swapped out (Y,N,blank): [N] Protection level (0-3).......: [0] Also I have my foreground/background ticks set to 2:2 You may need to play with your settings, If you have it setup and working though, I wouldn't play with it. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 9 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ■ ──── BBS Door Setup ────────────────────────────────────────────── ■ Basic Door Batch File: ┌───────────────────────────────────────────────┐ │ CD \DOOR │ │ PONYROM PONYROM#.CFG <RA Only also add N#> │ │ CD \BBS │ └───────────────────────────────────────────────┘ Check your BBS documentation on how to exit and return from a door! BBS Setups tested: ┌────────────────────────────────────────────────────┬───────────────┐ │ PCBOARD is REQUIRED to set │ USER DOOR │ │ the following in your │ SYS SYS │ │ PCBSETUP (DOORS.LST) │ ════ ════ │ │ (See your BBS DOC for location) │ Y Y │ └────────────────────────────────────────────────────┴───────────────┘ ┌────────────────────────────────────────────────────────────────────┐ │ Wildcat - Normal door operation │ └────────────────────────────────────────────────────────────────────┘ ┌────────────────────────────────────────────────────────────────────┐ │ REMOTE ACCESS type #7 exit in OPTIONAL DATA menu field: │ ├────────────────────────────────────────────────────────────────────┤ │ C:\COMMAND.COM /C C:\RA\PONYROM.BAT │ └────────────────────────────────────────────────────────────────────┘ These tested examples are not meant to teach you how to run doors on your BBS, see your BBS documentation for that information. ■ ──── To Download a Registered License Key File ─────────────────── ■ To register this software please print out REGISTER.FRM and mail it along with the appropriate registration fee payable to: Craig Barnett 1711 Stockton Hill Road, Suite # 178 Kingman, Az 86401 Registration will remove all [UnRegistered] displays and delays. It also entitles you to download any future minor updates for free. Upon Registration you will be able to download your Key File. You will also have access to Support Conferences on the Support boards where you will always find the most recent version of all our software. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 10 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ■ ──── Unregistered Limitations ──────────────────────────────────── ■ This software DOES NOT EXPIRE and IS NOT CRIPPLED. That is not to say that at some future date we won't change our policy. Purchase of a Registered license key will allow you to rid yourself of the UNREGISTERED notices, thereby also removing any unregistered delays and will also allow you access to any future Minor Updates that may be released. Major upgrades and Updates may require a small upgrade fee. ■ ──── Future Updates/Upgrades ───────────────────────────────────── ■ PonyROM (DBase) ─────────────── PonyROM (DBase) uses DBaseIII+ database routines. Updates are free by download to those that hold a registered license key to the Dbase versions for all Minor versions. Major versions will carry a nominal upgrade fee. PonyROM (BTree) [Available Approx. Late 1992/Early 1993] ──────────────────────────────────────────────────────── PonyROM (BTree) uses BTree multi-node database routines written in Turbo Pascal version 6.0. Updates are free by download to those that hold a registered license key to the BTree versions for Minor versions Major upgrade versions will carry a nominal upgrade fee. Upgrades from PonyROM (DBase) to PonyROM (BTree) will be available to registered license PonyROM (DBase) holders by download for a nominal upgrade fee. (Available Approx. late 1992/early 1993). ■ ──── PonyRom Errors ────────────────────────────────────────────── ■ These are the meanings of the various error code messages which PonyRom is capable of returning. The ones with an "*" in front should be looked at with an eye to a possible installation/configuration/setup error. Please report any error codes which you receive when calling the support BBS's for help. 3 Return without GoSub 56 Field Statement active 4 Out of Data *57 Device I/O error 5 Illegal Function Call 58 File already exists 6 Overflow 59 Bad Record length *7 Out Of Memory *61 Disk Full 9 Subscript out of range 62 Input past end of file 11 Divide by zero 63 bad record number 14 Out of String Space 64 bad file name 16 String Formula Too Complex 67 too many files 19 No "Resume" *68 device unavailable 20 Resume without Error *69 Communications Buffer Overflow *24 Device Timeout 70 Permission Denied *25 Device Fault *71 disk not ready *27 Out of Paper *72 disk-media failure 39 Case Else expected 73 Advanced Feature Unavailable 40 Variable Required 74 Rename across disks 50 Field Overflow *75 path/file access error 51 Internal Error *76 path not found *52 Bad file name or number *53 File not found 54 Bad file mode 55 file already open Error Logs Created: PONYROM.ERR - 98% could be a programming error <DBFNAME>.ERR - 100% User Setup Errors PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 11 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ■ ──── PonyFind ──────────────────────────────────────────────────── ■ PonyFind is a great, quick SysOp utility that allows you to find and local download any file matching a file found in the .dbf file. To use simply type: PonyFind [dbfname] Where dbfname is the created XXXXXXXX.dbf file with PonyDBF.exe ■ ──── RIABCONF ──────────────────────────────────────────────────── ■ This Program is not guaranteed to do anything except maybe take up a little disk space. This program can be used freely by you and anyone who you wish to give it to. We do not make any claims about this software except that we wrote it. If you find it useful then feel free to use it. This software has no warranties neither implied nor otherwise. If you use this software you agree to accept all liability and damages that may occur from the use of this software. We accept no liability for your use. This Program was written because of the way RBBS-in-a-Box cdrom discs are setup. It was very difficult to separate CDMASTER.DIR files into separate area listings. This program will read your CDMASTER.DIR file off your RIAB cdrom disc and create separate file list for each area on your hard drive. On our versions we had a few extra areas. The name of these oddball areas is different for each version of RIAB that it was tested against. If yours also has theses odd ball areas it will create a file list for the odd ball areas also. You will need to check these odd ball areas and add the files to the appropriate file list. To run RIABCONF.EXE you will need to run it with the following format. RIABCONF K:\RBBS\CDMASTER.DIR On the command line is the full drive/path to your CDMASTER.DIR file. That is it. You can take a coffee break now due to this process taking from 30 minutes to an hour, depending on the speed of your machine. This was the simplest way we could find to split the CDMASTER.DIR file into separate File Lists. When this software is finished you should have a file list for each area. RIAB.001 RIAB.002 and so on ... PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 12 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ■ ──── PonyEdit ──────────────────────────────────────────────────── ■ PonyEdit is used to edit, pack, remove, resort, delete files to the .dbf file. This program is made available for download by Registered license holders. PonyEdit requires that ALL .dbf files are re-compiled with the latest PonyCFG file in order to work correctly. This is due to the addition of 4 char number length in the updated .dbf's structure to alow for up to 9999 file areas. ■ ──── PonyTRAN ──────────────────────────────────────────────────── ■ PonyTran is a command line program that provides one transmit or one receive protocol session. To start a Zmodem protocol transmit of all the PAS files in your directory you would type the following: PonyTran /c 2 /b 9600 /z /t *.pas PonyTran will open Com2 at 9600 baud and transmit all PAS files using the Zmodem protocol. After all the PAS files have been transmitted PonyTran will report the ending AsyncStatus value. To send a list of files you would use @FileList If you wish to transmit additional files then you would rerun PonyTran with appropriate parameters. Let's take a look at all of the PonyTran parameters and discuss them in turn: Usage: PonyTran [options] SrcFilename /B BaudRate Baudrate /C # Comport name [default = 1] /T Transmit mode [default] /R Receive mode /S ASCII transfer /X Xmodem/XmodemCRC [default] /K Xmodem1K /L Xmodem1KG /Y Ymodem /G YmodemG /Z Zmodem /F Kermit /A Zmodem option - resume interrupted transfer /O Zmodem option - always overwrite files /N Zmodem option - only overwrite if newer /B BaudRate - If you do not specify a baud rate PonyTran will open the specified port without disturbing its existing parameters. You would typically omit the baud rate whenever you are running PonyTran as a DOS EXEC or Shell from some other communications program (so that PonyTran would use the line parameters left by the parent program). PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 13 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ /C # - This is the Com port number you wish to use. If you omit this parameter Com1 will be used. PonyTran supports Com1-Com4 on PCs and ATs, Com1-Com8 on PS/2s. /T - Specifies that you wish to transmit files. This is the default. Whenever you are transmitting files you must supply a file mask (or file name) as the last parameter on the command line. /R - Specifies that you wish to receive fies. If the protocol you've selected doesn't support file names (Xmodem and Ascii) then you must supply a receive file name as the parameter on the command line. If the selected protocol does support file names then any name you specify on the command line will be ignored. /S .. /F - Specifies the protocol you wish to use. PonyTran supports all standard protocols. /A .. /N - Specifies a few Zmodem options that you might want to experiment with. /A resumes interrupted file transfers. It can be specified by either the transmitter or receiver. /O tells Zmodem to always overwrite existing files (the default is to skip existing files). /N tells Zmodem to overwrite existing files only if the incoming file has a later time stamp. PonyTran will use hardware flow control,PonyTran will never use software flow control. PonyTran will display the progress of the protocol transfer. PonyTran will read the Environment variable PTLOG if it is set and will create a log of all transmitted and received files. It will append to the this file if it already exists. The log entry consists of the protocol type, file name, whether it was transmitted or received and whether the transfer was successful or not. PonyTran's logging routine will also delete partially received files unless the protocol in use was Zmodem (since Zmodem could resume the transfer from the point of interruption). PonyTran also reads Environment variable PTBBS if it is set and will write Wildcat Activity log format if it is set to WILDCAT. will write pcboard Activity log format if it is set to PCBOARD. Example, In your Config.sys (for 1 node) or (RUNDV.BAT for 2) put: SET DSZLOG=C:\WC30\WCWORK\NODE1\DSZ.LOG PTLOG=C:\WC30\ACTIVITY.001 OR PTLOG=C:\PCB\MAIN\CALLER1 PTBBS=WILDCAT OR PTBBS=PCBOARD If the Environment variable PTLOG is not set then the log file will not be created. Zmodem uses its own file management rules. PonyTran uses the default of WriteProtect which means it will skip files that already exist at the destination. You can modify this with the /O and /N command line parameters. Note that Zmodem doesn't have a rename option. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 14 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ■ ──── Common Solutions to Common Problems ───────────────────────── ■ QUESTION: What does it mean when I get an error 'PATH NOT FOUND IN 11000' ?? ANSWER: PonyROM can not find your DOOR.SYS file, check the Path Location in PonyCFG for the node causing the error. QUESTION: PonyRom just starts to run then locks up. What do I do? ANSWER: If you are running HyperDisk, then you need to turn off stage writes prior to running PonyROM in your door bat file. QUESTION: PonyROM works fine on 1 or 2 nodes, but the last node does not work right or I get EXCEPTION 13's. What do I do? ANSWER: Run Optimize correctly per the Desqview manual and exclude the proper memory areas for your system per the manual. QUESTION: I get errors during file searches. What do I do? ANSWER: Most of the time you either don't have enough memory in that window or your databases are too large. QUESTION: I run XYZ BBS software and PonyROM doesn't work right? ANSWER: PonyROM only supports WILDCAT! v3.xx, PCBoard 14.5, & Remote Access 1.10+, to use ANY other BBS software will require "100% TRUE CONVERSION" to a DOOR.SYS compatible to those systems, but it WILL NOT have any way of keeping track of your Upload/Download counters, only allow you "Micky Moused" access to the cdrom(s). Consider yourself warned. We may support other BBS software in the future, but none is planned at the present time. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 15 ┌────────────────────────────────────────────────────────────────────┐ │ PonyRom Documentation (c) 1991,1992 Sun Country Software │ └────────────────────────────────────────────────────────────────────┘ ■ ──── Sample Example Quick Installation Checklist ───────────────── ■ Lets call our sample example CDROM - YOURNAME v.3.4 ... (A) - Run PONYPATH.EXE { Creates the YOURNAME.PTH } (B) - Create 'YOURNAME.CNF' { Tells PONYDBF where to look } (C) - Run PONYDBF.EXE { Creates the YOURNAME.DBF } (D) - Create 'YOURNAME.LST' { List of File Area Text files } (E) - Create 'YOURNAME.BBS' and 'YOURNAME.SCR' { Area Menu Files } (F) - Run PonyCFG Pony#.CFG { PonyROM Nodes CFG #=Node# } (G) - If multi-cdroms also Hit (F5) and create ALL security levels { Multi-Cdroms setup } (1) Single Nodes/Single CDROM - Do [ A,B,C,D,E,F ] ... Your Done (2) Multi Nodes/Single CDROM - Do [ A,B,C,D,E ] And [ F for EACH NODE, change CFGName & DoorSys Location ] (3) Single Nodes/Multi CDROM - Do [ A,B,C,D,E for EACH CDROM & F ] And [ G for EACH ACCESS LEVEL ] (4) Multi Nodes/Multi CDROM - Do [ A,B,C,D,E for EACH CDROM ] And [ F for EACH NODE, change CFGName & DoorSys Location ] And [ G for EACH ACCESS LEVEL (Only Once) ] *2,3,4 - Available only with a registered license key file ■ ──── Support Boards ────────────────────────────────────────────── ■ ┌─────────────────────────────────────────────────────┐ │ Name Number Speed │ └─────────────────────────────────────────────────────┘ PrimeNet(tm) (602)757-1125 14400 v32/v42 Golden Valley (602)757-0385 14400 v32/v42 PONYWARE (DoorNet) Support worldwide echo conference is setup on both support systems for worldwide software support of ALL of our products. This is the only means of support, which is available worldwide for all of our products. Voice support is not included, provided, nor available. ■ ──── Thanks ────────────────────────────────────────────────────── ■ Special thanks to Steve Henry and his Users of the Ambassador board for many hours of beta testing and bug reporting under multi-node. Ambassador Board (519)925-0025 14400 v32/v42 Thanks to our families for understanding the long programing sessions with 16 hour a day phone conversations. And thanks to all the other SysOps and Users all over the world for putting up with PonyRom during its testing and debugging stages. PonyRom (C) 1991,1992 - Sun Country Software Ver 2.0 Page 16 ──────────────────────────────────────────── PonyRom (c) 1991, 1992, Sun Country Software ──────────────────────────────────────────── Use this form to register the software SYSOP NAME : ________________________ (Exact Case for Key) BBS NAME : __________________________ (Exact Case for Key) ADDRESS : ________________________________________________ CITY / STATE / ZIP..______________, ______ _____________ VOICE PHONE : __________________ DATA : _________________ BBS Software Used _________________ Number Of Nodes _____ How Do you want your License Key file sent??: _____ (A) Download from either Support BBS (Fastest/Best) _____ (B) Send via Fido Netmail to address (_____________) (Note: Available in Zone #1 Only) ┌────────────────────────────────────────────────────────┐ │ For Option C, D, below include an additional $5.00 │ └────────────────────────────────────────────────────────┘ _____ (C) Disk/US Mail Size _______ (5.25) or (3.5) Format _______ (360)(1.2)(720)(1.44) _____ (D) Uploaded to my BBS at: (_____)-(_____)-(_______) I will setup Author Name: __________________________ with Password of ___________________________________ All orders NOT including the additional $5.00 will be put on hold for download. Pay attention to and remember your choice of: (A, B, C, or D) to avoid confusion. Setup my Support BBS Account(s) with password: ___________ Where did you get your copy of this software? __________________________________________________________ (NOTE: ALL REGISTRATIONS MUST BE IN US FUNDS ONLY) ______ PonyROM CDROM Download Door v2.02b ........ $ 30.00 S & H ($5.00 EA IF OPTION C or D Choosen Above) $___.__ TOTAL ENCLOSED ... $ ________ (Make check or Money Order Payable to:) Craig Barnett 1711 Stockton Hill Road, Suite # 178 Kingman, AZ. 86401 Please grant up to 2 weeks for processing and delivery before order inquiries. ────────────────────────────────────────────────────────── Support BBS's: PrimeNet(tm) - (602)757-1125, Craig Barnett Golden Valley - (602)757-0385, Doug Preston ──────────────────────────────────────────────────────────