
                          Classified Ads v2.60

                   Copyright 1993-95, PAROLE Software
                          All rights reserved.

                          The Parole Board BBS
              (919) 965-4696 -> US Robotics v.Everything
                            FIDO: 1:151/185

                           PAROLE Software
                           9411 Buffalo Rd
                           Clayton, NC  27520

              (919) 965-3600 -> Voice (Before 8:30 pm EST)


DESCRIPTION:

     Classified Ads is a full-featured Ad listing door with support for
     most major BBS user drop files.  It supports DOOR.SYS,
     USERINFO.DAT, USERS.SYS, PCBOARD.SYS, SFDOORS.DAT, DORINFOx.DEF,
     TRIBBS.SYS, CALLINFO.BBS and GTUSER.BBS.

     Users may enter the door and list their ad with their telephone
     number and a short description of the service they are advertising.
     SysOps may use 10 different categories of their on choice in the
     door.

SUPPORT:

     Support for Classified Ads is available from several sources.  Messages
may be left on The Parole Board BBS in the "PAROLE Software" conference
or the Mustang! BBS in the "PRIVATE" conference.  If you feel that a
message is not satisfactory you may call me voice.  (919) 965-3600
Please call before 8:30pm EST as I am an early riser and need to get my
"beauty sleep".

NOTE:  *PLEASE* check your file name and paths very carefully.  Ninety
percent of the calls I get, are due to an incorrect path or CFG file
setup.  Read the following instructions carefully before calling.

UPDATES:

     Updates are FREE to registered users and may be downloaded from The
Parole Board BBS, Mustang! BBS and various other BBS systems.  Once
registered, ClassAd/DOS updates are free as long as I own the rights to it.
If you wish an update on disk, send $3 to the address listed above and
specify the disk size.

REGISTRATION:

      Registration is currently $15 and will entitle you to future
upgrades.  I reserve the right to change the price in the future.

INSTALLATION:

Configuration file layout:

C:\PCB\PCBOARD.SYS             Ŀ< For PCBoard systems using PCBOARD.SYS only
C:\PCB\USERS.SYS                < For PCBoard systems using USERS.SYS
C:\BBS\CALLINFO.BBS             < For Wildcat! systems (prior to v3.0)
C:\BBS\GTUSER.BBS               < For GT Power systems
C:\WC\WCWORK\NODE1\USERINFO.DAT < For Wildcat! 3.x+ systems.
C:\WC\WCWORK\NODE1\DOOR.SYS     < For Wildcat! 4.x+ systems.
C:\BBS\DOOR.SYS                 < For systems that support DOOR.SYS
C:\BBS\DORINFOx.DEF             < For QBBS/RBBS/RA. Replace x with Node #.
C:\BBS\SFDOORS.DAT              < For Spitfire systems.
C:\BBS\TRIBBS.SYS              < For TriBBS systems.
The Parole Board BBS
Dennis
Maidon
123456
14
10
C:\WC30\BULL\BULL99.BBS
[LEAVE BLANK] if "WC" or "PCB" in next line.
WC
YES
C:\WC30
C:\WC30\ADS
YES
YES
E:\TEXT
RIP

On lines 12, 13 and 16, the trailing "\" is optional.  ADDOR.EXE will
auto-detect it and act accordingly.

 1.  Path to BBS User file
 2.  Your BBS name
 3.  SysOp's first name.
 4.  SysOp's last name.
 5.  Serial Number if registered.
 6.  Number of days for listings to remain active. {set to 3-5 for beta}
 7.  Minimum Sec. Level to access door
 8.  Path and name of Color bulletin. Be sure to add the name of the
     bulletin that you want created on line 8 and 9.
 9.  Path and name of ASCii bulletin
10.  Type of Bulletins (WC = Wildcat!3.x  PCB = PCBoard  N = ANSI/ASCii)
     If you select the WC! or PCB type bulletins, you will only need to
     supply a filename and path for the color bulletin.  You still must
     include line 8.  You may leave it blank though.
11.  (Y/N)  Create the above bulletins.  This option ONLY works for
     registered versions.  The bulletins are automatically created in
     the DEMO versions.  They cannot be switched off.
12.  Path to ACTIVITY.LOG.  DO NOT put a filename on this line.  If you
     are running Wildcat!3.x, ClassAds will write to the correct
     ACTIVITY.xxx.  ClassAds will write to a file named ACTIVITY.xxx in
     the directory you have specified if you are not running WC!.  The
     "xxx" will correspond to the node number.
