Beijing Paradise BBS Backup/PARADISE.ISO/software/BBSDOORW/ADS10.ZIP/ADS10.DOC

Text File | 1994-12-08 | 12.0 KB | 303 lines

Welcome to:
The BBS ADVERTISER Door.

Written by:
Those Two Programming Guys

Brad Watts and Vince Sbordone

(C)Copyright 1994
______________________________________________________________________________

If you wish to use The BBS ADVERTISER! with WildCat you will have to use a
converter to go from PCBoard.Sys to Door.Sys. This Door was tested extensively
and performed without flaw using DOORMASTER 5.7.0 on a WildCat system.
DOORMASTER 5.7.0 is capable of converting other bbs drop files as well and is
available for download on many bbs's including:

The Paisano Olive Oil Import/Export Company   [phone].

Download Filename: DM57.ZIP
______________________________________________________________________________

Setup and Operation:

Make a directory for the files to be placed. My directory is
BBSADS10 off of my Doors directory. ie.

C:\WC30\DOORS\BBSADS10

or for PCBoard

C:\PCB\BBSADS10

Once you have created a directory place all the files that came with this
zip into it. Be sure that the directory is in your path.
______________________________________________________________________________

For PCB operation create a BAT file as shown, do not include the comments:

echo off
cd\BBSADS10              .(path to the dir you've made for the door files)
ADS10 ADS10.CNF c:\pcb   .(door EXE file, Configure file, path to where
                         . the drop file is, (Pcboard.sys))
cd\pcb                   .(to reload the bbs)

if exist event.bat event .(to start a timed event if needed)

If you would like to try the door locally type the following:
ADS10 ADS10.CNF c:\pcb LOCAL
The word LOCAL IS case sensitive.
The above should bring up the Door locally provided that you type
it from within the BBSADS10 directory. Be sure to delete the following files
after you experiment with the Advertiser so that it may be started normally.:

DELTRK.DAT   ... made when messages or ads are present.
MESS.DAT     ... will be made when messages are entered.
MESSNAME.DAT ... will be made when messages are entered.
ADxx.DAT     ... xx is the category that you placed an ad. (AD01 - 20.DAT)
______________________________________________________________________________

For WildCat systems I have included DOOR1.RUN. This is the start up
file that I am using at present. It is used in conjunction with
DOORMASTER 5.7.0+. Feel free to rename, and modify it as needed,
but it should work fine as is.
______________________________________________________________________________

DO NOT MODIFY ANY of the .SCR files.
These files are called from within the .EXE program and must be
present and unaltered for proper operation.
______________________________________________________________________________

For Non-Standard IRQ's place these two lines at the begining of the BAT file.

SET COMBASE=
SET COMIRQ =

For example, if you wanted to use Com4 (2E8) and IRQ6 you would enter:

SET COMBASE= $2E8
SET COMIRQ = 6

You may also convert and enter the Com's decimal equivalent... ie... 744 in
place of 2E8.

SET COMBASE= 744
SET COMIRQ = 6

You may use IRQ's up to and including IRQ7.

If you receive an 'Out Of Environment Space' error, check your DOS manual
and BBS manual for procedures on allocating more space.
_____________________________________________________________________________

The differences between the registered version and non registered
is that the non registered version is limited to the first 5 categories,
ADSUTIL.EXE remains inoperative, no JANITOR mode and uregistered versions
flash 'unregistered advertiser' at the bottom of the screen.
______________________________________________________________________________

O.k., heres the ADS10.CNF file setup. Do not include the comments:

INTERRUPT      .(if this doesn't work then try BIOS as the first line)
AnY BoArd      .(your BBS name goes here, upper and lower mix is o.k.)
000000000      .(registration number, allows other options to function)
0              .(reg only. Number of days to keep messages. Up to 365.
               . 0 = DO NOT DELETE ANY MESSAGES.)

All four lines must be present in the ADS10.CNF file.
______________________________________________________________________________

CATEGORY.DAT

Please make a COPY of the Category.Dat provided before altering the original.
If you look at the first few lines of the DAT file you will see the following:

01. 30, @X0F For Sale - Computers and Parts
02. 30, @X0F For Sale - Computer Hardware
03. 30, @X0F For Sale - Computer Software
04. 30, @X0F For Sale - Computer Monitors
05. 30, @X0F
06. 30, @X0F
07. 30, @X0F
08. 30, @X0F
09. 30, @X0F
10. 30, @X0F
etc
etc
20. 30, @X0F

Unregistered users are allowed the first 5 lines for configuration.
You will notice that each line is numbered and then there is the number 30
followed by a --->  ,  <---  then a space and then an @ code.

Registered Users:
The number 30 is the amount of days that an ad will remain in the database
and then be deleted. This number can be from 0 to 365 days. The   ,   IS
NECESSARY for correct operation.
A 0, (zero), means ... NEVER DELETE ADs FROM THAT CATEGORY EXCEPT BY OWNER
OR WHILE IN THE JANITOR MODE.
Unregistered defaults to 0 no matter what number is in this slot but keep
in mind that a number between 0 and 365 MUST be designated followed by a ','.

Reg & Unreg:
The @ code that follows the '30,' MUST be present for correct operation,
however, you may change the last two digits to change the line color ... @X0F
indicates that the characters that follow will be WHITE. A code of @X0C will
change the line color to light RED. A small list of @ codes follows this
section.
After the @ code the text is inserted, look at number one in the list. The
only thing you have to keep in mind is that you are allowed 33 characters.

If you do this:

01. 210, @X0F My Sales Category

The number of characters you've used = 17. No, the SPACE between the last
@ code 'F' and the first text letter 'M' does not count as one character.
Other @ codes in the line however will NOT be recognized as color changes
and will be counted and printed as themselves in the 33 character text line
total... ie....

05. 180, @X0F This line is taking up all spaces

The above shows how this line has used ALL available spaces for the text.

05. 253, @X0C This Text is RED not @X0FWHITE

This line will be printed as is with @X0FWHITE as shown, it WILL NOT change
the last word to the color WHITE. Total text characters = 30.

           ***   ALL 20 LINES TO THE END OF THE @ CODE MUST BE  ***
           ***    PRESENT IN THIS FILE FOR CORRECT OPERATION.   ***
           ***          PROPER FORMAT MUST BE OBSERVED.         ***
______________________________________________________________________________

Code Color List .:

00 Black    04 Red        08 Dk. Gray    0C Lt. Red
01 Blue        05 Magenta    09 Lt. Blue    0D Lt. Magenta
02 Green    06 Brown    0A Lt. Green    0E Yellow
03 Cyan        07 Lt. Gray    0B Lt. Cyan    0F White
______________________________________________________________________________

PEOPLE.FIL

This file will contain the name of the SysOp and any other authorized person
to enter the Advertiser with the option of JANITOR.

The people.fil is a text file with one name per line... ie...

Vince Sbordone
Brad Watts
LeAnn Sbordone
MaryAnn Watts

Use your favorite text editor to edit this file.

The Advertiser looks at the sign on name then checks to see if it matches
a name in the People.Fil. If it does it asks if that person would like to
enter the Advertiser in the JANITOR MODE.

System Operators, a word of caution:.. If you put the name 'SYSOP' in the
People.fil and your system recognizes you as 'SYSOP' then any ads or messages
left in the advertiser will be from 'SYSOP'. To avoid any confusion between
yourself and other persons with SysOp status on your system we advise you to
NOT USE the name 'SYSOP' in the People.fil. Instead, use your real name or the
name you login by on your system.

The file MUST BE PRESENT but names are only checked when registered.
______________________________________________________________________________

JANITOR MODE

When registered and if your name is in the People.Fil you will be asked if you
want to enter as the JANITOR. If you choose 'N' then you enter normally. If
you choose 'Y' then the following also takes place.

1) The ability to DELETE ANY AD. You will not be able to edit any ads except
   your own.
2) The ability to READ ANY MESSAGE and LEAVE a return message. You will not
   be able to delete or edit anyone else's messages.

