home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
EVENTS
/
BDAY122.ZIP
/
BIRTHDAY.DOC
< prev
next >
Wrap
Text File
|
1995-12-02
|
25KB
|
510 lines
┌────────────────────────────────────────────────────────────────────────────┐
│─═══════────══──═══════──══════════──══────══──═══════──────════───══────══─│
│─══────══───══──══────══─────══──────══────══──══────══────══──══───══──══──│
│─══────══───══──══────══─────══──────══────══──══─────══──══────══───════───│
│─════════───══──═══════──────══──────════════──══─────══──════════────══────│
│─══─────══──══──══───══──────══──────══────══──══─────══──══────══────══────│
│─══─────══──══──══────══─────══──────══────══──══────══───══────══────══────│
│─════════───══──══────══─────══──────══────══──═══════────══────══────══────│
│ │
│ Birthday v1.22 │
│ Copyright (c) 1992-1995 by Cris McRae │
│ All Rights Reserved │
│ │
│ A Birthday List Generator for │
│ WWIV v4.22+ BBS Systems │
│ │
└────────────────────────────────────────────────────────────────────────────┘
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
What is Birthday v1.22? It is a program written for WWIV v4.22+ BBS systems,
and it generates a listing of users with birthdays on the current date, the
the day before, and the day after. Here is a sample file output:
Birthday v1.22 [Unregistered] (c) 1992-1995 by Cris McRae
Birthday Listing for 09/18/95
YESTERDAY TODAY TOMORROW
───────────────────────── ───────────────────────── ─────────────────────────
Marlboro JAFO The Painter
Nick Phantom Of The Opera De Bug
Attack Ziggy William Padilla
Fingers Bill The Cat
I changed my system date to my birthday to generate the above listing. It is
nice to know who has the same birthday as you. Generally, you run it once a
day in your daily event batch file.
Birthday also supports the TODAY.xxx data files which are widely available.
If you have these files, and wish to have them included in the Birthday lists,
Birthday will print out all celebrity birthdays for the current date. If you
are registered, you can also have Birthday print out information about deaths,
holidays, religious obvservances, reminders, and special events.
Birthday can be used to generate lists for your G-files area, but beginning
with Birthday v1.10, it can also be used as a logon event. If a user happens
to log onto the BBS on their birthday, a nice Happy Birthday message is
printed out to them. It is also displayed if they are logging on after their
birthday, if it occured within the past seven days. You may edit the BDAY.*
files to display any message you like, as long as they use WWIV ANSI codes.
The BDAY.* files must go in the same directory where the BIRTHDAY.EXE is
located.
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ PROGRAM AUTHENTICITY ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
Birthday has been archived with PKWARE's PKZIP 2.04g using Authenticity
Verification. When you unzip the archive, you should see "-AV" displayed
after every file name. When completed, a message that looks like this will
be displayed:
Authentic files Verified! # KRK282
Cris McRae
If this authenticity statement is not displayed, or the authenticity code is
not "KRK282", then you have a copy of Birthday that has been tampered with.
Do >not< use any of the files contained within a tampered archive, as they
may contain viruses, trojans, or other harmful things.
Birthday has also been encrypted by a powerful encryption program. If the
executable file is tampered with, it will display a CRC warning and will not
run.
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ UPGRADING FROM PREVIOUS VERSIONS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
If you are upgrading from Birthday v1.17 or below, you >must< run BDAYCFG.EXE
prior to running BIRTHDAY.EXE. This is required because the BIRTHDAY.CFG file
is no longer used, and BIRTHDAY.EXE will convert your BIRTHDAY.CFG to the new
WWIV.INI format.
Failure to run BDAYCFG.EXE prior to running BIRTHDAY.EXE will result in
Birthday running with a default configuration. If you're registered, it will
also run in unregistered mode.
Of course, you should also copy the new BIRTHDAY.EXE over the old one.
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
To install Birthday v1.22, you must unzip BDAY122.ZIP to your main WWIV BBS
directory. Here is what should be included in the archive:
BIRTHDAY.DOC - Birthday v1.22 documentation file
BIRTHDAY.EXE - Birthday v1.22 executable file
BDAYCFG .EXE - Birthday v1.22 configuration program
BDAY .ANS - Birthday v1.22 Happy Birthday ANSI file
BDAY .MSG - Birthday v1.22 Happy Birthday ASCII file
REGISTER.LST - List of registered Birthday users
REGISTER.TXT - Birthday v1.22 registration form
TODAY .LCL - Sample TODAY.LCL file
FILE_ID .DIZ - File description
══[ CONFIGURATION FILE SETUP ]════════════════════════════════════════════════
Birthday comes with a configuration program called BDAYCFG.EXE. It is used
to edit all aspects of Birthdays's operation. All configuration info used by
Birhtday is stored in WWIV.INI. This file is not unique to Birthday, so you
may or may not already have one. If you do, BDAYCFG.EXE will simply append
to the file, otherwise it will create it from scratch. In either case, a new
section called "[Birthday]" will be added at the end of WWIV.INI.
The following is a description of each of the lines used by Birthday for it's
configuration. In most cases, you will never need to manually change any of
these lines in WWIV.INI, since the Birthday Configuration program (BDAYCFG)
is used to change the values.
ASCII_PATH =C:\WWIV\GFILES ; Path for your ASCII Birthday list. If you
; don't want to generate this file, leave
; blank.
ANSI_PATH =C:\WWIV\GFILES ; Path for your ANSI Birthday list. If you
; don't want to generate this file, leave
; blank.
TODAY_PATH =C:\WWIV\GFILES ; Path for your "TODAY.xxx" files. If you
; don't want to use these files, leave
; blank.
TODAY_OPTS =BDHIRS ; Today options. Identifiers are for:
; B - Birthdays
; D - Deaths
; H - Holidays
; I - Religious observances
; R - Reminders
; S - Special events
; You may specify the identifiers in the
; order you want them displayed. Only 'B'
; works in the unregistered version.
CLEAR_SCREEN =Yes ; For logon event. Do you want to clear the
; screen before displaying Birthday list?
PAUSE_SCREEN =Yes ; For logon event. Do you want to pause the
; screen after Birthday list is displayed?
ALLOW_ABORT =Yes ; For logon event. Allow users to abort the
; displaying of the Birthday list?
SHOW_ONLY_ONCE =No ; For logon event. Do you want to display
; the Birthday list on user's first logon
; only?
SAVE_BLANK_LISTS=No ; Display "No User Birthdays" in Birthday
; list if there are no birthdays for all
; three days?
SHOW_BLANK_LISTS=No ; For logon event. Do you want the Birthday
; list displayed if there are no birthdays?
; This option is useless if you use the
; TODAY.xxx files.
ADD_USER_NUMBERS=No ; Add user number after user name in
; Birthday listings?
HEADER_STYLE =1 ; Header style (1-11, 11 for custom). A
; list of available headers is provided in
; the next section of this document.
; If you want a custom header, use
; HEADER.TXT and put a 25 character string
; in it.
LIST_COLORS =3,2,5,7,1,2,1 ; Colors for the Birthday lists. (0-9)
; Color 1 - Birthday copyright notice
; Color 2 - Birthday Listing Date
; Color 3 - YESTERDAY, TODAY, & TOMORROW
; Color 4 - Separator lines
; Color 5 - User names
; Color 6 - "Celebrities born..." line
; Color 7 - Celebrity names
If you are using WWIV v4.22, colors 8 and 9 won't be available unless you have
modified your source. They are available in WWIV v4.23+.
══[ SAMPLE HEADERS ]══════════════════════════════════════════════════════════
1.
YESTERDAY TODAY TOMORROW
───────────────────────── ───────────────────────── ─────────────────────────
2.
YESTERDAY TODAY TOMORROW
-=-=-=-=-=-=-=-=-=-=-=-=- -=-=-=-=-=-=-=-=-=-=-=-=- -=-=-=-=-=-=-=-=-=-=-=-=-
3.
YESTERDAY TODAY TOMORROW
~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
4.
YESTERDAY TODAY TOMORROW
========================= ========================= =========================
5.
YESTERDAY TODAY TOMORROW
═════════════════════════ ═════════════════════════ ═════════════════════════
6.
YESTERDAY TODAY TOMORROW
≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈ ≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈ ≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈
7.
YESTERDAY TODAY TOMORROW
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
8.
YESTERDAY TODAY TOMORROW
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
9.
YESTERDAY TODAY TOMORROW
««««««««««««*»»»»»»»»»»»» ««««««««««««*»»»»»»»»»»»» ««««««««««««*»»»»»»»»»»»»
10.
YESTERDAY TODAY TOMORROW
»»»»»»»»»»»»*«««««««««««« »»»»»»»»»»»»*«««««««««««« »»»»»»»»»»»»*««««««««««««
══[ THE TODAY.LCL FILE ]══════════════════════════════════════════════════════
To customize your display with information of particular interest to your BBS
or immediate area, Birthday will scan for the presence of a file called
TODAY.LCL and include appropriate lines from it if it's found.
I have included a sample LOCAL.LCL file with a few birthdays in it. If you
wish, put this file in your GFILES directory. The format for the LOCAL.LCL
file is:
Column 1 : Must be one of the following letters:
B - Birthdays (only valid letter if unregistered)
D - Deaths
H - Holidays
I - Religious observances
R - Reminders
S - Special events
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 : This field can be:
BLANK - Does nothing (most will have this)
C - Continued line (must also have a date for these lines)
DOW - Day of week (1=Sunday, 2=Monday, etc.)
This causes the message to be displayed only if the
current day of week matches this value.
Cols 11-80: The message to display for this date.
Examples:
*mmddyyyy Birthdays
*-------- --------------------------------------------------------------------
B09021838 Queen Liliuokalani (last queen of Hawaii).
B09011875 Edgar Rice Burroughs, novelist
B09021952 Jimmy Connors, tennis star
NOTE: This file should be saved in such a way that all like categories are
grouped together, and it should be sorted by date, in ascending order.
This is required because of the method Birthday uses to read the file
and handle 'C'ontinued lines. Birthday cannot sort the information
for you.
══[ DAILY EVENT SETUP ]═══════════════════════════════════════════════════════
Once you have edited the WWIV.INI file, put "BIRTHDAY.EXE" in your daily event
batch file so it can be processed nightly.
══[ LOGON EVENT SETUP ]═══════════════════════════════════════════════════════
If you would like to run Birthday as a logon event, so that your Birthday
lists can be viewed by your users, put "BIRTHDAY.EXE L" in your logon event
batch file, or simply put that line in INIT if you have no other logon events.
If you don't currently have a logon event, and want Birthday to automatically
configure INIT to run Birthday at the logon event, type:
BDAYCFG /INSTALL
That will add "BIRTHDAY.EXE L" (including full path to the EXE) to INIT.
If you use the logon event feature, the BDAY.* files must be place in your
main BBS directory (same directory as your EXE).
══[ CHAIN SETUP ]═════════════════════════════════════════════════════════════
If you would like to run Birthday as a chain, use the following setup:
A. Description : Birthday Listings
B. Filename : BIRTHDAY.EXE L
E. ANSI : Optional
F. DOS Interrupt: Used
H. Shrink : No
I. Disable pause: No
J. Local only : No
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ COPYRIGHT/LICENSE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
This document and the program files ("the software") are copyrighted by the
author. The copyright owner hereby licenses you to use the software given
these restrictions:
■ The software shall be supplied in its original, unmodified form, which
includes this documentation;
■ The software may not be included or bundled with other goods or
services;
■ No fee is charged; an exception is granted to non-profit user's
groups, which are permitted to charge a small fee (not to exceed $5)
for materials, handling, postage, and general overhead. No other
organization is permitted to charge any amount for distribution of
copies of the software or documentation, or to include copies of the
software or documentation with sales of their own products.
The software and documentation are Copyright (c) 1992-1995 by Cris McRae
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ REGISTRATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
Birthday is shareware. This gives the user an opportunity to evaluate the
program before actually registering the software. If, after a 30 day period,
you wish to continue to use Birthday, you are required to register your copy
of Birthday with the author. To register, please fill out REGISTER.TXT and
send it to:
Cris McRae
P.O. Box 1351
Burbank, CA 91507
Registration is $5.00 US per copy of Birthday.
Note: Registration system used is REGKEY.
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ DISCLAIMER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
The author makes no warranties, expressed or implied, as to the quality or
performance of this program. Your use of this program constitutes your
release of the author from liability or litigation for any indirect or
consequential damages arising from the use of this program or its associated
files.
In no event will the author be liable to you for any damages, including any
lost profits, lost savings or other incidental or consequential damages
arising out of your use or inability to use the program, or for any claim by
any other party.
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ REVISIONS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
Version 1.00 (11/01/92)
■ Initial release
Version 1.01 (11/06/92)
■ Fixed color bug
■ Changed ASCII output file to BIRTHDAY.MSG for WWIV printfile
compatibility
■ Optimized C code a little
Version 1.02 (01/23/93)
■ Compiled with WWIV v4.22 userrec format
■ Program display updated to implement direct screen writes
■ DESQview aware - direct screen writes are turned off under DESQview
Version 1.10 (06/10/93)
■ Added color configurability
■ Added logon event capability
■ Added TODAY.xxx support
■ Added small registration fee
Version 1.11 (06/26/93)
■ Fixed color bug (evident when using color 4)
■ Added logon event install feature
Version 1.12 (09/08/93)
■ WWIV v4.23 multi-instance compatible
(Thanks to Jim Wire)
■ Fixed bug where names >24 characters messed up display
■ Added logon event ability to print Happy Birthday message to user when
they logon the day of their birthday
■ Added configurable ability to add user numbers after user names in listing
Version 1.13 (12/01/93)
■ Changed the WWIV v4.23 multi-instance code. Now uses Wayne Bell's
file sharing disk I/O routines.
■ Added ability to give gold to users on their birthday.
■ Added ability to give filepoints to users on their birthday.
■ Added ability to give extra time to users on their birthday. They must
log on the day of their birthday to get the time. The extra time is only
given on their FIRST logon of that day. This is for WWIV v4.23 users
only.
Version 1.14 (12/18/93)
■ Due to unknown causes, the gold, file points, and extra time features
caused certain systems to lock up. These features have been removed.
It is uncertain whether they will be added later or not.
Version 1.15 (01/10/94)
■ Fixed alignment problem in celebrity birthday listings
■ Fixed halting problem during logon event. Previous v4.23 compatible
versions opened the USER.LST and kept it open when it was not necessary,
causing other instances to halt until Birthday was done printing the
birthday list. This has been fixed.
■ Fixed user screen height problem. Instead of using the user's screen
height, prior versions used the BBS's screen height to determine the
number of lines to print before displaying [PAUSE] during the logon
event.
Version 1.16 (02/20/94)
■ Fixed problem reading the USER.LST to see if it was the current users
birthday during the logon event. It would only work if the user number
was 32 or below.
■ Fixed problem handling TODAY files that use the 'C' identifier to continue
an entry on the next line.
(Bug found by Spackle)
■ Fixed problem with printing out birthday lists that don't exist. For
instance, if you set up Birthday not to generate an ASCII file, and an
ASCII user logged on, Birthday would print out an error message because
it tried to open a non-existent file. Birthday now prints nothing if it
cannot find the file.
(Bug found by FireWalker)
Version 1.17 (06/29/94)
■ Fixed /INSTALL problem. It was not properly updating CONFIG.DAT.
■ Added support for configurable headers.
■ Added support for WWIV.INI. Birthday no longer uses BIRTHDAY.CFG.
■ Changed the way user numbers are handled if you have Birthday append them
to user names. Prior versions would not include the number if the name
was too long. Birthday now shortens the length of the user name to fit
the user number in.
■ Added configuration program (BDAYCFG.EXE). You must run BDAYCFG.EXE if
upgrading from previous versions in order to convert your BIRTHDAY.CFG
file into WWIV.INI format.
Version 1.18 (09/05/94)
■ Changed local list display (using L parameter) so no ANSI.SYS is required
to display color.
■ Added support for displaying Deaths, Holidays, Religious observances,
Special events, and Reminders from the TODAY files. This is a registered
feature only.
■ Improved the way Birthday displays continued lines from the TODAY files.
■ Fixed bug in BDAYCFG.EXE that would not save the header variable if you
changed it.
■ Updated BDAYCFG.EXE to allow you to configure the additional TODAY
features.
■ Changed logon event displaying so you can 'P'ause the display like with
WWIV, and users should be able to abort displaying a littler easier.
■ Made BDAYCFG.EXE more multitasker friendly. It now gives up time slices
while waiting for you to hit a key.
■ Added ability to display BDAY.* message to users if they are logging on to
the BBS up to seven days since their birthday occured. The BDAY.* message
is displayed to the user once, even if they log onto the BBS multiple
times on their birthday.
Version 1.19 (10/01/94)
■ Fixed problem reading TODAY.LCL file. This problem only occurs in v1.18.
Version 1.20 (06/17/95)
■ Fixed bug that caused lines to be duplicated in the TODAY listings.
Version 1.21 (06/20/95)
■ Fixed bug that caused TODAY files (except for TODAY.LCL) not to be
processed properly.
(Bug found by The Captain)
Version 1.22 (12/02/95)
■ Fixed crash bug that apparently was due to encryption software used on
Birthday.
■ Added support for MM00 and MM-- support in the TODAY.* files, so you can
specify something that happens every day in a given month.
■ Added support for reminder date ranges.
■ Fixed crash bug when displaying BIRTHDAY.MSG file to non-ANSI users.
┌────────────────────────────────────────────────────────────────────────────┐
│░░░░ CREDITS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
└────────────────────────────────────────────────────────────────────────────┘
Birthday is Copyright (c) 1992-1995 by Cris McRae
WWIV is Copyright (c) 1988-1995 by Wayne Bell
PKZIP is Copyright (c) 1989-1994 by PKWARE Inc.
REGKEY is Copyright (c) 1992 by Brian Pirie
IniFile Class is Copyright (c) 1993-1995 by Matt Hucke
If you have any comments or questions about this program, you can reach me
at the following network addresses:
TerraNET : 1@1
WWIVnet : 1@3809
IceNET : 1@8857
WWIVLink : 1@18857
Internet : cris@bluethun.com
If you are a sysop on one of the above WWIV networks, you may also subscribe
to my support sub. The sub name is "JAFO's Software Support". The sub type
is JAFOSUP. This sub is also gated to many other networks by other sysops.
You may also call my BBS system:
Blue Thunder BBS
USR 28.8 V.34 Dual Standards
Open 24 Hours
(818)848-4101