13.  If you select the option to have ClassAd write bulletins to a
     separate directory, enter the directory path here. (Read DOCs for
     further details.) See SPECIAL DIRECTORY INSTRUCTIONS below.  This
     option is currently *ONLY* available to Wildcat!3/4 systems.
14.  (Y/N) Create the bulletins in the special directory.  This option
     ONLY works for the registered version.  These bulletins are NOT
     created in the DEMO version.  They can not be switched on.
15.  (Y/N) Create the ASCii text file.  This file is automatically
     created in the DEMO version.  It cannot be switched off.
16.  Path of the ASCii text file.  DO NOT put a filename here. ADDOR.EXE
     will append "CLASSAD.TXT" to the path you specify. This path *MUST*
     exist as this file is written in the DEMO version.
17.  "RIP" = Create RIP bulletins "N" = do not create RIP bulls

All 17 lines must be present in the CFG file.  The lines that are not
needed or used, may be blank but, they must be there.

NOTE: There are 2 additional lines necessary when using GTUSER.BBS. Since
      this file does not provide the ComPort% and NodeNum% variables, you
      will need to add them to this .CFG file on lines 5 and 6
      respectively.

Classified Ads will operate on a multi-line BBS.  If you do not
incorporate the environment variables defined below, you will need a
separate CFG file for each node.  You must give each CFG its own
distinct name.

     EX:  CLASSAD1.CFG   CLASSAD2.CFG   CLASSAD3.CFG

CLASSAD.LST

     You will need to edit the enclosed "CLASSAD.LST" and include the
categories that suit your individual needs.  This file may contain up to
20 lines.  Please use and ASCii editor such as Qedit to edit this file as
some word processors add hidden control codes that could cause
unpredictable results.   The maximum length of each line is 25
characters.

SYSOP.CL

     This file, if it exists, must reside in the door directory.  It is
simply an ASCii text file containing one user name per line.  Place the
name of any user that you wish to have SysOp access in the door.  This
will give those users the ability to edit any listing in the database.

CLASSUP.CFG

     See the enclosed sample for details concerning this file.  This is
only available to registered sysops.


SPECIAL DIRECTORY INSTRUCTIONS:

     This part is only available at the present time to WC!3.x systems.
If, in the future, I can get some idea as to how to implement this on
different systems, I will make it available.


13.  If you select the option to have ClassAd write bulletins to a
     separate directory, enter the directory path here. (Read DOCs for
     further details.)

To set this function up, you must enter your "Conference Definition"
setup in MAKEWILD.  Create a message conference entitled "Classified
Ads" or whatever title suits your fancy.  Give this conference its own
Bulletin Directory path.  ADDOR.EXE will create the necessary
BULLETIN.BBS and a bulletin for each record listed in the database.
There is no special maintenance that the sysop needs do in this area.
If a record is deleted in the database, ADDOR.EXE will delete the proper
BULLx.BBS.

You will need to set the # of bulletins allowed in this area to the
maximum number of bulletins that you expect.  ADDOR.EXE will allow up to
500 in the database.  WC! allows 999 in each bulletin conference.

ͻ
 02-17-93                  Conference Definition                   19:56:02 
ͼ

        #           Description            #           Description
                 
         0 - !PRIVATE! Mail      [TPB]      1 - !PUBLIC! Mail       [TPB]
         2 - New Users!          [TPB]      3 - PAROLE Software     [TPB]
         4 - Classified Ads      [TPB]      5 -

ͻ
                 Copyright (c) 1989,93 Mustang Software, Inc.                 
     [F1] Help - [F2] Edit Access - [F3] Copy - [F4] Global - [ESC] Exit      
ͼ

ͻ
 02-17-93                  Conference Definition                   19:56:07 
 CONFERENCE DESCRIPTION ͸
                                                                              
  Conference Classified Ads      [TPB]    MISCELLANEOUS Ŀ 
                                          Conference sysop DENNIS MAIDON    
  PATHS Ŀ  Mail type                Normal   
  Bulletins      C:\WC30\ADS\           Max conference messages  100      
  Questionnaires C:\WC30\QUES\          Max lines per message    150      
  Menus          F:\MENU\               Number of questionnaires 3        
  Help           F:\HELP\               Number of bulletins      50       
  Display files  F:\DISP\               Check valid name         No       
  Messages       C:\WC30\MSG\           File area access                  
   
  TOGGLES Ŀ 
  Allow message attachments        N    Allow return receipts            Y  
  Prompt to kill received messages Y    Allow private messages           Y  
  Allow high ascii characters      Y    Force all messages private       N  
  Allow message carbon copies      Y    Use alias names                  N  
  Read only conference             N                                        
  
