                            BBS Herald v1.2
                            PAROLE Software
                    Copyright 1993-94, PAROLE Software
                          all rights reserved
                      Fido: 1;151/185 @fidonet.org

                          The Parole Board BBS
                          9411 Buffalo Rd
                          Clayton, NC  27520

                    (919) 965-4696 Ŀ
                                     US Robotics Dual Standards
                    (919) 965-9885 


DESCRIPTION:

     BBS Herald is a BBS door that allows you, the SysOp, to send a
display file to the users.  You may use this woth the LOGIN.BAT with
WC!, DOS Hook or as a straigh door program.  HERALD.EXE supports
DOOR.SYS, USERINFO.DAT, CALLINFO.BBS, SFDOORS.DAT, PCBOARD.SYS,
USERS.SYS, TRIBBS.SYS and DORINFOx.DEF.  Just be sure to use the
appropriate name on the first line of the CFG file.

SUPPORT:

     Support for HERALDis 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 9: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, HERALD updates are free as long as I own the rights to the
program.  If you wish an update on disk, send $3 to the address listed
above.

    If you are in a hurry and do not want to take the time to logon,
enter " PAROLE SOFTWARE NOW! " at the name prompt.  It will give you
access to the PAROLE Software file & support areas.  Don't forget the
"!" on "NOW".

CFG FILE:

C:\WC30\WCWORK\NODE1\USERINFO.DATĿ
C:\PCB\USERS.SYS                   <- Path to User file.  I recommend
C:\SF\SFDOORS.DAT                     using USERS.SYS for PCBoard and
C:\BBS\DORINFOx.DEF                   USERINFO.DAT for Wildcat!  if you
C:\BBS\CALLINFO.BBS                   are running WC! v4.x, you must
C:\BBS\GTUSER.DAT                     specify DOOR.SYS on line #1.
C:\BBS\DOOR.SYS                   
C:\BBS\PCBOARD.SYS                
C:\BBS\TRIBBS.SYS                
The Parole Board BBS
Dennis
Maidon
1234567
NOTICE

'The CFG file must contain 6 lines in the following format:

Line 1  Path and name of BBS user file
Line 2  BBS Name
Line 3  SysOp's first name
Line 4  SysOp's last name
Line 5  Registration number
Line 6  Filename to display, less extension.  You must append ".TXT" to
        this filename when you place the file in the door directory.  If
        you wish to display a RIP file, place a file with a ".RIP"
        extension.  For instance, if you wish to display a file named
        "SPECIAL.TXT", place "SPECIAL" on line 6 of the CFG file and
        place "SPECIAL.TXT" in the door directory.  If you want a RIP
        version, create a file named "SPECIAL.RIP" and place it int he
        door directory also.  If Herald detects RIPSCRIP capability, it
        will display the RIP version of the file.

NOTE:  You may now use one (1) CFG file for multi-node by using the
environment variables.

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:\WC30\WCWORK\NODE1   - C:\WC30\WCWORK\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
                             --------------
Create the CFG file(s) for you particular BBS.  You will also need a DOORx.BAT
to run the door.  This one is simple.

@ECHO OFF
CD \DOOR\HERALD
HERALD BBS.CFG /5
              
 
  If you are running non-Standard Com ports on your BBS, you will need to pass
 the proper IRQ to the door.  It doesn't hurt to pass the IRQ even if they are
 standard.  If a user enters the door and it just sits there acting sort of
 stupid, it's probably looking for the correct IRQ.  Always pass it on the
 command line and there will be no question.  Some networks have a problem
 using the "/" symbol.  HERALDwill now accept an asterisk "*" in place of
 the "/".  You may also use the environment variable in the DOORx.BAT file to
 pass info to the door.

HERALD BBS%WCNODEID%.CFG /%WCIRQID%

Make sure you DO have the variables set if you use this method.

NOTE: HERALD 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
        FOOBAR FOOBAR.CFG *5

      The /5 tells HERALD to use IRQ5 rather than the standard IRQ4 that
      is normally used with COM1. No /x parameter is needed for the standard
      IRQ's. HERALD supports IRQs 1 - 15.

Fossil Driver Support
---------------------
HERALD 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
     MYDOOR MYDOOR.CFG *FD

indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, HERALD will print a message to that effect and exit
the door gracefully.

    If you have WC! set up to TERMINATE on Doors, you will need to add a
    line to reload the BBS.  I'm not sure about the exact way this is
    set up since I do not use this method.  Check your WC! Manual.

                              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
                             ____________

   You may make this file available for downloading from your BBS or you may
   upload it to any BBS of your choice, provided that you do not make any
   changes to the contents of the archive (ZIP file). The archive and its
   individual contents may not be used by any service that charges any money
   whatsoever, without the written permission of the author.

        This ZIP file was created using the -AV function of PKZIP.  If
        my AV is missing then this file may not be complete or has been
        tampered with.  Complete and current editions of this program
        are always available for D/L on The Parole Board BBS.  If the -AV
        is missing please complain to your sysop to stop the practice of
        removing AV's as this is your assurance from the programmer that
        the file is complete and virus free.


CREDITS:

     Wildcat! BBS is Copyright 1985-1994, Mustang Software Inc.

     BBS Herald was written using the DoorFrame Door module for MicroSoft's
     Visual Basic for MS-DOS, Professional Version.

     DoorFrame is Copyright 1990-1993, Ted Freeman & Richard Paquette

     Visual Basic for MS-DOS is Copyrighted by Microsoft Corporation.

     My wife, Brenda, who puts up with my computer playtoys.