We thought that the sysop and co-sysops should have the ability to delete
objectionable ads but not edit them. With messages we allow for the reading of
messages by the sysop and co-sysops to comply with Rules and Regulations
reguarding private mail on BBS's.
______________________________________________________________________________

ADSUTIL.EXE

Registered only:

This utility is used as an EVENT. Consult your BBS manual for proper setup
and execution of events. ADSUTIL.EXE must reside in the advertiser directory.

It will purge all old Ads as per user deletion or by days to deletion as
specified by the CATEGORY.DAT file.

It will also purge any deleted messages and messages as per the days to
deletion in line 4 of the ADS10.CNF file.

The utility will process all .DAT files automatically and will check to make
sure that you have enough Disk Space to process your files. Adsutil.exe will
first look at the size of the file to be processed then check to make sure
that you have that much disk space PLUS an additional 1024 bytes. If you have
enough space the utility will process the file. If you don't have the room
Adsutil.exe will leave the file alone and check the next file for processing.

I am running the ADSUTIL.EXE purge program once a week as an EVENT. It seems
to keep up with what's happening without any problem, however, you may run it
as often as necessary to keep up with your system. Just type ADSUTIL at the
DOS prompt making sure you are in the advertiser directory.
______________________________________________________________________________

If you are RIP capable this door will FORCE color so you won't be left
with a MONO door.
______________________________________________________________________________

We have taken every precaution we could think of to prevent system problems
and lock-ups. All prompts and screens have timeouts with the longest being 5
minutes.
______________________________________________________________________________

The built in prompts and instruction screen within the door will help your
users view, enter, edit and retrieve ads and messages with ease.
______________________________________________________________________________

Upon registration you will have use of the full 20 categories, Janitor Mode
and Adsutil.Exe program. Your BBS name will replace the flashing
'Unregistered' message at the bottom of the screen and in the 'Returning You
To' screen at the end of the program.
______________________________________________________________________________

If you have any problems with the setup or execution of this Door please
leave a message to:

Vince Sbordone

The Paisano Olive Oil Import/Export Company ... Since 1952

[phone]

Please allow a few days for answer, or you may write to us at the address
in the REGISTER.DOC
______________________________________________________________________________

Special THANKS goes out to:

Those Two Programming Guys Wives..... Again. (Isn't that special).
Mary Ann and LeAnn.....

Compiled in Turbo Pascal 7 and ProKit 350/Turbo Pascal door writing aid.
______________________________________________________________________________

THOSE TWO PROGRAMMING GUYS
is a trademark of... er, well,
THOSE TWO PROGRAMMING GUYS!
so THERE!

(C)Copyright 1994

---------------------------------END OF FILE----------------------------------