home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
EVENTS
/
WWBDAY14.ZIP
/
WWBDAY.DOC
< prev
next >
Wrap
Text File
|
1994-12-21
|
28KB
|
731 lines
WWBDAY v1.40
Copyright (c) 1994 by Patrick McClean
Birthday List Generator for WWIV v4.22+ BBS Systems
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Table of Contents
=================
(1) INTRODUCTION
1.1 What is WWBDAY? . . . . . . . . . . . . . . . . . . . . 1
1.2 Usage . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.3 Features . . . . . . . . . . . . . . . . . . . . . . . 1
(2) INSTALLATION
2.1 Included Files . . . . . . . . . . . . . . . . . . . . 2
2.2 Upgrading from a Previous Version . . . . . . . . . . . 2
2.3 Configuration File Explained . . . . . . . . . . . . . 2
2.4 Running WWBDAY as a Birthday List Generator Only . . . 7
2.5 Running WWBDAY as a Logon Event . . . . . . . . . . . . 8
2.6 Running WWBDAY as a WWIV Chain . . . . . . . . . . . . 8
2.7 Command Line Switches Explained . . . . . . . . . . . . 9
2.8 The TODAY.xxx file . . . . . . . . . . . . . . . . . . 9
2.9 Custom Bulletin Headers . . . . . . . . . . . . . . . . 11
(3) WWBDAY REGISTRATION
3.1 General WWBDAY Registration Info . . . . . . . . . . . 11
3.2 Benefits of WWBDAY Registration . . . . . . . . . . . . 11
3.3 Registration By Mail . . . . . . . . . . . . . . . . . 12
3.4 Instant Registration on TNS BBS . . . . . . . . . . . . 12
(4) GENERAL INFO
4.1 Revision . . . . . . . . . . . . . . . . . . . . . . . 13
4.2 Credits/Thanks . . . . . . . . . . . . . . . . . . . . 13
(5) LEGAL INFO
5.1 Legal Disclaimer/Agreement . . . . . . . . . . . . . . 14
5.2 Definition of Shareware . . . . . . . . . . . . . . . . 14
- PAGE 1
=(1) INTRODUCTION ]=========================================================
-=[1.1]=- What is WWBDAY?
Thank you for you're interest in WWBDAY v1.40. This program, written
for WWIV v4.22 or 4.43+ BBS systems can be used to generate a listing of
users with birthdays on the current date, the day before, and the day
after. WWBDAY also supports TODAY.xxx data files which are available on
many BBS systems. This allows you to have a listing of celebrity birthdays
historical events or daily reminders/wit for the current date added to
you're regular user birthday listings.
-=[1.2]=- Usage
There are basically two ways to run WWBDAY :
(1) As a simple birthday list generator only.
(2) As a combination birthday list generator and logon event.
Option 1
========
Simply run WWBDAY once per day, preferably at midnight in any begin day
event that you have configured. This is the simplest usage and is usually
used for generating birthday listing files to be used in you're gfiles
section or elsewhere on the board.
Option 2
========
WWBDAY can also be used as a logon event! This option will display the
birthday listing when a caller logs the bbs also if a user happens to
log onto the BBS on their birthday, a nice Happy Birthday message of you're
choice is printed out to them.
-=[1.3]=- Features of WWBDAY
<*> WWIV v4.23 multi-instance compatible. DV\Windows\Network...etc..
(MUST have SHARE.EXE installed)
<*> Full color configurability
<*> Duel Usage - Logon event or simple birthday listing generator
<*> TODAY.xxx support for
celebrity birthday listing
historical events
daily reminder or wit
<*> Can be configured to only display only on users first logon of
the day.
<*> Highly configurable
<*> Can use most custom color formats in birthday lists
<*> Able to use custom bulletin headers. (R)
<*> Fully customizeable. (R)
(R) = Registered Feature
- PAGE 2
=(2) INSTALLATION ]=========================================================
-=[2.1]=- Included Files
To install WWBDAY v1.40, unzip the program to you're main WWIV BBS
directory.
Here is what should be included in the archive:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
WWBDAY .CFG - WWBDAY v1.40 sample configuration file
WWBDAY .DOC - WWBDAY v1.40 documentation file
WWBDAY .EXE - WWBDAY v1.40 executable file
HPYBDAY .ANS - WWBDAY v1.40 Happy Birthday ANSI file
HPYBDAY .MSG - WWBDAY v1.40 Happy Birthday ASCII file
REGISTER.FRM - WWBDAY v1.40 registration form
TODAY .SAM - Sample TODAY.LCL file
BDAYHEAD.ANS - ANSI header types available
BDAYHEAD.ASC - ASCII header types available
BBS900 .TXT - Registration by TABS 900 Info
FILE_ID .DIZ - File description
WHATS .NEW - New Features for WWBDAY v1.40
README .1ST - IMPORTANT INFO
[NOTE] If any files are missing from the archive then you may have
a copy that has been tampered with and you should call TNS BBS
at the number shown below to obtain a new copy.
-=[2.2]=- Upgrading from a previous version of WWBDAY
*[WARNING]* The configuration file has changed with WWBDAY v1.20
Upgrading from versions prior to v1.20 requires you to modify
your configuration file or use the one supplied with WWBDAY v1.20
and modify it to suit your BBS.
Three new options have been added which requires three new lines be
added to the configuration file right before the color options.
[ See configuration file explained below for more info ]
-=[2.3]=- Configuration File Setup
[NOTE] Before you run WWBDAY.EXE, make sure you edit WWBDAY.CFG for
you're system configuration.
Here is what to put in the file:
[ LINE 1 ]
--------------------------
C:\WWIV\GFILES
--------------------------
Path ONLY for you're ASCII birthday list. If you don't want to generate
this file, put NONE on this line.
- PAGE 3
[ LINE 2 ]
---------------------------------
C:\WWIV\GFILES
---------------------------------
Path ONLY for you're ANSI birthday list. If you don't want to generate
this file, put NONE on this line.
[ line 3 ]
---------------------------------
C:\WWIV\DATA
---------------------------------
Path ONLY to you're WWIV USER.LST file.
[ LINE 4 ]
---------------------------------
C:\WWIV\TODAY
---------------------------------
Path ONLY for you're "TODAY.xxx" files. If you don't want to use these
files, put NONE on this line.
[ LINE 5 ]
---------------------------------
Celebrities Born Today,
---------------------------------
Title line used for celebrity birthday display. You can put whatever
you want here and it will be used as the header for the celebrity
birthday list.
[ LINE 6 ]
---------------------------------
The Nocturnal Sanctuary
---------------------------------
The name of you're BBS.
[LINE 7 ]
---------------------------------
The Keeper
---------------------------------
Place the name of the SysOp of the BBS here.
[ LINE 8 ]
---------------------------------
00000000
---------------------------------
You're WWBDAY registration number. DO NOT change this line if you are
not registered or WWBDAY may not work.
- PAGE 4
[ LINE 9 ]
---------------------------------
1
---------------------------------
ASCII header style. If you have not registered WWBDAY you will only be
able to use header style 1 or 2 . Once you have registered WWBDAY you
will be able to select from many different header styles for you're
ASCII birthday listing as well as create you're own custom headers.
[NOTE]
To use a custom header you would put a 'C' on this line (without quotes)
and WWBDAY would look for a file in the same directory called BDAYHEAD.MSG
and if it exists, use it for you ASCII birthday header.
[ LINE 10 ]
---------------------------------
1
---------------------------------
ANSI header style. If you have not registered WWBDAY you will only be
able to use header style 1 or 2 . Once you have registered WWBDAY you
will be able to select from many different header styles for you're
ANSI birthday listing as well as create you're own custom headers.
[NOTE]
To use a custom header you would put a 'C' on this line (without quotes)
and WWBDAY would look for a file in the same directory called BDAYHEAD.ANS
and if it exists, use it for you ANSI birthday header.
[ LINE 11 ]
---------------------------------
1
---------------------------------
Pause style. Once registered you may choose from several different pause
prompt style. If not registered leave at 1
[ LINE 12 ]
---------------------------------
Y
---------------------------------
For logon event. Do you want to clear the screen before birthday
list is displayed? Put Y or N
[ LINE 13 ]
---------------------------------
Y
---------------------------------
For logon event. Do you want to pause the screen after birthday list
is displayed? Put Y or N
- PAGE 5
[ LINE 14 ]
---------------------------------
Y
---------------------------------
For logon event. Allow users to abort the displaying of the birthday
list? Put Y or N
[ LINE 15 ]
---------------------------------
N
---------------------------------
For logon event. Do you want the birthday list displayed if there are
no birthdays? This option is pretty much useless if you use any of the
TODAY.xxx file options. Put Y or N
[ LINE 16 ]
---------------------------------
Y
---------------------------------
Add user number after user name in birthday listings?
[ LINE 17 ]
---------------------------------
N
---------------------------------
For logon event. Display birthday listing to callers who already logged
on once today. Put Y or N
[ LINE 18 ]
---------------------------------
Y
---------------------------------
Display historical events for today? WWBDAY can also add historical events
from your today files. There are several ways to do this.
1> Put Y on this line and WWBDAY will search the same today files that
you are using for your celebrity birthdays.
2> Put a S on this line directly followed by the FULL drive\path\filename
including file extension, to the file to search for the events.
[EXAMPLE] C:\WWIV\TODAY\TODAY.HIS
3> Put a S on this line directly followed by the FULL drive\path\filename
without the .XXX file extension and WWBDAY will search for the file
in a similar fashion as the celebrity birthday file where .XXX is the
month. [ See full explanation of today files ]
[EXAMPLE] C:\WWIV\TODAY\HISTORY
- PAGE 6
[ LINE 19 ]
---------------------------------
Y
---------------------------------
Display Reminders or Witty comments for today? WWBDAY can also add special
daily reminders or witty comments from your today files. There are several
ways to do this.
1> Put Y on this line and WWBDAY will search the same today files that
you are using for your celebrity birthdays.
2> Put a S on this line directly followed by the FULL drive\path\filename
including file extension, to the file to search for the reminders.
[EXAMPLE] C:\WWIV\TODAY\TODAY.WIT
3> Put a S on this line directly followed by the FULL drive\path\filename
without the .XXX file extension and WWBDAY will search for the file
in a similar fashion as the celebrity birthday file where .XXX is the
month. [ See full explanation of today files ]
[EXAMPLE] C:\WWIV\TODAY\WIT
[ LINE 20 ]
---------------------------------
3
---------------------------------
Color for program name
[ LINE 21 ]
---------------------------------
3
---------------------------------
Color for "Birthday Listing for...." title line
[ LINE 22 ]
---------------------------------
2
---------------------------------
Color for YESTERDAY, TODAY, & TOMORROW.
[ LINE 23 ]
---------------------------------
5
---------------------------------
Color for separator lines.
[ LINE 24 ]
---------------------------------
1
---------------------------------
Color for user names.
- PAGE 7
[ LINE 25 ]
---------------------------------
3
---------------------------------
Color for "Celebrities born..." title line.
[ LINE 26 ]
---------------------------------
1
---------------------------------
Color for celebrity names.
[ LINE 27 ]
---------------------------------
7
---------------------------------
Color for celebrity year.
[ LINE 28 ]
---------------------------------
3
---------------------------------
Color for [PAUSE] prompt.
[MOTE 2] Notice the filename is not specified in lines 1 and 2. The
filenames for the birthday lists will be WWBDAY.MSG and
WWBDAY.ANS.
[NOTE 1] EACH line must have something on it.
Also note that for the color choices, WWBDAY will support any color you're
system will support as long as it is in the standard format of "" + a
SINGLE character to specify the color. For example if you are using a
stock copy of WWIV v4.22, colors you will be able to use colors 0-7. If
you are using a stock copy of WWIV 4.23+ you will be able to use colors
0-9. If you have modified you're BBS to support additional colors as long
as they are in the standard format mentioned above they will work fine.
-=[2.4]=- Running WWBDAY as a birthday list generator in you're daily event.
Simply edit the WWBDAY.CFG file, put "WWBDAY.EXE" in you're daily
event batch file so it may generate you're daily birthday lists
every night.
=======
EXAMPLE
=======
CD\WWIV <<< Make sure you execute WWBDAY from you're WWIV dir
WWBDAY.EXE <<< No command line for event usage
- PAGE 8
-=[2.5]=- Running WWBDAY as a logon event.
If you would like to run WWBDAY as a logon event, so that you're birthday
lists can be viewed by you're users upon logon, put WWBDAY.EXE in you're
nightly event as shown above and also put "WWBDAY.EXE /L%1" in you're
logon event batch file and make sure you have the %1 in INIT also so
that WWIV will pass the path to chain.txt to WWBDAY.
===========================
EXAMPLE FROM LOGON.BAT FILE
===========================
CD\WWIV
WWBDAY.EXE /L%1
=================
EXAMPLE FROM INIT
=================
Logon Event : C:\BATCH\LOGON.BAT %1
If you do not use a logon batch file then enter "WWBDAY.EXE /L%1"
without the quotes in INIT as you're Logon Event.
NOTE 1 : There is NO space between the /L and the %1
NOTE 2 : You could substitute the full path and filename for chain.xxx
for the %1 if you wish.
=================
EXAMPLE FROM INIT
=================
Logon Event : C:\WWIV\WWBDAY.EXE /L%1
-=[2.6]=- Running WWBDAY as a WWIV chain
If you would like to run WWBDAY as a chain, here is how you set it up:
1. Setup WWBDAY in you're nightly event as shown above.
2. Setup WWBDAY in chainedit as shown.
A. Description : Birthday Listings
B. Filename : WWBDAY.EXE /L%1
E. ANSI : Optional
F. DOS Interrupt: Used
H. Shrink : No
I. Disable pause: No
J. Local only : No
- PAGE 9
-=[2.7]=- Command Line Switches Explained
/L - This tells WWBDAY to run as a logon event and display
the appropriate birthday listing (ANSI/ASCII). You would
also use this command to run WWBDAY as a chain. The
correct syntax for the command line is
WWBDAY.EXE /L{path and filename of chain file}
Commands may be upper or lower case. But make sure to put the /LOGON
command first on the command line if used.
-=[2.8]=- TODAY.xxx FILE
To customize you're birthday listing with information of particular
interest to you're BBS or immediate area, WWBDAY will scan for the
presence of a file called TODAY.xxx and include appropriate lines from
it if it's found.
The file names for the today files would be as follows.
=======================================================
TODAY.JAN
TODAY.FEB
TODAY.MAR
TODAY.APR
TODAY.MAY
TODAY.JUN
TODAY.JUL
TODAY.AUG
TODAY.SEP
TODAY.OCT
TODAY.NOV
TODAY.DEC
- PAGE 10
This is the format of the TODAY.xxx file
========================================
Column 1 : 'B' for birthday listings.
'S' for historical event.
'R' for reminder or wit.
or 'F' for reminder or wit.
Cols 2-5 : Month and day as MMDD with leading zeros.
Cols 6-9 : The full year of the event as four digits.
Column 10 : A space.
or
'C' - Use this for continuing a line to the next line
Cols 11-80: The message to display for this date.
[EXAMPLES]
*mmddyyyy Birthdays
B05011769 Duke of Wellington, (nee Arthur Wellesley), British general.
B05011830 Mother Jones, (nee Mary Harris Jones), hellraiser.
B05011916 Glenn Ford, actor.
B05011917 John Beradino, actor.
*mmddyyyy Historical events
S04301945 Adolf Hitler commits suicide.
S04301948 the Organization of American States (OAS) is founded.
*mmdd Reminder or wit
R0401 Mondays are the potholes in the road of life.
or
F0401 Mondays are the potholes in the road of life.
[NOTE] I have seen files using both the R and files using the F so I
supported both versions.
If you wish to wrap a long line to the next line you would replace
the space on column 10 with a 'C' then continue the line as shown below.
B07091802 Thomas Davenport, invented the first commercially successful
B07091802Celectric motor.
- PAGE 11
-=[2.9]=- Custom Bulletin Headers *-(REGISTERED FEATURE)
If you have registered WWBDAY you have the option of creating you're own
ASCII and ANSI bulletin headers.
To use custom headers :
1> Create you're header(s) with a text editor or The Draw and name them
BDAYHEAD.ASC for you're ASCII header and BDAYHEAD.ANS for you're ANSII
header.
2> Copy you're header file(s) to the directory where WWBDAY.EXE is.
3> To tell WWBDAY to use the custom header when creating you're bulletins
place a 'C' (without the quotes) on line 9 for ASCII and(or) 10 for
ANSII. [again, this will only work if you are registered]
4> Run WWBDAY to generate the new bulletins.
=(3) WWBDAY REGISTRATION INFO ]=============================================
-=[3.1]=- General WWBDAY Registration Info
I believe that BBS software should be as inexpensive as possible because
it already costs so much just to run a good BBS (I'm a SysOp) so for this
reason registration is only $5.00 US per copy of WWBDAY v1.40 and you're
registration is good for all future versions of WWBDAY.
No one likes NAG-Wares, myself included.... there are no beeps, time
delays or heavy restrictions to the unregistered version of WWBDAY.....
However there are benefits to registering WWBDAY.
-=[3.2]=- Benefits of WWBDAY Registration.
1> Registration removes the [UNREGISTERED] message from you're bulletins.
as well as the event screen.
2> Registration allows full use of all internal ASCII/ANSI header types.
3> Registration allows the use of custom external ASCII/ANSII header
types.
- PAGE 12
=-[3.3]=- Registration By mail
Fill out REGISTER.TXT and send it to:
Patrick H McClean
14448 Amar Rd. Unit K
La Puente, CA. 91744
-=[3.4]=- Instant Registration On TNS BBS
You may instantly register WWBDAY v1.40 by calling.
The Nocturnal Sanctuary (or) TNS BBS - 818-919-0777
3 Nodes / 14.4v.32/42bis / 24 hours
TABS 900 Registration Info
This Telephone Access Billing System (TABS) allows you to pay for credits
on The Nocturnal Sanctuary. You can use these credits to instantly
register WWBDAY, WWDIF, The Randomizer or other WWWares software.
When you call our 900-number a computer-automated voice system will ask
for the seven digit number of this TNS BBS (919-0777). When you enter
this number, 2 things will happen. The automated voice system will tell
you you're ID-code, and a flat $10 charge will appear on you're next phone
bill. Have a pencil and paper ready to write down this number. Once you
have you're ID-code you can then call The Nocturnal Sanctuary to redeem
you're ID-code and instantly receive you're registration code which will
remove all limitations from the unregistered version of WWBDAY.
*************************************************************************
Our 900 Number: 1-900-622-8227 (voice)
Our BBS Number: 919-0777 (TNS BBS)
*************************************************************************
The cost of this call is $10
Anyone under the age of 18 must have parental permission.
TABS is a service of True Media, Inc
- PAGE 13
=(4) GENERAL INFO ]========================================================
-=[4.1]=- Revisions
Version 1.00 (05/14/94)
■ Initial release
Version 1.10 (05/16/94)
■ Minor fix, but I wanted to get this out right away.
Fixed listings to show the first 25 characters of long names when
user number added to end of name is selected.
Version 1.20 (06/04/94)
■ Added support for historical events from Today files
■ Added support for reminders or wit from Today files
■ Added logon usage option to only display listings on users
first logon of the day.
■ Optimized for quicker display of birthday lists with less disk usage.
Version 1.30 (NEVER)
■ Call it superstition.....
Version 1.40 (06/15/94)
■ Minor cosmetics.....
-=[4.2]=- Credits/Thanks
WWDBDAY v1.40 Copyright (c) 1994 by Patrick McClean
WWIV is Copyright (c) 1988-1994 by Wayne Bell
Today is distributed as freeware by Patrick Kincaid
Tigger @ Tigger's After Dark for help with beta testing
If you have any questions or comments about this program, or any other
WWWares Sofware you can reach me at the following network addresses:
WWIVnet : 1@8870
WWIVLink : 1@18870
TerraNET : 1@8860
IceNET : 1@8882
SOLARnet : 1@8859
USLink : 1@8866
FILEnet : 1@1500
USAnet : 1@8872
GameLink : 1@8853
You may also call my BBS
~~~~~~~~~~~~~~~~~~~~~~~~
The Nocturnal Sanctuary
14.4v32/42bis - 3 nodes - (818)919-0777
- PAGE 14
=(5) LEGAL INFO ]==========================================================
-=[5.1]=- DISCLAIMER/AGREEMENT
Users of WWBDAY must accept this disclaimer of warranty:
"WWBDAY is supplied as is. The author disclaims all warranties,
expressed or implied, including, without limitation, the warranties of
merchantability and of fitness for any purpose. The author assumes no
liability for damages, direct or consequential, which may result from
the use of WWBDAY."
"WWBDAY is a `shareware' program and is provided at no charge to the
user for evaluation. Feel free to share it with you're friends, but
please do not give it away altered or as part of any other software
package, etc. The essence of "user-supported" software is to provide
personal computer users with quality software without high prices and
yet to provide incentive for programmers to continue to develop new
products. If you find this program useful and find that you are using
WWBDAY and continue to use WWBDAY after a reasonable trial period, you
must make a registration payment to the author. Anyone distributing
WWBDAY for any kind of remuneration must first contact the author for
authorization.
"You are encouraged to pass a copy of WWBDAY along to you're friends
for evaluation. Please encourage them to register their copy if they
find that they can use it.
-=[5.2]=- Definition of Shareware
Shareware distribution gives users a chance to try software before
buying it. If you try a Shareware program and continue using it, you
are expected to register. Individual programs differ on details some
request registration while others require it, some specify a maximum
trial period. With registration, you get anything from the simple right
to continue using the software to an updated program with printed manual.
Copyright laws apply to both Shareware and commercial software, and the
copyright holder retains all rights, with a few specific exceptions as
stated below. Shareware authors are accomplished programmers, just like
commercial authors and the programs are of comparable quality. (In both
cases, there are good programs and bad ones!) The main difference is in
the method of distribution. The author specifically grants the right to
copy and distribute the software, either to all and sundry or to a
specific group. For example, some authors require written permission
before a commercial disk vendor may copy their Shareware.
- PAGE 15
You should find software that suits you're needs and pocketbook, whether
it's commercial or Shareware. The Shareware system makes fitting you're
needs easier, because you can try before you buy. And because the
overhead is low, prices are low also. Shareware has the ultimate
money-back guarantee if you don't use the product, you don't pay for it.