home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Media Share 9
/
MEDIASHARE_09.ISO
/
dbase
/
troop.zip
/
SCOUT30.DOC
< prev
next >
Wrap
Text File
|
1989-04-19
|
12KB
|
265 lines
SCOUT Ver. 3.0
Copyright (c) 1985,1986,1989 by Roy M. Bartee II
02/20/89
DOCUMENTATION
SCOUT was written for Troop 273, Littleton, Colorado. This is
shareware for any troop that can use it. I do not charge for the
program however the program is not public domain and I reserve all
rights to the program and it's "look and feel". If you find the program
useful please send me a council or district patch. If you can't
download, I will return formatted disks sent to me, 5 1/4 or 3 1/2
inch, or I can mail a new disk for $5 or $10 respectively. The source
code is likewise available.
Roy M. Bartee II
6287 So. Coventry Lane West
Littleton, Colorado 80123
(303)795-2205 (voice)
GEnie mail R.BARTEE2
SCOUT.BAS was originally written on a TIPC in MS-BASIC and last
revised in 1986. This new version has been rewritten in Turbo Basic,
Ver 1.1, compiled on a 386 clone and should run without revision on any
IBM compatible. SCOUT.EXE chains two subprograms which must be on the
same disk. The compiled version is dramatically faster than the
interpreted basic. Large ramdisks or memory resident programs may
reduce available memory and cause out of memory or string space errors,
check these first if you have problems.
The archive file or disk that you have should contain five files:
SCOUT30.DOC SCOUTCFG.EXE
SCOUT.EXE SCOUT.000 SCOUT.001
The three SCOUT.* files must be on the same disk. SCOUTCFG.EXE
allows you to set Troop number (5 digits) and drive designators, see
below.
FILES
The following data files are created:
SCOUT.CFG Configuration file.
ROSTER.DAT Name, address,phone,birthday,status,etc.
LEADPOS.DAT Leadership positions held by all Scouts
ADVANCE.DAT Advancement records of all Scouts
SKILLAWD.DAT Record of all skill awards earned
MERITBAD.DAT Record of all merit badges earned
SPECAWRD.DAT Record of special awards(honor unit,etc.)
CONWORK.DAT Record of all Scouts' conservation hours
CIVWORK.DAT Record of all Scouts' civic service hours
plus a separate file (CAMP1.DAT, CAMP2.DAT, etc.) is created for each
scout for his camping record.
The program allows faster access to data since ROSTER.DAT and other
files are being accessed simultaneously but has the following
limitations. Most floppy disk operating systems are limited to a
maximum of 112 files in the root directory per disk. This can be
easily solved by creating a subdirectory on the disk and running the
program from there. There is no limit to the number of files in a
subdirectory.
-2-
On a dual drive system the CAMP#.DAT files can be on a second disk
in drive B:. SCOUTCFG allows you to specify which drive the CAMP and
WORK files are located on if different from the SCOUT program.
Scouts' records can be marked as DROPPED, however their records are
not deleted but saved for future reference. I have a PURGE program
that completely deletes a scout's record but I recommend not using it.
If there are any "edited" records with a blank date, the purge program
can cause later file read errors. If you think you need it, contact me.
The program will run "as is" on a hard disk system and will have
unlimited files if in a subdirectory.
Note: Our Troop uses a "Troop work hours" system which requires each
Scout to accumulate a certain number of work hours on Troop money
making projects to be eligible for camp outs and other activities.
This part of the program is left intact. The above discussion
regarding camping data files is the same for "Troop work hours" data
files should you choose to utilize this aspect of the program.
MENU
The program is menu driven. PLEASE READ THE PROMPTS! In most
situations a blank entry (ENTER KEY or RETURN KEY) with no data will
return you to a menu. The ENTER or RETURN KEY is used after all
entries.
A recurring request has been to be able to edit other DAT files
besides the ROSTER.DAT to correct entry errors. The records EDIT
feature, though not as elegant as the roster editing, fills that need.
The CAMPING and WORK hours including Conservation and Civic Service are
NOT included in the edit routine. If you find an error in a scout's
hours the easiest thing to do is make a separate "CORRECTION" entry. (
You will need to use a different date from the original error.) A
negative number for time or days may be entered.
You can "delete" a wrong award, leadership position, etc. by
hitting ENTER at the date prompt. Later if you try to enter awards in
the SCOUT program it will tell you it is already entered. At that time
go back to EDIT and enter the correct dates for the awards or merit
badges. You will see the award listed with a blank date. Edit that
record # with the now correct date.
From the main menu in SCOUT simply hitting ENTER(return) at the
prompt will run EDIT for you and you can jump back and forth between
the two. ENTER(return) at the prompt in EDIT will exit to DOS.
The main menu is divided into right and left halves. The left half
is data entry routines, the right half is for the display and/or
printing of records. The data entry routines are self explanatory
except:
1. ROSTER: When editing a roster entry hitting ENTER will move you
through the form saving those entries not changed. You may mix upper
and lower case BUT when calling up individual records you must follow
the same convention. (For simplicity I have done our records all in
upper case).
-3-
"ADULT,DROPPED and FATHER" are used as markers when entered as the
the FIRST word in the "DATA" section. ADULT is for registered
Scouters, FATHER allows listing a father separately in the roster for
keeping track of work hours. DROPPED is obvious. These markers affect
certain recovery routines by selective inclusion or exclusion. The
records of DROPPED scouts are left intact but not printed unless that
name is specifically asked for. There is a specific record for phone #,
a second or work phone can be entered on the DATA line. The Roster
print out prints the first 11 characters of this DATA line.
You can designate such things for the Roster as PL, SPL, JASM,
ADULT SM, ADULT ASM. With ADULTs I have been putting a work phone number
in the MOTHER area as "W nnn-nnnn".
2. CAMPING: The place, description and date are entered, then each
scout. I enter date eg."1/23-24/86" but you can just enter first day if
you wish. A separate program is available for the Denver area which
includes the Council camper patch and segments.
4. WORK HOURS: Conservation and civic service hours are entered
here. A single activity is entered and then each scout and his hours is
entered. Our "Troop work hours" is also accessed here.
6. MERIT BADGES: This has been changed. The 14 required (or
options) for Eagle are listed on the left. Other badges on the right.
If the right side exceeds 20 badges, additional badges overwrite
starting at the top right.
8. SPECIAL AWARDS, ACTIVITIES: This is for entering other awards
and activities on a scouts record.
The record recovery routines are also self explanatory and I would
recommend entering data on a couple of scouts then running all the
RECORDS programs to see what they do. The revised program is set to
run on Epson or IBM printers. All brand specific initialization strings
have been removed and only common printer commands are now present.
Your parallel printer must be available via LPT1:.
9. INDIVIDUAL RECORDS: In addition to single complete scout
records this routine will print mailing labels (3 1/2 x 15/16
continuous), rosters, the complete records on all the scouts at once
(we do this before each Court of Honor to see what has been earned
since the last Court), plus allow you to view data on the screen
without printing it, though you have to be fast with the pause or hold
key on scouts with large records.
The Roster, Advancement on All, and Skill awards on scouts below
1st class print in compressed mode and utilize an entire 8 1/2 inch
wide paper. All other printouts have a 1 inch left margin for punching
for a three ring binder. The rest of the record routines allow you to
view and/or print out selected aspects of a scouts record.
11. INDIVIDUAL ADVANCEMENT: You can also get a chronological age
list or a total troop advancement listing. Good for allowing the
Scoutmaster to see who is progressing and who is not.
13. INDIVIDUAL SKILL AWARDS: A listing of all scouts under first
class and their skill awards is also available.
-4-
* * * *
* Notes on specific nuances (idiosyncrasies): Some prompts from the
program which end with a question mark are asking you to respond with
an uppercase "Y" or "N" (Yes or No). Other prompts will ask for another
letter to be input such as "Do you want apples (A) or oranges (O)?".
You would then enter the appropriate response either "A" or "O".
When editing the ROSTER (routine 1) the "NAME?" prompt is asking
for the last name. It will accept three letters and return with the
first person whose last name starts with those three letters and a "?"
prompt. You respond with a "Y" or "N". If "N" then the program
searches for the next name with the same first three letters. LETTER
CASE IS SIGNIFICANT, if you use upper and lower case entering new names
into the roster, you must always use upper and lower case. All other
routines that prompt with "NAME?" require you to enter the ENTIRE LAST
name. The ROSTER.DAT file is then searched for that name and you will
then be prompted with the full name and a "?". If this is not the
person you want type "N" and the next person with the same last name
will prompt. If a name is not found in the roster file the prompt will
return to "NAME?" again. The ENTER key or RETURN key alone at a NAME
or data entry prompt will return you to a main menu.
The program reads the internal "DATE$" (date string) resident in
DOS. This date is put on some records when they are printed. Be sure
to execute the DATE command when you boot your system. To configure
the program run SCOUTCFG otherwise run SCOUT.