home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / bbsdoors / 2amdoor.arc / 2AMDOOR.DOC next >
Text File  |  1989-05-28  |  33KB  |  828 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                                                 2AMDOOR
  13.  
  14.                                                   A fast door interface
  15.                                                                 utility
  16.                                                             for 2AM-BBS
  17.  
  18.  
  19.                                        Copyright (c) 1989, Dave Maynard
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                                           Files included in 2AMDOOR.ZIP
  36.  
  37.  
  38.                                                             2AMDOOR.EXE
  39.                                                             2AMDOOR.DOC
  40.                                                              README.DOC
  41.                                                               ORDER.DOC
  42.                                                             RELEASE.DOC
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                                                         2
  50.  
  51.                                    Contents
  52.  
  53.  
  54.          1.  INTRODUCTION TO 2AM-BBS JUMP DOORS
  55.              A.  What is a jumpdoor . . . . . . . . . . . . . . . . .  3
  56.              B.  How to install jumpdoors . . . . . . . . . . . . . .  4
  57.              C.  Information passed to a jumpdoor by 2AM-BBS. . . . .  5
  58.              D.  Other Door systems . . . . . . . . . . . . . . . . .  6
  59.  
  60.  
  61.          2.  2AMDOOR INSTALLATION
  62.              A.  Single port BBS. . . . . . . . . . . . . . . . . . .  7
  63.              B.  Multi-port BBS . . . . . . . . . . . . . . . . . . .  8
  64.  
  65.  
  66.          3.  2AMDOOR OPERATION - PRODUCE OUTPUT FILES
  67.              A.  RBBS . . . . . . . . . . . . . . . . . . . . . . . .  11
  68.              B.  WILDCAT. . . . . . . . . . . . . . . . . . . . . . .  11
  69.              C.  PCBOARD. . . . . . . . . . . . . . . . . . . . . . .  11
  70.  
  71.  
  72.          4.  2AMDOOR OPTIONS - HANDLES AND LOG FILES
  73.              A.  Allow use of handles in jumpdoors. . . . . . . . . .  12
  74.              B.  Maintain a 2AMDOOR log file. . . . . . . . . . . . .  12
  75.  
  76.  
  77.          5.  TROUBLE YOU CAN GET INTO . . . . . . . . . . . . . . . .  13
  78.              A.  With error messages  . . . . . . . . . . . . . . . .  13
  79.              B.  Without error messages . . . . . . . . . . . . . . .  13
  80.  
  81.  
  82.          6.  EXAMPLES
  83.              A.  Czar wars  . . . . . . . . . . . . . . . . . . . . .  15
  84.              B.  Casino . . . . . . . . . . . . . . . . . . . . . . .  15
  85.              C.  Bad example! . . . . . . . . . . . . . . . . . . . .  16
  86.  
  87.          7.  REGISTRATION AND BACKGROUND
  88.              A.  Technical Support & Registration . . . . . . . . . .  17
  89.              B.  References . . . . . . . . . . . . . . . . . . . . .  17
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.                                                                         3
  97.  
  98.     1A.   WHAT IS A JUMPDOOR?
  99.  
  100.  
  101.     A jumpdoor is a program that may be run 'outside' of 2AM-BBS. Normally
  102.     a door program was written to be an on-line game that the users of your
  103.     BBS can play, however there are many door programs that are not games,
  104.     but are user - accessible utilities. A program to view the contents of
  105.     compressed format files, is an example of this type of door. The
  106.     quantity and variety of door programs written to be on-line games is
  107.     tremendous. In short, a jumpdoor program becomes an extension of your
  108.     BBS, and adds capabilities to it! The only real constraints placed on a
  109.     jumpdoor program is that they fit in memory, and can communicate with
  110.     the modem.
  111.  
  112.     2AM-BBS has all of the capabilities needed to run as many doors as you
  113.     want. Each of the doors can also be assigned 'security' levels, so that
  114.     if you wish, only selected users can utilize the doors. Basically, the
  115.     way that 2AM-BBS interfaces to door programs is identical to most BBS
  116.     systems. Here are the steps:
  117.  
  118.  
  119.  
  120.                      TABLE I - STEPS OF RUNNING A JUMPDOOR
  121.     ______________________________________________________________________
  122.  
  123.     1. A user with access to the door selection choices a jumpdoor
  124.     selection.
  125.  
  126.     2. Control of the BBS is passed to a SysOp configured file that
  127.     contains the jumpdoor menu, as well as instructions for the BBS to
  128.     complete when a door is selected. (PASSAGES.DAT)
  129.  
  130.     3. Upon completion of the door selection, 2AM-BBS creates a file with
  131.     information related to the user 'going through the door'. (JUMPER.DAT)
  132.     This file contains information like the users name, time remaining on
  133.     the board, if the user has graphics capability, etc.
  134.  
  135.     4. The SysOp configured file (PASSAGES.DAT) normally will invoke a
  136.     batch file that will:
  137.  
  138.                 a) Turn on a carrier detection program (for protection)
  139.                 b) Convert the 2AM-BBS JUMPER.DAT file into a format
  140.                 compatible with the door program.
  141.                 c) Move to the directory where the door program is located.
  142.                 d) Start up the door program.
  143.                 e) Upon termination of the door program, de-activate the
  144.                 carrier detection program.
  145.  
  146.     5. Control will be automatically be returned to 2AM-BBS at the
  147.     completion of the above steps (the batch file invoked by PASSAGES.DAT)
  148.     ______________________________________________________________________
  149.  
  150.  
  151.  
  152.  
  153.                                                                          4
  154.  
  155.  
  156.     It is important to note that during the time that the jumpdoor program
  157.     has control of the machine that attention must be paid to the
  158.     'protection' you have provided. When the door program is running, all
  159.     of the 'bullet-proof' software of 2AM-BBS is not being run, and it is
  160.     up to you to insure that a user cannot get himself into trouble by
  161.     using the doors.
  162.  
  163.  
  164.  
  165.     1B.  HOW TO INSTALL JUMPDOORS
  166.  
  167.     Jumpdoors are easy to install, and not always easy to get running.
  168.     There is complete information on how to install a jumpdoor in the
  169.     2AM-BBS system in the SysOps Manual, pages 11-1 to 11-3 READ IT!.
  170.  
  171.     Basically, it's a good idea to keep each of the door programs, and its
  172.     support files in a separate directory than any of the 2AM-BBS required
  173.     directories. I prefer to have all of my door directories as
  174.     sub-directories of BBS\JUMP. For example the game Phantasia is located
  175.     in C:\BBS\JUMP\PHANT. There is no real need for this structure, but it
  176.     sure helps to keep things straight on the board.
  177.  
  178.     So, lets say that you are going to install Phantasia as a jumpdoor on
  179.     your BBS. First make the C:\BBS\JUMP\PHANT directory, then un-compress
  180.     the files into that directory. THEN READ ALL OF THE DOOR'S
  181.     DOCUMENTATION! Each door author does things differently, and what
  182.     worked before to get a door going may not work this time!
  183.  
  184.     Some doors have a separate utility program that must be run first.
  185.     Quite often, these utility programs will create the data files needed
  186.     by the door program, and perhaps set up your customized game. Be sure
  187.     to run the configuration program first, if the door you are installing
  188.     has one. (Phantasia has a program called SETUP.EXE)
  189.  
  190.     Most jumpdoor programs can be run in a local mode. Its a good idea to
  191.     do this, and get used to the game. You don't have to be an expert on
  192.     the game, but your users will expect you to know something about it,
  193.     and you will also need to know if its working correctly. This is also a
  194.     good way to find out if you have all of the jumpdoor's support files,
  195.     if the setup you may have done is correct, and what type of maintenance
  196.     will be expected of you during the course of the game.
  197.  
  198.     Now that you are sure that the door program is installed on your PC
  199.     correctly, it's time to tell 2AM-BBS where the program is, and what to
  200.     do when a user selects it. All that 2AM-BBS knows about a door program
  201.     is contained in the file called PASSAGES.DAT located in the \BBS\JUMP
  202.     directory. This file is not needed for your BBS to run, so you may not
  203.     even the file on the disk. If not, it can be created with any ASCII
  204.     text editor as shown in the 2AM-BBS SysOps manual.
  205.  
  206.  
  207.                                                                         5
  208.  
  209.  
  210.  
  211.     There is not too much information that the PASSAGES.DAT file contains
  212.     about the door programs. You must decide upon a privilege level for use
  213.     in the door (normally a privilege level of 1 is available to all
  214.     users). Normally, I do not allow all users to access a new door, but
  215.     reserve it for trusted users that have agreed to assist in a little
  216.     door checkout (and leave E-Mail about the results if I'm not around!).
  217.  
  218.     Most door programs will not have the LOCAL command turned on. Since
  219.     most doors programs are for remote users, the LOCAL command should be a
  220.     0. The third piece of information in PASSAGES.DAT is a DOS command or
  221.     file name to execute, when the door is selected (as in step 4 above).
  222.     Almost always this is the name of a batch file. For Phantasia, I use a
  223.     batch file called PHANT.BAT. PAY ATTENTION TO THE DISCUSSION ABOUT THE
  224.     " /C" AND THE "%" IDENTIFIERS IN THE SYSOPS MANUAL PARAGRAPH 11.1.1!
  225.     This can be easily ignored, and when ignored, almost nothing will work
  226.     the way you think it should!
  227.  
  228.     If you are running a 2 port BBS, be sure you include the PORTNUM
  229.     variable at the end of the PASSAGES.DAT command line. You will need
  230.     this PORTNUM value in the batch file you are going to run!
  231.  
  232.     Also, don't get too carried away with the comment line(s) after the
  233.     jumpdoor entry. You can only have two, and ALL of the comment line is
  234.     included in the JUMP.LOG file created by 2AM-BBS, sometimes causing a
  235.     real strange looking validator log file.
  236.  
  237.     Finally, there is a bug in version 3.0 that occurs when you have more
  238.     than 8 doors included in the PASSAGES.DAT file. The selection menu
  239.     displayed when the user does a "S" (show) command, gets shifted to the
  240.     left a couple of places. It doesn't cause any harm, just looks funny
  241.     (sorry Neil!).
  242.  
  243.  
  244.  
  245.     1C.  INFORMATION PASSED TO A JUMPDOOR BY 2AM-BBS
  246.  
  247.     2AM-BBS produces a file called JUMPER.DAT (or JUMPER2.DAT for a
  248.     multi-node system) when a jumpdoor is activated. This file provides
  249.     user information to the door program in order for it to run. In version
  250.     3.0 of 2AM-BBS, there are 17 lines of information about the user
  251.     created. This information includes things like the baud rate, users
  252.     handle, if the user has graphics, where the user is calling from, etc.
  253.  
  254.  
  255.  
  256.  
  257.                                                                         6
  258.  
  259.  
  260.     1D.  OTHER DOOR SYSTEMS
  261.  
  262.     This is where the program 2AMDOOR.EXE comes into play. Since 2AM-BBS is
  263.     a relatively new type of board, the vast majority of existing door
  264.     programs are built to interface with other types of BBS's. I wrote
  265.     2AMDOOR to serve as an interface between 2AM-BBS and WILDCAT, RBBS, or
  266.     PCBOARD. The three types of interface files produced allow any 2AM-BBS
  267.     to run a huge selection of door software.
  268.  
  269.     Not all of the information passed along by the JUMPER.DAT file is what
  270.     is required by one of the other types, and also, some additional
  271.     information is required by the other types. Where possible, I have
  272.     calculated the correct information and put it into the 'target' file.
  273.  
  274.     Each different type of BBS creates a file that is a different structure
  275.     from the other, it is also named differently. The following table shows
  276.     the correct output file names for each type of door currently supported
  277.     by 2AMDOOR:
  278.  
  279.  
  280.  
  281.             TABLE II - PROPER OUTPUT FILE NAMES FOR EACH BOARD TYPE
  282.     ______________________________________________________________________
  283.  
  284.                      DOOR                   WANTS TO READ
  285.                      TYPE:                  A FILE NAMED:
  286.                     --------------------------------------
  287.                      WILDCAT  .............  CALLINFO.BBS
  288.                      PCBOARD  .............  PCBOARD.SYS
  289.                      RBBS     .............  DORINFOX.DEF
  290.  
  291.                     (X stands for the port number: 1, or 2)
  292.     ______________________________________________________________________
  293.  
  294.  
  295.     It's important to know the above relationship, since 2AMDOOR will not
  296.     automatically produce the correct file name for you. It will create a
  297.     file named anything you want!
  298.  
  299.     Some door programs expect to see more than the basic user information
  300.     file. 2AMDOOR will NOT create these for you. This is a list of what a
  301.     door program MAY expect to see for each type. The door program also may
  302.     NOT expect to see them. Normally if the door expects to see one or more
  303.     of the following files, the documentation will tell you. If the
  304.     documentation doesn't tell you, sometimes you will get an error message
  305.     from the door program telling you that it expected something. Other
  306.     times, it just won't work, and you can only guess why. I have about 3
  307.     of these that I'm still playing around with.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.                                                                          7
  316.  
  317.  
  318.     2. 2AMDOOR INSTALLATION
  319.  
  320.     Installation of the 2AMDOOR program is extremely easy! You just need
  321.     the 2AMDOOR.EXE file in your \BBS\JUMP directory. Actually, it could be
  322.     just about anywhere, since full path names are supported by 2AMDOOR.
  323.     Just make sure that wherever you locate the program, that the proper
  324.     path names are passed to it for locating the input file (JUMPER.DAT)
  325.     and the output files (one of the three mentioned above).
  326.  
  327.     If you elect the LOG option, 2AMDOOR will create a file called
  328.     DOORLOG.TXT in the same directory that its located in. (more on the
  329.     options latter on).
  330.  
  331.  
  332.     2A.  SINGLE PORT OPERATION
  333.  
  334.     In a single port operation, there is no need to specify that the
  335.     parameter PORTNUM be passed from the PASSAGES.DAT file (see the 2AM
  336.     sysops manual section 11). Also, since there is only one possible port
  337.     that originated the call, you do not need to include a decision in your
  338.     batch files based upon the PORTNUM value. The following is a good
  339.     example of a batch file used to create a WILDCAT door for the Phantasia
  340.     game:
  341.  
  342.  
  343.  
  344.                    TABLE III - SAMPLE SINGLE PORT BATCH FILE
  345.     ______________________________________________________________________
  346.  
  347.         echo off
  348.         cls
  349.         cd\bbs\jump
  350.  
  351.           echo  SINGLE PORT IN USE
  352.           echo  > com1
  353.           echo  Starting the jump now! > com1
  354.           echo  > com1
  355.           echo  Using 2AMDOOR to convert to WILDCAT format > com1
  356.           2amdoor wildcat jumper.dat d:\bbs\jump\phant\callinfo.bbs h l
  357.           cd\bbs\jump\phant
  358.           echo  > com1
  359.           echo Copying the data files to Ram Disk for speed > com1
  360.           copy *. e:\phant
  361.           COPY BULLETIN.TXT COM1:
  362.           echo  > com1
  363.           echo Starting up the game > com1
  364.           phant 1 WILDCAT
  365.           rem Copying the datafiles back to the hard disk
  366.           copy e:\phant\*. d:\bbs\jump\phant
  367.  
  368.     ______________________________________________________________________
  369.  
  370.  
  371.  
  372.                                                                         8
  373.  
  374.  
  375.  
  376.     What appear to be pretty dumb commands "ECHO > COM1" really have a
  377.     <ALT-255> character just in front of the ">" symbol. This gives the
  378.     effect of double spacing the text lines to the user on the other end of
  379.     the comm port.
  380.  
  381.  
  382.     2B.  MULTI PORT BBS
  383.  
  384.     The basics of a batch file for a multi port system is basically the
  385.     same as above except there has to be a way to distinguish between port
  386.     one and port two. 2AM-BBS takes care of this for you by allowing the
  387.     use of the variable PORTNUM to be passed to a batch file as a command
  388.     line parameter. Based upon the value of PORTNUM, your batch file can do
  389.     the right things to the right port, as well as tell 2AMDOOR which
  390.     JUMPER.DAT file to use (JUMPER.DAT or JUMPER2.DAT)
  391.  
  392.  
  393.  
  394.  
  395.                                                                         9
  396.  
  397.  
  398.            TABLE IV - SAMPLE MULTI PORT BATCH FILE (NEVER BEEN RUN!)
  399.     ______________________________________________________________________
  400.  
  401.         echo off
  402.         cls
  403.         cd\bbs\jump
  404.  
  405.         IF %1 == 1, GOTO PORT1
  406.         IF %1 == 2, GOTO PORT2
  407.         GOTO END
  408.  
  409.         :PORT1
  410.           echo  PORT ONE ACTIVE
  411.           echo  > com1
  412.           echo  Starting the jump now! > com1
  413.           echo  Using 2AMDOOR to convert to WILDCAT format > com1
  414.           2amdoor wildcat jumper.dat d:\bbs\jump\phant\callinfo.bbs h l
  415.           cd\bbs\jump\phant
  416.           echo  > com1
  417.           echo Copying the data files to Ram Disk for speed > com1
  418.           copy *. e:\phant
  419.           COPY BULLETIN.TXT COM1:
  420.           echo  > com1
  421.           echo Starting up the game > com1
  422.           phant 1 WILDCAT
  423.           rem Copying the datafiles back to the hard disk
  424.           copy e:\phant\*. d:\bbs\jump\phant
  425.           GOTO END
  426.  
  427.         :PORT2
  428.           echo  PORT TWO ACTIVE
  429.           echo  > com2
  430.           echo  Starting the jump now! > com2
  431.           echo  Using 2AMDOOR to convert to WILDCAT format > com2
  432.           2amdoor wildcat jumper2.dat d:\bbs\jump\phant\callinfo.bbs h l
  433.           cd\bbs\jump\phant
  434.           echo  > com2
  435.           echo Copying the data files to Ram Disk for speed > com2
  436.           copy *. e:\phant
  437.           COPY BULLETIN.TXT COM1:
  438.           echo  > com2
  439.           echo Starting up the game > com2
  440.           phant 1 WILDCAT
  441.           rem Copying the datafiles back to the hard disk
  442.           copy e:\phant\*. d:\bbs\jump\phant
  443.           GOTO END
  444.  
  445.         :END
  446.     ______________________________________________________________________
  447.  
  448.  
  449.  
  450.  
  451.  
  452.                                                                          10
  453.  
  454.  
  455.  
  456.     This is only an example of multi port operation. I don't run multi
  457.     port, but have experimented around a little running mine that way, and
  458.     I think this is a pretty close approximation as to what it should be.
  459.     If someone develops a good example of a multi port batch using 2AMDOOR,
  460.     please send along a copy! You even could attempt to use the first
  461.     parameter (%1) in the JUMPER.DAT portion of the command line, that way
  462.     you could support any port number that came along.
  463.  
  464.     Actually, there is a problem with this particular method of running
  465.     Phantasia. The batch file should check the current status of the RAM
  466.     disk files before allowing another user to copy old ones in. Also, my
  467.     machine doesn't have enough memory (only 640k) to allow two copies of
  468.     Phantasia, so I guess I'll never have to figure that one out.
  469.  
  470.     The point that I really am trying to make in all of this is that
  471.     2AMDOOR will support as many ports as you want to. Notice in the above
  472.     multi port example, that JUMPER2.DAT was passed to 2AMDOOR, not
  473.     JUMPER.DAT. 2AMDOOR really doesn't care what the input file name is, it
  474.     will try to open it and read it, no matter what or where it is.
  475.  
  476.  
  477.  
  478.  
  479.                                                                         11
  480.  
  481.  
  482.  
  483.     3.  2AMDOOR OPERATION - PRODUCE OUTPUT FILES
  484.  
  485.     The product of 2AMDOOR is an output file. Right now (release 1.0) it
  486.     can support three output file structures, RBBS, WILDCAT, and PCBOARD.
  487.     The object of these output files is of course to satisfy the door
  488.     program's requirements. For example, if you have a door that want to be
  489.     run on a WILDCAT BBS, then you must tell 2AMDOOR to produce a WILDCAT
  490.     format output file (WITH THE CORRECT FILE NAME!). Unlike several other
  491.     door converters, wherever I could use 'live' data (from the JUMPER.DAT
  492.     file) I did. Often, this meant a small amount of decision making in the
  493.     converter software, since different door files have different
  494.     information in them.
  495.  
  496.  
  497.  
  498.     3A.  RBBS
  499.  
  500.     You must tell 2AMDOOR what format output file you want it to produce.
  501.     In this particular case, you must put RBBS (not case sensitive) as the
  502.     first parameter following the program name. This is simply a message to
  503.     2AMDOOR, and there should be no path name associated with RBBS. If you
  504.     enter a name that 2AMDOOR does not support, you will be told on the
  505.     screen, as the program starts.
  506.  
  507.     The second parameter must be the full path and file name for the
  508.     JUMPER.DAT file you are using. If 2AMDOOR cannot find it, you will get
  509.     an error message on the screen.
  510.  
  511.     Make sure that the output file name you specify is proper for RBBS
  512.     (DORINFOX.DAT). If you enter this name wrong, 2AMDOOR will produce the
  513.     wrong file. It will simply produce whatever you tell it to call the
  514.     file.
  515.  
  516.  
  517.     3B.  WILDCAT
  518.  
  519.     By now, your getting the idea of how 2AMDOOR works. You must specify
  520.     WILDCAT as the first command line parameter, the full path and file
  521.     name for the JUMPER.DAT file you want used, and the correct path and
  522.     file name for the output file (CALLINFO.BBS).
  523.  
  524.  
  525.     3C.  PCBOARD
  526.  
  527.     This one is just a little different. For reasons of clarity, you must
  528.     use PCB14 as the first parameter, NOT PCBOARD. This is because 2AMDOOR
  529.     produces a PCBOARD version 14 file. 2AMDOOR will just not know what you
  530.     are talking about if you use PCBOARD as the BBS type. Remember to call
  531.     your output file PCBOARD.SYS!
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.                                                                         12
  539.  
  540.  
  541.     4.  2AMDOOR OPTIONS - HANDLES AND LOG FILES
  542.  
  543.     Not done yet! There are a couple of options that you can select on the
  544.     2AMDOOR command line. One is if you wish to allow user handles to be
  545.     passed to the door program instead of the full user's name. The other
  546.     option tells 2AMDOOR to create and maintain a log of its use.
  547.  
  548.  
  549.     4A.  Allow use of handles in jumpdoors
  550.  
  551.     By use of the H parameter (not case sensitive) as either of the last
  552.     two command line parameters, 2AMDOOR will put the users handle in the
  553.     output file, instead of the user's full name as entered in the 2AM-BBS
  554.     new user application. For example:
  555.  
  556.               2AMDOOR PCB14 JUMPER.DAT C:\BBS\JUMP\PCBOARD.SYS H
  557.  
  558.     Will tell 2AMDOOR to pass the users handle to the file PCBOARD.SYS. I
  559.     normally use this H parameter, since a lot of users on my board prefer
  560.     their handle vs. their name. Also, If I saw ALFRED HITCHCOCK (real
  561.     name) instead of PIGBAG (handle) I wouldn't know who it was.
  562.  
  563.  
  564.     4B. Maintain a 2AMDOOR log file
  565.  
  566.     Using the L command line parameter tells 2AMDOOR to create and maintain
  567.     a log file. The log file is amended each time that the L parameter is
  568.     'on' and 2AMDOOR is started. If you include the L parameter in some
  569.     batch files and not in others, then you will not have a complete log of
  570.     2AMDOOR's usage. If you are curious about a single door's usage, you
  571.     can use the L parameter for only that door, and examine the log to see
  572.     how (and who) is using the door. The log file is called DOORLOG.TXT and
  573.     is located in the same directory as the 2AMDOOR.EXE file. Here is an
  574.     example of a log entry:
  575.  
  576.  
  577.                 DEREK WAHILA ... AKA ... DEREK
  578.                   > On Sat May 27 21:12:15 1989
  579.                   > While connected at: 1200 Baud on COMM1
  580.                   > Used 2AMDOOR to create a PCB14 file
  581.  
  582.  
  583.     Each time the log is written to, 2AMDOOR includes the users real name
  584.     as shown in the user's application, and the user's handle (after the
  585.     AKA.. Also Known As), the date/time of the passage, baud rate, comm
  586.     port, and the type of file produced. If you have an active board, this
  587.     file can get pretty large, so you may want to delete it from time to
  588.     time (via the scheduler?)
  589.  
  590.  
  591.  
  592.  
  593.  
  594.                                                                         13
  595.  
  596.  
  597.     5.  TROUBLE YOU CAN GET INTO
  598.  
  599.     There are several ways that you can get into 'trouble' running a door,
  600.     or using 2AMDOOR. There are two types in my mind, those with error
  601.     messages, and those without.
  602.  
  603.  
  604.     5A.  WITH ERROR MESSAGES
  605.  
  606.     There are several sources of error messages. The first one is 2AM-BBS
  607.     itself. If you mess something up in the PASSAGES.DAT file, 2AM-BBS will
  608.     note it in one of the system log files. Normally, when I get this type
  609.     of error, it's easily found by looking at the PASSAGES.DAT file.
  610.     (beware of an extra blank line before the EOF). Make sure you check the
  611.     system logs if something is going wrong, since you will not get an
  612.     indication of what the trouble is from 2AM-BBS any other way.
  613.  
  614.     You can also get error messages from 2AMDOOR. There is a message that
  615.     indicates you asked for a door conversion that doesn't exist. Like
  616.     telling it to produce a PCBOARD file instead of a PCB14 file for
  617.     instance. There is also an error message for each of the three files
  618.     that 2AMDOOR opens and uses. The program will tell you which one it's
  619.     having trouble with, just write it down, as it goes by.
  620.  
  621.     Finally, the door program itself may give you error messages. The
  622.     better doors will have a list of these errors in the documentation, and
  623.     a hint as to what the trouble is. Remember, some of the door programs
  624.     require that the modem CD (carrier detect) be active, so if you are
  625.     trying to debug the thing locally, and all looks good, it could be you
  626.     need a trusty user to call and try it.
  627.  
  628.  
  629.     5B. WITHOUT ERROR MESSAGES
  630.  
  631.     The worst of all, the door doesn't work, and there is no indication of
  632.     what is wrong. Well, it can still be narrowed down! First of all, its
  633.     hard to mess up something in 2AM-BBS and not get an entry in one of the
  634.     logs. So, put that consideration last on the list. Most likely its the
  635.     way in which the door program is installed. RE-read the documentation
  636.     for the door, some documents are tricky to understand. Look at the
  637.     directory that the door is in, if there are a couple of .EXE or.COM
  638.     files, do a little experimentation with them. One may be a setup
  639.     program! Many door programs have their own configuration files that
  640.     need to be edited for your configuration, so if you see something with
  641.     a .DAT or .TXT extension, try looking at them with an editor.
  642.  
  643.     If the door program works in local mode, that doesn't mean it will work
  644.     over the comm port! If the door program supports several different
  645.     types of interfaces, try them by instructing 2AMDOOR (and the door
  646.     program) to produce a different file.
  647.  
  648.     Make sure that 2AMDOOR is not giving you an error message when it
  649.     starts up. Errors associated with files will cause a beep, errors that
  650.     you make will not beep, but will be shown on the screen when the
  651.     program starts up.
  652.  
  653.  
  654.  
  655.                                                                         14
  656.  
  657.  
  658.     The door may sense that no-one is on the modem, so have a REALLY good
  659.     friend call, and wander away from his PC, while you pretend you are the
  660.     user, and try different things. (remember alt-J). Also, you can stay in
  661.     chat mode, and start the batch file up also. If you think that there
  662.     are error messages (or may be) shown on the screen, but they go by too
  663.     fast to read, remember that you can log the screen to a disk file in
  664.     2AM-BBS, and then look at it latter.
  665.  
  666.     Finally, just give up and go on to another door. There's a million of
  667.     'em.
  668.  
  669.  
  670.  
  671.  
  672.                                                                         15
  673.  
  674.  
  675.     6.  EXAMPLES
  676.  
  677.     Here are example batch files for some of the most favorite jumpdoors on
  678.     my board:
  679.  
  680.  
  681.     6A.  Czar wars
  682.  
  683.     Czar wars is one of the most favorite, and oldest BBS doors. Its a
  684.     great space-trading adventure game and can support a HUGE and
  685.     complicated universe. For more information on CZARWARS see the
  686.     references section at the end of this document.
  687.  
  688.  
  689.         echo off
  690.         cls
  691.         cd\bbs\jump
  692.         echo  > com1
  693.         echo  Starting the jump now! > com1
  694.         echo  > com1
  695.         echo  Using 2AMDOOR to convert to PCBOARD format > com1
  696.         2amdoor pcb14 jumper.dat c:\czar\pcboard.sys l h
  697.         cd\bbs\czar
  698.         ECHO  > com1
  699.         echo  > Starting up the game...
  700.         czar_pgm /pcb14
  701.  
  702.  
  703.  
  704.     6B.  CASINO
  705.  
  706.     Casino is a gambling game door, that has amazingly good graphics
  707.     support. It's not restricted to graphics players however. For more
  708.     information on CASINO see the references section at the end of this
  709.     document.
  710.  
  711.  
  712.         ECHO OFF
  713.         cls
  714.         cd\bbs\jump
  715.         echo  > com1
  716.         echo  Starting the jump now! > com1
  717.         echo  > com1
  718.         echo  Using 2AMDOOR to convert to a wildcat format > com1
  719.         2AMDOOR PCB14 JUMPER.DAT \BBS\JUMP\casino\CALLINFO.BBS H L
  720.         cd \bbs\jump\casino
  721.         casino 1 \BBS\JUMP\CASINO WILDCAT
  722.  
  723.  
  724.  
  725.  
  726.                                                                         16
  727.  
  728.  
  729.     6C.  Bad example!
  730.  
  731.     Suppose the following for CZARWARS:
  732.  
  733.         echo off
  734.         cls
  735.         cd\bbs\jump
  736.         echo  > com1
  737.         echo  Starting the jump now! > com1
  738.         echo  > com1
  739.         echo  Using 2AMDOOR to convert to PCBOARD format > com1
  740.         2amdoor RBBS jumper.dat c:\czar\pcboard.sys l h
  741.         cd\bbs\czar
  742.         ECHO  > com1
  743.         echo  > Starting up the game...
  744.         czar_pgm /pcb14
  745.  
  746.  
  747.     It won't work! 2AMDOOR was told to produce a output file in the RBBS
  748.     format, and call it pcboard.sys. IT WILL!. Be careful of this. By about
  749.     this time you may be wondering why I left it that way. Why not create a
  750.     default output file name dependant upon the type of interface being
  751.     produced? I wanted to maintain the multi port capability, and this way,
  752.     you can call the output DORINFO1.DAT or DORINFO2.DAT or whatever.
  753.     Besides, once you get the batch file working, there is no reason to
  754.     mess with it!
  755.  
  756.  
  757.  
  758.  
  759.                                                                         17
  760.  
  761.  
  762.     7A.  REGISTRATION & TECHNICAL SUPPORT
  763.  
  764.     This is a SHAREWARE program intended to be used by SysOps of 2AM-BBS.
  765.     It's not intended to be FREE! If you have tried the program, and are
  766.     using it on your board to run doors, then you should BUY the program
  767.     from me for $15.00. I intend to continue to support this product by
  768.     adding more door interfaces to it like GAP, WWIV, QBBS, and perhaps
  769.     MONITOR. When you register your copy with me, I'll record your name and
  770.     address and will send you the next higher release as soon as its
  771.     completed. Also, by registering you can ask me all the questions you
  772.     want about how to make a door work on your 2AM system. I run about 10
  773.     at any one time, deleting the not-so-favorite ones, and adding new ones
  774.     all the time, so I have a lot of practice in this sort of thing. Just
  775.     call my board and post a message in the 2AM discussion area.
  776.  
  777.          CONNECT! BBS @ (607)-724-7170, 24hrs, 2400/1200/300, 100 Megs
  778.  
  779.     As a registered user, you can also download any of the door programs
  780.     that I have managed to get working, and its associated batch file as
  781.     well!
  782.  
  783.  
  784.     7B. REFERENCES
  785.  
  786.  
  787.     1) 2AM-BBS (c) copyright 1986 - 1989 is a product of 2AM ASSOCIATES. It
  788.     is supported via The DREW University Underground BBS at any of the
  789.     following numbers:
  790.  
  791.  
  792.                (201)-377-8245,  (201)-377-8193   (201)-377-7861
  793.                         (201)-377-6810,  (201)-377-4538
  794.  
  795.  
  796.     2) Phantasia, a role playing game, by Edward Estes (AT&T Teletype
  797.     Corporation) and Modified by Chris Robertson 1985 is distributed free
  798.     of charge on MYCROFT BBS! at:
  799.  
  800.                                 (408)-927-0105
  801.  
  802.     3) CZARWARS, a space trading game, (Copyright 1987-1989) by Ray
  803.     Yeargin is distributed via Shareware and is available for evaluation
  804.     on THE HOME OF CZARWARS BBS at:
  805.  
  806.                                 (904)-878-7704
  807.  
  808.  
  809.     4) CASINO a gambling game is written by Michael W. Bayley (SysOp of
  810.     MYCROFT BBS!) and is distributed free of charge.
  811.  
  812.  
  813.  
  814.     5) A lot of 'pointing to the right document' help was provided by Scott
  815.     Swain SysOp of CONSOLE COMMAND BBS at:
  816.  
  817.                 (805)-968-5901, (805)-968-9411,  (805)-968-0307
  818.  
  819.  
  820.  
  821.     6) Many thanks to the patient users of CONNECT! for helping me out with
  822.     the debug of the doors and my program.
  823.  
  824.  
  825.     7) Special thanks to THIN ICE for all the debug time!
  826.  
  827. 
  828.