home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Carsten's PPE Collection
/
Carstens_PPE_Collection_2007.zip
/
T
/
TABPPE50.ZIP
/
TABS-PPE.DOC
< prev
next >
Wrap
Text File
|
1994-05-28
|
29KB
|
623 lines
TABS-PPE Version 5.0
Written By: Ray Sulich
Compiled with PCBoard PPLC Version 2.0
Copyright 1993, 1994 Clark Development Company
Disclaimer:
This software is provided without any guarantee, either expressed or implied.
All responsibilities for its use rest with the user of the software and not the
author. The only thing that I will guarantee, is that when you have this
program on your harddrive, it will take up at least a little disk space.
License:
This software has not been released into the Public Domain. Nor, is TABS-PPE
free. This version has been released as SHAREWARE it has cost, considerable
time in coding and the compiler wasn't free either. So, if the program meets
your needs I would like to ask you to contribute $10 to ensure the future
progress and support of this program.
Why TABS-PPE:
This program was written because I was having trouble with the programs
supplied by TABS to interface with PCBoard so, I wrote this PPE interface for
their program TMAN.EXE. I also wanted better accounting for where the SIDS
were going. I don't know what the future will bring :) your inputs would be
much appreciated......
What does it do?:
In reality it really does alot of things. It accepts the SID (Subscription
Identification Number) supplied by the TABS (900-XXXX) service, validates the
SID entered by comparing it to the list of active SIDS you have. If a match is
made, the number is "deleted" and the callers account is upgraded. It also can
update caller notes, pass messages to the Sysop, manage your TABS services, and
keeps you up to date.
Why do you need it?
This program has some nice features, that to date, TABS-PCB (supplied by the
TABS company) doesn't.
1. It will explain the TABS service to your callers.
2. Show the caller the types of upgrades available (either $10 or $25) you
may have three of each upgrade type. Of these three upgrades for each
type, Two are configurable, the third type is sort of pass through. The
first two levels will act as you have configured. The third level will
allow the caller to donate but his account will not be changed.
3. Send a message to the caller thanking him/her for the donation. (optional)
4. Send a message to the Sysop notifying you of the transaction. (optional)
5. Join the caller to your contributors conf. (optional)
6. Creates a detailed log, (located in the same directory as the PPE), of the
PPE's usage or errors. TABS1.LOG for Node 1, TABS2.LOG for Node 2 etc.
7. Will send a message to the sysop if an error occurs (optional)
8. Updates callers notes with the callers donation information (optional)
9. Excepts donations without upgrading the callers access (after 1st or 2nd
donation).
10. Allows the Sysop to see the number of SID's remaining, add new SID's and
pack the Active SID lists.
11. Supports RIP graphics, security and language specific external menus.
12. Allow multiple configuration files
13. Spinning prompts while the program is working, to keep your callers
amused :)
14. This PPE will produce the following error levels (for internal use) and
will log them to your TABS.LOG for your troubleshooting pleasure....:)
Errorlevel 10 = User entered a valid SID and was upgraded....
Errorlevel 11 = User entered an invalid SID
Errorlevel 12 = TABS PPE could not create its temporary work file.
Errorlevel 13 = Could not find file containing the list of new SID's to
add to your active SID listing.
Errorlevel 14 = Could not locate the active SID listing. You entered
the name incorrectly on line 14 of the config. file or
it is not located in the same directory as the PPE
15. Sends Sysop a messase when the number of active SIDS is below a
configurable number (OPTIONAL)
16. Allows Sysop to set the number of tries a caller gets when entering a
SID
18. In all cases after a caller has successfully entered his SID, he will be
presented with a short screen saying Thank you, and showing him the new
access levels and his caller notes will be updated with his donation
information.
19. Write a bulletin containing a list of all your contributors. (OPTIONAL)
20. Allow the caller to download an information file called TABSINFO.TXT
instead of reading all the subscription offers and how to use TABS
instructions online. (OPTIONAL)
21. If the caller contributes he may then download a receipt of the
transaction. (OPTIONAL)
22. Comes with a easy to use INSTALL.PPE that will assist you greatly in the
installation and maintenance of the program.
******************************************************************************
Installation:
1. Unzip the archive (guess you've already done that :))
2. TAB-PPE has been compiled with Version 2 PPL compiler. TABS-PPE WILL NOT
run on PCBoard 15.0.....
3. TABSPPE may be installed as a door, or in the PCBoard "CMD.LST" in the
following manner:
Using PCBSetup (DOOR method.....)
╔══════════════════════════════════════════════════════════════════════════════╗
║ Edit DOORS File ║
║ ║
║ USER DOOR ║
║ Filename Password Sec Login SYS SYS Shell Path to DOOR Files
║ ══════════ ════════════ ═══ ═════ ════ ════ ═════ ════════════════════════ ▒
║ 1) TABS 02 N N N Y C:\PCB\DOOR\ ▒
║ Press F2 to edit the DOOR file ▒
║
║ ESC=Exit Alt-R=Repeat a Line Alt-I=Insert a Line Alt-D=Delete a Line ║
╚══ 11:54:06 ═══ 04-18-94 ══════ F1 ═ help ════ caps: OFF num: OFF ins: OFF ═╝
In this manner any PPE can be run as a door. Here is an example of a batch
file to run the PPE:
TABS.BAT
ECHO !C:\TABS\TABS.PPE OPTIONS.CFG> PCBDOOR.TXT
In PCBSetup under:
File Locations, Configuration Files, Name/Loc of Default CMD.LST add a lines
like this (CMD.LST method)
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Locations ║
║ ║
║ Command Security PPE/MNU File -or- Keystroke Replacement ║
║ ══════════════ ════════ ═══════════════════════════════════════
║ 1) TABS 10 C:\TABS\TABS.PPE OPTIONS.CFG ▒
║ 2) DONATE 10 C:\TABS\TABS.PPE OPTION1.CFG ▒
║ 3) MORE 40 C:\TABS\TABS.PPE OPTION2.CFG ▒
║ 4) INSTALL 200 C:\TABS\INSTALL.PPE ▒
║
║ ESC=Exit Alt-R=Repeat a Line Alt-I=Insert a Line Alt-D=Delete a Line ║
╚══ 12:50:22 ═══ 02-19-94 ══════ F1 ═ help ════ caps: OFF num: OFF ins: OFF ═╝
c:\tabs\tabs.ppe OPTIONS.CFG
c:\tabs\tabs.ppe OPTION2.CFG
^^^^^^^^^^^
etc. etc. etc...........
In either case where you see the ^^^^^'s is were you specify the name of the
configuration file that you wish TABS-PPE to use. This/These configuration
file(s). If you have more than one configuration file MUST reside in the same
directory as the TABS.PPE file. If you execute a "DIR" in this directory, it
would look something like this. These files MUST, absolutely MUST reside in the
same directory as the .PPE file.
Volume in drive C is MS-DOS_6
Volume Serial Number is 1B63-A5F7
Directory of C:\TABS
. <DIR> 05-27-94 12:57p
.. <DIR> 05-27-94 12:57p
1ST10 911 05-17-94 6:25p *
1ST25 905 05-17-94 6:27p *
2ND10 912 05-17-94 6:31p *
2ND25 912 05-20-94 8:26a *
3RD10 723 05-17-94 6:29p *
3RD25 715 05-17-94 6:30p *
BULLET FTR 369 05-26-94 3:16p OPTIONAL
BULLET HDR 291 05-26-94 3:55p OPTIONAL
CONTRIBS TXT 1,117 05-26-94 7:27p OPTIONAL
INFO 1,986 05-17-94 7:02p *
INSTALL PPE 28,873 05-27-94 12:46p
INTRO10 2,063 05-19-94 4:30p *
INTRO25 2,063 05-19-94 4:30p *
MEN10 1,279 05-19-94 3:36p *
MEN10200 2,002 05-17-94 6:20p ***Sysop menu for use with external
MEN25 1,279 05-19-94 3:36p * screens. Last 3 digits would be
MEN25200 2,002 05-17-94 6:21p ***the same as your access level.
NOADD10 660 05-17-94 6:54p *
NOADD25 660 05-17-94 6:54p * Same as above but for the $25
OPTIONS CFG 78 05-27-94 12:42p configuration of the PPE
RECEIPT HDR 139 05-17-94 3:48p OPTIONAL
SIDS10 LST 1,023 05-26-94 7:27p List of your $10 SID's
SIDS25 LST 564 05-26-94 10:47a List of your $25 SID's
TABS10 CFG 232 05-27-94 12:19p $10 Configuration file
TABS25 CFG 230 05-27-94 12:46p $25 Configuration file
CONTRIBS LST 518 05-27-94 12:59p OPTIONAL
TABS PPE 31,822 05-27-94 10:54p hmmmm, guess you better have this
one.....
Files with an asterisk after them are only required if you are not using
internal menus.
4. Configure the options available to the TABS PPE. You may use your favorite
ASCII text editor or the INSTALL.PPE that is included with this package.
I recommend that you use the included INSTALL.PPE, as the options will be
written out exactly as I programmed them. These options are the $10 or the
$25 TABS service you may use either 1 option or both. These options are set
by configuring the OPTIONS.CFG file. Call this .CFG file what you wish, but
all lines MUST be present and it must reside in the same directory as
TABS-PPE this configuration file is named on the command line that runs
TABS-PPE (See above examples)
Here is the layout of the "OPTIONS.CFG" file.
Straight Board BBS
123456789023445
YES
TABS10.CFG
YES
TABS25.CFG
NO
INFO
YES
Line 1: Your BBS name.....
Line 2: Your registration number (blank if not registered)
Line 3: Will you be offering the $10 contribution service. (YES, or NO)
Line 4: The name of the TABS PPE configuration file for the $10 service. The
configuration file listed here, must also reside in the same directory
as TABS.PPE. This option may be a blank line if you are not offering
this service.
Line 5: Will you be offering the $25 contribution service. (YES, or NO)
Line 6: The name of the TABS PPE configuration file for the $25 service. The
configuration file listed here, must also reside in the same directory
as TABS.PPE. This option may be a blank line if you are not offering
this service.
Line 7: Do you wish to use the internal Options display screen (YES, or NO)
If you have configured this program to provide both the $10 and the
$25 contribution services, This menu will be displayed as soon as
the caller enters TABS-PPE. This menu should ask the caller which
service he/she is interested in.
Line 8: The name of the external Options display screen. If you answered NO
on line 5 this is the file that will be displayed as your options
display menu. Same description as above, but you write it :)
Line 9: Yes, or No...... allow the caller to download the TABSINFO.TXT file
from the OPTIONS menu.
4. Configure the program with the TABS10.CFG file.... all lines MUST be
present. If you do not wish to use one of the configuration items you
MUST leave a blank line in place of the option. This is the configuration
file listed in the "OPTIONS.CFG" file as the configuration file for your
$10 contribution service. Looking at the "OPTIONS.CFG" file above, you
see there is also a TABS25.CFG file listed for the $25 contribution service.
These configuration files are where you tell TABS-PPE how to handle
upgrading your callers based on a $25 or $10 contribution. If you do not
offer a $10 or a $25 service then, of course you wouldn't need a
configuration file for it.
Here is the layout of the TABS10.CFG file.
RAY SULICH
NO * New this version
YES * New this version
RECEIPT.HDR * New this version
YES * New this version
YES * New this version
CONTRIBS.TXT * New this version
BULLET.HDR * New this version
CONTRIBS.LST * New this version
BULLET.FTR * New this version
40
365
10
60
4,000,000
50
1094
10
90
5,500,000
94
10
3
1
SIDS10.LST
YES
NO
INTRO10
YES
1ST10
2ND10
3RD10
MEN10
Line 1: The Sysops Name
*Line 2: Yes= Use today's date as the first day of the callers subscription.
No= Tabs checks the callers expiration date, and if this date is in
the future just add the new number of days to todays date. If the
callers account has already expired TAB-PPE resets the expiration date
to todays date and add the new number of days to that.
*Line 3: Allow the successfull contributor to download a receipt of this
transaction. (YES, or NO)
*Line 4: Name of the header file to add to the receipt (blank if not using
receipt function) this file if used must reside in the same directory
as TABS.PPE
*Line 5: Allow caller to download TABSINFO.TXT, this option will be shown to
the caller on the main billing menu. The TABSINFO.TXT file MUST
reside in the same directory as TABS.PPE and it must be called
TABSINFO.TXT
*Line 6: Have TABS-PPE create a bulletin listing the persons that have
successfully contributed using the TAB-PPE system. (YES, or NO)
*Line 7: Name of the bulletin that TABS-PPE will create in the same directory
as the PPE. (blank if the bulletin option has been disabled)
*Line 8: Name of the file to be added to the bulletin as the header file. This
file must reside in the same directory as the PPE. (blank if bulletin
option has been disabled)
*Line 9: Listing of the persons that have contributed to your BBS. One name
per line. TABS-PPE will maintain this file by adding the contributing
callers name to it when he/she contributes. You might want to add or
delete names as time goes on so we provided this file to accomplish
that task. This file must reside in the same directory as the
PPE. (blank if bulletin option has been disabled)
*Line 10: Name of the file to be added to the bulletin as the footer file. This
file must reside in the same directory as the PPE. (blank if bulletin
option has been disabled)
Line 11: First access level to upgrade to ....
NOTE: All callers who enter a SID who are BELOW this level will be
Upgraded to this level
Line 12: Number of days you wish the caller to hold this access level.
ie: In the above example the caller would be at level 40 for 365 days.
You MUST have the next line set or who knows what access level the
caller will be downgraded to, once the subscription expires.
Line 13: Level caller is to be downgraded to when his/her subscription expires.
Line 14: Number of minutes the caller would get per day at the first upgrade
level.
NOTE: This number is for display purposes only, and should be entered in
minutes.
Line 15: Download Bytes available per day at the first upgrade level.
NOTE: This number is for display purposes only, and should be entered in
Bytes. You may add commas as needed
ie: 1,000 would read on the screens 1,000 bytes per day
MOST LINES BELOW THIS POINT ARE OPTIONAL, if you choose not to use these items
you MUST leave a space for the option !!!!
Line 16: Second Access level to upgrade to... (OPTIONAL)
NOTE: If you enter a number on this line it MUST be a larger number than
you entered for the first access level to upgrade to. If you entered
25 on line 11 of this file, the number you enter here MUST be 26 or
greater. Any caller who is at an access level that is greater than
the level entered on line 11 of this file, but less then the number
you enter here will be upgraded to this level.
Line 17: Number of days you wish the caller to hold this access level.
(OPTIONAL)
ie: In the above example the caller would be at level 50 for 1094 days.
You MUST have the next line set or who knows what access level the
caller will be downgraded to, once the subscription expires.
Line 18: Level caller is to be downgraded to when his/her subscription expires.
(OPTIONAL)
Line 19: Number of minutes the caller would get per day at the second upgrade
level. (OPTIONAL)
NOTE: This number is for display purposes only, and should be entered in
minutes.
Line 20: Download Bytes available per day at the second upgrade level.
(OPTIONAL)
NOTE: This number is for display purposes only, and should be entered in
Bytes. You may add commas as needed
ie: 1,000 would read on the screens 1,000 bytes per day
Line 21: Contributors Conference number to join the caller to. (OPTIONAL)
This program will join the caller to the conference number you
specify here, with RXS flags.
Line 22: If number of SID's remaining are less than this number TABS PPE
will send you a message. (Set this option at 0 to disable)
(OPTIONAL)
Line 23: Number of attempts to get the caller when entering his SID. If
he fails to enter a valid SID this many times, he will be
sent out of the program.
Line 24: Sysop's Conference number to pass messages to (OPTIONAL)
This program will send messages to the Sysop when:
1. An error occurs (will pass errorlevel)
2. A caller successfully completes a donation
3. When SID's remaining are less than configured amount
NOTE: I urge you to configure this setting. If you choose not to the only
way you will know there is a problem with the program, is by reading
the TABS%PCBNODE%.LOG
Line 25: Name of the file containing your list of Active SID's. One SID
(Seven digit number) on each line. File must reside in the same
directory as the TABS.PPE. In this case this list would contain
the $10 SID's provided by the TABs BBS service.
Line 26: Yes, or No ...... Do you wish to have TABS-PPE update the callers
caller notes. You must have the Caller notes PSA installed for this
to work.
Line 27: Yes, or No......Do you wish to NOT promote donations that will not
upgrade the callers access level (ie the caller already has an
access level higher than what you have configured on line 11 and or
16 (if configured). If you answer YES and have external screens
enabled (see Line 29) the program will display the file listed on
configuration line 34 instead of the file on line 32, if internal
menus are used the caller will be passed a screen stating that no
further entitlements are granted, contact the sysop if you desire a
higher access level. In either case if the caller still elects to
enter a Subscription ID this program will accept the donation. This
program will ALWAYS except donations from callers that are at higher
access levels than configured on line 11 or 16 (if configured). This
is due to the fact that if the caller has already called the TABS 900
number and paid for a Subscription ID for your BBS, it is only good
for your BBS and you should be setup to accept it. Mostly, a this is
a setting that effects the internal screens, you could do the same
thing (if you use external screens) by changing the text in the screen
listed on line 32.
Line 28: The name of the file to be displayed to the caller that explains this
specific service the caller choose while at the Options display menu
or if you haven't configured the program to offer both the $10 dollar
service and the $25 service, this screen will be displayed instead of
the options screen.
Line 29: Yes, or No ..... Do you wish to use external screens or write your
own. Yes for externals, or No for internals.
If you have answered NO, on line 29 you do not have to configure the rest
of these options. In other words, if you use internal menus you do not need
lines 30-34. Just leave a blank line for each option. There are no in
betweens.... all internal, or all external.
Line 30: Name of the screen which displays the benefits given for contributing
to your BBS for the first time at this dollar amount. This file must
reside in the same directory as the PPE. You may have separate screens
for different access levels and languages.
Line 31: Name of the screen which displays the benefits given for contributing
to your BBS for the second time at this dollar amount. This file must
reside in the same directory as the PPE. You may have separate screens
for different access levels and languages.
Line 32: Name of the screen which is displayed if you have answered No on line
27 and the callers access level is above the highest configured
access level. This file would normally state that no further
entitlements are granted but you wish to promote further donations ie.
I'm broke, even though you don't get anything by donating please help
me... :) File must reside in the same directory as the PPE. You may
have separate screens for different access levels and languages.
Line 33: Name of the screen that serves as the PPE's main menu. File must
reside in the same directory as the PPE. You may have separate
screens for different access levels and languages.
Line 34: Name of the screen which is displayed if you have answered Yes on
line 27 and the callers access level is above the highest configured
level. The menu would normally say something like, at your access
level no further entitlements are granted using this program Please
contact your sysop for information on higher access levels. File
must reside in the same directory as the PPE. You may have separate
screens for different access levels and languages.
Important other Notes:
Be aware........ the external menus can say anything you want them to say.
Play with the program, It should do just about anything that you want it to
do. If it is not able to do what you wish, let me know..... !!! Also, DOUBLE
BE AWARE :) all the screens supplied with this package are customized for my
BBS..... you must change the screens to suite your system or you'll be giving
my BBS alot of undue attention on your system.
* Indicates new in this version......
If a caller decides to donate to your BBS but is at a level higher than what
you have specified in the configuration file, the donation will be accepted
and a message is passed to the caller. The screen that is displayed to the
caller is configurable as to either promote additional donations or no.
If you use the INSTALL.PPE the program will create a flag which disables
TABS-PPE until you finish configuring it. This will prevent share violations
that would occur if you were configuring the door while a caller was in it.
On the other hand TABS-PPE creates a flag during its use that will prevent you
from configuring the door while a caller is in it.
If you choose to use the bulletin generator, I recommend that some time when
all your BBS nodes are down, that you copy the bulletin tabs creates to some
other area. This would be the area that the callers would view the bulletin
from. If you do not do this and TABS-PPE trys to update the bulletin while a
caller is on another node reading it, it will cause a share violation. There
is no way around this.... you can't change a bulletin while someone is online
reading it.
This version of the program is TOTALLY UNCRIPPLED, but you will find that
it has a 5 second delay upon exiting the PPE and a Please register me note.
If you have any trouble with this program. I may be reached via the RIME
network PCB Utilities conference, if you choose you may route messages to me
via ->1475 or the PCB Support Echo on FidoNet or netmail via 1:275/25 or
1:265/30
Good luck, and may the contributions pour in !!
Remember, this program is SHAREWARE...... The $10 registration fee will allow
you to download the registered version of this program, and will remove
the built-in delay upon exiting the program and "stamp" your BBS name into the
code. Your BBS name will be displayed to the caller as they exit the door.
You may send the registration fee to:
Ray Sulich
1012 Scarborough CT.
Virginia Beach, VA
23456
You may also call the TABS 900 service and get a SID for this BBS. Then call
the support BBS listed below and redeem your SID for a registered copy of
TABS-PPE in the PPEDOOR.
Please include the following registration form. Give us about 1 week to
process your order, then call the Support BBS. At the main menu, enter
"PPEDOOR" and you will then enter the TABS-PPE download program. It will
check to see if I have received your registration fee, if I have it will
prompt you to create a registration key. You may also download the key and
the newest version of the program if you choose. The most current
registered code will always be available in this door. New versions may be
F'reqed via the magic filename of TABS-PPE.
Support BBS:
Straight Board BBS at:
804-468-6454 USR DS HST 16.8 V32/Bis V42/Bis
804-468-6528 AT&T Dataport 14.4 V32/Bis V42/Bis
----------------------------------------------------------------------------
T a b s - P P E Order form ...............................
TO: Ray Sulich Date___/___/___
1012 Scarborough CT
Virginia Beach, VA 23456
(Please use capitalization and punctuation where necessary.)
FROM: SysOp Name: _______________________________________________
This MUST be EXACTLY the same name you logon to the
support BBS with !!!!!!!
BBS Name: _________________________________________________
EXACTLY the way you wish it displayed in the TABS-PPE
exit screen !!!!
Address: __________________________________________________
City: ______________________ State: __________ ZIP: _______
Voice: ( ) _________________ BBS: ( ) _________________
Baud Rates:________________________
Program Name.............Registration FEE.......................
TABS-PPE $10.00
Total $______
F E E D B A C K
---------------
I learned of this Door from:
[ ] - A Friend [ ] - Computer Club
[ ] - BBS [ ] - Compuserve
[ ] - Salt Air BBS [ ] - Other
COMMENTS: _____________________________________________________
_______________________________________________________________
_______________________________________________________________
_______________________________________________________________
_______________________________________________________________