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