home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CLSSAD25.ZIP / SYSOP.MAN < prev    next >
Text File  |  1995-01-18  |  15KB  |  350 lines
  1.  
  2.                           Classified Ads v2.50
  3.  
  4.                    Copyright 1993-95, PAROLE Software
  5.                           ALL RIGHTS RESERVED
  6.  
  7.                           The Parole Board BBS
  8.               (919) 965-4696 -> US Robotics v.Everything
  9.                             FIDO: 1:151/185
  10.               (919) 965-9885 -> US Robotics v.Everything
  11.                             FIDO: 1:151/183
  12.  
  13.                            PAROLE Software
  14.                            9411 Buffalo Rd
  15.                            Clayton, NC  27520
  16.  
  17.               (919) 965-3600 -> Voice (Before 9:30 pm EST)
  18.  
  19.  
  20. DESCRIPTION:
  21.  
  22.      Classified Ads is a full-featured Ad listing door with support for
  23.      most major BBS user drop files.  It supports DOOR.SYS,
  24.      USERINFO.DAT, USERS.SYS, PCBOARD.SYS, SFDOORS.DAT, DORINFOx.DEF,
  25.      TRIBBS.SYS, CALLINFO.BBS and GTUSER.BBS.
  26.  
  27.      Users may enter the door and list their ad with their telephone
  28.      number and a short description of the service they are advertising.
  29.      SysOps may use 10 different categories of their on choice in the
  30.      door.
  31.  
  32. SUPPORT:
  33.  
  34.      Support for Classified Ads is available from several sources.  Messages
  35. may be left on The Parole Board BBS in the "PAROLE Software" conference
  36. or the Mustang! BBS in the "PRIVATE" conference.  If you feel that a
  37. message is not satisfactory you may call me voice.  (919) 965-3600
  38. Please call before 9:30pm EST as I am an early riser and need to get my
  39. "beauty sleep".
  40.  
  41. NOTE:  *PLEASE* check your file name and paths very carefully.  Ninety
  42. percent of the calls I get, are due to an incorrect path or CFG file
  43. setup.  Read the following instructions carefully before calling.
  44.  
  45. UPDATES:
  46.  
  47.      Updates are FREE to registered users and may be downloaded from The
  48. Parole Board BBS, Mustang! BBS and various other BBS systems.  Once
  49. registered, CatList updates are free as long as I own the rights to it.
  50. If you wish an update on disk, send $3 to the address listed above and
  51. specify the disk size.
  52.  
  53. REGISTRATION:
  54.  
  55.       Registration is currently $15 and will entitle you to future
  56. upgrades.  I reserve the right to change the price in the future.
  57.  
  58. INSTALLATION:
  59.  
  60. Configuration file layout:
  61.  
  62. C:\PCB\PCBOARD.SYS             ─┐< For PCBoard systems using PCBOARD.SYS only
  63. C:\PCB\USERS.SYS                │< For PCBoard systems using USERS.SYS
  64. C:\BBS\CALLINFO.BBS             │< For Wildcat! systems (prior to v3.0)
  65. C:\BBS\GTUSER.BBS               │< For GT Power systems
  66. C:\WC\WCWORK\NODE1\USERINFO.DAT │< For Wildcat! 3.x+ systems.
  67. C:\WC\WCWORK\NODE1\DOOR.SYS     │< For Wildcat! 4.x+ systems.
  68. C:\BBS\DOOR.SYS                 │< For systems that support DOOR.SYS
  69. C:\BBS\DORINFOx.DEF             │< For QBBS/RBBS/RA. Replace x with Node #.
  70. C:\BBS\SFDOORS.DAT              │< For Spitfire systems.
  71. C:\BBS\TRIBBS.SYS              ─┘< For TriBBS systems.
  72. The Parole Board BBS
  73. Dennis
  74. Maidon
  75. 123456
  76. 14
  77. 10
  78. C:\WC30\BULL\BULL99.BBS
  79. [LEAVE BLANK] if "WC" or "PCB" in next line.
  80. WC
  81. YES
  82. C:\WC30
  83. C:\WC30\ADS
  84. YES
  85. YES
  86. E:\TEXT
  87. RIP
  88.  
  89. On lines 12, 13 and 16, the trailing "\" is optional.  ADDOR.EXE will
  90. auto-detect it and act accordingly.
  91.  
  92.  1.  Path to BBS User file
  93.  2.  Your BBS name
  94.  3.  SysOp's first name.
  95.  4.  SysOp's last name.
  96.  5.  Serial Number if registered.
  97.  6.  Number of days for listings to remain active. {set to 3-5 for beta}
  98.  7.  Minimum Sec. Level to access door
  99.  8.  Path and name of Color bulletin. Be sure to add the name of the
  100.      bulletin that you want created on line 8 and 9.
  101.  9.  Path and name of ASCii bulletin
  102. 10.  Type of Bulletins (WC = Wildcat!3.x  PCB = PCBoard  N = ANSI/ASCii)
  103.      If you select the WC! or PCB type bulletins, you will only need to
  104.      supply a filename and path for the color bulletin.  You still must
  105.      include line 8.  You may leave it blank though.
  106. 11.  (Y/N)  Create the above bulletins.  This option ONLY works for
  107.      registered versions.  The bulletins are automatically created in
  108.      the DEMO versions.  They cannot be switched off.
  109. 12.  Path to ACTIVITY.LOG.  DO NOT put a filename on this line.  If you
  110.      are running Wildcat!3.x, ClassAds will write to the correct
  111.      ACTIVITY.xxx.  ClassAds will write to a file named ACTIVITY.xxx in
  112.      the directory you have specified if you are not running WC!.  The
  113.      "xxx" will correspond to the node number.
  114. 13.  If you select the option to have ClassAd write bulletins to a
  115.      separate directory, enter the directory path here. (Read DOCs for
  116.      further details.) See SPECIAL DIRECTORY INSTRUCTIONS below.  This
  117.      option is currently *ONLY* available to Wildcat!3/4 systems.
  118. 14.  (Y/N) Create the bulletins in the special directory.  This option
  119.      ONLY works for the registered version.  These bulletins are NOT
  120.      created in the DEMO version.  They can not be switched on.
  121. 15.  (Y/N) Create the ASCii text file.  This file is automatically
  122.      created in the DEMO version.  It cannot be switched off.
  123. 16.  Path of the ASCii text file.  DO NOT put a filename here. ADDOR.EXE
  124.      will append "CLASSAD.TXT" to the path you specify. This path *MUST*
  125.      exist as this file is written in the DEMO version.
  126. 17.  "RIP" = Create RIP bulletins "N" = do not create RIP bulls
  127.  
  128. All 17 lines must be present in the CFG file.  The lines that are not
  129. needed or used, may be blank but, they must be there.
  130.  
  131. NOTE: There are 2 additional lines necessary when using GTUSER.BBS. Since
  132.       this file does not provide the ComPort% and NodeNum% variables, you
  133.       will need to add them to this .CFG file on lines 5 and 6
  134.       respectively.
  135.  
  136. Classified Ads will operate on a multi-line BBS.  If you do not
  137. incorporate the environment variables defined below, you will need a
  138. separate CFG file for each node.  You must give each CFG its own
  139. distinct name.
  140.  
  141.      EX:  CLASSAD1.CFG   CLASSAD2.CFG   CLASSAD3.CFG
  142.  
  143. CLASSAD.LST
  144.  
  145.      You will need to edit the enclosed "CLASSAD.LST" and include the
  146. categories that suit your individual needs.  This file may contain up to
  147. 20 lines.  Please use and ASCii editor such as Qedit to edit this file as
  148. some word processors add hidden control codes that could cause
  149. unpredictable results.   The maximum length of each line is 25
  150. characters.
  151.  
  152. SYSOP.CL
  153.  
  154.      This file, if it exists, must reside in the door directory.  It is
  155. simply an ASCii text file containing one user name per line.  Place the
  156. name of any user that you wish to have SysOp access in the door.  This
  157. will give those users the ability to edit any listing in the database.
  158.  
  159. CLASSUP.CFG
  160.  
  161.      See the enclosed sample for details concerning this file.  This is
  162. only available to registered sysops.
  163.  
  164.  
  165. SPECIAL DIRECTORY INSTRUCTIONS:
  166.  
  167.      This part is only available at the present time to WC!3.x systems.
  168. If, in the future, I can get some idea as to how to implement this on
  169. different systems, I will make it available.
  170.  
  171.  
  172. 13.  If you select the option to have ClassAd write bulletins to a
  173.      separate directory, enter the directory path here. (Read DOCs for
  174.      further details.)
  175.  
  176. To set this function up, you must enter your "Conference Definition"
  177. setup in MAKEWILD.  Create a message conference entitled "Classified
  178. Ads" or whatever title suits your fancy.  Give this conference its own
  179. Bulletin Directory path.  ADDOR.EXE will create the necessary
  180. BULLETIN.BBS and a bulletin for each record listed in the database.
  181. There is no special maintenance that the sysop needs do in this area.
  182. If a record is deleted in the database, ADDOR.EXE will delete the proper
  183. BULLx.BBS.
  184.  
  185. You will need to set the # of bulletins allowed in this area to the
  186. maximum number of bulletins that you expect.  ADDOR.EXE will allow up to
  187. 500 in the database.  WC! allows 999 in each bulletin conference.
  188.  
  189. ╔══════════╦════════════════════════════════════════════════════════╦══════════╗
  190. ║ 02-17-93 ║                 Conference Definition                  ║ 19:56:02 ║
  191. ╚══════════╩════════════════════════════════════════════════════════╩══════════╝
  192.  
  193.         #           Description            #           Description
  194.        ───   ─────────────────────────    ───   ─────────────────────────
  195.          0 - !PRIVATE! Mail      [TPB]      1 - !PUBLIC! Mail       [TPB]
  196.          2 - New Users!          [TPB]      3 - PAROLE Software     [TPB]
  197.          4 - Classified Ads      [TPB]      5 -
  198.  
  199. ╔══════════════════════════════════════════════════════════════════════════════╗
  200. ║                 Copyright (c) 1989,93 Mustang Software, Inc.                 ║
  201. ║     [F1] Help - [F2] Edit Access - [F3] Copy - [F4] Global - [ESC] Exit      ║
  202. ╚══════════════════════════════════════════════════════════════════════════════╝
  203.  
  204. ╔══════════╦════════════════════════════════════════════════════════╦══════════╗
  205. ║ 02-17-93 ║                 Conference Definition                  ║ 19:56:07 ║
  206. ╒═══════════════════════════ CONFERENCE DESCRIPTION ═══════════════════════════╕
  207. │                                                                              │
  208. │  Conference Classified Ads      [TPB]   ┌────────── MISCELLANEOUS ─────────┐ │
  209. │                                         │ Conference sysop DENNIS MAIDON   │ │
  210. │ ┌─────────────── PATHS ───────────────┐ │ Mail type                Normal  │ │
  211. │ │ Bulletins      C:\WC30\ADS\         │ │ Max conference messages  100     │ │
  212. │ │ Questionnaires C:\WC30\QUES\        │ │ Max lines per message    150     │ │
  213. │ │ Menus          F:\MENU\             │ │ Number of questionnaires 3       │ │
  214. │ │ Help           F:\HELP\             │ │ Number of bulletins      50      │ │
  215. │ │ Display files  F:\DISP\             │ │ Check valid name         No      │ │
  216. │ │ Messages       C:\WC30\MSG\         │ │ File area access                 │ │
  217. │ └─────────────────────────────────────┘ └──────────────────────────────────┘ │
  218. │ ┌───────────────────────────────── TOGGLES ────────────────────────────────┐ │
  219. │ │ Allow message attachments        N    Allow return receipts            Y │ │
  220. │ │ Prompt to kill received messages Y    Allow private messages           Y │ │
  221. │ │ Allow high ascii characters      Y    Force all messages private       N │ │
  222. │ │ Allow message carbon copies      Y    Use alias names                  N │ │
  223. │ │ Read only conference             N                                       │ │
  224. │ └──────────────────────────────────────────────────────────────────────────┘ │
  225. ╘══════════════════════════════════════════════════════════════════════════════╛
  226. ║                 Copyright (c) 1989,93 Mustang Software, Inc.                 ║
  227. ║     [F1] Help - [F2] Edit Access - [F3] Copy - [F4] Global - [ESC] Exit      ║
  228. ╚══════════════════════════════════════════════════════════════════════════════╝
  229.  
  230. 14.  (Y/N) Create the bulletins in the special directory.  This option
  231.      ONLY works for the registered version.  These bulletins are NOT
  232.      created in the DEMO version.  They can not be switched on.
  233.  
  234. MISCELLANEOUS NOTES:
  235.  
  236. ADDOR.EXE requires DOS 3.x and up since all files are opened in SHARED mode.
  237.  
  238. When using PCBOARD.SYS, ADDOR.EXE also accesses the USERS file.
  239.  
  240. When using USERS.SYS, ADDOR.EXE also accesses PCBOARD.SYS, PCBOARD.DAT and the
  241. USERS file.
  242.  
  243. The DOOR.SYS used by ADDOR.EXE is the standard 52 line GAP (tm) file.
  244.  
  245. The CALLINFO.BBS used by ADDOR.EXE currently contains 36 lines.
  246.  
  247. WILDCAT! EXTRA:
  248.  
  249. If ADDOR.EXE updates the Text file, it will write a 0-byte file to the
  250. door directory named, CHANGE.FIL.  If you use Transcan to update the WC!
  251. database, you can test for this file and only run TranScan when needed.
  252. Be sure to delete it after running transcan.  There may be utilities
  253. that will update the databases of various other BBS systems.  CHANGE.FIL
  254. is created whenever the CLASSAD.TXT is updated.
  255.  
  256. @ECHO OFF
  257. CLS
  258. D:
  259. CD \DOOR\AD
  260. ADDOR AD.CFG /%WCIRQID%
  261. IF EXIST D:\DOOR\AD\CHANGE.FIL TS E:\TEXT\CLASSAD.TXT /TK,T
  262. IF EXIST D:\DOOR\AD\CHANGE.FIL ERASE D:\DOOR\AD\CHANGE.FIL
  263.  
  264. Fossil Driver Support
  265. ---------------------
  266. ADDOR.EXE supports the use of Fossil drivers.  To tell your Door to use the
  267. Fossil driver instead of the standard COM ports, just put /FD on the command
  268. line when running the door. For example:
  269.      MYDOOR MYDOOR.CFG /FD
  270. indicates that a Fossil driver is present and should be used. If no Fossil
  271. driver is detected, ADDOR.EXE will print a message to that effect and exit
  272. the door gracefully.
  273.  
  274.      Unless you are using a Digi-board, do not use the "/FD" switch with
  275. ADDOR.EXE.  There is a bug in DoorFrame pertaining to fossil drives that
  276. causes erratic behavior.
  277.  
  278. Environment Variables
  279. ---------------------
  280. ADDOR.EXE supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  281. COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  282. number after the configuration filename. Let's assume your Door is
  283. called FOOBAR and you want to use COM1 and IRQ5. The command line
  284. passed to your Door would be:
  285.     FOOBAR FOOBAR.CFG /5  or
  286.     FOOBAR FOOBAR.CFG /%IRQ%  for the environment variable.
  287. The /5 tells ADDOR.EXE to use IRQ5 rather than the standard IRQ4 that
  288. is normally used with COM1. No /x parameter is needed for the standard IRQ's.
  289.  
  290. When specifying the location of the system file on line 1 of the doors .CFG
  291. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  292. and %wcnodeid%. Some examples:
  293.  
  294.  PCBoard: 
  295.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  296.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  297.  
  298.  Wildcat!:
  299.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  300.  
  301. Non-PCBoard systems may use the PCB environment variables by setting them
  302. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  303.  SET PCBDRIVE=C:
  304.  SET PCBDIR=\BBSDIR
  305.  SET PCBNODE=1
  306.  
  307. DISCLAIMER:
  308.  
  309.                               LEGALITIES
  310.                               __________
  311.  
  312.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  313.       WITHOUT WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  314.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  315.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  316.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  317.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  318.       OR BREACH OF ANY WARRANTY.
  319.  
  320. DISTRIBUTION:
  321.  
  322.      The current release of Classified Ads may be found on The Parole
  323. Board BBS and will be available to all first time callers.  I will also
  324. upload it to select BBSs across the country.
  325.  
  326. NOTES:
  327.  
  328.      Classified Ads is written and compiled using Visual Basic for DOS
  329.      v1.0 (Professional Version)  VB/DOS is copyright 1992, MicroSoft
  330.      Inc.
  331.  
  332.      Wildcat! is Copyright 1986,1994 Mustang Software Inc.
  333.  
  334.      Many thanks to the SysOps that helped to test this door product.
  335.      Their names and BBS info may be viewed by selecting "$" from the
  336.      Main Menu.
  337.  
  338.      Qedit is Copyright (C) 1985-1993 by SemWare, all rights reserved
  339.  
  340.      This door was written using the DoorFrame module by Ted Freeman.
  341.  
  342.      Bill Clinton for making all this necessary.  I need the $$$ to pay
  343.      his darn taxes.
  344.  
  345.      Mike Rickman for creating and donating the instruction screens.
  346.  
  347.      Thanks to all that have made suggestions for the door.
  348.  
  349.  
  350.