Mar. 26, 1989
The Biblio-File system is a citation management system designed to
be used in keeping track of literature references. Biblio-File differs
in approach from other citation management packages by providing you
with the automatic capacity to file citations by subject matter in
addition to using key words. The package is written to accommodate the
way most of us collect and create our journal files. That is, we start
with a broad topic, collect a few citations in this category and then
realize we need to subdivide the file folder into separate and more
precise headings. Biblio-File follows this same concept, and allows
easy reclassification of articles originally filed in a broader
The system is menu driven, and uses multiple windows to provide easy
and consistent entry of information. All key words, subjects, authors
and journals can be added during citation entry, or they can be added
independently using the appropriate utility function included in the
package. Each of the utility functions as well as the set up and use
of the system will be described in more detail below.
BiblioFile uses B+ tree indexes into the citation for authors,
journals, key words and subjects. This provides for unparalleled speed
of retrieval on any combination on these index fields.
NOTE: If you have been using an earlier version of BiblioFile (prior
to 2.51) you MUST run the BIBCONV program on your ".CIT" files
to be able to use them under any version after 2.51. A
description of this program and the procedure for converting is
given in Appendix A.
BiblioFile consists of the following programs:
BIB.EXE: The main executable program for the BiblioFile system.
BIB.OVR: The overlay portion of the executable program.
REVISION.HST: Revision history for BiblioFile.
CONFIG.SYS: The configuration file to increase the number of files
and buffers available for BiblioFile.
CONTROL: A user configurable file containing the colors for video
CONTROL.MNO: A control file for monochrome monitors. Copy this to
CONTROL if the VSET program (below) doesn't create a
pleasing screen appearance.
BIBUTIL.EXE: The utility program for BiblioFile that contains
modules for listing the index files, setting video
attributes, deleting duplicate citations, and deleting
entire databases. Replaces DELBIB.EXE, VSET.EXE, and
BIBCONV.EXE A conversion utility to transform the ".CIT" files of
earlier versions into the format needed by Bib251 or
Turbo Pascal and Database Toolbox are trademarks of Borland
IBM, PS/2, and Compaq are the trademarks of the respective
The windows and the screen writes used in this program are
accomplished using the QWIK and WINDOW routines of Jim LeMay (CIS
Turbo Professional is the trademark of Turbo Power Software.
MedLine and Grateful Med are copyright of the National Library of
This system is now distributed as ShareWare. The author retains
exclusive copyright to the material.
Users may freely copy and distribute this software and
documentation in its original, unmodified state. Other than reasonable
copying and shipping and handling charges, no remuneration may be
accepted by any party other than the copyright holder.
If you find BiblioFile useful after an evaluation period of one
month, please register your copy by sending $40 to the author. This
registration fee is one-time only, and allows unlimited upgrades to
future versions of the shareware BiblioFile System. Registration fees
will be used to defray development costs and to encourage further
The latest version of BiblioFile will always be available on the
Genesis Project BBS, and usually, CompuServe on the IBMAPP forum.
Please direct all inquiries and comments about BiblioFile to
no parity, 8 data bits, 1 stop bit
Dean Madar, M.D., Ph.D.
1855 Girard NE, #16
Albuquerque, NM 87106
BiblioFile and its companion programs are distributed as is without
warrantee of any kind expressed or implied. The author will not be
liable for any damage arising out of their use.
BiblioFile will run on IBM PC, PC XT, PC AT, and PS/2. BiblioFile has
also been tested on IBM close compatibles including COMPAQ, UNISYS
(Sperry), Tandy, ARC Turbo 12, and Northgate.
Minimum requirements are:
380 kilobytes of free memory;
MS DOS or PC DOS 2.0 or greater;
Two diskette drives, (although a hard disk is recommended for
A color or monochrome monitor including CGA, EGA, VGA or Hercules;
A large collection of otherwise unorganized journal citations.
Grateful Med from the National Library of Medicine (if you wish to
use the direct importation facility.
LANGUAGES AND LIMITS:
The current version of BiblioFile incarnation is written in Turbo
Pascal 5.0, with some assembly language assists. Windowing is handled
using the QWIK and WINDW units of Jim LeMay. Some units from Turbo
Power Software's Turbo Professional are also used. The data and index
files use the Turbo Pascal Database Toolbox. The final code has been
analyzed with Turbo Power's Analyst to remove uncalled procedures,
remove unused variables, and pack the .EXE file.
As in any program, there were some design assumptions and limits
made in BiblioFile. Some of the known limits follow.
Your subject tree may have a maximum level of 10. That is, 10
nested levels from parent to last child. Within any level,
though, the only limit on number of siblings is disk space.
Only 20 databases may be active at any one time.
Although the system will run on a dual floppy computer, a disk
cache program would be very useful in speeding up disk input. There is
a LOT of disk activity associated with this program. It is also
written in such a way that the index and data files are flushed with
each new addition to protect against disasters. This is most
noticeable, of course, on a floppy based system.
If you are currently using a version of BiblioFile prior to 2.51,
read Appendix A: "Converting from BiblioFile Before 2.51". You MUST
convert your data files before using this version of BiblioFile.
One of the files included in the BiblioFile distribution disk is a
CONFIG.SYS file. If you already have a CONFIG.SYS file without the
lines the lines FILES = 20 and BUFFERS = 20, include those lines in
that file. If you do not have a CONFIG.SYS file, copy the CONFIG.SYS
file provided onto your boot diskette, then reboot your computer.
Dual floppy system:
If you will be running BiblioFile from a dual floppy system, the
program disk will be in drive A and the data disk will be drive B.
Create a new formatted system disk in drive A and copy the
following files from the distribution disk to your new system disk:
Create a second formatted system disk in drive A and copy the
following files on to it:
BIBCONV.EXE (only if you will be converting data files made prior to
This second disk now contains all of the utilities needed to run
BiblioFile. These modules are used only occasionally, and need not be
present on the main program disk. Remove the distribution disk from
the B floppy drive and replace it with a formatted blank disk.
For hard disk systems:
Create a new subdirectory of your choice and copy all of the files
from the distribution disk into the subdirectory. The CONFIG.SYS file
should be filed to the root directory if you do not already have a
CONFIG.SYS file present there. See above for a more complete
explanation of the use of CONFIG.SYS.
BiblioFile consists of two main programs: BIB.EXE which contains
the database definition, data entry and search features, and
BIBUTIL.EXE which contains the less commonly used utilities to examine
the index files, change the video colors, delete databases and scan for
The main menu of the BiblioFile system consists of eight choices,
with eight more choices in the Utility menu. The selection of the
module to execute is made by the "point and shoot" method. Move the
light bar cursor to the desired activity and press to begin
execution. Alternatively, you may also press the number associated
with the menu choice, or the capitalized first letter of the menu
In most cases, data entry in the BiblioFile system is completed by
pressing the key. The cursor moves from field to field by
pressing either the key or using the up or down arrow keys.
Any field may be visited as often as required prior to pressing the
key. Any invalid data input, or attempts to skip a required
field will result in a message window appearing on the screen.
Context sensitive help is available in many fields by pressing the
key. The active function keys are displayed on the last line of
the CRT on all data entry screens. A prompt which varies from field to
field will appear on lines 19-23 of the CRT as the cursor is moved
Umlauts and grav marks:
The valid character string changes as you move between fields. For
alphanumeric fields, you can enter any key from the keyboard, as well
as characters with accent marks, umlauts, etc. To access these special
characters, press and hold the key, and type the ASCII code for
the corresponding character on the numeric keypad. For example: the
character " " is created with 129. See the ASCII table in the
back of any DOS, BASIC or other programming manual for a complete
listing of these characters and codes.
Change to the directory containing the BiblioFile system. (Probably
hard drive users only).
From the DOS command line type BIB followed by . If you wish to
use the utility functions, type BIBUTIL followed by . The
primary menu of the program will be displayed.
Making a new database:
The first step in using the BiblioFile system is creating a new
database and telling the system where the data files will be stored.
Select option 6) "Make a New Database" from the main BiblioFile menu.
A database name may be any valid DOS file name up to eight characters
in length. After entering the database name, press to advance
the curser to the data drive field. Enter the drive letter where the
data files will be stored. If the database is already in use, or if
similarly named files already exist on the data disk, a message window
will appear on the screen.
For hard disk systems the data drive may be the same drive that
contains the BiblioFile programs. For dual floppy drive systems, it
is recommended that the second floppy drive be used for data.
After pressing , BiblioFile will create fifteen files on the
data drive. These files all share a common name with different
extensions depending on the purpose of the file. For floppy based
systems it is recommended that only a single database be placed on one
floppy disk. On a hard disk system any number of databases may be
created, up to the capacity of the hard disk. There are no shared
files between various databases. Each of the data files is created in
the directory from which BiblioFile was activated. Paths are
currently not supported.
IMPORTANT: If you are using a dual floppy system, you must copy the
DBLIST file created by BiblioFile onto the second floppy you made with
BIBUTIL.EXE. Some of the utilities require this list of database
Picking a Database:
Whenever you use the BiblioFile system, you will first need to pick
a database from the list of currently active entries. Select option 1)
"Pick a Database" from the primary menu. A list of all currently
available database names will be displayed on the screen. Move the
cursor to the desired database by using either the up or down arrow
keys. Select the database by pressing . Each screen of the
system will display the name of the database in use to guard against
inadvertent corruption of datafiles.
Prior to using a particular database for the first time you must
enter the subjects under which you will be filing citations. The
concept of the BiblioFile system is that subjects are arranged in a
hierarchical, or conceptually, as a branching tree structure. Each of
the major subjects can be considered the root of a subject tree which
may have up to 9 sub-headings (branches and leaves).
The first time that subject entry is selected after creating a
database, you will be asked to enter a subject name. After typing the
subject and pressing the key this first subject will be
displayed in a window on the left border of the screen. From this
point on to add a new subject at this level of the tree, simply press