home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / opus / drlk223a.arc / DRLINK.DOC < prev    next >
Text File  |  1989-12-14  |  35KB  |  704 lines
  1.  
  2.  
  3.     DRLINK v2.21 OPUS 1.10 G6 and OPUS 1.03 DOORS Linking Utility
  4.  
  5.                         July 31, 1989
  6.  
  7.                (C) Copyright 1988, 1989, Chris A. Holten
  8.                    COWBOY Country USA!
  9.                    4010 Swanton Street
  10.                    Casper Wyoming, 82609
  11.                    Voice (307) 235-4728
  12.  
  13.       All rights reserved.
  14.  
  15.       This is free for the asking, but is *NOT* Public Domain Software.
  16.       If you paid money for this program, you got screwed. If you sell
  17.       this program you are in violation of the law. If you are caught
  18.       selling it you may even get your ass kicked by one tough Cowboy.
  19.  
  20. SPECIAL THANKS:
  21. --------------
  22.  
  23. A -very- special thanks to the people that have helped so much in
  24. creating in DRLINK v 2.21. There have been many good Opus Sysops that
  25. have given some great ideas, ferreted out bugs, sent file structures
  26. and DOORS to test with, and at times put thier BBS's through some
  27. pretty crazy things helping me develop DRLINK. These folks did more to
  28. make DRLINK work than I did and never flamed me when it crashed thier
  29. systems:
  30.  
  31. 303/2 Craig Edwards, Opus 1.03, XT clone, -wierd- DoubleDOS setup
  32. 303/5 Thomas Lange, Opus 1.03, Tandy 1000, DoubleDOS
  33. 101/200 Cheryl Buzzell, Opus 1.10, 386 DV, Dual Standard HST, 38400 baud
  34. 106/131 Danny Wofford, Opus 1.10, AT, HST, 19200 baud
  35. 114/7 Michael Malone, Opus 1.03, The only normal one of the bunch...
  36. 302/1 Dave Bell, Opus 1.03, AT clone, HST, Flatland cyberpunk, FOSSIL expert
  37.  
  38.  
  39. NOTICE:
  40. -------
  41.   This program is released as is only to be used at your own risk.
  42.   There are no warranties, either expressed or implied that this
  43.   software, you or anyone in your supervision, sight or hailing will
  44.   even come close having this software perform in the manner described
  45.   below. You are only liscensed to use this software if you choose to
  46.   use it at your own risk. Any damage you may or may not incur with the
  47.   use of this program is entirly your fault if you try running this
  48.   software on a computer. Chris Holten, and all users of C's Doghouse
  49.   will not be responsible for this software working on any other system
  50.   than the single (1) Epson Equity III AT computer sitting in C's
  51.   basement at 4010 Swanton ST, Casper WY, 82609.
  52.  
  53.   This Software is free for the asking, but DRLINK is *NOT* released
  54.   into the public domain. The Liscense that you agree to by using
  55.   DRLINK, is that whatever use you put it to, I ask that you not
  56.   attempt to make money off it. This is for fun and to help other
  57.   folks, including BBS Sysops to have fun with. If you can make use of
  58.   DRLINK please do.  Any time you want to show your appreciation for
  59.   the time and effort I and many others have put into developing
  60.   drlink, you can do it by sending DOORS to test with or -accurate- BBS
  61.   file structure documention. I would -greatly- appreciate it. The
  62.   biggest hassle and expense we have had in developing DRLINK is
  63.   running down good BBS file structures and DOORS to test it with. Of
  64.   course, if you must give money, then give it to the OPUS Shanti
  65.   project.
  66.  
  67.   I have put DOORlink together with the goal of providing the OPUS
  68.   community a utility that will allow them to run most any other BBS
  69.   DOOR or other external program they want to. It can be run in command
  70.   line mode, writing the BBS subsystem files that the single DOOR
  71.   requires. When that one door is completed, exit back to Opus to a
  72.   .BBS file, or with DRLINK MENU, up to 100 external programs can be
  73.   set up for a user to choose from. After each DOOR or other external
  74.   program is completed, DRLINK will be returned to, until the user
  75.   either runs out of time, or chooses to exit back to OPUS. Both 40 and
  76.   80 column mode and ANSI/Non-ANSI graphics are automatically supported
  77.   with the DRLINK MENU. The amount of time in each individual DOOR and
  78.   security level for access can be set up when using the DRLINK MENU
  79.   function. If a user is in NON-ANSI mode, none of the DRLINK screens
  80.   will contain ASCII characters over 127. In ANSI mode, IBM Graphics
  81.   are displayed in the opening screen. In menu mode, and with the
  82.   proper modem (Works with a CPI locked at 38400 baud) it is possible,
  83.   by setting up LOCKBAUD and MAXDOORBAUD in the DRLINK.CTL file, to run
  84.   doors that normally won't run at 19200 or 38400 baud. It only works
  85.   with modems that are capable of having the input baud rate changed
  86.   while maintaining a constant CONNECT baud rate. The DOOR will run at
  87.   the CONNECT baud rate, and when the DRLINK MENU is returned to,
  88.   DRLINK will reset the baud back to the LOCKBAUD rate. See the sample
  89.   DRLINK.CTL file for a further explanation of making this work.
  90.  
  91.   If the MENU system is run from the Opus OUTSIDE EXIT <errorlevel> set
  92.   up, Drlink will keep track of the time the user was in the external
  93.   programs, and correct his remaining time in Opus by both/either using
  94.   the -T switch to pass remaining time back to OPUS or by having DRLINK
  95.   update the USER.BBS file (Time on today). By exiting OPUS to run
  96.   DRLINK MENU /B, approximately 140k of memory can be saved as compared
  97.   to running External programs from the usual OPUS shell via a .BBS
  98.   file and ^OCexternal.bat command.
  99.  
  100.   DRLINK seems to work just fine with PCBoard v 11.8a, 12.1, 14.0,
  101.   Wildcat, and GAP doors and -most- RBBS doors. I have stuck in
  102.   routines to write MGW, FORBES, and GT doors. These file structures
  103.   are very simple, and should work, but due to the paucity of DOOR
  104.   programs for these lessor known communications packages, those
  105.   routines haven't been tested <At all>. Most likely you will find some
  106.   doors that just aren't going to work with DRLINK. If so, help us to
  107.   fix it by sending the DOOR or decent documention on what the BBS
  108.   subsystem files is supposed to be that the DOOR is using.
  109.  
  110.   This is what drlink does (or attempts to do anyway):
  111.  
  112.    1. It reads the Lastusxx.bbs file, takes most all of the information
  113.       out of that file (Graphics, Monitor width, length, more?,
  114.       time-parameters etc), combines that information with the
  115.       information in the DRLINK.CTL file to accurately pass on user
  116.       parameters and the remaining time the User has on the System
  117.       (including time till events that you want to force humans off the
  118.       system with). It will also allow you to adjust a users DOOR time
  119.       based on his uploads to your system. I recommend that you set
  120.       both the privel level times and event times (Only the ones you
  121.       want to force the user off the system with) to the *exact* times
  122.       you set them up to in the OPUS.CTL and SCHED.BBS files. You can,
  123.       however, make them something different if you choose to. You
  124.       -must- have a DRLINK.CTL file if you are using with a OPUS 1.03
  125.       system. Since OPUS 1.10 passes the remaining time to the
  126.       Lastusex.bbs file (1.03 doesn't) then use of the DRLINK.CTL file
  127.       is optional with those lucky enough to have OPUS 1.10 systems.
  128.  
  129.    2. Writes the required data files for whatever type DOOR you select.
  130.  
  131.    3. If it is a QuickBBS type Door that requires a QuickBBS command
  132.       line and you use the /E switch, it will write a spawndor.bat that
  133.       will run whatever QuickBBS Doors you should want to run. The
  134.       spawndor.bat file will be written to change drives and
  135.       directories as necessary to run the door, and then allow a Sysop
  136.       to add up to 12 command lines to finish the Spawndor.bat file to
  137.       properly return to OPUS! (Don't forget to add a line in
  138.       DRLINK.CTL to CD \OPUS (Or whatever the OPUS Default directory
  139.       is). The command EXIT is automatically appended to the
  140.       SPAWNDOR.bat file if not run as an outside exit from OPUS and if
  141.       run with the /boutside.bat file, The last statement in the
  142.       SPAWNDOR.BAT file will be the name of the Outside.bat file.
  143.  
  144.    4. Automatically supports Baud Rates as high as 38,400 (even with
  145.       systems running a locked baud, commands to tell DRLINK to lock
  146.       baud are no longer necessary) or the maximum Door Subsystem is
  147.       capable of running,  and still provide automatic detection of the
  148.       local mode and write the correct parameters for operation of the
  149.       DOOR locally. Since OPUS 1.03 sticks a 9600 baud rate in the
  150.       lastusex.bbs file for local mode, it is necessary to check for
  151.       carrier to determine if the caller is local or online. Should a
  152.       9600 baud caller hangup at just -exactly- the right time, it's
  153.       entirely possible that DRLINK will assume a local mode and write
  154.       the DOORS subsystem files for local mode. This can -only- occur
  155.       with OPUS v1.03 and at a 9600 baud rate. If you lock the baud
  156.       rate at 19200 for your 9600 baud modem it will be no problem.
  157.       NOTE: to automatically detect the comport baud rate, DRLINK reads
  158.       the MSB and LSB values of the selected comport and computes the
  159.       required baud rate. If the external program you are running
  160.       screws with those values on exit, then DOORLINK may not compute
  161.       the baud rate correctly (causing wierd things to happen). If you
  162.       find an external program that screws up the comport baud rate
  163.       (MSB and LSB values) on exit, then you won't be able to run that
  164.       program using drlink. Drlink monitors Carrier, and if the Carrier
  165.       is lost, will drop DTR for security, and exit with an errorlevel
  166.       of 1.
  167.  
  168.  
  169. ERROR Messages:
  170.  
  171.      If there is an error in the finding or writing any of the various
  172.      and sundry subsystem files DRLINK uses, you will get a beep and an
  173.      error message attempting to help you isolate the problem. DRLINK
  174.      will then exit with an errorlevel of at least 1. If you have DLOG
  175.      set up in your .CTL file, then the error exit and possible cause
  176.      of the error will be noted in the DRLINK.LOG. Drlink will also
  177.      exit with errorlevel 1 if the user has 0 time or if carrier is
  178.      dropped. If you have DLOG set up in your DRLINK.CTL file, then the
  179.      error exit and possible cause of the error will be noted in the
  180.      DRLINK.LOG. If you are running from command line mode, it would be
  181.      a good idea to trap this errorlevel in your batch file, and exit
  182.      with out running the door. In MENU mode, DRLINK writes the
  183.      SPAWNDOR.BAT file to trap errorlevels and exit back to the BBS.
  184.      IE: The batch file I run Baystreet Bulls in command line mode:
  185.  
  186.            echo off
  187.            drlink /lE:\opus\lastus01.bbs /pe:\doors\motu\ /Cdrlink.prm /U
  188.            if errorlevel 1 goto QUIT
  189.            cd\doors\motu
  190.            baybull bsb.cfg
  191.            :QUIT
  192.            cd \opus
  193.            EXIT
  194.  
  195.     If you are running from MENU mode, DRLINK will trap the Errorlevel
  196.     in the Spawndor.bat file and return back to OPUS in what ever
  197.     manner you have told it to your Spawndor setup in the DRLINK.CTL
  198.     file.
  199.  
  200. DRLINK Command line words (Case insensitive):
  201.  
  202. MENU   Will have Drlink present the User a menu selection of the doors
  203.        available to him, at his security level. MENU will also allow
  204.        you to set the maximum time allowed in each individual DOOR. A
  205.        spawndor.bat file is written by DRLINK with the proper commands
  206.        to execute the DOOR. After each DOOR is completed the
  207.        Spawndor.bat file will return to DRLINK. When the user runs out
  208.        of time or chooses to exit DRLINK, he will be returned back to
  209.        the BBS in what ever manner you have set up in the spawndor
  210.        commands in the DRLINK.CTL file. If you choose to run DRLINK as
  211.        an Outside Exit < errorlevel > function of OPUS, using the
  212.        /BBATNAME.BAT command, DRLINK will pass the users remaining time
  213.        and the baud rate back to the BATNAME.BAT file. It is up to you
  214.        to set up your opus batch file to trap the -Bbaudrate (%1) and
  215.        -Ttimeleft (%2) on your OPUS commandline. (See the /B command
  216.        below). When You run DRLINK MENU you -must- set your batch file
  217.        up to invoke the SPAWNDOR.BAT file that DRLINK writes. IE
  218.  
  219.            DRLINK MENU /U /lc:\opus\lastuse1.bbs /cc:\opus\drlink.prm
  220.            IF ERRORLEVEL 1 GOTO QUIT
  221.            SPAWNDOR.BAT
  222.            :QUIT
  223.            EXIT
  224.  
  225.       Would invoke DRLINK. After DRLINK is exited, if no errors are
  226.       encountered, the SPAWNDOR.BAT file that DRLINK writes will be
  227.       executed. The spawndor.bat file will contain the commands
  228.       necessary to execute the program the user has chosen, and return
  229.       to DRLINK with the same command line that it was originally
  230.       invoked with. Sounds complicated, but run it once and type out
  231.       the SPAWNDOR.BAT file it writes to see how simple it really is.
  232.  
  233.       The F8 key will return the user back to the bbs in MENU mode.
  234.       The F9 key will toggle QUIET (Snoop) in MENU mode.
  235.       The F10 key will drop to DOS in MENU mode.
  236.  
  237.       If you have DLOG uncommented in the DRLINK.CTL file, when in MENU
  238.       mode, DRLINK will keep a log of users, errors, and the external
  239.       programs they executed while in DRLINK.
  240.  
  241. UPDATEUSER This command should -ONLY- be used when you are exiting Opus
  242.            via the Outside Exit < errorlevel > setup in the OPUS.CTL
  243.            file. When used in conjunction with the MENU and /B command,
  244.            the user's record (and just that one record) will be updated
  245.            in the USER.BBS file with the amount of time the user was
  246.            outside + his previous time in OPUS. That way when OPUS is
  247.            ruturned to via the OPUS BBS %1 set in your batch file that
  248.            is used to return the user to opus, all time parameters will
  249.            be correct (not necessary to use %2 (-Ttimeleft)). If you
  250.            screw up and run the UPDATEUSER /Boutside.bat command when
  251.            shelling from OPUS you will munge your USER.BBS file bigger
  252.            than hell. If you don't understand the difference between
  253.            and Outside Exit <errorlevel> command and a shell via an
  254.            embedded command or the Outside RUN command, then don't use
  255.            the UPDATEUSER feature. Garanteed -bad- results if run from
  256.            a shell (even hitting the ESC key at the prompt and running
  257.            a batch file with the UPDATEUSER could munge the USER.BBS
  258.            file.) Neat feature, and quite handy, and if used correctly,
  259.            reasonbly safe, but you've been warned....
  260.  
  261. HELP   Will have drlink give a brief listing of the command line
  262.        switches.
  263.  
  264. QUIET  Will prevent DRLINK from writing to the local screen (Snoop OFF)
  265.        and with PCBOARD and GAP (Generic) doors, write the subsystem
  266.        file with the local screen off flag. The door has to be capable
  267.        of reading this flag and using it to shut the local screen
  268.        writes and beeping off. System X-10 Canada doors and Camelot
  269.        doors (PCBoard) correctly go into QUIET mode (keep the screen
  270.        blank).
  271.  
  272.            DRLINK QUIET (Same as SNOOP OFF in OPUS)
  273.                 Will prevent DRLINK from outputting to local screen.
  274.  
  275.        In MENU mode F9 will toggle the QUIET on and off (to snoop or
  276.        not to snoop...that is the question..).
  277.  
  278. COM2   The default comport for DRLINK is Com1. If you put com2 anywhere
  279.        in the command line, com2 will be used. This overides whatever
  280.        comport you use in the DRLINK.CTL file. If you are running OPUS
  281.        1.10 and choose -not- to use the DRLINK.CTL file, and are
  282.        running on COM2, you -must- use this switch. COM1 is the default
  283.        with out a control file. You can overide whatever Comport is in
  284.        the DRLINK.CTL file by putting COM1 or COM2 on the command line.
  285.        (Making it possible to run from two comports with the same .CTL
  286.        file).
  287.  
  288.            DRLINK COM2
  289.  
  290.                 Will cause DRLINK to use COM2 reguardless of what's in
  291.                 the DRLINK.CTL file.
  292.  
  293. NOTIMER [Command line mode only]
  294.  
  295.        DRLINK pauses for 2 seconds before exiting back to the batch
  296.        file. That is in order for the user to have enough time to read
  297.        his remaining time and upload adjustment factor. If you have a
  298.        slow computer/harddisk then you can put NOTIMER on the command
  299.        line to eliminate the 2 second pause.
  300.  
  301. DRLINK Command Line Switches (Must be preceded with / symbol -- You can
  302.        write mutiple BBS subsystems in different directories):
  303.  
  304. /B   [Use only with MENU combined with Outside EXIT XX in the OPUS.CTL file]
  305.  
  306.      This tells DRLINK to pass time and baud rate parameters back to
  307.      OPUS via the Opus -B and -T switches. You designate the
  308.      outside.bat file that you want the parameters passed back to by
  309.      using the command line:
  310.  
  311.           /Bc:\opus\Outside.bat
  312.  
  313.      Doorlink will then write a spawndor.bat file that will invoke your
  314.      Outside.bat file with the -Bbaud (%1) and -Ttimeleft (%2) passed
  315.      back to it. IE:
  316.  
  317.      In your RUNOPUS.BAT file
  318.  
  319.      :START
  320.      OPUS BBS
  321.      IF ERRORLEVEL 99 goto DRLINK
  322.      other junk
  323.      :DRLINK
  324.      DRLINK /l\opus\lastus01.bbs menu /U /boutside.bat
  325.      IF ERRORLEVEL 1 GOTO START
  326.      SPAWNDOR.BAT   <---Always have a SPAWNDOR.BAT command with MENU
  327.  
  328.      When the user selects O)utside (and you have it set up in your
  329.      BBS.CTL file to cause Opus to exit with an Errorlevel of 99) then
  330.      DRLINK will be executed. After the user makes a menu selection and
  331.      drlink is exited, the SPAWNDOR.BAT file that DRLINK writes will be
  332.      executed. The when the user chooses to return to the bulletin
  333.      board (or runs out of time) the SPAWNDOR.BAT file will invoke your
  334.      Outside.BAT file with:
  335.  
  336.          c:\opus\Outside.bat -Bbaud -TTimeLeft.
  337.  
  338.      If, in your Outside.bat file you have:
  339.  
  340.       rem Ron Bemis BAUD program. If carrier, errorlevel is higher than 0
  341.       Baud.com
  342.       If errorlevel 1 goto Board
  343.       rem if no carrier run your regular runopus.bat file
  344.       runopus
  345.       :Board
  346.       Opus Outside.prm %1 %2 -nf
  347.       if errorlevel 99 goto DRLINK
  348.       REM If a lower errorlevel run the regular RUNOPUS.BAT file
  349.       runopus
  350.       :DRLINK
  351.       DRLINK /l\opus\lastus01.bbs menu /U /boutside.bat
  352.       spawndor.bat
  353.       REM just for safety
  354.       runopus
  355.  
  356.      Then opus will be invoked with:
  357.  
  358.         Opus Outside.prm -Bbaud -Ttimeleft -nf
  359.  
  360.      It's not necessary to use the %2 (Remaining time parameter) if you
  361.      invoke drlink /Boutside.bat UPDATEUSER and have DRLINK update the
  362.      user.bbs file with time used in O)utside. With OPUS 1.10, you don't
  363.      need to mess with time at all. 1.10 keeps track of Outside exit
  364.      time on it's own (the UPDATEUSER will actually mess things up with
  365.      1.10).
  366.  
  367.      Once a user is in the Outside.bat file, he will stay there until
  368.      he logs off and OPUS exits. When he exits OPUS, the normal
  369.      RUNOPUS.BAT file will be executed and wait for another caller. You
  370.      can set up your outside.bat file to do anything you want it to do,
  371.      same as having a second RUNOPUS.BAT file to mess with. (Start
  372.      simple though.)
  373.  
  374.      I use Outside as my .PRM file in for the Outside.bat. It does not
  375.      show the user the LOGO.BBS, Welcome.BBS and Bulletin.BBS files. It
  376.      is also set up to exit after a caller with an errorlevel of 5. All
  377.      other parameters and errorlevels are set up identically to my
  378.      normal BBS.PRM file. That way any errorlevels that the user exits
  379.      with will be passed back to the runopus.bat file when the user
  380.      exits OPUS. If you want to you can trap those errorlevels in your
  381.      RUNOPUS.BAT file and do what ever processing is necessary.
  382.  
  383.  
  384. /C   [Use with both MENU and Command line mode]
  385.  
  386.      Tells Drlink which parameter file to read. If left out, it will
  387.      attempt to read DRLINK.PRM in the default directory. This switch
  388.      is provided in case you have to do something fancy and need more
  389.      than just one drlink .prm file or don't want to have your
  390.      configuration files in the OPUS default directory. If you are
  391.      running OPUS 1.03, You -must- have a DRLINK.PRM file or DRLINK
  392.      will give you an error message to that effect, and won't write the
  393.      subsystem files. If you are running OPUS 1.10, the DRLINK.PRM file
  394.      is optional in command line mode unless you want to adjust a users
  395.      time for uploads or don't mind being called "The Sysop" and having
  396.      your board name as "The BBS". 1.10 Sysops running DRLINK MENU
  397.      -must- have compiled the drlink.ctl file into a .prm file and use
  398.      the /C command.
  399.  
  400.         /Cc:\opus\drlink.prm
  401.      or
  402.         /cf:\contrl\drlinkDD.prm
  403.  
  404.      The documentation for setting up the DRLINK.CTL file and compiling
  405.      it with DRLK_CTL is contained in the sample DRLINK.CTL file. Don't
  406.      forget to compile the .CTL file into a .PRM file before running
  407.      DRLINK.
  408.  
  409. /l   [MENU and command line mode]
  410.  
  411.      Command line switch telling DRLINK where to find the OPUS
  412.      lastusxx.bbs. If you leave this switch off it will default to
  413.      lastuser.bbs in the default directory.
  414.  
  415.        /Lc:\opus\lastuse1.bbs
  416.  
  417.       Tells DRLINK to look for the Lastuser file in c:\opus. The most
  418.       common problem DRLINK users seem to have is putting the /l in front
  419.       of the lastuser.bbs. DRLINK goes off into gagaland if the /l isn't
  420.       there. IE:
  421.  
  422.        /lastuse1.bbs --- gagaland
  423.        /llastuse1.bbs --- drlink is happy as a bug in a rug.
  424.  
  425. /t   [Menu and Command line mode]
  426.  
  427.      Set time to a maximum limit. This will allow you to limit the users
  428.      time to a maximum you want to allow him in the door. If the users
  429.      remaining time on the system is less than the maximum time you want
  430.      to allow in the Door, then the remaining time on the system will be
  431.      passed to the door. If you adjust a users time for uploads (/U),
  432.      then the adjustment ratio will be taken after the time is limited
  433.      with the /T command. (IE, if the users ratio is .6 and you use
  434.      /T10, then the user will get .6*10 or 6 minutes in the DOOR.
  435.  
  436.              /t10
  437.  
  438.       Will set the maximum time in the door to 10 minutes.
  439.  
  440. /u   [Menu and Command line mode]
  441.  
  442.      Factor DOORS time based on Quantity of Uploads. You must have the UL
  443.      time ratios set up in the DRLINK.CTL file if you use this switch. If
  444.      you use this switch in combination with the /T switch, the ratio you
  445.      set up in the DRLINK.CTL file will also ratio the time you allow in
  446.      the door with the /t switch. IE, If you set an UL ratio of .7 up, and
  447.      use a /T20 then the user will recieve .7*20 or about 14 minutes
  448.      maximum time in the door.
  449.  
  450.  
  451. The following subsystem commands can be used in commandline mode. If
  452. you are running in MENU mode, then set up these commands in the
  453. DRLINK.CTL file under the Subsystem command catagory (Setup for MENU
  454. mode is documented in the sample DRLINK.CTL file.)
  455.  
  456. PCBOARD versions 14.0, 12.1 and 11.8a -- DRLINK will write the
  457.      PCBOARD.SYS, USERS, and PCBOARD.DAT files in the designated
  458.      directory. The PCBOARD.SYS file is similiar to the OPUS
  459.      Lastusxx.bbs file, the USERS file will be a 2 record USERS file
  460.      that the first record will be the Sysop's and the Second Record
  461.      will be the users. The PCBOARD.DAT file is akin to the OPUS.PRM
  462.      file (But not hardly). Most PCBoard DOORS only use the PCBOARD.SYS
  463.      file, however a rare few use the USERS file, and some read the
  464.      PCBOARD.DAT file to get the version out of it. Since you could be
  465.      set up with DOORS that need these files and you might have doors
  466.      for all three versions in the same directory, I set up DRLINK to
  467.      write each of these files each time. Lots less hassle than
  468.      screwing around with more command line switches, and it only takes
  469.      a silly millisecond longer.
  470.  
  471. /p   PCBoard doors v 12.1 switch. It should be followed by the full
  472.      pathname that you want the PCB Door to be run from. Since the PCB
  473.      v 12.1 file structure only allows the passing of a 4 digit baud
  474.      rate, unless the DOOR author converts a 1920 baud rate to 19200
  475.      and an 3840 baud rate to 38400 baud, you won't be able to run v
  476.      12.1 doors over 9600 baud. System X-10 Canada Doors and Camelot
  477.      Doors were tested at 19200 baud. None would run at 38400 baud.
  478.  
  479.        /Pe:\doors\motu
  480.  
  481.      Will tell DRLINK to Write the v12.1 PCBOARD.SYS PCBOARD.DAT and
  482.      USERS files in the e:\doors\motu directory. You must then change
  483.      to that directory in your batch file and run MOTU. Example Batch
  484.      file (MOTU.BAT).
  485.  
  486.        DRLINK /lc:\opus\lastuse1.bbs /pe:\doors\motu
  487.        if errorlevel 1 goto QUIT
  488.        cd \doors\motu
  489.        motu
  490.        cd \opus
  491.        :QUIT
  492.        EXIT            <---Don't forget EXIT or you will cause OPUS to
  493.                            make those ridiculous high messages numbers.
  494.  
  495. /4   PCBoard v 14.0 switch. /4 will work in the same manner as the /p,
  496.      except that it will write the PCB v14.0 DOORS sybsystem (PCBOARD.SYS,
  497.      PCBOARD.DAT, USERS) files in the designated directory. Passes a
  498.      baud rate of up to 38,400. (Turbochess 3.0, Othello and Barons are
  499.      the only PCB v 14 doors we could get to run at 38400 baud. We
  500.      tested a few DORPCH35 doors, and none would work at 38400 baud. No
  501.      doubt somewhere there are DORPCH35 doors working just fine at
  502.      38400 baud, but we couldn't find any. The few DORPCH35 doors we
  503.      did test worked just fine at lower baud rates though.
  504.  
  505. /8   PCBoard v 11.8a switch. /8. Same as /p and /4 but files for PCB v
  506.      11.8a PCBOARD.SYS, PCBOARD.DAT and USERS files are written in the
  507.      designated directory. The file structure only allows for the
  508.      passing of a 4 digit baud rate, so unless the DOOR author converts
  509.      a 1920 baud rate to 19200 baud or an 3840 baud rate to 38400 baud,
  510.      you are stuck at 9600 baud with PCB 11.8 doors.
  511.  
  512. /r   RBBS doors switch. it should be followed by the full pathname that
  513.      you keep your RBBS door in: (Passes up to 38,400 baud but we
  514.      haven't found an RBBS door that runs that fast.)
  515.  
  516.       DRLINK /re:\doors\motu\  <--Trailing Backslashes are not required
  517.                                   but shouldn't screw drlink up either.
  518.  
  519.       Will write the necessary RBBS files (RBBS-PC.DEF, MESSAGES and
  520.       DORINFO1.DEF) to run RBBS doors with. In this example the files
  521.       would be written to drive e:, directory \doors\motu. Use a batch
  522.       similiar to the Example for the PCBoard /p switch.
  523.  
  524. The following Switches work in the same manner as RBBS and PCBoard
  525. Switches. (Including the directory name you want to write the DOOR
  526. configuration files to.)
  527.  
  528. /W   WILDCAT  -- /Wc:\doors\wildcat (Maximum of 9600 baud --Maybe higher)
  529. /G   GAP      -- /Gc:\doors\gap\    (Maximum of 38,400 baud --Maybe)
  530. /M   MGW      -- /M\doors\mgw       (Maximum of 38,400 baud)
  531. /F   FORBES   -- /F\doors\forbes    (Maximum of 38,400 baud)
  532. /X   GT       -- /X       <--- without a drive or pathname files are
  533.                            written in default directory for any of the
  534.                            command line switches to call up the DOOR
  535.                            subsystem.
  536.  
  537. /O  OPUS v1.03. /Oc:\opus\ Writes an OPUS v 1.03 LASTUSER.BBS file in
  538.                            the default directory. The Baud rate of the
  539.                            Comport instead of the CONNECT Baud Rate
  540.                            is put into the created lastuser.bbs file.
  541.                            This might be handy if you run a locked baud
  542.                            rate. You can use /o to convert an OPUS 1.10
  543.                            LASTUSXX.BBS file to an OPUS 1.03
  544.                            LASTUSER.BBS file or with 1.03 you can use
  545.                            the /o to make a lastuser.bbs file that has
  546.                            the locked baud rate in it. Baud Rates
  547.                            higher than 19200 cannot be passed to the
  548.                            LASTUSER.BBS file. Some utilities that use
  549.                            the FOSSIL -may- leave the COMPORT in better
  550.                            shape when they exit if they are told to use
  551.                            the locked baud rate via the converted
  552.                            LASTUSER.BBS file. If you are having trouble
  553.                            running OPX or some other opus utility from
  554.                            drlink, try running the utility with the
  555.                            converted LASTUSER.BBS file. No garantees,
  556.                            but it -might- work.
  557.  
  558. QUICKBBS doors:
  559.  
  560. /Q    QuickBBS doors Switch. It should be followed by the full pathname
  561.       that you want to Execute your QuickBBS doors from. (Maximum of
  562.       38,400 baud)
  563.  
  564.       DRLINK /qc:\doors\tw1000
  565.  
  566.       This will write the DORINFO1.DEF file in c:\doors\tw1000 directory.
  567.       NOTE: DRLINK will also use the pathname to obtain the Drive and
  568.       Directory information it needs to write the SPAWNDOR.BAT file. The
  569.       SPAWNDOR.BAT file is necessary for running QuickBBS style doors
  570.       that require a commandline. Be *SURE* to set up the ending batch
  571.       file commands you need to have the spawndor.bat file allow a
  572.       correct return to OPUS in the DRLINK.CTL file.
  573.  
  574. /Efilename
  575.              Tells Drlink where and what the filename of the QuickBBS
  576.              Door .exe file is. (This Example is for TW 9.02, written
  577.              -SPECIFICALLY- for QuickBBS. -- TW 9.03 uses the RBBS
  578.              style DORINFO1.DEF and if you are running TW 9.03, the /E
  579.              switch is -not- to be used.)
  580.  
  581.              /etwq.exe
  582.  
  583.              or something like:
  584.  
  585.              /ec:\doors\bin\twq.exe
  586.                          ^
  587.              if the Doors .EXE file is kept in a different directory from
  588.              the directory you want to execute the QuickBBS door from.
  589.  
  590.  
  591. To run the QuickBBS door, DRLINK will take the information provided by the
  592. /Q and /E switches write a SPAWNDOR.BAT file. That spawndor.bat file will
  593. contain the following:
  594.  
  595. c:                     <----This is based on whatever drive and directory
  596. cd \doors\tw1000       <----you put with the /Q switch
  597. TWQ.EXE baud First Last timeleft graphics        <--From /E switch
  598. + what ever ending spawndor.bat commands you set up in the
  599. DRLINK.CTL file. They could be something like:
  600.  
  601. cd \opus
  602. capture on
  603.  
  604. DRLINK automatically adds the EXIT command as the last statement in the
  605. batch file. Hence DRLINK would write the Spawndor.bat file as follows:
  606.  
  607. c:
  608. cd \doors\tw1000
  609. twq.exe baudrate firstname lastname timeleft graphics
  610. cd \opus
  611. capture on
  612. exit
  613.  
  614. Here is an example batch file (WARQBBS.BAT) that will fire up DRLINK
  615. and then invoke the SPAWNDOR.BAT file to run TW1000 (Verson 9.01 and
  616. 9.02 only!! --NOT-- 9.03 which needs no QuickBBS commandline):
  617.  
  618.   Drlink /lc:\opus\lastuse1.bbs /qc:\doors\tw1000\ /etwq.exe
  619.   spawndor.bat
  620.  
  621. Drlink will write the spawndor.bat file, and then your WAR.BAT file
  622. (Called from OPUS) will invoke it with the spawndor.bat command.
  623.  
  624. ========================================================================
  625. QuickBBS commandline door in MENU mode:
  626.  
  627.       If you are running in MENU mode and want to run a quickBBS door
  628.       that -requires- the quickbbs command line, then you set the /E
  629.       command up as the execute designator. IE in the MENU portion of
  630.       the DRLINK.CTL file, you would have:
  631.  
  632. MENU
  633. 6, /Qe:\doors\, /Ee:\doors\TWQ.EXE, TW v 9.01, 48, 30
  634. END
  635.  
  636. =========================================================================
  637.  
  638. If you use DRLINK with the /Q switch, but don't use the /E switch, DRLINK
  639. will write the DORINFO1.DEF file in the directory you indicate, but it
  640. will not write the SPAWNDOR.BAT file. This command is may be useful for
  641. running other door utilities that only require the DORINFO1.DEF file to
  642. get it's information (TradeWars v903).
  643.  
  644. DOORlink Control File (Read the Sample DRLINK.CTL file for documention
  645.          on correct set up also:
  646.  
  647. NOTE! The DRLINK.CTL file -must- be compiled with DRLK_CTL.EXE into a
  648. .PRM file for DRLINK's use.
  649.  
  650.    You -MUST- have a compiled parameter file when running DRLINK with
  651.    OPUS v 1.03 or with the MENU system with either OPUS 1.03 or OPUS
  652.    1.10.
  653.  
  654.    After preparing the drlink.ctl file, use DRLK_CTL to compile it. IE
  655.  
  656.           DRLK_CTL DRLINKDD.CTL
  657.  
  658.    Will compile the DRLINKDD.CTL file into a DRLINKDD.PRM file. You
  659.    would then invoke drlink with the command DRLINK /Cdrlinkdd.PRM.
  660.    As with DRLINK, the default .CTL file is DRLINK.CTL. If you execute
  661.    DRLINK with no command line, DRLK_CTL will look for a DRLINK.CTL
  662.    file to compile into a DRLINK.PRM file.
  663.  
  664. KNOWN DRLINK PROBLEMS (That I can't/won't fix).
  665.  
  666. Doorlink does not use the FOSSIL. It makes a vanilla DOS call to open
  667. the comport, but like many (most?) external programs, FOSSIL or no
  668. FOSSIL, some combinations of FOSSILS, DOS versions, and BIOS versions
  669. just cause external programs to go out into gaga land. If you have
  670. problems with DRLINK locking up, then try a different fossil. We have
  671. found that with an EPSON EQUIII bios 1.10 DRLINK will lock up tighter
  672. than a drum with OPUSCOMM 5.30. It works just fine with X00 v 1.10 (far
  673. and away the most reliable FOSSIL for OPUS) and BNU. On a Tandy 1000,
  674. DRLINK will lock up with BNU, but works just dandy with OPUSCOMM 5.30
  675. and X00. No doubt there are more computer/dos/fossil combinations that
  676. just aren't going to get along with DRLINK. Hopefully you will find a
  677. FOSSIL that suits your needs, works with your modem and all your
  678. external programs. If all else fails try X00 v 1.08 or X00 v 1.10. No
  679. garantees, but X00 seems to do best on the widest variety of
  680. machine/sofware combinations. As a note, If you think the problem is in
  681. DRLINK, then just boot your computer up with out the FOSSIL anywhere in
  682. memory and run it. The odds are 999,999 in 1,000,000 that DRLINK will
  683. run fine on your IBM or clone computer. The problem is in the FOSSIL
  684. and the way Fossils dink up the comports with many clone computers BIOS
  685. <Sigh>.
  686.  
  687. Please help me to make this OPUS utility better by giving me some
  688. feedback and help with with future revisions. Many Sysops feedback over
  689. this past year of developing DRLINK has really improved it over the
  690. original program. No way can I run down all the BBS subsystem file
  691. structures to program with or adaquately test it with all the various
  692. and sundry doors we are trying to get DRLINK to run on OPUS BBS's. I
  693. need your help, -especially- in running down well documented BBS
  694. subsystem file structures. (Some of mine are hacks, having good
  695. structure documentation from the original software authors of the
  696. various and sundry BBS's would make DRLINK work better).
  697.  
  698. Chris Holten
  699. COWBOY Country USA!
  700. E-Mail -- FidoNet 303/2, 303/5
  701. 4010 Swanton ST.
  702. Casper Wyoming 82609
  703. Voice (307) 234-4728
  704.