Category : Databases and related files
Archive   : MAL1.ZIP
Filename : MAL.HLP

 
Output of file : MAL.HLP contained in archive : MAL1.ZIP
*I
General Help¬Syntax KeysMEdit KeysìUpdate Master FileADD!UPDATEÉ"DELETEà' SEARCHy,
SEARCH MASTER FILE™0 LIST MASTER FILEÎ4 SCREEN LISTÐ6
PRINTER LIST\9RECREATE INDEX FILESû;OS SHELLÖ=MAL VERSION INFO??QUIT MAL¬@MAL INDICESBTITLEŽDAUTHORFPUBLICATIONšGVOLUMN NUMBER)IPAGE NUMBER{JDATE OF PUBLICATION“KISBN¯LKEYWORDSÈMEXTRACTDONOTESôPPRINTER SELECTIONªRPRINTER SELECTIONÿÿÿÿ

MAL help file.

MAL 1.0 - Magazine Article Library Feb. 1990 - by Paul E. Castle II

*B 1,General Help


MAL 1.0 - Magazine Article Library

MAL was written by Paul E. Castle II

Syntax: MAL [-switches]

-b = BIOS screen writing
-c = CGA snow elimination
-h = Display MAL syntax
-i = Introductory screen inactive
-m = Monochrome attributes forced
-p = Path to MAL files
-x = Exploding windows active

*P

MAL is a menu driven, magazine article tracking system.
It is written in Turbo C v2.0 and uses Mike Smedley's
extended C library CXL v5.0.
MAL is started using the above ^SYNTAX^. From that
point on, you simply make menu selections and enter
data.
Some of MAL's features are controled by keyboard
key combinations and function ^KEYS^. These keys
provide scrolling, screen print, processing, help, and
many other functions.
All data entry screens recognize a wide range of
^EDIT KEYS^ that make data entry quick and easy.
At all times, HELP is just a keystroke away. Just
press "F1" and a help window will pop up.

*P

If you have any questions, comments, complaints, or
suggestions, I can be reached through:

CompuServ: 76530,305
Dream Castle BBS - (619) 436-2617

or
write to

Paul E. Castle II
155 Rosebay Dr. #6
Encinitas, Ca. 92024


Press [Esc] to exit HELP
*E

*B 2,Syntax

MAL - Magazine Article Library

Syntax: MAL [-switches]

-b = BIOS screen writing
-c = CGA snow elimination
-h = Display MAL syntax
-i = Introductory screen inactive
-m = Monochrome attributes forced
-p = Path to MAL files
-x = Exploding windows active

At start-up, MAL can be configured through the use of
command line switches.

*P

If you wish to run MAL from a remote terminal, the
"-b" switch will force MAL to use BIOS calls for I/O.
Without this switch, I/O is performed directly to the
video memory.
The "-c" switch can be used if you experience "snow"
during MAL direct memory I/O. This switch activates
MAL snow removal.
The "-i" switch, not covered in the MAL documentation,
prevents the introductory screen from being displayed.
MAL defaults to color output. You can force MAL to
use monochrome attributes by using the "-m" switch.
Using the "-x" switch starts MAL with exploding windows
active. Once inside MAL, you can toggle exploding
windows OFF and ON using the [F10] key.

*P

MAL can be run from any directory. However, if MAL
is run from a directory other than the one that holds
its files, you must use the "-p" switch to indicate
the location of its files.
If you do not run MAL in the same directory with its
files and you do not want to use the "-p" switch, you
can use the environment variable "MAL". Just use the
DOS SET command to set MAL equal to the path to your
files. For example:

SET MAL=C:\MAL

Switches can be run togeather (ie: MAL -mbx) or used
singly (ie: MAL -m -b -x). Either the "-" or "/" can

*P



be used as the "switch character". If switches are run
togeather, the "-p" switch MUST be the last in the list.



See also: ^GENERAL HELP^



Press [Esc] to exit HELP
*E

*B 3,Keys

Key Combinations and Function Keys

Certain key combinations and function keys perform
specific functions within MAL, as mentioned under the
^General Help^.
At any time, you can activate a HELP screen, specific
to where you are, by pressing [F1].
The [Esc] key allows you to exit the screen/function
you are currently in. Pressing [Esc] at the Main Menu
will exit MAL. Using the [Esc] key to exit MAL does
NOT cause a problem. MAL will go through its normal
exit routine and all updates and deletes will be applied.
You can, also, use the [Alt-X] key combination to exit
MAL from anywhere. You will be asked to confirm that

*P

you wish to exit MAL. If you respond "Y", all updates
and deletes will be applied and the session will end.
If you reply "N", you will be left at the same point
that you pressed [Alt-X].
The [F2] function key is used to complete processing.
This is true in the Search Criteria, Add, Update, and
Delete windows. When Updating or Deleting records, you
will be prompted to confirm the requested action prior
to the record being processed. When selecting search
criteria, [Ctrl-Enter] or [Enter] while in the last field
will start the search process.
Pressing the [F6] function key will dump the current
screen contents to the printer. Be sure the printer is
on and ready. I do not trap this error.

*P

[F10] can be used to toggle "exploding windows", as
mentioned in the ^Syntax^ help. Exploding windows are
a nice visual effect that can eventually drive you to
insanity. One note, a window will close in the same
manner it was opened no matter what the toggle at the
time.
Finally, the [PgUp] and [PgDn] keys are used to
scroll through multiple screens of information.


Press [Esc] to exit HELP
*E

*B 4,Edit Keys


Cursor Movement
---------------

Arrow keys - cursor movement
Ctrl-LeftArrow - word left
Ctrl-RightArrow - word right
Home - beginning of field
End - end of line/field
Ctrl-Home - beginning of first field
Ctrl-End - end of last field
Tab - next field
Shift-Tab - previous field
*P


Inserting and Deleting
----------------------

Ins - toggle insert mode
Del - delete character at cursor
BackSpace - delete character left
Ctrl-BackSpace - delete word left
Ctrl-T - delete word right
Ctrl-U - delete to end of field
Ctrl-Y - delete to end of form

See also: ^GENERAL HELP^ ^SYNTAX^ ^KEYS^

Press [Esc] to exit HELP
*E

*B 5,Update Master File

**** UPDATE MASTER FILE ****

The UPDATE function allows you to modify the master
file. This includes the initial entry of master file
records, deletion of unwanted or unneeded records,
updating of individual master records, and a search
feature that allows you to specify search criteria and
then page through matching entries.


See also: ^ADD^ ^UPDATE^ ^DELETE^ ^SEARCH^
^GENERAL HELP^

Press [Esc] to exit HELP
*E

*B 6,ADD



**** ADD ****

The ADD feature is used to make the initial entry of
master file records. After selecting ADD, you will be
presented with the MAL input screen. Fill in the data
fields and press [F2] to process the screen and add
the record to the master file.

See also: ^GENERAL HELP^ ^UPDATE MASTER FILE^

Press [Esc] to exit HELP
*E

*B 7,UPDATE

**** UPDATE ****

The update feature is used to make changes to existing
master file records. After selecting UPDATE, you will
be presented with the MAL search criteria screen. Enter
one or more of the key values, press [F2], and the
master file will be searched for matching entries. If
matching entries are found, you will then be given a
screen, like the one used to ADD records, with the data
from the matching master records displayed. You can
page through these records, make changes, and use the
[F2] key to update the record. Changes to the master
record take effect immediately. If an index field is
*P

modified, the associated index file record will not be
updated until the MAL session is ended. This can
produce some strange results during the current session.
For example, you an article by Stephen King. You then
realize you meant Robert Block, enter UPDATE, change
King to Block, and process. If you search on Robert
Block, there will not be a match. The index file
still indicates Stephen King as the author. Update
index fields with care!

See also: ^GENERAL HELP^ ^UPDATE MASTER FILE^ ^SEARCH^

Press [Esc] to exit HELP
*E

*B 8,DELETE

**** DELETE ****

The delete feature is used to remove master file
records. After selecting DELETE, you will be presented
with the MAL search criteria screen. Enter one or more
of the key values, press [F2], and the master file will
be searched for matching entries. If matching entries
are found, you will then be given a screen, like the
one used to ADD records, with data from the matching
master records displayed. You can page through these
records, locate the one(s) you wish to delete, and press
the [F2] key to delete the record. Unlike the Update
feature, which updates immediately, deleted records are
not removed until the end of the current MAL session.
*P

At that time, the deleted records are removed and the
index files updated. If you delete a record and then
decide you made a mistake, simply select UPDATE, retrieve
the mistakenly deleted record, and use [F2] to process.
This will reset the delete flag and "re-add" the record.

See also: ^GENERAL HELP^ ^UPDATE MASTER FILE^ ^SEARCH^

Press [Esc] to exit HELP
*E

*B 9,SEARCH

**** SEARCH ****

The search feature is used to locate master file
records that match certain search criteria. MAL has
four different index, or search, fields including two
that allow multiple entries. These fields are Title,
Author (two fields), Publication or Magazine (both are
used), and Keywords (nine entries). Once search has
been selected, you are presented with a search criteria
screen. You may enter one or more of these fields and
then press [F2] to process. The master file is then
searched for matching records and the data is displayed
on a screen like the data entry screen. You may page
through the entries using the [PgUp] and [PgDn] ^Keys^.
*P


This feature exists as a Main Menu selection, an
UPDATE MASTER FILE selection, and as a part of the
Update and Delete features.


See also: ^GENERAL HELP^ ^UPDATE MASTER FILE^
^MAL INDICES^

Press [Esc] to exit HELP
*E

*B 10,SEARCH MASTER FILE

**** SEARCH MASTER FILE ****

The search feature is used to locate master file
records that match certain search criteria. MAL has
four different index, or search, fields including two
that allow multiple entries. These fields are Title,
Author (two fields), Publication or Magazine (both are
used), and Keywords (nine entries). Once search has
been selected, you are presented with a search criteria
screen. You may enter one or more of these fields and
then press [F2] to process. The master file is then
searched for matching records and the data is displayed
on a screen like the data entry screen. You may page
through the entries using the [PgUp] and [PgDn] ^Keys^.
*P


This feature exists as a Main Menu selection, an
UPDATE MASTER FILE selection, and as a part of the
Update and Delete features.


See also: ^ADD^ ^UPDATE^ ^DELETE^ ^SEARCH^
^GENERAL HELP^ ^MAL INDICES^

Press [Esc] to exit HELP
*E

*B 11,LIST MASTER FILE

**** LIST MASTER FILE ****

The list function is used to list the master file
records in sorted order. You can chose one of the
four different index fields to sort on. These are:
Title, Author, Publication or Magazine, and Keywords.
The sorted list can then be viewed on the screen or
sent to the printer.


See also: ^MAL INDICES^ ^GENERAL HELP^
^PRINTER SELECTION^

Press [Esc] to exit HELP
*E

*B 12,SCREEN LIST

**** MASTER FILE SCREEN LIST ****

Selecting the SCREEN option, of the list function,
allows you to select your sort criteria and then view
the master file on your screen. The master file records
are presented, in sorted order, in the same format as
the ADD screen. You can scroll through the records
using the [PgUp] and [PgDn] keys. Only records that
contain an entry for the selected sort field will be
displayed.

See also: ^MAL INDICES^ ^GENERAL HELP^
^LIST MASTER FILE^ ^PRINTER SELECTION^

Press [Esc] to exit HELP
*E

*B 13,PRINTER LIST

**** MASTER FILE PRINTED LIST ****

Selecting the PRINTER option, of the list function,
allows you to select your sort criteria and then have
the master file list directed to your printer. The
master file recoreds are presented, in sorted order,
in the same format as the ADD screen. Only records
containing an entry for the selected sort field will
be displayed. Be sure your printer is on and ready.
I do not trap this error.

See also: ^MAL INDICES^ ^GENERAL HELP^
^LIST MASTER FILE^ ^PRINTER SELECTION^

Press [Esc] to exit HELP
*E

*B 14,RECREATE INDEX FILES


**** RECREATE INDEX FILES ****

The recreate feature is used to recreate the MAL
index files in case of disaster. Accidents do tend
to happen. And, there may come a time that one or
more of the four index files may be lost or damaged.
If this ever occurs, selecting this option will
rebuild the index files.

See also: ^MAL INDICES^ ^GENERAL HELP^

Press [Esc] to exit HELP
*E

*B 15,OS SHELL


**** OS SHELL ****

The OS shell feature allows you to drop to DOS
while still in MAL. You can then perform any DOS
functions and then return to MAL by typing "EXIT"
at the DOS prompt.

See also: ^GENERAL HELP^

Press [Esc] to exit HELP
*E

*B 16,MAL VERSION INFO


**** MAL VERSION INFO ****

The MAL version feature allows you see information
concerning this version of MAL. It will tell you the
version number and the software and hardware used to
create this release of MAL.

See also: ^GENERAL HELP^

Press [Esc] to exit HELP
*E

*B 17,QUIT MAL


**** QUIT MAL ****

Selecting QUIT will exit MAL. At this time, all
records with the delete flag set will be removed and
the index files will be updated to show key field
updates and deleted entries.

See also: ^GENERAL HELP^ ^UPDATE^ ^DELETE^

Press [Esc] to exit HELP
*E

*B 18,MAL INDICES

**** MAL'S INDEX FIELDS ****

MAL has four fields that are used for indexing and
searching the master file. These fields are: Title,
Author, Publication or Magazine, and Keywords. While
examples of the suggested use of each field are given
in their individule help screen, you are free to use
these fields in any manner you wish. All fields are
alphanumeric and case is ignored for the search routine.

See also: ^GENERAL HELP^ ^SEARCH MASTER FILE^
^UPDATE^ ^DELETE^ ^TITLE^
^AUTHOR^ ^PUBLICATION^ ^KEYWORDS^
*E

*B 19,TITLE


**** TITLE ****

Fifty character alphanumeric index field.

Title can be anything you desire. It is meant to be
used as a unique identifier representing the article
to be tracked.

Examples:
Sort Routines in C
Black Holes and Time Travel

See also: ^SEARCH MASTER FILE^ ^MAL INDICES^
*E

*B 20,AUTHOR



**** AUTHOR ****

Two, thirty character alphanumeric index fields.

Author can be anything you desire. It is meant to be
used to indicate the author of the magazine article
to be tracked.

Examples:
Stephen Hawkings
Bobby Fischer

See also: ^SEARCH MASTER FILE^ ^MAL INDICES^
*E

*B 21,PUBLICATION



**** PUBLICATION ****

Fifty character alphanumeric index field.

Publication can be anything you desire. It is meant
to be used to indicate the magazine in which the
article to be tracked was published.

Examples:
PC World
Psychology Today

See also: ^SEARCH MASTER FILE^ ^MAL INDICES^
*E

*B 22,VOLUMN NUMBER




**** VOLUMN NUMBER ****

Ten character alphnumeric field.

Volumn number can be anything you desire. It is meant
to be used to indicate the issue number of the magazine
containing the article to be tracked.

Example: 11/123 - Issue 11 Number 123
*E

*B 23,PAGE NUMBER




**** PAGE NUMBER ****

Four character numeric field.

Page number can be anything you desire. It is meant
to be used to indicate the page on which the article
starts.

Example: 120
*E

*B 24,DATE OF PUBLICATION



**** DATE OF PUBLICATION ****

Eight character alphanumeric field.

Date of publication can be anything you desire. It is
meant to be used to indicate the date the magazine was
published.

Example: 01/01/90
*E

*B 25,ISBN




**** ISBN ****

Ten character alphanumeric field.

ISBN can be anything you desire. It is meant to
be used to indicate the International Standard Book
Number of the magazine.

Example: 0672226316
*E

*B 26,KEYWORDS


**** KEYWORDS ****

Nine, fifteen character alphanumeric index fields.

Keywords can be anything you desire. It is meant to be
used to specify single words that relate to the article.

Examples: Chess Nimzovitch
Knights Blockade

See also: ^SEARCH MASTER FILE^ ^MAL INDICES^
*E

*B 27,EXTRACT


**** EXTRACT ****

Four, Fifty-Five character alphanumeric fields.

Extract can be anything you desire. It is meant to
be used to provide a short summary of the article.

Example:
An exploration of theory, relating to the
possibility of time travel, of Black Holes.
Also, explores Novas, Quasars, Pulsars, and
Worm Holes.
*E

*B 28,NOTES


**** NOTES ****

Two, fifty-five character alphanumeric fields.

The two notes fields can be used in any way you see
fit. They can be used to give additional information
about the article, magazine, authors, etc.

Example:
Both authors are previous winners of Nobel
prizes for physics. This is the third
installment of four.
*E

*B 29,PRINTER SELECTION


**** PRINTER SELECTION ****

This function allows you to select one of the supported
printer types for the LIST function to use. Currently
supported printers are: EPSON compatiable, HP compatiable,
and GENERIC for all other types. More may be added as
time and need dictate.

See also: ^LIST MASTER FILE^

Press [Esc] to exit HELP
*E

END OF MAL HELP FILE


  3 Responses to “Category : Databases and related files
Archive   : MAL1.ZIP
Filename : MAL.HLP

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: http://www.os2museum.com/wp/mtswslnk/