home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / JFYAHT13.ZIP / CLDOOR37.ZIP / CALLDOOR.DOC < prev    next >
Encoding:
Text File  |  1991-09-07  |  20.9 KB  |  472 lines
  1.     ╒════════════════════════════════════════════════════════════════════╕
  2.     │     ▒████  ▒████  ▒█     ▒█         ▒███▄  ▒████  ▒████  ▒████     │
  3.     │     ▒█     ▒█ ▒█  ▒█     ▒█         ▒█ ▒█  ▒█ ▒█  ▒█ ▒█  ▒█ ▒█     │
  4.     │     ▒█     ▒████  ▒█     ▒█   ▒███  ▒█ ▒█  ▒█ ▒█  ▒█ ▒█  ▒███      │
  5.     │     ▒█     ▒█ ▒█  ▒█     ▒█         ▒█ ▒█  ▒█ ▒█  ▒█ ▒█  ▒█ ▒█ V3.7│
  6.     │     ▒████  ▒█ ▒█  ▒████  ▒████      ▒███▀  ▒████  ▒████  ▒█ ▒█     │
  7.     │           Compiled in Turbo Pascal ver. 5.5 by James Fair          │
  8.     ╘════════════════════════════════════════════════════════════════════╛
  9.  
  10.                                Door Converter for
  11.                                    Wildcat 3.0
  12.                                ══════════════════
  13.                                   converts to:
  14.                         QuickBBS, PCBoard v12, PCBoard v14
  15.                       RA, RBBS, DoorWay, GAP, and GTPowerNode
  16.                                ══════════════════
  17.                             (c) Copyright 1990,1991
  18.                                    James Fair
  19.  
  20.  
  21. ══════  Overview:  ══════
  22.  
  23.      Basically, CallDoor is a conversion program written in Turbo Pascal to
  24. Convert Callinfo.bbs (userfile written by Wildcat) to QuickBBS, PCBoard12
  25. and PCBoard14, RA ver 1.0, RBBS, Doorway, GAP, and GT type userfiles. This
  26. will allow Wildcat sysops to run doors written for all of these BBS's. I
  27. wrote it in particular, so that a friend of mine could run the Scrabble
  28. On-Line game (written for QuickBBS) on his Wildcat system. I later added
  29. support for PCBoard ver 12.1 and 14.0, GAP, DOORWAY, and GT. CallDoor has
  30. been tested out on Wildcat versions 2.0x. I have tried to make CallDoor
  31. very fast and at the same time very small. Many converters I have seen are
  32. very large and slower and only convert for one type of Door. PCBCONV for
  33. example. CallDoor is only 45k and converts 8 types of doors for Wildcat!
  34. And it's Fast! I hope you enjoy using it. Version 3.7 now supports Wildcat
  35. ver 3.0 and uses the Door.sys and Userinfo.dat.
  36.  
  37.      If you are using an older version of Wildcat (Some older versions may
  38. write the callinfo.bbs a little differently) and this program does not work,
  39. please just send me a sample copy of your callinfo.bbs and I will be glad to
  40. write a new version of CallDoor to work on your system.
  41.  
  42.  
  43. ╔══ Note ═════════════════════════════════════════════════════════════════════╗
  44. ║ The new version 3.7 of Calldoor will create the EXITINFO.BBS for RA in the  ║
  45. ║ new RA v1.01 format. Use "0" in the command line....See syntax below. Due to║
  46. ║ some special requests, Calldoor ver 3.7 will create the exitinfo and append ║
  47. ║ the users.bbs to actually allow you to run RA as a door from Wildcat. It    ║
  48. ║ will also first read the users.bbs and get the credits, pending, messages   ║
  49. ║ posted, last read, usernumber, and group number for the current user.       ║
  50. ║                                                                             ║
  51. ╚═══ Special Thanks to Thom MacDonald for all his support and beta testing ═══╝
  52.  
  53.  
  54.  
  55.  
  56. ══════  These following files should be included in your zipfile:  ══════
  57.  
  58. CallDoor.exe ===> The executable file to perform the conversion.
  59. Calldoor.cfg ===> The config file required by CallDoor.
  60. CallDoor.doc ===> The file you are reading now.
  61. Register.frm ===> The Registration form for Calldoor v3.7.
  62.  
  63.  
  64.  
  65.  
  66.  
  67. ══════  Installing CallDoor:  ══════
  68.      Installation of CallDoor is quite simple. Just copy CallDoor.exe and
  69. CallDoor.cfg to the same directory that Callinfo.bbs resides. C:\Wildcat
  70. for example. For CallDoor to execute properly it must be in the same
  71. directory as Callinfo.bbs. For Wildcat 3.0 it must be in the same directory
  72. as Door.sys.
  73.  
  74.  
  75.  
  76.  
  77. ══════  CallDoor.cfg:  ══════
  78.      A sample copy of CallDoor.cfg is included in the zipfile. It should look
  79. like this:
  80.  
  81. 1. The Fishing Hole BBS           ( The name of your BBS ) (max 30 characters)
  82. 2. James                          ( Sysops First Name )    (max 15 characters)
  83. 3. Fair                           ( Sysops Last Name )     (max 15 characters)
  84. 4. 129 *  see                     ( A flags to turn on )   (0..255)
  85. 5. 0   *  notes                   ( B flags to turn on )   (0..255)
  86. 6. 0   *  below                   ( C flags to turn on )   (0..255)
  87. 7. 0   *  for these               ( D flags to turn on )   (0..255)
  88. 8. D:\RA                          ( Path to Users.bbs  or Blank )
  89.  
  90. Line 1: This is simply the name of your BBS.
  91. Line 2: The sysop's First name.
  92. Line 3: The sysop's Last name.
  93. Line 4 - 7: *
  94. Line 8: The path to Users.bbs (NOTE => if you do not want to use CallDoor to
  95.         read "Users.bbs" and create Exitinfo.bbs then leave this line blank).
  96.  
  97.  * In version 3.1 of Calldoor I wanted to make it flexible to allow you to
  98.    restrict some of the things a user could get into if you run RA as a door.
  99.    Therefore, I allow you to set the flags you want to give the callers. And
  100.    I read the credits etc from the users.bbs to be set when they log on to
  101.    RA. Let's look at a few examples:
  102.  
  103. Flags, in RA, can restrict a user from certain file areas, echo mail areas, etc
  104. so in order to give you the flexibility to restrict a caller when using RA for
  105. mail you may put the flags in the calldoor.cfg file. Here's the formula.
  106.  
  107. Each flag area consists of 8 flags...
  108.  A flags  X------X     ==> Flag A1 and A8 on
  109.  B flags  --------     ==> All B flags off
  110.  C flags  --------     ==> All C flags off
  111.  D flags  --------     ==> All D flags off
  112.  
  113. for instance, you could have a message area in RA that required the user to
  114. have Flag A1 on before he could enter a message in that particular message area
  115. With the above example this user could enter a message.
  116.  
  117.  What I need from you is a decimal value on lines 4,5,6,and 7 of Calldoor.cfg
  118.  to tell me which flags you want turned on. The number must be between 0 and
  119.  255. Below are the values for each flag.
  120.  
  121.           128   64   32   16   8   4   2   1   ══> Decimal Value for each flag
  122.  A Flags = X    -    -    -    -   -   -   X   ══> Flag 1 and Flag 8 on
  123.  
  124.  simply add the numbers above each flag you want turned on. In this example
  125.  If I wanted flag A1 and A8 on I would enter 129 in line 4 of Calldoor.cfg.
  126.  
  127.  Let's try another one. Let's say you wanted Flags A1,A2 and D8 on. Lines
  128.  4 thru 7 on Calldoor.cfg should say:
  129.    192  (A flags - 1 and 2 on)
  130.    0    (B flags - all off)
  131.    0    (C flags - all off)
  132.    1    (D flags - 8 on)
  133.  
  134.  *****
  135.  In order to use these flags and credits restrictions, put the command line
  136.  parameter "FLAGS" on the command line. Explained below...
  137.  
  138.  Just use your favorite line editor (Qedit or Edlin) for example to change
  139.  the CallDoor.cfg file for your system.
  140.  
  141. ┌── NOTE ──────────────────────────────────────────────────────────────────────┐
  142. │ Starting with Version 3.3 of CallDoor, If you leave lines 4 thru 7 blank,    │
  143. │ Calldoor will look at the current flag settings in RA and use those. In      │
  144. │ other words, If you want to put their flags to a certain setting before they │
  145. │ enter RA, put the numbers on these lines. If you want to just use their      │
  146. │ current flag settings simply leave these lines blank.                        │
  147. └────────────────────────────────────>*<───────────────────────────────────────┘
  148.  
  149.  CallDoor will also first read the "users.bbs" file currently in RA and carry
  150.  over the current credits, calls, group, usernumber, messages posted, last read
  151.  pending, and number of call the user has to "Exitinfo.bbs". Therefore all this
  152.  info in RA is kept up with at all times when running it as a door from Wildcat!
  153.  
  154. ┌── Special Note ─────────────────────────────────────────────────────────────┐
  155. │ If a user does not already exist in "users.bbs" then Calldoor v3.7 will add │
  156. │ him/her as the NEXT AVAILABLE USER NUMBER and the credits, calls, messages  │
  157. │ posted, last read, and pending will ALL BE SET TO "0". You will have to set │
  158. │ them up with the credits, etc with your user editor the FIRST TIME ONLY!!!  │
  159. │ Once they are set up, Calldoor v3.7 will read all the current info from the │
  160. │ users.bbs and keep up accordingly for each consecutive time that user calls.│
  161. │                                                                             │
  162. └─────> Once again, Special Thanks to Thom Macdonald for bug reporting <──────┘
  163.  
  164.  
  165.  
  166.  
  167. ══════  CallDoor Command Line Syntax  ══════
  168.      The correct syntax for calldoor is as follows:
  169.  
  170. Calldoor <doortype> <path> <userfile type> <flags> <#>
  171.    │         │        │           │           │     │
  172.    │         │        │           │           │     │
  173.    │         │        │           │           │     └─> specific .cfg file
  174.    │         │        │           │           │            (or omit)
  175.    │         │        │           │           └─> either the word flags
  176.    │         │        │           │                        (or omit)
  177.    │         │        │           └─> /D or /C (Wildcat 3.0 or 2.xx mode)
  178.    │         │        │
  179.    │         │        └─> path to write userfiles
  180.    │         │
  181.    │         └─> doortype to convert to  (0=QuickBBS/RA/RBBS)
  182.    │                                     (1=PCBoard ver12)
  183.    │                                     (2=Pcboard ver14)
  184.    │                                     (3=DoorWay)
  185.    └> executable file                    (4=GAP)
  186.                                          (5=GT PowerNode)
  187.                                          (6=Wildcat 2.x) **
  188.  
  189.  
  190. <doortype> - can be a 0,1,2,3,4,5,6 see above.
  191. <path>     - is the path where you want the userfile written.
  192. <userfile> - tells CallDoor to use either Door.sys (Wildcat 3.0 userfile)
  193.              or Callinfo.bbs (Wildcat 2.xx userfile)
  194.              "/D" for Door.sys or "/C" for Callinfo.bbs
  195.              (Must be capital letter!)
  196. <flags>    - use this if you want to pass flags and credits in RA.
  197. <#>        - use Cldoor#.cfg instead of Calldoor.cfg.*
  198.  
  199.  * I have added yet another means of setting different restrictions on a
  200.    user when entering RA as a door or mailer etc. If you put a number here
  201.    Calldoor will look for "Cldoor#.cfg" instead of "Calldoor.cfg". Just
  202.    replace the "#" with a number 1..99. For instance if you put a "1" in
  203.    the command line, Calldoor will use "Cldoor1.cfg" instead of Calldoor.cfg.
  204.    This way you may have multiple config files. Use the same format as
  205.    Calldoor.cfg for these, but place different flag settings etc.
  206.  
  207. ** For the new Wildcat 3.0 I have added a doortype 6 to convert to the old
  208.    Wildcat 2.x format (Callinfo.bbs) to allow you to run doors written for them
  209.  
  210. ── NOTE ──────────────────────────────────────────────────────────────────────
  211.  If "Flags" and "#" are not given in the command line, all flags and credits
  212.  default to 0. If you are not using Calldoor to run RA as a door just omit
  213.  these two command line parameters.
  214.  
  215.  
  216.  
  217.  
  218. ══════ Files Generated by Calldoor ══════
  219.  
  220. <doortype> 0 - will write: Dorinfo1.def and Exitinfo.bbs  (QBBS,RA,RBBS)
  221. <doortype> 1 - will write: PCBoard.sys, PCBoard.dat, Users (PCBoard ver 12.0)
  222. <doortype> 2 - will write: PCBoard.sys, PCBoard.dat, Users (PCBoard ver 14.x)
  223. <doortype> 3 - will write: Door.sys (Doorway version)
  224. <doortype> 4 - will write: Door.sys (GAP version)
  225. <doortype> 5 - will write: GTuser.bbs (GT PowerNode)
  226. <doortype> 6 - will write: Callinfo.bbs (Wildcat 3.0)
  227.  
  228.    * RA, RBBS, and QuickBBS use the same "DORINFOX.DEF" user file format
  229.      so use "0" for any of these three you wish to convert to. Version
  230.      3.7 of Calldoor creates the Exitinfo.bbs for RA version 1.01..
  231.  
  232.  
  233. ══════ Command line examples ══════
  234.  
  235. Below is an example to use Calldoor for the On-Line game Scrabble written for
  236. QuickBBS.  ** No flags or credits need to be passed for games. **
  237. example 1:
  238.  
  239. Calldoor 0 C:\WC\DOORS\SCRABBLE /C
  240.    │     │           │           │
  241.    │     │           │           └─> Using Wildcat 2.xx (Callinfo.bbs)
  242.    │     │           │
  243.    │     │           └─> Path to write dorinfo1.def (NOTE no trailing
  244.    │     │                                            backslash needed)
  245.    │     │
  246.    │     └─> Write Quick/RA/RBBS userfile (dorinfo1.def)
  247.    │
  248.    │      
  249.    └> executable file
  250.  
  251.  
  252. ══════════════
  253. Here's an example to use Calldoor for RA as a door and use the flags set in
  254. Calldoor.cfg, Running under Wildcat 3.0
  255. example 2:
  256.  
  257. Calldoor 0 D:\RA /D FLAGS
  258.   │      │   │    │   │
  259.   │      │   │    │   └─> Use flags set in Calldoor.cfg to restrict access
  260.   │      │   │    │
  261.   │      │   │    └─> Using Wildcat 3.0 (Door.sys user file)
  262.   │      │   │
  263.   │      │   └─> Write dorinfo1.def and exitinfo.bbs in D:\RA
  264.   │      │
  265.   │      └─> Write Quick/RA/RBBS userfile
  266.   │
  267.   └─> executable file
  268.  
  269.  
  270. ══════════════
  271. And here's an example to use Calldoor for RA as a door and use the flags
  272. set in "Cldoor2.cfg", Running Wildcat 2.xx.
  273. example 3:
  274.  
  275. Calldoor 0 D:\RA /C FLAGS 2
  276.   │      │   │    │   │   │
  277.   │      │   │    │   │   └─> Use "Cldoor2.cfg" instead of Calldoor.cfg
  278.   │      │   │    │   │
  279.   │      │   │    │   └─> Pass flags and credits into RA
  280.   │      │   │    │
  281.   │      │   │    └─> Using Wildcat 2.xx (Callinfo.bbs user file)
  282.   │      │   │
  283.   │      │   └─> Write dorinfo1.def and exitinfo.bbs in D:\RA
  284.   │      │
  285.   │      └─> Write Quick/RA/RBBS userfile
  286.   │
  287.   └─> executable file
  288.  
  289.  
  290.  
  291. ══════════════
  292. And here's an example to use Calldoor for running a PCBoard ver 14.x door
  293. and running Wildcat 3.0.
  294. example 3:
  295.  
  296. Calldoor 2 D:\RA\DOORS /D
  297.   │      │      │       │
  298.   │      │      │       │
  299.   │      │      │       │
  300.   │      │      │       └─> Using Wildcat 3.0 (Door.sys user file)
  301.   │      │      │
  302.   │      │      └─> Write PCBoard.sys, PCBoard.dat and Users in d:\ra\doors dir.
  303.   │      │
  304.   │      └─> Write PCBoard v 14.x userfiles
  305.   │
  306.   └─> executable file
  307.  
  308.         
  309.    Just type "CALLDOOR" by itself for an example of the correct syntax and
  310. explanation. If you use any incorrect syntax an error will come up with an
  311. explanation of what to do.
  312.  
  313.  
  314.  
  315.  
  316.  
  317. ══════  Sample .bat files  ══════
  318.      Here is a sample bat file for using CallDoor with Wildcat 3.0
  319.  
  320. CD\WC                                ( change dir to where callinfo.bbs is )
  321. CALLDOOR 0 C:\WC\DOORS\SCRABBLE /D   ( CallDoor in Dorinfo1.def mode )
  322. CD\WC\SCRABBLE                       ( change dir to your game program )
  323. SCRABDOR SCRABBLE.CFG                ( execute the On-Line game )
  324. CD\WC                                ( change dir back to wildcat )
  325. CAT                                  ( .bat file to call back up the BBS )
  326.  
  327.  
  328. ****Note**** The Scrabble On-Line game also requires a fossil driver like
  329.              X00.sys, which you may find here on The Fishing Hole BBS or
  330.              other fine BBS's. Wildcat will not run Scrabble without it.
  331.              Simply put X00.sys in your root dir and add a line to your
  332.              config.sys (device = X00.sys). Other QuickBBS doors will not
  333.              require a fossil.
  334.  
  335.  
  336.  
  337. ══════════════
  338. Here's a sample bat file using Calldoor to run RA as a door with Wildcat 2.xx
  339.  
  340. CD\WC                         ( change dir to where callinfo.bbs is )
  341. CALLDOOR 0 D:\RA /C FLAGS     ( CallDoor using flags and credits )
  342. D:                            ( change drives )
  343. CD\RA                         ( change dir to RA )
  344. RA -R -E0                     ( read exitinfo.bbs and run RA )
  345. C:                            ( change drives back to C: )
  346. CD\WC                         ( change dir back to wildcat )
  347. CAT                           ( .bat file to call back up the BBS )
  348.  
  349.    If you have any trouble running this program, please just contact the
  350.    author at one of the numbers listed below.
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.                S T A N D A R D      D I S C L A I M E R
  358.             ═══════════════════════════════════════════════
  359.      The Author of this product will in no event be held liable or
  360.      responsible for direct, indirect, or incidental damages of any
  361.      kind.  By use of this product, you assume full liability from
  362.      the uses of this program.  This software is provided AS IS
  363.      without warranties or any kind.  Use at YOUR own risk.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.                  R E G I S T R A T I O N     I N F O
  370.             ═══════════════════════════════════════════════
  371.      CallDoor is Public Domain Software and may be used without charges
  372.      or fee. However, I have put many hours of work and testing into this
  373.      product to provide Wildcat sysops the ability to run QuickBBS,PCboard
  374.      GAP,Doorway,and GT doors on their system with professional results.
  375.      And to allow them to run RA as a door from Wildcat version 2.XX and 3.0.
  376.      As a sysop I know the costs and work of running a professional looking
  377.      Bulletin Board System. Therefore I do not require a large registration
  378.      fee for the use this program. A registration fee of $10.00 would be
  379.      greatly appreciated for continued use of this product.  With your
  380.      registration you will receive the latest updates and changes of
  381.      this program automatically. And continue to serve your users well.
  382.   ══════════ Please use the file Register.frm for registration info ═════════
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389. ═══════ Revision Information ════════
  390.  
  391. Version 1.0
  392.         This version had only the support for dorinfo1.def. Written for a
  393.         friend that wanted to run the scrabble game on his wildcat system.
  394.         pretty straight-forward and simple. Simple graphics.
  395.  
  396. Version 2.0
  397.         Version 2.0 added support for RA, QuickBBS, RBBS, PCBoard v12 and
  398.         PCBoard v14, DoorWay, GTPowerNode, and GAP. Changed graphics on
  399.         screen with Wildcat menu-type graphics.
  400.  
  401. Version 2.1
  402.         Little Bug Fix on PCBoard v12 and v14 time stamp characters. Added
  403.         a couple of cosmetic changes on some other stuff.
  404.  
  405. Version 3.0
  406.         Added support to write Exitinfo.bbs and read from Users.bbs in RA v1.0
  407.         to enable you to run RA as a door from Wildcat. Lots of changes were
  408.         made here. Lots of work!!
  409.  
  410. Version 3.1
  411.         Small change to users.bbs when user added with Calldoor. Now makes a
  412.         new user the next available user number in RA. Used to use the user
  413.         number in Wildcat. This would cause garbage data between valid user
  414.         records.
  415.  
  416. Version 3.2
  417.         Yes...another oversight on my part. Added support for multiple nodes.
  418.         added two command line parameters for Node number and COMport. Now
  419.         writes dorinfoX.def from the node number you give. If you put a "/N2"
  420.         on the command line it will write the file Dorinfo2.def. 0 through 99
  421.         are now supported.
  422.  
  423. Version 3.3
  424.         Well, I had to back off on the Dorinfo2.def etc. RA version 1.0 does
  425.         not write anything other than "Dorinfo1.def" and therefore Writing a
  426.         Dorinfo2.def caused some problems when exiting RA. Added a new help
  427.         file when you type Calldoor by itself. Backed out on the /N /C command
  428.         line parameters for the reasons stated above. All in all, I feel this
  429.         version has all the little problems licked. Enjoy!
  430.  
  431. Version 3.4
  432.         A couple of changes. I had purposely left the "Sysop Next" option
  433.         as it stood in RA. However, with some it has caused problems. In
  434.         version 3.4 It forces the sysop next (boolean) option to FALSE so as
  435.         not to cause RA (registered) to beep until the sysop hits a key. Also
  436.         added a date and time stamp in the comments section of Exitinfo.bbs
  437.         so you will always know when the last time a user logged onto RA from
  438.         Wildcat! The big one in this version is the additon of FILE LOCKING
  439.         when reading the users.bbs. It appears that if you are using Desqview
  440.         or other multi-tasking software, the users.bbs or usersxi.bbs in RA
  441.         was growing in size. I now lock the files in read only state and deny
  442.         write access during the reading of the user information and release
  443.         it once I am through.
  444.  
  445. Version 3.5
  446.         A small bug fix for the credits when the "flags" option was omitted
  447.         from the command line.
  448.  
  449. Version 3.6
  450.         Added support for the Door.sys and Userinfo.dat created by the new
  451.         Wildcat ver 3.0. True the new Wildcat is supposed to fully support
  452.         mail etc and there may be no need to use RA as a door for mail but
  453.         for the door games CallDoor is just what you need. And as for the
  454.         mail...well just in case......CallDoor to the rescue!!. Enjoy!
  455.  
  456. Version 3.7
  457.         Added a doortype 6 to create the Callinfo.bbs written by Wildcat 2.0
  458.         to allow you to run all the games written for the old Wildcat.
  459.  
  460. ══════════════════════════════════════════════════════════════════════════════
  461.  
  462. I have plans to add support for more door types in the near future. If you
  463. would like to see something in particular...
  464.  
  465.                         Please send Comments or
  466.                            Suggestions to:
  467. James Fair                                  
  468. 813 Bellevue Rd.                            The Fishing Hole BBS (615)646-5550
  469. Nashville, TN 37221                              24hrs - 7 days a Week
  470.  
  471.                ──═════(Thanks for using Calldoor v3.7)════──
  472.