home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / DFIX141.ZIP / DOORFIX.DOC < prev    next >
Encoding:
Text File  |  1990-10-14  |  12.8 KB  |  336 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.               ░▒▓▓                           █▀▀▀▀           ▓▓▒░
  7.  ────────────░▒▓▓  ▄▄▄    ▄▄▄    ▄▄▄   ▄▄▄▄  █▄▄▄ ▄▄▄▄▄ ▄  ▄  ▓▓▒░────────────
  8. ─────────────░▒▓▓  █  █  █   █  █   █  █▄▄▀  █      █    ▄▄   ▓▓▒░─────────────
  9.  ────────────░▒▓▓  █▄▄▀  ▀▄▄▄▀  ▀▄▄▄▀  █  █  █    ▄▄█▄▄ ▄  ▄  ▓▓▒░────────────
  10.               ░▒▓▓                                           ▓▓▒░
  11.  
  12.                        DoorFix Door Conversion Utility
  13.  
  14.                             Version 1.40.01 Beta
  15.  
  16.                   Written by Eric Harvey and Donald Huggins
  17.  
  18.             Copyrighted (c) 1990 by Eric Harvey and Donald Huggins
  19.          DoorFix (tm) is a registered trademark of the above license.
  20.  
  21.  
  22.  
  23.  
  24.                              ╔═══════════════════╗
  25.                              ║ TABLE OF CONTENTS ║
  26.                              ╚═══════════════════╝
  27.  
  28. What it Does............................................................ 1
  29.  
  30.  
  31. How to Use DoorFix...................................................... 2
  32.  
  33.  
  34. Command Line Parameters................................................. 3
  35.  
  36.  
  37. Errorlevels Returned for Batch Files.................................... 4
  38.  
  39.  
  40. Configuration File...................................................... 5
  41.  
  42.  
  43. Disclaimer / Bug Reporting.............................................. 6
  44.  
  45.  
  46.  
  47.  
  48. DoorFix Documentation                                                  Page 1
  49.  
  50. ╔═══════════════╗
  51. ║ What it Does  ║
  52. ╚═══════════════╝
  53.  
  54. DoorFix  is  a  utility which reads the Door.sys, Dorinfo1.def, callinfo.bbs,
  55. or Sfdoors.dat files created by many other BBS systems and converts them into
  56. a variety  of  "door support"  files.   It is a program  which was originally
  57. created to run those 'stubborn' doors on our systems.
  58.  
  59. Files Included in Original Distribution Archive:
  60.  
  61. Name of File      │ Description of File
  62. ──────────────────┼───────────────────────────────────────────────────
  63. Doorfix.exe       │ DoorFix Main Executable File
  64. Doorfix.doc       │ DoorFix Main Documentation
  65. Doorfix.cfg       │ Sample DoorFix Configuration File
  66. Changes.log       │ Changes Made to DoorFix
  67. Readme.1st        │ Last Minute Additions <May or may not exist>
  68. SharWare.Txt      │ DoorFix Registration Notice
  69.  
  70. DoorFix will create data files from information found in Door.sys and
  71. DoorFix.cfg for the following doors:
  72.  
  73. Door Type         │  File<s> Created or Updated
  74. ──────────────────┼─────────────────────────────
  75. New Door Sys File │ Door.sys
  76. B.H. Forbes       │ Userfile
  77. Genesis Deluxe    │ Callinfo.bbs
  78. Milton Gameworks  │ Userinfo.txt
  79. RBBS <Old Format> │ Dorinfo1.def
  80. RBBS <New Format> │ Dorinfo1.def
  81. Spitfire          │ Sfdoors.dat
  82. TPBoard           │ Dorinfo1.def
  83. Wildcat 1.12/1.13 │ Callinfo.bbs
  84. Wildcat 2.0+      │ Callinfo.bbs
  85. WWIV systems      │ Chain.text
  86. PCBoard 12.1      │ Pcboard.sys
  87.                   │ PCBoard.dat
  88.                   │ Users
  89. PCBoard 14.x      │ Pcboard.sys
  90.                   │ Pcboard.dat
  91.                   │ Users
  92. QBBS 2.01         │ Exitinfo.bbs
  93.                   │ Dorinfo1.def  {using new RBBS format}
  94. QBBS 2.61         │ Exitinfo.bbs
  95.                   │ Dorinfo1.def  {using new RBBS format}
  96. Remote Access .02 │ Exitinfo.bbs
  97.                   │ Dorinfo1.def  {using new RBBS format}
  98. Phoenix 1.3       │ Info.bbs
  99.  
  100.  
  101.  
  102. DoorFix Documentation                                                  Page 2
  103.  
  104. ╔═════════════════════╗
  105. ║ How to Use DoorFix  ║
  106. ╚═════════════════════╝
  107.  
  108. DoorFix uses the following command line parameters.  These parameters can
  109. be in any  order  on  the  command line and any case,  provided they  are
  110. separated by spaces.  Parameters bounded by < >'s are not mandatory.
  111.  
  112. From DOS:
  113. ─────────
  114. DOORFIX DoorType <CfgFilePath> </Q> </ND> </L> </DB> </R> <LockedBPS>
  115.  
  116.  
  117. NOTE:  DoorFix without any parameters will bring up a help screen.
  118.  
  119. "DoorType" Can be any of the following:
  120.  
  121. "DoorType"  │ Door Format Created
  122. ────────────┼──────────────────────────────
  123. DsNew       │ New Door.Sys
  124. Forbes      │ B.H. Forbes
  125. Genesis     │ Genesis Deluxe
  126. Mg          │ Milton Gameworks
  127. DoorOld     │ RBBS Old Format
  128. DoorNew     │ RBBS New Format
  129. Spit        │ Spitfire
  130. OldWild     │ Wildcat 1.12/1.13
  131. NewWild     │ Wildcat 2.0+
  132. WWIV        │ WWIV
  133. PCB12       │ PCBoard 12.1
  134. PCB14       │ PCBoard 14.x
  135. OLDQBBS     │ QuickBBS 2.01
  136. NEWQBBS     │ QuickBBS 2.61
  137. RA          │ Remote Access 0.02
  138. Phoenix     │ Phoenix 1.3
  139. TPBoard     │ TPBoard
  140.  
  141.  
  142.  
  143. DoorFix Documentation                                                  Page 3
  144.  
  145. ╔═════════════════════════╗
  146. ║ Command Line Parameters ║
  147. ╚═════════════════════════╝
  148.  
  149. "CfgFilePath"  is  the  PATH  <don't include filename!>   to  look  for
  150.   Doorfix.cfg in.  It should be in the format C:\CFGFILEDIR.
  151.  
  152.  
  153. "/Q"  (do not include "s) is an optional parameter. If present, Doorfix
  154.   will run in the  QUIET  mode.  This means that NO screen output will be
  155.   done when DoorFix is in operation (unless a serious error occurred).
  156.  
  157. "/ND"  is  an  optional Parameter.  If present, DoorFix will NOT delete
  158.   the source Door.sys file as it normally does.
  159.  
  160. "/L"   is  an  optional parameter.  If present, DoorFix will keep a log
  161.   of what it does and when it ran.  This switch has several options:
  162.  
  163.    1. /L only to log to DOORFIX.LOG in the current directory. <default>
  164.    2. /L with a Dos environment variable named Dfixlog will set the log
  165.       file to write to the COMPLETE file and pathname specified by this
  166.       variable.  Wherever it points, DoorFix will write the log to.
  167.         (Environment variables are usually set using
  168.            SET DFIXLOG=<complete file/pathname>
  169.         from the Autoexec.bat file.  See Dos manual for more details.)
  170.    3. /L=<full pathname>   Doorfix  will  keep  a  log to the  filename
  171.       specified.
  172.  
  173. "/DB"  is  the  debug mode.   It  will display much info about what the
  174.   program is doing.   If you have a problem, use this option to compile a
  175.   good bug report or fix your problem.   Use the >> <Filename> option  to
  176.   redirect the output to a file if you wish to send us info on bugs.
  177.  
  178. "/R=PROGRAM.EXE_1_5_3" or "/R==1_5_3" will allow you to shell to another
  179.   program from DoorFix and run this program w/ user-definable command line
  180.   parameters.  
  181.     Examples: DOORFIX NEWWILD /R=PROGRAM.EXE_1_5_3
  182.               DOORFIX PROGRAM.EXE /R==1_5_3
  183.  
  184.     Here is the table for what the above numbers stand for:
  185.     1 : User First Name          6 : ANSI Status (0=off,1=on)
  186.     2 : User Last Name           7 : User Record Number
  187.     3 : Time Left in Mins.       8 : User Password
  188.     4 : Baud Rate                9 : User Security Level
  189.     5 : Comm Port (1,2,etc...)  10 : Calling from (all spaces deleted)
  190.  
  191.   In the First Example, Doorfix would convert source file type to new format
  192.   of callinfo.bbs then would shell to run Program.exe with three command line
  193.   parameters-#s corresponding to those given above.  Up to 9 may be entered
  194.   in 1_2_3,etc... fashion on the command line.
  195.  
  196.   In the second Example, Doorfix would only read in the info, not converting
  197.   anything, and shell out to run Program.exe w/ same command line (note extra
  198.   "=" when ONLY shelling and that PROGRAM.EXE may be any valid complete or
  199.   partial path to a program to run).
  200.  
  201. "LockedBPS"  is  another optional parameter.   If present, DoorFix will
  202.   override the  baud  rate found in the Door.sys file and replace it with
  203.   the one you specify here. This comes in handy for those HST/HAYES, etc.
  204.   users who lock their baud rate/com port.
  205.  
  206. ********
  207.  
  208. Special note about Locked Baud rate when using PCBoard 12.1 doors.
  209.    THEY WILL NOT (!!) work above 9600 BPS.  The configuration does not allow
  210.    more than 4 characters to describe the baud rate.  Guess what?  19200 has
  211.    more than 4 characters and hence will not work.
  212.  
  213. ********
  214.  
  215.  
  216.  
  217. DoorFix Documentation                                                  Page 4
  218.  
  219. From a Batch File:
  220. ──────────────────
  221.  
  222. In most scenarios, DoorFix will be run from a batch file.  We have
  223. setup errorlevels DoorFix will exit with upon encountering certain
  224. processing errors.  You can check these in your calling batch file.
  225. Doorfix Will exit with the following errorlevels:
  226.  
  227. Errorlevels  │   Meaning
  228. ─────────────┼───────────────────────────────────────────────────
  229. errorlevel 0 │ Doorfix ran successfully.  No Errors encountered.
  230. errorlevel 1 │ Source file for conversion not found.
  231. errorlevel 2 │ Doorfix.Cfg not found.
  232. errorlevel 3 │ Invalid Command Line.
  233. errorlevel 4 │ Could not create file.
  234. errorlevel 5 │ Error in calling routine for PCBoard.  (Debugging)
  235. errorlevel 6 │ Detect attempt to run PCBoard 12.1 at locked baud above 9600.
  236. errorlevel 7 │ Unknown conversion source file type.
  237.  
  238.  
  239.  
  240. DoorFix Documentation                                                  Page 5
  241.  
  242. ╔════════════════════╗
  243. ║ Configuration File ║
  244. ╚════════════════════╝
  245.  
  246. Config File:
  247.  
  248.      You must have a file called Doorfix.cfg present in the same directory as
  249. Doorfix  to create certain door support files.  A sample doorfix.cfg file has
  250. been included. This file consists of:
  251.  
  252. Line  1 - Board Name
  253. Line  2 - Sysop First Name
  254. Line  3 - Sysop Last  Name
  255. Line  4 - Registration Number or NONE
  256. Line  5 - Path to Main BBS   Directory
  257. Line  6 - Path to BBS Gfiles Directory
  258. Line  7 - Doortype - Either  DOORSYS,  DORINFO,  NEWWILD,  SPITFIRE, or OLDWILD.
  259.           DOORSYS  will tell Dfix  to  convert  from  Door.sys,  DORINFO will do
  260.           the  same  for  Dorinfo1.def,  NEWWILD will tell  Dfix to convert from
  261.           Wildcat   Callinfo.bbs 2.0+   while   OLDWILD   will  do  the same for
  262.           Wildcat 1.13.  SPITFIRE  will  tell  Dfix to convert from Sfdoors.dat.
  263. Line  8 - Path  to  Output files  to  <NOT Filename>.   All converted files will
  264.           be written to this directory.   Enter NUL here if you wish files to be
  265.           output to the current directory.
  266. Line  9 - Path to Input files from.   Same as above except this is an input path.
  267. Line 10 - Default Quiet mode.   Either TRUE or FALSE.  If True Dfix will operate
  268.           in  quiet  mode every time it is run,  otherwise it will display info.
  269.           The command line switch overrides this.
  270. Line 11 - Com Port # (1-4)
  271.  
  272.      This config file may now have comments to the right and below the 8 lines
  273. of data.   Anything right of the ';' comment character will be ignored.  After
  274. the first 8 lines of the file,  you may enter as many lines of comments as you
  275. wish.  See example Cfg file for additional information.
  276.  
  277.  
  278.  
  279.  
  280. Help:
  281.  
  282.   DoorFix has a few help screens which can be accessed via the ? command line
  283. parameter or just running DoorFix w/o any command line parameters.
  284.  
  285.  
  286.  
  287.  
  288. DoorFix Documentation                                                  Page 6
  289.  
  290. ╔════════════╗
  291. ║ Disclaimer ║
  292. ╚════════════╝
  293.  
  294.     This program is guaranteed to do absolutely nothing except take up
  295. disk space.   Use it at your own risk.  We don't ask anything for this
  296. program except that you enjoy it.   Anyway, if it breaks- don't ask us
  297. to fix it!  If you can't agree to these simple terms - do NOT use this
  298. program and DELETE it immediately!  Permission is granted to rearchive
  299. this  program  and  reproduce it in any manner provided all the  files
  300. listed in the beginning of this file are included.
  301.  
  302. ╔═════════════════════╗
  303. ║ Credits/Bug Reports ║
  304. ╚═════════════════════╝
  305.  
  306.     If  you  find  any  bugs, want another door format added, or  have
  307. suggestions on how to improve Doorfix, please let us know  about them.
  308. Also,  we  will be glad to help out with any problems you may have  in
  309. setting it up. We may be reached at the following BBS numbers, through
  310. any of the Tag related echoes, or mail on any of the Tag Alpha boards.
  311.  
  312. Boards to call for support/New Versions:
  313.  
  314. Name                | BBS Number   | Fidonet Node #  | Desc
  315. ──────────────────────────────────────────────────────────────────────
  316. Just For Fun BBS      804-793-6094   1:264/610         Development Site
  317. The Hugman's BBS      804-793-0950   1:264/613         Development Site
  318. The Late Night BBS    804-685-1602   1:264/611         Alpha Test Site
  319.  
  320. It has been suggested that we setup an echo for DoorFix support.
  321. If we receive enough support/replies from you, we will setup an echo.
  322. If you desire this, please let us know, that's the only way you'll ever
  323. get it!
  324.  
  325. Lastly, we desperately need more up-to-date BBS interface structures
  326. if we are to be able to support more of you, so please send them via
  327. netmail to either Development Site or post them in the DOORWARE echo.
  328. Do not feel left out if your BBS type isn't listed or supported, get
  329. involved and send us your structure(s) and we will happily add support
  330. for you.  Also, if you are in need of a reverse utility (i.e. one that
  331. doesn't already start with one that is allowed as an input and produces
  332. something that you have structures for), send us the structures and we'll
  333. add it to DoorFix and also provide you with your own personalized utility.
  334.  
  335.  
  336.