home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
HAM Radio 1
/
HamRadio.cdr
/
log
/
nn5ilog
/
nn5iedit.doc
< prev
next >
Wrap
Text File
|
1985-12-07
|
24KB
|
661 lines
NN5IEDIT
component of the
NN5I LOGGING SYSTEM
Copyright (c) 1985
Carl B. Hayes
All Rights Reserved
1
The NN5I Logging System is a simple-to-use, lightning-fast
contest logging and duping system for the IBM Personal Computer.
Written entirely in assembler language, it has the following
features:
* Records callsign, exchange, time, date, and
callsign of the local station operator for up
to 2999 QSOs per BAND/MODE combination.
* Will print the log of QSOs completed so far, while
simultaneously logging additional QSOs.
* Prints QSOs in chronological order or in order
by callsign, or as a standard dupe sheet.
* Can print QSOs as they are made (real-time printing).
* Essentially immune to loss of power to the PC. If
power is lost while logging, only the QSO currently
being entered will be lost. The others will still
be there when power is restored.
* Extremely fast DUPE checking. If the callsign is a
duplicate, the program will tell you with a flashing,
bright yellow message as soon as you type in the
callsign and hit ENTER. Usually the message will
appear before you can remove your finger from the
ENTER key.
* Gives you the option of logging a DUP or not.
* Continuously displays date, time, number of QSOs so
far, callsign of last station worked, and callsign
of the operator who is operating at the moment.
* Printed log marks each DUPE contact and lists the
date and time of the original QSO.
* Includes a post-editor for use after the contest is
over, for correcting incorrect entries made during
the contest.
FREE DEMONSTRATION VERSION
In order to allow you to try out the NN5I Logging System without
purchasing it first, the system exists in a DEMO version as well
as in the "production" version. The only difference between the
two versions is that the DEMO version runs only fifteen minutes
at a time and then automatically terminates.
2
REQUIRED EQUIPMENT
In order to run the NN5I Logging System, you need an IBM Personal
Computer or close compatible with at least 384K of RAM storage
and one 360K diskette drive. The system will run on hard disk or
on diskette and is not copy-protected. It will also run on a RAM
disk, but this has no effect upon speed and makes it vulnerable
to power loss. Also recommended is a printer, without which it
will be difficult to print out the results.
WHAT YOU GET ON THE DISK
The distribution diskette (or, in the case of the DEMO version,
the distribution diskette or the ARC or LBR file downloaded from
a bulletin board) contains several files. One of them,
NN5ILOG.DOC, is a documentation file for the logging program,
NN5ILOG.COM, the executable program that you run during the
contest. The document you are reading, NN5IEDIT.DOC, is the
documentation for NN5IEDIT.COM, which is the program you run
AFTER the contest to make any corrections in the log. Also
included are several BAT files for use in hard disk systems for
rapid BAND/MODE switching.
HOW (BRIEFLY) THE PROGRAM WORKS
When you execute the NN5I Log Editing Program, the first thing it
does is format in RAM (not RAMdisk) a file (requiring 240K bytes
of RAM) that will contain the logged QSOs. Then it looks on the
default drive (diskette drive or hard drive) for a file
NN5ILOG.LOG. If it finds one, it reads from it any QSOs logged
in previous executions of the NN5I Logging Program. If no such
file is present, the program produces an error message and
terminates, because the file can be created only by the Logging
Program; the Log Editing Program cannot create it.
The program will produce a logo on your screen and spend several
seconds formatting its internal tables in memory. Then it will
read the QSOs from the file and make itself ready for editing.
3
THE EDITOR SCREEN
The NN5I Log Editing Program displays, on the left half of the
screen, information pertaining to the log file as a whole. On
the right side of the screen, it displays information pertaining
to an individual QSO. Also on the right side of the screen is a
set of instructions on the use of the Special Function Keys of
the IBM PC keyboard.
The information on the left side of the screen is:
CONTEST NAME This is printed as part of the
heading whenever you do any printing
from the NN5ILOG program. You can
change it to whatever you like, up
to 15 characters.
CALLSIGN This is also printed as part of the
heading by NN5ILOG. You can change
it to whatever you like, up to 15
characters.
ENTRANT'S NAME Also part of NN5ILOG's printed page
heading. Change it to anything you
like, up to 20 characters.
BAND Part of NN5ILOG's printed heading,
this is also displayed continuously
whenever NN5ILOG is running. Change
it to anything, up to 3 characters.
MODE Part of NN5ILOG's printed heading,
this is also displayed continuously
whenever NN5ILOG is running. Change
it to anything, up to 3 characters.
OPERATOR Displayed continuously whenever
NN5ILOG is running, this is recorded
(and printed) with each QSO in order
to indicate, for multi-operator
contest stations, which operator
made each logged QSO. Change it to
anything, up to 6 characters.
TOTAL RECORDS The total size of the NN5ILOG.LOG
file in 80-byte records. This will
always be 3000, except in custom
versions of the NN5I Logging System.
You cannot change this at all.
FREE RECORDS This indicates the number of records
available for additional QSOs, which
take one record each. You will see
this change whenever you delete a
QSO from the log.
4
TOTAL QSOs Indicates the total number of QSOs,
including DUPes, currently in the
file. This plus the number of free
records, plus one for the master
record, should equal the total
number of records in the file. You
will see this change whenever you
delete a QSO from the log.
FIRST CALLSIGN This is the first callsign in the
log, without regard to the time
and date of the QSO. In comparing
callsigns, 0 is considered smaller
than 9; and the digit used is the
last digit in the callsign, not
including any suffixes separated by
a slash ("/"). For example, the
digit in P42J/W6 would be the "2".
If the digits are the same, the
following letters (again without
including suffixes separated by "/")
are identical, the characters in
front are compared. Only if these
are also identical are the two
callsigns considered identical.
You may see this change if you
change the callsign for a QSO in
the log.
LAST CALLSIGN The last callsign in the log, in
order by callsign. You may see this
change if you change the callsign
for a QSO in the log.
FIRST DATE/TIME This is the first date and time for
any QSO in the log (NOT the date
and time of the FIRST CALLSIGN).
You may see this change if you
change the date or time of a QSO
in the log.
LAST DATE/TIME The last date and time for any QSO
in the log. You may see this change
if you change the date or time of
a QSO in the log.
5
The information on the right side of the screen is:
CALLSIGN The callsign of a station you
worked and logged in the contest.
You can change this to anything
you like, up to 15 characters, and
the log will be completely
re-DUPed immediately and auto-
matically. This may take up to
three seconds.
DATE The date of the QSO. You can
change this to anything you like,
up to 8 characters; but if you
depart from the MM/DD/YY format,
the NN5ILOG program may be unable
to print QSOs correctly in order
by date and time.
TIME The time of the QSO. You can
change this to anything you like,
up to 8 characters; but if you
depart from the HH:MM:SS format,
the NN5ILOG program may be unable
to print QSOs correctly in order
by date and time.
EXCHANGE The received contest exchange. You
may change this to anything you
like, up to 20 characters.
OPERATOR An identifier (usually his own call
sign) for the operator who was
operating your station for this QSO.
You can change this to anything you
like, up to 6 characters.
NUMBER A sequential QSO number. If you
specified, when creating the log
originally with NN5ILOG, that the
contest used serial numbers, this
will have been assigned in sequence
by NN5ILOG, starting with a number
you specified; and it will be printed
along with the other information for
the QSO whenever NN5ILOG prints the
QSOs. If you specified that the
contest DIDN'T use serial numbers,
NN5ILOG will have recorded it as
zero. In either case, you can change
it to any number you like, from zero
to 9999; but it will be meaningless
(not printed) if you specified that
serial numbers were not required.
6
If the contact is a DUPe, also displayed on the right side of the
screen will be the legend, DUPE, followed by the date and time of
the earlier contact bearing an identical callsign. If you change
the date, time, or callsign for a QSO, the entire file is reDUPed
immediately and automatically; this may take up to three seconds.
HOW TO MODIFY INFORMATION ON THE LEFT SIDE OF THE SCREEN
In order to modify information on the left side of the screen,
first strike the F7 key; this will move the cursor to the first
character of the CONTEST NAME. If you want to modify that field,
simply overtype the information displayed; your changes will
appear in contrasting color. Striking ENTER will record any
changes you made in the log file on disk, and move the cursor
down to the next line. Each time you strike ENTER, the cursor
will move down to the next line, recycling from the bottom line
that you can change (OPERATOR) to the top line (CONTEST NAME).
On each line, just overtype anything you want to change.
HOW TO MODIFY INFORMATION ON THE RIGHT SIDE OF THE SCREEN
In order to modify information on the right side of the screen,
first strike the F8 key; this will move the cursor to the first
character of the CALLSIGN. Simply overtype any information you
wish to change, moving from line by striking the ENTER key just
as you did on the left side of the screen.
TERMINATING THE PROGRAM
To terminate the program, simply strike the ESCape key (for
compatibility with NN5ILOG, you may, if you wish, hold down the
CTRL key while striking the ESCape key, and it will still work).
This will return you to DOS. You can then change diskettes for
another BAND/MODE combination and re-enter the NN5IEDIT or
NN5ILOG command.
7
KEYBOARD REFERENCE
The following is a complete summary of the use of the keys on the
IBM PC keyboard. Please note that it is NEVER necessary to use
the SHIFT keys, just as in the NN5ILOG program.
LEFT and Right arrow keys: There are two left-arrow keys
and one right-arrow key on the
keyboard. These can be used
as backspace and forward-space
while you are typing.
ESCape Ends the program.
F1 When the cursor is on the right
side of the screen, steps to the
previous QSO in DATE/TIME order,
unless the QSO displayed is the
earliest QSO in the log. When
the cursor is on the left side
of the screen, does nothing.
F2 When the cursor is on the right
side of the screen, steps to the
NEXT QSO in DATE/TIME order,
unless the QSO displayed is the
latest QSO in the log. When the
cursor is on the left side of
the screen, does nothing.
F3 When the cursor is on the right
side of the screen, steps to the
previous QSO in callsign order,
unless the QSO displayed is
already the first in that order.
When the cursor is on the left
side, does nothing.
F4 When the cursor is on the right
side of the screen, steps to the
NEXT QSO in callsign order,
unless the QSO displayed is
already the last in that order.
When the cursor is on the left
side, does nothing.
8
KEYBOARD REFERENCE continued
F5 When the cursor is on the right
side of the screen, deletes the
currently-displayed QSO from the
log, with utter finality. Also
moves the cursor to the left
side of the screen. When the
cursor is on the left side of
the screen, does nothing. This
assures that you cannot, by
holding down F5 too long,
inadvertently delete more than
one QSO.
F6 ReDUPes the entire log. This
may take up to three seconds.
F7 Moves the cursor to the left
side of the screen, and places
it at the first character in
the CONTEST NAME.
F8 Moves the cursor to the right
side of the screen, and places
it at the first character in
the CALLSIGN.
9
OBTAINING A COPY OF THE NN5I LOGGING SYSTEM
The DEMO version of the NN5I Logging System, which runs only for
fifteen minutes at a time, is available free on the NN5I BBS and
possibly on other BBSs.
The NN5I BBS is active at
(214) 960-2730
300 or 1200 baud
The DEMO version can be obtained for $5.00 by sending a diskette
and self-addressed, stamped mailer to:
Carl B. Hayes
Box 5988
Richardson, TX 75083
The best way to send a 5-1/4" diskette mailer is to enclose it in
an 8" diskette mailer, which can usually be bought at the same
places that sell 5-1/4" mailers. Simply enclose your diskette and
the new, stamped and addressed 5-1/4" mailer, along with your
check or cash, in the larger mailer, along with a NOTE that says
WHAT YOU ARE ORDERING!
The PRODUCTION version of the NN5I Logging System is available
for $75.00. Please order it from the above address; it is not
necessary to include a mailer when ordering the PRODUCTION
version. You should include a NOTE that says you are ordering
the PRODUCTION version of the NN5I Logging System.
Although extreme effort has been expended in the creation and
debugging of the NN5I Logging System, no guarantee or warranty is
given. Prospective purchasers are urged to use the DEMO version
to determine whether this program is suited to their needs, and
to assume all risks. Payment for either the DEMO version or for
the PRODUCTION version is not refundable under any circumstances;
this is basically a one-man hobby operation.
10