home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / OS2 / MODEM / GLOS2110 / SYSOP.DOC < prev   
Text File  |  1995-02-28  |  30KB  |  1,035 lines
  1. ┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐
  2. │ g ││ o ││ a ││ t ││ l ││ i ││ s ││ t ││ / ││ 2 │
  3. └───┘└───┘└───┘└───┘└───┘└───┘└───┘└───┘└───┘└───┘
  4. ┌───┐┌───┐┌───┐┌───┐┌───┐
  5. │ v ││ 1 ││ . ││ 1 ││ 0 │
  6. └───┘└───┘└───┘└───┘└───┘
  7.  
  8. Copyright 1995 by Mike Aleksiuk, All Rights Reserved
  9.  
  10. SYSOP DOCUMENTATION
  11. ────────────────────────────────────────────────────
  12. ──────────────────────────────────────────────────────────────────────
  13.  
  14.            Table of Contents
  15.  
  16. ──────────────────────────────────────────────────────────────────────
  17.  
  18. 1.0 License and Disclaimer Information  . . . . . . . . . . . . . . . . 1
  19.    1.1 Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  20.    1.2 License  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  21.  
  22. 2.0 GoatList/2 - What Is It?  . . . . . . . . . . . . . . . . . . . . . 2
  23.  
  24. 3.0 Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  25.  
  26. 4.0 Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  27.    4.1 Basic Installation . . . . . . . . . . . . . . . . . . . . . . . 4
  28.    4.2 Installing on Maximus-Style Native OS/2 Systems  . . . . . . . . 5
  29.    4.3 Installing on OS/2 Boards That Use Port Names  . . . . . . . . . 5
  30.    4.4 Running an OS/2 Door From A DOS BBS  . . . . . . . . . . . . . . 6
  31.  
  32. 5.0 Command-Line Parameters . . . . . . . . . . . . . . . . . . . . . . 8
  33.    5.1 /NODE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  34.    5.2 /NASTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  35.    5.3 /NICE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  36.    5.4 /PATH  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  37.    5.5 /PORT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  38.    5.6 /LOCAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  39.  
  40. 6.0 Configuring the Door  . . . . . . . . . . . . . . . . . . . . . . . 10
  41.    6.1 The Main Menu  . . . . . . . . . . . . . . . . . . . . . . . . . 10
  42.    6.2 The Configuration File . . . . . . . . . . . . . . . . . . . . . 10
  43.  
  44. 7.0 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  45.    7.1 File List  . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  46.    7.2 Too Much Config? . . . . . . . . . . . . . . . . . . . . . . . . 11
  47.    7.3 Can't Find the Dropfile  . . . . . . . . . . . . . . . . . . . . 11
  48.    7.4 Only Works Locally . . . . . . . . . . . . . . . . . . . . . . . 11
  49.    7.5 Wrong Time Left  . . . . . . . . . . . . . . . . . . . . . . . . 12
  50.    7.6 Accessing B: Drive . . . . . . . . . . . . . . . . . . . . . . . 12
  51.  
  52. 8.0 Plans for Future Releases . . . . . . . . . . . . . . . . . . . . . 13
  53.  
  54. 9.0 Thanks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  55.  
  56. 10.0 Contacting the Author  . . . . . . . . . . . . . . . . . . . . . . 15
  57.  
  58.  
  59. ──────────────────────────────────────────────────────────────────────
  60.  
  61.            1.0 - License and Disclaimer Information
  62.  
  63. ──────────────────────────────────────────────────────────────────────
  64.  
  65.  1.1 Disclaimer
  66.  
  67. DISCLAIMER
  68. ----------
  69.  
  70.         This software and accompanying materials are distributed
  71.         "as is" without warranty, expressed or implied; including
  72.         but not limited to any implied warranties of merchantability
  73.         or fitness for a particular purpose.  In no event shall Mike
  74.         Aleksiuk, OuiRMarbles Programming Services, or anyone involved
  75.         with the creation and production of this product be held
  76.         liable for any damages, including, but not limited to, any
  77.         lost profits, savings, data or other incidental, indirect,
  78.         special, or consequential damages arising out of the use
  79.         or inability to use this software, or for any claim by any
  80.         other party, even if Mike Aleksiuk or OuiRMarbles Programming
  81.         Services have been advised of the possibility of such damages.
  82.         The person using the software bears all risk as to the quality
  83.         and performance of the software.
  84.  
  85.  1.2 License
  86.  
  87. LICENSE INFORMATION
  88. -------------------
  89.  
  90. GoatList/2 is copyrighted freeware.  You are licensed to run this program
  91. for as long as you wish, with or without paying any money to the author,
  92. Mike Aleksiuk.
  93.  
  94. It is neither illegal nor unwanted for you to distribute GoatList/2 freely
  95. providing that you are distributing the complete archive with all of the files
  96. intact.
  97.  
  98. You may include unmodified and complete archive versions of the shareware
  99. version of GoatList/2 in software collections (ie: CD-ROM discs).
  100.  
  101. Please note that the author is not obligated in any way to provide support
  102. nor to provide future versions of GoatList/2.  Do not take this as
  103. a guarantee that I will NOT be providing future enhancements, versions, or
  104. support of GoatList/2.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119. ──────────────────────────────────────────────────────────────────────
  120.                     GoatList/2 v1.10 - End of Page 1
  121. ──────────────────────────────────────────────────────────────────────
  122.  
  123.  
  124. ──────────────────────────────────────────────────────────────────────
  125.  
  126.            2.0 - GoatList/2 - What Is It?
  127.  
  128. ──────────────────────────────────────────────────────────────────────
  129.  
  130. GoatList/2 is a fully functioning "door" program.  It is designed to be
  131. called from a bulletin board system (BBS) running over the modem.
  132.  
  133. GoatList/2 can *NOT* be run from DOS or any operating system other than OS/2.
  134. This door is a multi-threaded program, taking advantage of all OS/2 has to
  135. offer.  It is fully freeware, so you do not have to pay for it.  I do accept
  136. donations.
  137.  
  138. All technicalities aside, GoatList/2 is a BBS listing program.  In other
  139. words, it is generally a database storing a list of bulletin board systems.
  140. The general idea is that sysops or users alike enter the door, view the list
  141. of bulletin board systems, and perhaps add their own to the list.
  142.  
  143. Other people enter the door, view the list as well, and find information on
  144. BBSes they need to know about.  That information includes the telephone
  145. number, name, BBS software, and many other information the user might wish to
  146. know about.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184. ──────────────────────────────────────────────────────────────────────
  185.                     GoatList/2 v1.10 - End of Page 2
  186. ──────────────────────────────────────────────────────────────────────
  187.  
  188.  
  189. ──────────────────────────────────────────────────────────────────────
  190.  
  191.            3.0 - Getting Started
  192.  
  193. ──────────────────────────────────────────────────────────────────────
  194.  
  195. If you would like to give GoatList/2 a test run, run GOATLIST.EXE with the
  196. /LOCAL parameter from an OS/2 command line.  Example:
  197.  
  198. GOATLIST.EXE /LOCAL
  199.  
  200. You can check out the door all you want this way, and decide whether to
  201. install it or not.
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249. ──────────────────────────────────────────────────────────────────────
  250.                     GoatList/2 v1.10 - End of Page 3
  251. ──────────────────────────────────────────────────────────────────────
  252.  
  253.  
  254. ──────────────────────────────────────────────────────────────────────
  255.  
  256.            4.0 - Installation
  257.  
  258. ──────────────────────────────────────────────────────────────────────
  259.  
  260. GoatList/2 can be run from OS/2 native BBS software (such as Maximus/2 or
  261. LoraBBS/2), or it can be run from DOS based BBS software run under OS/2.  I
  262. myself have run GoatList/2 from RemoteAccess under OS/2.
  263.  
  264. You will want to follow the Basic Installation below, then continue on to
  265. the extra sections which cover detailed explanations on how to install this
  266. door on various types of systems.
  267.  
  268. The reason it gets this complex is the fact that, under OS/2, you can be
  269. running OS/2 BBS software or DOS BBS software.
  270.  
  271.  4.1 Basic Installation
  272.  
  273. BASIC INSTALLATION
  274. ------------------
  275.  
  276. To install GoatList/2, follow these steps:
  277.  
  278. 1.) Create a new directory for GoatList/2, and decompress the GoatList/2
  279.     archive into that directory.  In all of our examples, we will assume
  280.     the directory is C:\BBS\GOATLIST, though any directory will be fine.
  281.  
  282. 2.) Create a batch file which your BBS will run to start GoatList/2.  Usually,
  283.     this batch file will only be the following:
  284.  
  285.     C:
  286.     CD\BBS\GOATLIST
  287.     GOATLIST.EXE
  288.     CD\BBS
  289.  
  290.     Remember to substitute the path and drive on which you have installed
  291.     the game.
  292.  
  293.     Command Line Arguments:
  294.     Before worrying about which actual arguments you need, read the full
  295.     installation documentation, including the section that pertains to your
  296.     particular setup (ie: DOS BBS setup, OS/2 BBS setup, or OS/2 BBS passing
  297.     a port name).
  298.  
  299. 3.) Copy the file DRS2V5B2.DLL to a directory on your LIBPATH.  (The LIBPATH
  300.     is defined in CONFIG.SYS.  Usually the LIBPATH points to \OS2\DLL).  This
  301.     will allow GoatList/2, and any other program using the Doors/2 interface,
  302.     to find the library file.
  303.  
  304.     Note:  If your copy of GoatList/2 doesn't have this DLL file along with
  305.     it, and you don't have DRS2V5B2.DLL on your hard drive, you will not be
  306.     able to run GoatList/2.
  307.  
  308.     Note:  This file has a hefty size attached to it.  You should only need
  309.     one copy of DRS2V5B2.DLL on your hard drive, and it should be inside a
  310.     directory on your LIBPATH:
  311.  
  312.     If you happen to be running Iron Ox for OS/2 or any other program that
  313.     you know to be a Doors/2 program, you may already have DRS2V5B2.DLL on
  314. ──────────────────────────────────────────────────────────────────────
  315.                     GoatList/2 v1.10 - End of Page 4
  316. ──────────────────────────────────────────────────────────────────────
  317.  
  318.  
  319.     your hard drive.  You should be able to run fine with that file, but if
  320.     you want to be extra-safe, check the dates on the file.  Use the newest
  321.     one.
  322.  
  323. 4.) Now look through the following sections.  If you are running a
  324.     Maximus-style native OS/2 BBS software, such as any OS/2 BBS which passes
  325.     the OS/2 comm. port handle to the door, read the next section.  If you
  326.     run a BBS such as Lora/2, look through the section after the Max-style
  327.     section.  And finally, if you run a DOS BBS under OS/2, read the final
  328.     section in the installation chapter.
  329.  
  330.  4.2 Installing on Maximus-Style Native OS/2 Systems
  331.  
  332. INSTALLING ON MAXIMUS-STYLE NATIVE OS/2 SYSTEMS
  333. -----------------------------------------------
  334.  
  335. One important distinction among OS/2 BBS'es is between systems (like
  336. Max/2) that trade in comm handles and systems (like Lora) that trade in
  337. port names.  By default, GoatList/2 assumes that it is running on a
  338. Maximus-style system.
  339.  
  340. Here is a sample menu entry for running GoatList/2 on a single-node Maximus
  341. system:
  342.  
  343. From Menus.Ctl
  344.  
  345.             Display_File  C:\Max\Misc\Dorinfo          Normal "GoatList/2"
  346.       NoDsp Xtern_Dos     C:\Bbs\GoatList\GoatList.exe Normal "G"
  347.  
  348. No batch/script file is required.  The Dorinfo script included with
  349. Max/2 works fine, providing you are not running a multinode setup.
  350.  
  351.  4.3 Installing on OS/2 Boards That Use Port Names
  352.  
  353. INSTALLING ON OS/2 BOARDS THAT USE PORT NAMES
  354. ---------------------------------------------
  355.  
  356. My current knowledge is that the OS/2 BBS package Lora, like DOS BBS systems,
  357. writes the name of the correct port to the dropfile instead of the number
  358. corresponding to a comm handle.  If this is true of your BBS software, you'll
  359. need to use the command-line argument /PORT to indicate to the door that it
  360. will need to open a serial port.
  361.  
  362. Your command-line would look somewhat like this:
  363.  
  364. C:\BBS\GOATLIST\GOATLIST.EXE /PORT
  365.  
  366. If you're sure your BBS software writes a port name to its dropfiles,
  367. you are using the /PORT command-line option, and the door has trouble
  368. opening the comm port anyway, double-check that you have your serial
  369. driver configured to allow sharing of comm ports between sessions (with
  370. SIO, you would need to use the "-" parameter, described in the section
  371. below).
  372.  
  373. The Maximus examples above should give you a general idea on batch files
  374. and menu configuration.
  375.  
  376. Note:  Depending on the configuration of your system, you may wish to
  377. try using the /NICE parameter.  See the section on command-line
  378. arguments, below.  You should only need to consider using the /NASTY
  379. ──────────────────────────────────────────────────────────────────────
  380.                     GoatList/2 v1.10 - End of Page 5
  381. ──────────────────────────────────────────────────────────────────────
  382.  
  383.  
  384. parameter if your users spend a lot of time in ill-behaved DOS doors.
  385.  
  386.  4.4 Running an OS/2 Door From A DOS BBS
  387.  
  388. RUNNING AN OS/2 DOOR FROM A DOS BBS
  389. -----------------------------------
  390.  
  391. If you are running a DOS BBS under OS/2, you should be able to take advantage
  392. of the enhanced features and performance of GoatList/2.
  393.  
  394. The following method is not guaranteed to work on your system, much less to
  395. generate responsive performance on heavily loaded multinode systems.  If you
  396. run a single-node DOS BBS under OS/2, and you're concerned about CPU load,
  397. you should be pleased with the performance of GoatList/2.
  398.  
  399. However, if you run a multinode system with a lot of non-timeslicing DOS
  400. doors, you may have to run GoatList/2 in /NASTY mode and you won't get the
  401. same benefits you would if GoatList/2 had better-behaved fellow programs and
  402. you could run it in /NICE mode.
  403.  
  404. To run GoatList/2 from a DOS BBS, you must be using Ray Gwinn's SIO or
  405. compatible drivers (COMM.SYS/VCOMM.SYS will not work).  Recent versions of
  406. SIO, working with OS/2 2.1x and above, will allow OS/2 and DOS sessions to
  407. share a communications port.  SIO must be loaded with the "-" parameter,
  408. which allows port-sharing, and you must have the "Share comm port with OS/2
  409. Sessions" option turned on in the DOS Sessions Settings for the session in
  410. which you run your BBS.
  411.  
  412. To spawn OS/2 sessions from your DOS BBS, you will need OS2EXEC or a
  413. similar utility.  OS2EXEC creates OS/2 sessions that wait on commands
  414. from DOS sessions; you run the door by telling OS2EXEC to execute
  415. GOATLIST.EXE
  416.  
  417. So, with requirements and caveats stated, let's get to batch files and
  418. configuration information.  First of all, you must run OS2EXECD.EXE which
  419. is a part of the OS2EXEC package.
  420.  
  421. What I did was created a session on my desktop in the BBS folder which simply
  422. runs OS2EXECD.EXE in its own full-screen session.  I created a shadow of this
  423. icon and put it into the Start Up folder, which will have the OS2EXECD icon
  424. run everytime the BBS starts up.
  425.  
  426. If you don't want to do that, you can create a .CMD file to run it.  Here is
  427. an example of a STARTUP.CMD which is run everytime OS/2 boots up:
  428.  
  429. REM Start "Daemon" sessions for the BBS node
  430. START /FS OS2EXECD
  431. REM End of startup .CMD
  432.  
  433. My RemoteAccess batch file for GoatList/2 looks somewhat like this:
  434.  
  435. C:
  436. CD\BBS\GOATLIST
  437. OS2EXEC GOATLIST.EXE /PORT
  438. CD\BBS
  439.  
  440. If you are running a DORINFO system, you may need to use the /NODE
  441. parameter.  If GoatList/2 has trouble finding your dropfile, you may need to
  442. specify it on the command line.  See the basic installation instructions,
  443. above, and the information on command-line arguments, below.
  444. ──────────────────────────────────────────────────────────────────────
  445.                     GoatList/2 v1.10 - End of Page 6
  446. ──────────────────────────────────────────────────────────────────────
  447.  
  448.  
  449.  
  450. Remember: You must have the /PORT command-line parameter for running under a
  451. DOS BBS.  See the chapter on command-line arguments if you want details.
  452.  
  453. If you run a multinode system with high-speed lines and/or non-timeslicing
  454. comm software (in other words, if there are other tasks that eat up lots of
  455. CPU time when players will be in GoatList/2) you may need to try the /NASTY
  456. parameter.  See the section on command-line parameters, below.
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509. ──────────────────────────────────────────────────────────────────────
  510.                     GoatList/2 v1.10 - End of Page 7
  511. ──────────────────────────────────────────────────────────────────────
  512.  
  513.  
  514. ──────────────────────────────────────────────────────────────────────
  515.  
  516.            5.0 - Command-Line Parameters
  517.  
  518. ──────────────────────────────────────────────────────────────────────
  519.  
  520. Command-line parameters are all of the characters that come on the command-line
  521. AFTER the program name.  They are an easy way to pass the program values,
  522. especially if you want to use different values in different cases, without
  523. changing the configuration file.
  524.  
  525.  5.1 /NODE
  526.  
  527. The /NODE parameter tells GoatList/2 the node number which is calling the
  528. door.  This will most likely only be needed with DORINFOx.DEF systems, and
  529. even more likely with multinode systems.
  530.  
  531. Please note that this door is not built to be run on a multinode system.  In
  532. other words, it is up to you that two nodes don't call this door at the same
  533. time.
  534.  
  535. The /NODE parameter is used like this:
  536.  
  537. C:\BBS\GOATLIST\GOATLIST.EXE /NODE 2
  538.  
  539. *NOTE THE SPACE!*  The space is important for /NODE to work.  This example
  540. tells the door that it is running on node 2.  If DORINFOx.DEF dropfiles are
  541. in use, it will be looking for the file DORINFO2.DEF.
  542.  
  543.  5.2 /NASTY
  544.  
  545. Systems running OS/2 BBS's can be gentle and friendly places where all
  546. software co-operates and shares the CPU.  Others can be just the opposite.
  547. The /NASTY parameter warns the door that it is running in one of those
  548. atmospheres that *ISN'T* a friendly and gentle place, and that it needs
  549. to set its thread priorities very high to compete with the other software.
  550.  
  551. You should probably stay away from this parameter unless you get complaints
  552. about GoatList/2 running very slowly and/or you know you run lots of
  553. non-timeslicing DOS doors.
  554.  
  555.  5.3 /NICE
  556.  
  557. The /NICE parameter is the exact opposite of the /NASTY parameter above.
  558. Using the /NICE parameter lets GoatList/2 know that it is running in a
  559. friendly atmosphere and that it can rely on CPU idle time to do things
  560. like refresh the screen and dump output to the comm driver.
  561.  
  562. On all-native systems or single-node systems with a light CPU load, using
  563. /NICE should make for better performance with substantially less CPU load.
  564. This option is almost guaranteed, however, to provide miserable performance
  565. on multinode systems running DOS BBS software and/or non-timeslicing DOS
  566. doors.
  567.  
  568. Note:  By default, GoatList/2 is neither /NICE nor /NASTY.  It uses moderate
  569.        thread priorities.  Many sysops will need neither the /NICE nor the
  570.        /NASTY parameter.  The parameters are included to give more control
  571.        over door performance.
  572.  
  573.  5.4 /PATH
  574. ──────────────────────────────────────────────────────────────────────
  575.                     GoatList/2 v1.10 - End of Page 8
  576. ──────────────────────────────────────────────────────────────────────
  577.  
  578.  
  579.  
  580. GoatList/2 autodetects which dropfile to use by checking the directory for
  581. the most current dropfile it supports.
  582.  
  583. You can specify the path where GoatList/2 should look for its dropfile and
  584. (if necessary) the name of the dropfile to use.  Example:
  585.  
  586. C:\BBS\GOATLIST\GOATLIST.EXE /PATH C:\RA\
  587.  
  588. or
  589.  
  590. C:\BBS\GOATLIST\GOATLIST.EXE /PATH C:\RA\DORINFO3.DEF
  591.  
  592. Important Note:  Make sure to note the space between the /PATH parameter
  593. and the actual directory you specify.  This is a requirement of the /PATH
  594. parameter.
  595.  
  596. Note:  This command-line option is usually not necessary.
  597.  
  598.  5.5 /PORT
  599.  
  600. By default, GoatList/2 expects to find a Max/2-style comm handle in its
  601. door information file.  If you're running a BBS program that places the
  602. comm port name in the dropfile (like any DOS BBS and some OS/2 BBS systems),
  603. you will need to include this parameter.
  604.  
  605.  5.6 /LOCAL
  606.  
  607. This parameter will allow you to log into the door from the command-line
  608. with no modem contact at all.
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639. ──────────────────────────────────────────────────────────────────────
  640.                     GoatList/2 v1.10 - End of Page 9
  641. ──────────────────────────────────────────────────────────────────────
  642.  
  643.  
  644. ──────────────────────────────────────────────────────────────────────
  645.  
  646.            6.0 - Configuring the Door
  647.  
  648. ──────────────────────────────────────────────────────────────────────
  649.  
  650. I'm slowly making GoatList/2 as configurable as it can be.  Over the next
  651. few versions, you'll notice that the amount of configurable items will
  652. increase.
  653.  
  654.  6.1 The Main Menu
  655.  
  656. If you don't like the main menu that came with GoatList/2, you can edit it
  657. to your specifications.  All you must do is find an editor capable of ANSI
  658. (I recommend a program called TheDraw) and ASCII (a text editor such as
  659. QEdit can usually do this just fine) editing.
  660.  
  661. Just load up the files MAINMENU.ASC or MAINMENU.ANS into the file, and edit
  662. away.  Make sure you let the users know their choices.  Editing a menu can
  663. be handy if you wish to totally block out certain choices (such as deleting
  664. a BBS entry) from your user.
  665.  
  666. (Note: There is an option in GOATLIST.CFG which will allow you block your
  667. users from deleting or editing any BBS entries.  Read the next section if you
  668. wish to know more about it.)
  669.  
  670.  6.2 The Configuration File
  671.  
  672. If you haven't noticed already, there is a file which came with GoatList/2
  673. called GOATLIST.CFG.  This file is a very flexible way of configuring the
  674. door.
  675.  
  676. This file is editable with a text editor, and is very self-explanatory.  Just
  677. read it and see.  It'll give you good directions, and explain each keyword
  678. in a good amount of detail.
  679.  
  680. Only a few of the things covered in GOATLIST.CFG are:
  681.  
  682.  - blocking a user from editing or deleting any BBS entries
  683.  
  684.  - specifying a "power user" who will have the power to delete or edit any and
  685.    all of the BBS entries
  686.  
  687.  - specifying the directory where the dropfile is located
  688.  
  689.  - specifying the name of the log, or disabling it altogether.
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704. ──────────────────────────────────────────────────────────────────────
  705.                     GoatList/2 v1.10 - End of Page 10
  706. ──────────────────────────────────────────────────────────────────────
  707.  
  708.  
  709. ──────────────────────────────────────────────────────────────────────
  710.  
  711.            7.0 - Troubleshooting
  712.  
  713. ──────────────────────────────────────────────────────────────────────
  714.  
  715. This section is devoted to solving problems with the door.  Since this door
  716. is in it's premier version, I haven't found many problems as of yet.  After
  717. this door has been circulating for a while, perhaps I'll find some problems
  718. to document.
  719.  
  720.  7.1 File List
  721.  
  722. First of all, make sure you have all of the files marked with a star below
  723. before you think of anything else.  Most likely, if you are missing a file
  724. with a star beside it, that is the problem, and you should search for a
  725. better copy of GoatList/2.
  726.  
  727. FILE_ID.DIZ    File identification
  728. GOATLIST.EXE * The GoatList/2 main program
  729. MAINMENU.ANS * ANSI version of the main menu
  730. MAINMENU.ASC * ASCII version of the main menu
  731. ENTRY.ANS    * ANSI screen for the ANSI editing routines
  732. SYSOP.DOC      This document.
  733. DRS2V5B2.DLL * You must have this file to run GoatList/2.
  734. GOATLIST.CFG   Though this file is important, you don't even need this file
  735.                to successfully run GoatList/2.
  736. BBS.DAT        This is the file containing all of the BBS listings.  It isn't
  737.                important, because it can be created by the program.
  738. README.1ST     Read this first. <g>
  739. HISTORY.TXT    Bug fixes and additions.
  740.  
  741.  7.2 Too Much Config?
  742.  
  743. A common mistake among sysops when installing a program is when they decide
  744. to use as many command-line paramaters or configuration features as they
  745. can.  Don't specify the dropfile path on the command line unless the game
  746. doesn't work without it.  Don't add any extra lines to your batch file (ie:
  747. one that copies the dropfile to the game directory before execution).  Don't
  748. add the game to your path (inside your CONFIG.SYS).  Keep everything simple.
  749.  
  750.  7.3 Can't Find the Dropfile
  751.  
  752. If you find that the door cannot find your dropfile, you have three choices:
  753.  
  754.  - Specify the dropfile directory on the command line (see the chapter on
  755.    command line parameters).
  756.  
  757.  - Specify the dropfile directory inside GOATLIST.CFG.  Read GOATLIST.CFG with
  758.    your favourite text editor and look for the BBSDir option.
  759.  
  760.  - Make absolutely sure that your BBS software is producing a dropfile.
  761.  
  762.  7.4 Only Works Locally
  763.  
  764. If you find that the game only works locally, but not over the modem...
  765.  
  766. If you're using the /PORT parameter, try NOT using it.  If you're not using
  767. it, try to use it.  Next you might want to try the advice for the above error,
  768. "Can't Find the Dropfile", as the real problem might be that the program is
  769. ──────────────────────────────────────────────────────────────────────
  770.                     GoatList/2 v1.10 - End of Page 11
  771. ──────────────────────────────────────────────────────────────────────
  772.  
  773.  
  774. finding the wrong dropfile and trying to open the wrong port.  If none of the
  775. above fixes your problem, contact me and we'll try figure this out.
  776.  
  777.  7.5 Wrong Time Left
  778.  
  779. If you're using EXITINFO.BBS and you find that when a person enters the door
  780. he/she has the wrong "time left" value (such as 73329385)... here is what to
  781. do!
  782.  
  783. In the batchfile that runs GOATLIST.EXE, rename EXITINFO.BBS to an
  784. unimportant name *before* calling GoatList/2.  Then once GoatList/2 is
  785. completed, rename the file *back* to EXITINFO.BBS.
  786.  
  787.  7.6 Accessing B: Drive
  788.  
  789. If GoatList/2 is trying to access the B: drive when it runs, then you would
  790. want to disable or remove the DoorDir keyword from GOATLIST.CFG.  If that
  791. doesn't solve it, contact me as soon as possible.
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834. ──────────────────────────────────────────────────────────────────────
  835.                     GoatList/2 v1.10 - End of Page 12
  836. ──────────────────────────────────────────────────────────────────────
  837.  
  838.  
  839. ──────────────────────────────────────────────────────────────────────
  840.  
  841.            8.0 - Plans for Future Releases
  842.  
  843. ──────────────────────────────────────────────────────────────────────
  844.  
  845. I've decided to post my plans for future releases of GoatList/2.  I'm not
  846. worrying about anybody trying to put out a better product than this one who
  847. might steal these, because if you put out a better product, more power to
  848. you.  I'll use it myself.  I especially don't mind competition since this
  849. thing brings me in no cash.
  850.  
  851. Anyways, here is the not-so-long awaited top six plans for future releases:
  852.  
  853.  1. Generating a textfile format BBS list
  854.  
  855.  2. Inter-BBS capability
  856.  
  857.  3. Improve the documentation
  858.  
  859.  4. Add help screens for the user
  860.  
  861.  5. Colour configuration
  862.  
  863.  6. Allowing users to download the list, via external programs (ie: DSZ)
  864.  
  865. Note: Any suggestions you might have, I am willing to hear.
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899. ──────────────────────────────────────────────────────────────────────
  900.                     GoatList/2 v1.10 - End of Page 13
  901. ──────────────────────────────────────────────────────────────────────
  902.  
  903.  
  904. ──────────────────────────────────────────────────────────────────────
  905.  
  906.            9.0 - Thanks
  907.  
  908. ──────────────────────────────────────────────────────────────────────
  909.  
  910. I would like to thank the following people for their help in making this
  911. version of GoatList/2 available:
  912.  
  913. Joel Downer
  914. -----------
  915.         Not only did he write Doors/2, the powerful OS/2 door kit for C
  916. that I take advantage of, he helped me with my problems using it along the
  917. way.
  918.  
  919. Paul Sidorsky
  920. -------------
  921.         This guy has always been around to help me with programming
  922. challenges.  He always points me in the right direction.  He also got me
  923. interested in OS/2.  I'd probably be with DOS right now if he hadn't moved
  924. to OS/2.  Paul also performs his beta squeal whenever a new beta comes out,
  925. and enjoys running the new betas on his board, then pointing out all of my
  926. stupid mistakes.
  927.  
  928. Brian Pirie
  929. -----------
  930.         Joel Downer might not have released or written Doors/2 if it weren't
  931. for Brian Pirie.  Brian wrote the OpenDoors C kit, which Joel uses for his
  932. own DOS doors.  Then Brian gave permission for Joel to release his ported
  933. OS/2 version of OpenDoors, which is now Doors/2.
  934.  
  935. Some Guy In An Int'l OS/2 Echo
  936. ------------------------------
  937.         Mr. Echo was the person who asked: "Is there a BBS lister door for
  938. OS/2 I can f'req?" - I took the liberty of coding and providing one for
  939. everyone.  I'm hoping that there wasn't a quality one out there, as the only
  940. two OS/2 doors I've seen are Othello/2 and Iron Ox for OS/2, of which the
  941. latter only worked.
  942.  
  943. Duaine Johnson
  944. --------------
  945.         This guy didn't do much testing *yet*, but he will for the next
  946. version.  Maybe by then it'll work for him. <g>
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964. ──────────────────────────────────────────────────────────────────────
  965.                     GoatList/2 v1.10 - End of Page 14
  966. ──────────────────────────────────────────────────────────────────────
  967.  
  968.  
  969. ──────────────────────────────────────────────────────────────────────
  970.  
  971.            10.0 - Contacting the Author
  972.  
  973. ──────────────────────────────────────────────────────────────────────
  974.  
  975. I am *ALWAYS* open for suggestions and bug reports, so please contact me
  976. if you have either of the two.
  977.  
  978. You can contact me as Mike Aleksiuk by any of the following ways:
  979.  
  980. Netmail
  981. -------
  982. 1:134/235 - (More Than Just Applesauce BBS, Calgary, AB)
  983. 1:134/31  - (C.R.I.S.I.S. HQ, Calgary, AB)
  984.  
  985. EchoMail
  986. --------
  987. Providing my source isn't cut off, I can be reached via the following echos:
  988.  
  989. DOORGAMES
  990. DOORWARE
  991. ON_LINE_GAMES
  992. OS2DOORS
  993. OPENDOORS
  994.  
  995. Conventional Mail
  996. -----------------
  997.  
  998. Mike Aleksiuk
  999. 303 Dalcastle Mews NW
  1000. Calgary, AB, Canada
  1001. T3A 2P1
  1002.  
  1003. Thanks, Mike
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029. ──────────────────────────────────────────────────────────────────────
  1030.                     GoatList/2 v1.10 - End of Page 15
  1031. ──────────────────────────────────────────────────────────────────────
  1032.  
  1033.  
  1034. This manual compiled using MC v1.03 by Matthew Mastracci
  1035.