;
                 Copyright (c) 1989,93 Mustang Software, Inc.                 
     [F1] Help - [F2] Edit Access - [F3] Copy - [F4] Global - [ESC] Exit      
ͼ

14.  (Y/N) Create the bulletins in the special directory.  This option
     ONLY works for the registered version.  These bulletins are NOT
     created in the DEMO version.  They can not be switched on.

MISCELLANEOUS NOTES:

ADDOR.EXE requires DOS 3.x and up since all files are opened in SHARED mode.

When using PCBOARD.SYS, ADDOR.EXE also accesses the USERS file.

When using USERS.SYS, ADDOR.EXE also accesses PCBOARD.SYS, PCBOARD.DAT and the
USERS file.

The DOOR.SYS used by ADDOR.EXE is the standard 52 line GAP (tm) file.

The CALLINFO.BBS used by ADDOR.EXE currently contains 36 lines.

WILDCAT! EXTRA:

If ADDOR.EXE updates the Text file, it will write a 0-byte file to the
door directory named, CHANGE.FIL.  If you use Transcan to update the WC!
database, you can test for this file and only run TranScan when needed.
Be sure to delete it after running transcan.  There may be utilities
that will update the databases of various other BBS systems.  CHANGE.FIL
is created whenever the CLASSAD.TXT is updated.

@ECHO OFF
CLS
D:
CD \DOOR\AD
ADDOR AD.CFG /%WCIRQID%
IF EXIST D:\DOOR\AD\CHANGE.FIL TS E:\TEXT\CLASSAD.TXT /TK,T
IF EXIST D:\DOOR\AD\CHANGE.FIL ERASE D:\DOOR\AD\CHANGE.FIL

Fossil Driver Support
---------------------
ADDOR.EXE supports the use of Fossil drivers.  To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
     MYDOOR MYDOOR.CFG /FD
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, ADDOR.EXE will print a message to that effect and exit
the door gracefully.

     Unless you are using a Digi-board, do not use the "/FD" switch with
ADDOR.EXE.  There is a bug in DoorFrame pertaining to fossil drives that
causes erratic behavior.

Environment Variables
---------------------
ADDOR.EXE supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
number after the configuration filename. Let's assume your Door is
called FOOBAR and you want to use COM1 and IRQ5. The command line
passed to your Door would be:
    FOOBAR FOOBAR.CFG /5  or
    FOOBAR FOOBAR.CFG /%IRQ%  for the environment variable.
The /5 tells ADDOR.EXE to use IRQ5 rather than the standard IRQ4 that
is normally used with COM1. No /x parameter is needed for the standard IRQ's.

When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:

 PCBoard: 
   USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
   USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS

 Wildcat!:
   USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%

Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch that runs the door. For example:
 SET PCBDRIVE=C:
 SET PCBDIR=\BBSDIR
 SET PCBNODE=1

DISCLAIMER:

                              LEGALITIES
                              __________

      THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
      WITHOUT WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT
      LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
      FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
      THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
      SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
      OR BREACH OF ANY WARRANTY.

DISTRIBUTION:

     The current release of Classified Ads may be found on The Parole
Board BBS and will be available to all first time callers.  I will also
upload it to select BBSs across the country.

NOTES:

     Classified Ads is written and compiled using Visual Basic for DOS
     v1.0 (Professional Version)  VB/DOS is copyright 1992, MicroSoft
     Inc.

     Wildcat! is Copyright 1986,1994 Mustang Software Inc.

     Many thanks to the SysOps that helped to test this door product.
     Their names and BBS info may be viewed by selecting "$" from the
     Main Menu.

     Qedit is Copyright (C) 1985-1993 by SemWare, all rights reserved

     This door was written using the DoorFrame module by Ted Freeman.

     Bill Clinton for making all this necessary.  I need the $$$ to pay
     his darn taxes.

     Mike Rickman for creating and donating the instruction screens.

     Thanks to all that have made suggestions for the door.


