home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CATLST41.ZIP / CATLIST.MAN < prev    next >
Text File  |  1993-09-23  |  35KB  |  696 lines

  1.  
  2.  
  3.  
  4.         ╓──────────────────────────────────────────────────────────────╖
  5.         ║╓────────────────────────────────────────────────────────────╖║
  6.         ║║┌─────┐ ┌──────┐ ┌─────┐        ┌─┐    ┌───┐ ┌─────┐ ┌─────┐║║
  7.         ║║│ ┌─┐ │ │ ┌──┐ │ └─┐ ┌─┘        │ │    └┐ ┌┘ │ ┌───┘ └─┐ ┌─┘║║
  8.         ║║│ │ └─┘ │ └──┘ │   │ │   ┌────┐ │ │     │ │  │ └───┐   │ │  ║║
  9.         ║║│ │ ┌─┐ │ ┌──┐ │   │ │   └────┘ │ │     │ │  └───┐ │   │ │  ║║
  10.         ║║│ └─┘ │ │ │  │ │   │ │          │ └──┐ ┌┘ └┐ ┌───┘ │   │ │  ║║
  11.         ║║└─────┘ └─┘  └─┘   └─┘          └────┘ └───┘ └─────┘   └─┘  ║║
  12.         ║╙────────────────────────────────────────────────────────────╜║
  13.         ║                                                              ║
  14.         ║             A Full-Featured BBS Listing Program              ║
  15.         ║             Copyright 1992-93, PAROLE Software               ║
  16.         ║                     All rights reserved                      ║
  17.         ╙──────────────────────────────────────────────────────────────╜
  18.  
  19.                             Dennis N. Maidon
  20.                           The Parole Board BBS
  21.                              311 Buffalo Rd
  22.                            Clayton, NC  27520
  23.  
  24.                         (919) 965-3600 -> Voice
  25.  
  26.                           The Parole Board BBS
  27.                              FIDO 1:151/185
  28.  
  29.         (919) 965-4696 ->─╖
  30.                           ╟─ Wildcat! -> US Robotics Dual Standard
  31.         (919) 965-9885 ->─╜
  32.  
  33.                             Free Advice BBS
  34.  
  35.         (919) 934-1002 -> Wildcat! -> US Robotics Dual Standard
  36.  
  37.                        --------------------------
  38.                     Now with RIP! Graphic bulletins.
  39.                        --------------------------
  40.  
  41.     CatList is a full-featured BBS Listing door written in the beginning for
  42. WC! 3.x and greater.  CatList now supports TriBBS, SpitFire and PCBoard.  It
  43. may work with other systems but has not been tested on them.  I do not imply
  44. in any shape, form or fashion that CatList will operate on any other BBS
  45. software.  CatList will maintain a BBS list for a specified number of days.
  46. At the end of that time, the user that listed the BBS will receive a notice
  47. for 10 days informing him/her that their listing has expired and must be
  48. updated.  On the eleventh day if the user has not updated the listing, it
  49. will be deleted from the database.   CatList notifies the user that the
  50. listing was deleted.  All notifications are sent using the USERxxx.BBS
  51. files which WildCat! sends to the individual user when they logon.  Once
  52. this file is sent, WC! then deletes the file and logs it to the ACTIVITY.LOG.
  53. CatList supports COMs 1-4 only. It will also support COMs 5-8 with the
  54. addition of a FOSSIL driver.
  55.  
  56.     Only the user that originally listed a BBS will be able to
  57. Edit/Update or Delete that listing.  You as the sysOp have the ability
  58. to E/U/D any listing in the database.
  59.  
  60.     The door should be easy enough to set up on its own, particularly if
  61. you're familiar with door operation under Wildcat!  If you do have any
  62. problems, you can reach me on The Parole Board BBS or you can call me
  63. voice.
  64.  
  65. REGISTERED OPTIONS:
  66.  
  67.     Once registered, you may set the Listing Age (Line #7 of the CFG
  68. file) to any number of days.  Until registration, it is locked at 14
  69. days.  I do not like 'crippling' or 'handicapping' one of my programs
  70. but on my older doors, there are more un-registered users using them
  71. than registered.  Registered SysOps also have the ability to use
  72. HEADER.DAT and TAIL.DAT files.  These are ASCii text files that are
  73. added to the TEXT file that is created by CatList.  You may use them for any
  74. reason that you desire.  The HEADER.DAT is written to the text file just
  75. after the Copyright Info and before the body of the listings. The
  76. TAIL.DAT is written just after the body of the listings and before the
  77. credits.  The files must be named "HEADER.DAT" & "TAIL.DAT".
  78.  
  79. Registered SysOps may also create a header file that will be used in the
  80. "Spec File" that is created.  Place the name of the header file in line
  81. #17 of the CFG file.  This file may be configured by the SysOp to contain
  82. a specific number of listings.  Some may prefer to use this file as a
  83. HELLOx.BBS or GOODBYE.BBS file.
  84.  
  85. SysOps that would like to use POSTMASTER (Copyright 1992, Dave Cody &
  86. BoardWalk Software) have the option of setting Line 14 of the CFG file
  87. to "Y".  CatList will then create two files named "CATLIST.EXP" and
  88. "CATLIST.DEL" in the WC! home directory that you specified on line 10 of
  89. the CFG file.  CATLIST.EXP contains the names of the users that have
  90. EXPIRED listings.  The CATLIST.DEL contains the names of users with
  91. listings that have been deleted.  These files are ONLY created once each
  92. day when the maintenance is performed.  You may want to add a couple of
  93. lines to your DOORx.BAT to test for these files and have POSTMASTER work
  94. on them. CatList is fully functional other than these options.
  95.  
  96. If you do not like the list of BBS softwares that are hard coded into
  97. Catlist, you may create a file named "SOFTWARE.CL" and place it into the
  98. door directory.  CatList will look for this file and use that list
  99. instead of the hard coded BBS softwares.  See the enclosed "SOFTWARE.CL"
  100. for the file format.  It *MUST* contain exactly 30 lines.  Each software
  101. type may be a maximum of 8 characters.  That fits "WildCat!" exactly.
  102. <grin>  The modem types may also be changed through the "MODEM.CL" file.
  103. This file must also be located in the door directory.  It contains 18
  104. lines with a maximum of 25 characters per line.  You may delete either
  105. or both of these files if you prefer to keep the defaults in CatList.
  106.  
  107. Users may also download the CATLIST.TXT file via the door. To utilize
  108. this option, you will need a copy of DSZ/GSZ.EXE.  You will need to
  109. create a CFG file named "DSZCFG.x" (x=Node Number).
  110.  
  111. DSZ            <-Line 1
  112. 2F8,3          <-Line 2
  113.  
  114. =========================================================================
  115. This file requires *ONLY* 2 lines.  I have included the instructions
  116. here to enable you to locate them a bit easier.
  117.  
  118.                With this release, users that enter an event may also
  119.                upload an ANSI display screen.  This will require
  120.                creating a file named "DSZCFG.x", with the "x" being the
  121.                node number.  If you have more than 1 node, you must
  122.                create a file for each node.  The format is as follows:
  123.  
  124.                 Line 1:  "DSZ" or "GSZ" (without the quotes) Place the
  125.                          filename of whichever program you use.
  126.  
  127.                 Line 2:  You will need to enter the BASE,IRQ of the node
  128.                          you are operating on here.  For example, If you
  129.                          are using COM2, you should place "2F8,3" on
  130.                          this line.  See the enclosed DSZCFG.1 for a
  131.                          sample.
  132.  
  133.                          COM1      3F8,4 ─┐ Standard
  134.                          COM2      2F8,3 ─┘
  135.                          COM3      3E8,<IRQ> ─┐Put correct IRQ number
  136.                          COM4      2F8,<IRQ> ─┘instead of <IRQ>
  137.  
  138.                 You should read the DSZ/GSZ documentation and the
  139.                 X00.SYS DOCs for further details.  You should also have
  140.                 DSZ.COM or GSZ.COM located in a directory that is in
  141.                 your path.  Users will be given a choice of ZMODEM,
  142.                 XMODEM, XMODEM-1K, XMODEM-CRC, YMODEM and YMODEM-1K.  I
  143.                 wholeheartedly recommend that you register DSZ or GSZ
  144.                 from Chuck Forsberg if you intend to use it.
  145.  
  146. If you wish, you may create a file named "DONOR.CL" and place it in the
  147. CatList door directory.  Place  the user's name in this file that
  148. donated CatList to your BBS.  CatList will display a line:
  149.      CatList courtesy of : <users's name>
  150. If CatList does not locate the file, it will not display the donor line.
  151.  
  152. SUPPORT:
  153.  
  154.      Support for CatList is available from several sources.  Messages
  155. may be left on The Parole Board BBS in the "PAROLE Software" conference
  156. or the Mustang! BBS in the "PRIVATE" conference.  If you feel that a
  157. message is not satisfactory you may call me voice.  (919) 965-3600
  158. Please call before 9:30pm EST as I am an early riser and need to get my
  159. "beauty sleep".
  160.  
  161. NOTE:  *PLEASE* check your file name and paths very carefully.  Ninety
  162. percent of the calls I get, are due to an incorrect path or CFG file
  163. setup.  Read the following instructions carefully before calling.  You
  164. should also read the CATLIST.HIS file as it contains information that is
  165. not included in this file.
  166.  
  167. UPDATES:
  168.  
  169.      Updates are FREE to registered users and may be downloaded from The
  170. Parole Board BBS, Mustang! BBS and various other BBS systems.  Once
  171. registered, CatList updates are free for life.  If you wish an update on
  172. disk, send $3 to the address listed above and specify the disk size.
  173.  
  174.     If you are in a hurry and do not want to take the time to logon,
  175. enter " PAROLE SOFTWARE NOW! " at the name prompt.  It will give you
  176. access to the PAROLE Software file & support areas.  Don't forget the
  177. "!" on "NOW".
  178.  
  179. ---------------
  180.  
  181. CEDITxx.ZIP  This utility allows you to reset the last update of each
  182. record on the CatList database.  This is also a full featured database
  183. editor for CatList.
  184.  
  185. ----------------
  186.                               LEGALITIES
  187.                               __________
  188.  
  189.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  190.       WITHOUT WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  191.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  192.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  193.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  194.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  195.       OR BREACH OF ANY WARRANTY.
  196.  
  197.                              DISTRIBUTION
  198.                              ____________
  199.  
  200.    You may make this file available for downloading from your BBS or you may
  201.    upload it to any BBS of your choice, provided that you do not make any
  202.    changes to the contents of the archive (ZIP file). The archive and its
  203.    individual contents may not be used by any service that charges any money
  204.    whatsoever, without the written permission of the author.
  205.  
  206.         This ZIP file was created using the -AV function of PKZIP.  If
  207.         my AV is missing then this file may not be complete or has been
  208.         tampered with.  Complete and current editions of this program
  209.         are always available for D/L on The Parole Board BBS.  If the -AV
  210.         is missing please complain to your sysop to stop the practice of
  211.         removing AV's as this is your assurance from the programmer that
  212.         the file is complete and virus free.
  213.  
  214. INSTALLATION:
  215.  
  216.     Installation of CatList is an easy straightforward operation.  You
  217. will need to create a directory to hold the CatList files.  For
  218. simplicity, we will use the directory "C:\DOOR\CATLIST" in this
  219. documentation.  Once you have created "\CATLIST", unZIP the CATLISTx.ZIP
  220. archive into that directory.  Create a sub directory named "\AFILES".
  221. The ANSI BBS ads will be ULed to this directory. You should then create
  222. a sub directory called "C:\DOOR\CATLIST\SCREENS". UnZIP the file
  223. "SCREENS.ZIP" into this sub-directory.  SCREENS.ZIP should contain the
  224. following files:
  225.  
  226.      instruct.ans ─┐     User Instructions
  227.      instruct.asc ─┘
  228.      menu.ans     ─┐
  229.      menu.asc      │
  230.      menu2.ans     │     Main Menu
  231.      menu2.asc     │
  232.      menunew.ans   │
  233.      menunew.asc  ─┘
  234.  
  235.      vscreen.ans  ─┐     View system Stats Screen
  236.      vscreen.asc  ─┘
  237.      welcome.ans  ─┐     Opening Welcome Screen
  238.      welcome.asc  ─┘
  239.  
  240.     Any of these screens may be modified by the user but with some
  241. restrictions.  The MENU.xxx, VSCREEN.xxx, and WELCOME.xxx screens must
  242. remain the same physical size since some of the info on them is
  243. hard coded in the CATLIST.EXE program.
  244.  
  245.    MSGIMP.ZIP contains sample .IMP files that you may modify to suit
  246.    your individual tastes.  Place these files where you normally place
  247.    your .IMP files.  This should be in your \WC30\MSG directory.  The
  248.    archive should contain the files "DELETE.IMP" and "EXPIRE.IMP".
  249.  
  250.    You will then need to edit the CATLIST.CFG file(s) to suit your
  251. individual WildCat! setup.  You MUST use an ASCii editor to edit the CFG
  252. file at all times.  Some word processors leave hidden control codes that
  253. could cause CatList to die a horrible and ugly death.  The CATLIST.CFG
  254. file must contain 17 lines.  Make sure that the lines in the CFG file
  255. that require a "^" switch have them.  If you get an "Overflow error" or
  256. and "Illegal function call" then you have probably left one of the
  257. switches off.  The "^" is nothing more than a SHIFT-6.  It is NOT a
  258. CTRL-6 key press.
  259.  
  260. C:\WC30\WCWORK\NODE1\USERINFO.DAT─┐
  261. C:\PCB\USERS.SYS                  ├ <- Path to User file.  I recommend
  262. C:\SF\SFDOORS.DAT                 │    using USERS.SYS for PCBoard and
  263. C:\BBS\DORINFOx.DEF               │    USERINFO.DAT for Wildcat!
  264. C:\BBS\CALLINFO.BBS               │
  265. C:\BBS\GTUSER.DAT                 │
  266. C:\BBS\DOOR.SYS                   │
  267. C:\BBS\PCBOARD.SYS                │
  268. C:\BBS\TRIBBS.SYS                ─┘
  269. The Parole Board BBS                <- BBS Name
  270. Dennis                              <- SysOp's first name
  271. Maidon                              <- SysOp's last name
  272. 12345                               <- Registration Serial number
  273. 100                                 <- Min. Sec level to access door
  274. 260                                 <- Min Sec lev to Add listings
  275. 30                                  <- Number of days to maintain listing
  276. E:\TEXT\TPB-LIST.TXT^L              <- Path to create text file and
  277.                                        switch to determine the type of
  278.                                        text file you want created.
  279.                                        "^S" = Short Listing
  280.                                        "^L" = Long Listing
  281.                                        One of these switches *MUST* be
  282.                                        present.
  283. RIP                                 <- "RIP" = RIP Bulletin "N" = No RIP
  284. C:\WC30\BULL\BULL35.BBS^Y           <- Path to create COLOR bulletin &
  285.                                        @pause@ switch
  286. C:\WC30\                            <- Your HOME dir - ACTIVITY.xxx log
  287. C:\WC30\DISP                        <- Path to your display files
  288. Y                                   <- (Y/N) Create files needed by POSTMASTER
  289.                                        This option is only available to
  290.                                        registered users but, this line
  291.                                        must still be included in the CFG
  292.                                        file.
  293. C:\WC30\DISP\GOODBYE.SCR^Y          <- REGISTERED USERS ONLY FEATURE
  294.                                        "[N]" disables.  Notice the
  295.                                        brackets. "[]"  They have to be
  296.                                        there.
  297.  
  298.                                        This line *MUST* be included in
  299.                                        the CFG file whether you have
  300.                                        registered CatList or not.
  301.                                        CatList will now create a special
  302.                                        color file that contains a
  303.                                        specified number of listings from
  304.                                        the database.  I've had several
  305.                                        request this feature so that
  306.                                        they may use it as a GOODBYE.BBS
  307.                                        screen.  If you want to disable
  308.                                        this feature, place "[N]" on this
  309.                                        line.  If it is disabled, you may
  310.                                        leave off the next line.  The
  311.                                        "^Y" will append a @pause@ to the
  312.                                        special file.  If you do not want
  313.                                        the pause, add "^N" to this line.
  314.                                        One of these switches *MUST* be
  315.                                        used if you do not disable the
  316.                                        special file creation.
  317. 5                                   <- Number of listings in the Special
  318.                                        file.  If you've disabled the
  319.                                        feature, you may leave this line
  320.                                        out of the CFG file.
  321. SPECHDR.DAT                         <- Name of the HEADER file for the
  322.                                        Special file.  This will allow
  323.                                        you to run multiple copies of
  324.                                        CatList in the same directory and
  325.                                        have a different header for each copy.
  326.  
  327.               ===========================================
  328. NOTE:     There are 2 additional lines necessary when using GTUSER.BBS.
  329.           Since this file does not provide the Comport and Node number,
  330.           You need to add the to the CFG file on lines 5 and 6.  All
  331.           other lines in the CFG file move up accordingly.   Instead of
  332.           17 lines, you will have 19 lines.
  333.  
  334. Line 1    This is where CatList will look to find USERINFO.DAT.  It MUST
  335.           always point to the NODEx directory and NOT the \WC30
  336.           directory.  You must use USERINFO.DAT, do not use DOOR.SYS for
  337.           a WC! BBS.
  338.  
  339. Line 2    Your BBS name
  340.  
  341. Line 3    Your First Name or the name you go by on the BBS (DO NOT use
  342.           "SYSOP")
  343.  
  344. Line 4    Your last name
  345.  
  346. Line 5    When you register CatList you will be given a serial number.
  347.           Place it on this line.  Until then, you may put any number you
  348.           desire here or leave it blank.
  349.  
  350. Line 6    This is the minimum security level that you will allow to
  351.           enter the door.  DO NOT use the Security Name In makewild.
  352.           Always use the Menu Access number.
  353.  
  354.      ┌──────────── MISCELLANEOUS ────────────┐
  355.      │ Menu access level        150          │<-  Use this Number from the
  356.      │ Menu display set         6            │    EDIT PROFILE SCREEN in
  357.      │ Daily time limit         120          │    MAKEWILD.  The cotton-picker
  358.      │ Maximum logon time       60           │    won't work if you use the
  359.      │ Maximum up/down ratio    50           │    Security Profile NAME.
  360.      │ Maximum daily downloads  15           │    Trust Me, I've been there.
  361.  
  362. Line 7   This is the minimum security level that may Add, Edit, Delete
  363.           or Update listings.  Same procedure as Line 6
  364.  
  365. Line 8    This is the number of days that a BBS listing will remain current.
  366.           If you specify "45" here, all listing will remain valid for 45
  367.           days. At that time a notice will be sent to the LISTER that his
  368.           listing has expired and that it will be deleted in 10 days.  He
  369.           will receive a notice each day for the 10 days.  On the eleventh
  370.           day, if the listing has not been updated, it will be deleted from
  371.           the database.  There is no way to recover the listing once it has
  372.           been deleted.  Users are notified by using the "USERxxxx.BBS" files
  373.           in the Display directory.  These files are deleted by Wildcat! once
  374.           they have been sent to the user.  The first person to enter the door
  375.           each day causes the program to run the maintenance and update
  376.           routines.  DO NOT delete the file, LASTCHK.DAT, unless i give
  377.           instructions to do so in an upgrade.  This file is used by
  378.           CatList to make sure the maintenance is run when it is needed.
  379.  
  380. Line 9    This line contain the path and name of the text file that you
  381.           want CatList to create.  This file contains no color codes and
  382.           is paginated for a printer.  This file is similar to the
  383.           WCLIST.TXT file that the List door on Mustang! BBS creates.
  384.           <G> You may also specify the type of listing you want created.
  385.           "^S" = Short Listing (no description)
  386.           "^L" = Long listing  (full description)
  387. Line 10   CatList supports RIP graphics in that it will create a RIP
  388.           bulletin.  Place "RIP" on this line if you support RIP and
  389.           wish CatList to create a RIP bulletin.  Place a "N" to disable
  390.           this function.
  391. Line 11   This is the path and name of the COLOR bulletin that you want
  392.           created.  This bulletin is created using WC!3.x color codes
  393.           and MUST have a ".BBS" filename extension. You may also prefer
  394.           a HELLOx.BBS screen though the file could get a bit large in
  395.           due time.  You can also set the default for the @pause@ at the
  396.           end of the bulletin.  At the end of the bulletin use a "^" as
  397.           the spacer and place either a "Y" or "N".  One of them *MUST*
  398.           be there for the program to work properly.
  399.  
  400. Line 12   Path where CatList will find you ACTIVITY.xxx files.  This is
  401.           your Wildcat! home directory.  CatList writes  to the
  402.           individual Activity logs so that you can keep tabs on what
  403.           happens in the door.
  404.  
  405. Line 13   This is the path to your Display directory.  Catlist will
  406.           write the USERxxxx.BBS file in this directory.
  407.  
  408. Line 14   (Y/N)  If this line is set to "Y" then Catlist will create the
  409.           CATLIST.EXP & CATLIST.DEL files that are needed by POSTMASTER.
  410.           This option is only available to registered users but, this
  411.           line must still be included in the CFG file.
  412.  
  413. Line 15   REGISTERED USERS!  This line must be included in the CFG file
  414.           for CatList to operate.   If you want to disable it, place
  415.           "[N]" on this line.  CatList will now create a color display
  416.           file with only a specified number of listings from the
  417.           database.  The number of listings in the file is controlled by
  418.           line 16. "^Y" = @pause@  "^N" = no pause.
  419.  
  420. Line 16   Number of listings to be included in the Special file on line
  421.           15.
  422.  
  423. Line 17.  Name of the HEADER file to append to the Special file.  Be
  424.           sure to add the proper color codes that you prefer to this
  425.           file.  A sample is included in "SPECHDR.DAT".
  426.  
  427.      Make sure that all your CFG files contain 17 lines.  If you are
  428.      operating a Multi-Node setup, you must have a separate CFG file for
  429.      each node.  Each CFG file mus also have unique name such as:
  430.  
  431.      BBS1.CFG   BBS2.CFG   BBS3.CFG
  432.                             ---------------
  433.  
  434. NOTE:  You may now use one (1) CFG file for multi-node by using the
  435. environment variables.
  436.  
  437. When specifying the location of the system file on line 1 of the doors .CFG
  438. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  439. and %wcnodeid%. Some examples:
  440.  PCBoard: 
  441.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  442.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  443.  
  444.  Wildcat!:
  445.    USERINFO.DAT in C:\WC30\WCWORK\NODE1   - C:\WC30\WCWORK\NODE%WCNODEID%
  446.  
  447. Non-PCBoard systems may use the PCB environment variables by setting them
  448. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  449.  SET PCBDRIVE=C:
  450.  SET PCBDIR=\BBSDIR
  451.  SET PCBNODE=1
  452.  
  453. NOTE:  See the enclosed archive, "CATLIST.PCB" for details on installing
  454. CatList on PCBoard v15.0.
  455.                              --------------
  456. Create the CFG file(s) for you particular BBS.  You will also need a DOORx.BAT
  457. to run the door.  This one is simple.
  458.  
  459. @ECHO OFF
  460. CD \DOOR\CATLIST
  461. CATLIST BBS.CFG /5  or CATLIST BBS.CFG /%WCIRQID%
  462.               ──┬─
  463.  ┌──────────────┘
  464.  └ If you are running non-Standard Com ports on your BBS, you will need to pass
  465.  the proper IRQ to the door.  It doesn't hurt to pass the IRQ even if they are
  466.  standard.  If a user enters the door and it just sits there acting sort of
  467.  stupid, it's probably looking for the correct IRQ.  Always pass it on the
  468.  command line and there will be no question.  Some networks have a problem
  469.  using the "/" symbol.  CatList will now accept an asterisk "*" in place of
  470.  the "/".  You may also use the environment variable in the DOORx.BAT file to
  471.  pass info to the door.
  472.  
  473. CATLIST BBS%WCNODEID%.CFG /%WCIRQID%
  474.  
  475. Make sure you DO have the variables set if you use this method.
  476.  
  477. NOTE: CatList supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  478.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  479.       number after the configuration filename. Let's assume your Door is
  480.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  481.       passed to your Door would be:
  482.  
  483.         FOOBAR FOOBAR.CFG /5
  484.  
  485.       The /5 tells CatList to use IRQ5 rather than the standard IRQ4 that
  486.       is normally used with COM1. No /x parameter is needed for the standard
  487.       IRQ's. CatList supports IRQs 1 - 15.
  488.  
  489. CatList Files
  490. _____________________
  491.  
  492. CLBRDR.RIP     Registered Users may create this file to replace the
  493.                default "CATLIST.RIP".  CatList will look for the
  494.                existence of this file in the "\SCREENS" directory and
  495.                display it if found.  This screen is the border around
  496.                the text area of CatList.
  497.                ---REGISTERED SYSOPS ONLY!---
  498. SPECHDR.RIP    CatList will look for this file in the door directory and
  499.                use it as the RIP header on the Spec File instead of the
  500.                default header.  Most SysOps use the Spec File as a
  501.                GOODBYE screen for their BBS.
  502.                ---REGISTERED SYSOPS ONLY!---
  503.  
  504. HI2LO.SRT      CatList defaults to sorting the database from low to high using
  505.                the area code of the BBS telephone number.  If CatList detects
  506.                this file in the door directory, it will sort and print the
  507.                bulletins from high to low.  It may be a "0" byte file.
  508.  
  509. RIP.NO         If CatList detects this file in the door directory, it will
  510.                disable all RIPSCRIP support.  Even if you do not support RIP
  511.                on your BBS, CatList will function properly using RIP if the
  512.                incoming caller is using a RIP compatible term program.  This
  513.                may be a "0" byte file.
  514.  
  515. GOODBYE.NO     If you do not wish to offer users the ability to
  516.                [G]oodbye from the door, create this file and place it in
  517.                the CatList directory.  This may be a '0' byte file.
  518.  
  519. NOTICE.NO      If you utilize POSTMASTER or other similar utility and
  520.                wish to prevent the creation of the "USERxxxx.BBS"
  521.                notification files, place this file in your CatList
  522.                directory and those files well not be created.  The
  523.                "CATLIST.DEL" and "CATLIST.EXP" files will still be
  524.                created.
  525.                ---REGISTERED SYSOPS ONLY!---
  526.  
  527. CLTEXT.TXT     This file is an ASCii file containing all the prompts used in
  528.                CatList.  Registered SysOps may obtain a utility that allows
  529.                you to edit the .TXT file and recompile it to the CLTEXT.DAT
  530.                file.  MKCLTXT.EXE
  531.  
  532. HEADER.DAT     If CatList detects this file, it will read it in and print it
  533.                out in the CATLIST.TXT file as a header.
  534.                ---REGISTERED SYSOPS ONLY!---
  535.  
  536. TAIL.DAT       CatList will append the contents of this file to the end of the
  537.                CATLIST.TXT file if it is detected.
  538.                ---REGISTERED SYSOPS ONLY!---
  539.  
  540. CATLIST.SPC    This is an ASCii file that is placed in the door directory.  If
  541.                CatList detects it, it will be displayed to all incoming
  542.                callers after the welcome screen.
  543.                ---REGISTERED SYSOPS ONLY!---
  544.  
  545. LASTCHK.DAT    Created by CatList.  DO NOT delete this file.  This is
  546.                NOT an ASCii file.  DO NOT try and edit it.  This is used
  547.                by CatList to make sure the maintenance is run at the
  548.                proper time.
  549.  
  550. CATLIST.DEL    This file is created only if you have the CFG set up to
  551.                use Postmaster.  It contains the user names that have
  552.                had listings deleted.  Created by CatList in the same
  553.                directory as the ACTIVITY.xxx file.
  554.  
  555. CATLIST.EXP    This file is created only if you have the CFG set up to
  556.                use Postmaster.  It contains the user names that have
  557.                listings that are expired.  Created by CatList in the
  558.                same directory as the ACTIVITY.xxx file.
  559.  
  560. CHANGE.FIL     Created by CatList.  This file is created when the
  561.                database has been changed.  WC! SysOps may test for this
  562.                file in their DOORx.BAT file and have TranScan update the
  563.                CATLIST.TXT file that is created.
  564.  
  565. CATLIST.LOG    Created by CatList.  This contains the names of users
  566.                that have entered listings in CatList.
  567.  
  568. DSZCFG.x       This is the config file to allow DSZ or GSZ to be used in
  569.                conjunction with CatList so that users may Download the
  570.                text file or upload ANSI ads to the BBS.
  571.  
  572. NOTE->>>>>     CatList has the following information hard coded into the code.
  573.                However; Registered SysOps may create the following files to
  574.                override the defaults in CatList.  If CatList detects these
  575.                files, it will read them into memory.  If not, it will use the
  576.                coded defaults.  These .CL files allow you to personalize your
  577.                CatList installation.
  578.  
  579. NETWORK.CL     This is an ASCii file that contains 10 lines.  Each line has
  580.                the name of one network on it.  You may use no more than 15
  581.                characters in each line.  Do NOT use a "!" in this file.  It
  582.                will disrupt the RIP display on the remote end.
  583.                ---REGISTERED SYSOPS ONLY!---
  584.  
  585. MODEM.CL       This file contains the list of modems that are presented to the
  586.                lister for their selection.  This file must contain 18 lines
  587.                with a maximum of no more than 25 characters per line.
  588.                ---REGISTERED SYSOPS ONLY!---
  589.  
  590. SOFTWARE.CL    This file contains the BBS software selections presented to
  591.                users.  This is an ASCii file containing 30 lines with a
  592.                maximum of 8 characters per line.
  593.                ---REGISTERED SYSOPS ONLY!---
  594.  
  595. DONOR.CL       If your Registered version of CatList was donated by a user,
  596.                you may place their name(s) in this file and CatList will
  597.                display the info to all incoming callers.
  598.  
  599. NOTE-> Creating a "0" byte file.  At the DOS prompt, type the following:
  600.  
  601.      COPY CON <filename> [CR]
  602.      press <F6> [CR]
  603.  
  604.      [CR] = Enter
  605.      This will create a '0' byte file using the <filename> specified in the
  606.      command line above.
  607.  
  608. Fossil Driver Support
  609. ---------------------
  610. CatList supports the use of Fossil drivers.  To tell your Door to use the
  611. Fossil driver instead of the standard COM ports, just put /FD on the command
  612. line when running the door. For example:
  613.  
  614.      MYDOOR MYDOOR.CFG /FD
  615.      MYDOOR MYDOOR.CFG *FD
  616.  
  617. indicates that a Fossil driver is present and should be used. If no Fossil
  618. driver is detected, CatList will print a message to that effect and exit
  619. the door gracefully.
  620.  
  621.     If you have WC! set up to TERMINATE on Doors, you will need to add a
  622.     line to reload the BBS.  I'm not sure about the exact way this is
  623.     set up since I do not use this method.  Check your WC! Manual.
  624.  
  625.      Wildcat! will pick up the [G]oodbye from the door as a normal
  626.      logoff.  It is possible that Livecat! will see this as a Drop
  627.      Carrier and not pass it to WC! as a normal logoff.  No damage is
  628.      done.
  629.  
  630. GOODBYE Option:  ("tBernasconi" switch)
  631.  
  632.      If you do not wish the users to [G]oodbye from the door, create a
  633. file in the door directory named "GOODBYE.NO".  CatList will look for
  634. this file and if it exists, will disable the [G]oodbye option.
  635.  
  636. NOTE:  You may edit any of the screens included in this archive for your
  637.        personal use.  DO NOT distribute them in the CATLIST.ZIP archive.
  638.        You may distribute them separately.  I recommend using TheDraw to
  639.        edit the screens.  They should remain the same physical size as
  640.        the originals.  Be sure to delete any trailing blank lines at the
  641.        bottom of the screens.
  642.  
  643.  
  644. CREDITS:
  645.  
  646.      Wildcat! BBS is Copyright 1985-1993, Mustang Software Inc.
  647.  
  648.      PCBoard is a registered trademark of Clark Development Company.
  649.  
  650.      PostMaster is Copyright 1992, Dave Cody and BoardWalk Software
  651.  
  652.      CatList was written using the DoorFrame Door module for MicroSoft's
  653.      Visual Basic for MS-DOS, Professional Version.
  654.  
  655.      TranScan is copyright by Craig Dunstan.
  656.  
  657.      DoorFrame is Copyright 1990-1993, Ted Freeman
  658.      NOTE- Ted Freeman passed away on July 13, 1993.  If you ever had the
  659.      opportunity to meet or talk with him, you couldn't help but like him.  He
  660.      will be sorely missed in the BBS world.
  661.  
  662.      Visual Basic for MS-DOS is Copyrighted by Microsoft Corporation.
  663.  
  664.      The ßeta Team [W]ho's Who:
  665.  
  666.      Mike Shockley   Shock Treatment        Garland, TX       (214) 495-5980
  667.  
  668.      Lee Fisher      The LOST BBS           Overland Pk., KS  (913) 642-0349
  669.  
  670.      Steve Sambor    Land of the Unicorns   Bronxville, NY    (914) 961-0399
  671.  
  672.      Craig Dunstan   TranScan BBS           Topeka, KS        (913) 266-0781
  673.  
  674.      Ned Attayek     Free Advice BBS        Smithfield, NC    (919) 934-1002
  675.  
  676.      Herb Dunn       The Dew Drop Inn       Bakersfield, CA   (805) 322-5587
  677.  
  678.      Tom Lamere      The Petting Zoo        Phoenix, AZ       (602) 992-0019
  679.  
  680.      Alan Bennett    Terminal Entry         Rockingham, NC    (919) 895-0368
  681.  
  682.      Without the time and effort that was spent by the preceding BETA
  683.      team members, CatList would not have been possible.
  684.  
  685.      Also, a special thanks to all of you that have called with
  686.      suggestions for CatList.
  687.  
  688.      DSZ / GSZ Copyright Chuck Forsberg
  689.  
  690.      TheDraw Copyright 1986-1993, TheSoft Programming Services and Ian
  691.      E. Davis.
  692.  
  693.      All other brand and product names are registered trademarks or
  694.      copyright of their respective companies.
  695.  
  696.