QLIB.TXT :                             Copyright 1993 QUART, Inc.

Users' Manual for QLIB.EXE - QCDRUN (TM) CD-ROM Database Editor
             
        QCDRUN CD-ROM Library System for Microsoft Windows is a 
database management utility and automatic CD-ROM launcher for the 
Windows Multimedia and CD-ROM user with an extensive library of
CD-ROMs. QCDRUN gives you true click-and-load convenience. 

        QLIB.EXE creates and edits the master database files that
allow QCD and the other programs of the QCDRUN system to identify 
and run CD-ROMs from catalogued information. QLIB can run as a
standalone Windows application, and will be called by QCD if it 
cannot identify the CD-ROM currently in the drive. 

        All QCDRUN programs automatically locate the main Windows 
working directory on your hard drive and search there for .PIF and 
.INI files and major Windows operational files. Certain operating 
options in QCDRUN rely on the availability of the Windows utilities 
WINFILE (File Manager), WRITE (for on-screen filling out and printing 
of the registration form), and NOTEPAD (to read documentation), in 
your main Windows working directory. These functions will not operate 
correctly if these utilities are absent or located elsewhere. 

        QLIB accepts data base information from direct keyboard 
entry or from selection menus and saves this in two database files - 
QCD.INI in your Windows directory, and CDLIST.INI in the QCDRUN 
working directory. QLIB can shell at your request to QDOC to read 
documentation and write registration forms.       

        QLIB : Initial Operation:

a.      From Windows Program Manager menu - select File Run

b.      Enter the Command Line  h:\dir\qlib, where h is your working 
hard drive; and dir is the working directory containing the QCDRUN
system. (Default path is c:\qcd.) If you have installed the QCDRUN 
working directory into your DOS path, you need only enter QLIB at 
the File Run command line.

c.       Press ENTER (from the keyboard) or click OK (left mouse button)


        QLIB : General Instructions and Operations

Please be aware:        

        At any prompt in QLIB - Clicking "Cancel" unconditionally  
terminates the program.

        To accept defaults (when shown in prompts) - press "ENTER" 
or click "OK"

        To change from defaults - enter from the keyboard, then 
press "ENTER" or click "OK"

        All mouse operations in QLIB use the (standard) left mouse 
button.

        Any timed Message or Display window (without an "OK" button) 
can be closed, allowing the program to continue before the set time
(which is a maximum of 5 seconds), by placing the cursor in the window
and clicking the left mouse button. 



Step by step:

PRELIMINARY TESTING:

a.      QLIB opens with a copyright notice that clears in 5 seconds.

b.      QLIB tests for installation in WIN.INI. If you try to simply
copy the QCDRUN distribution files to your hard drive and run QLIB 
without completing the QINSTALL procedure, QCD and QLIB will not 
find the appropriate entries in WIN.INI or the QCD.INI file, and 
will be unable to operate. If the {QCD} section is not present in 
WIN.INI, QLIB tells you to run QINSTALL and terminates.

FILE BACKUP and DOCUMENTATION VIEWER:

c.      QLIB makes backup copies of existing CD-ROM library files
QCD.INI and CDLIST.INI in the QCDRUN working directory. QLIB then 
shells out to QDOC to allow you to view or print program documentation 
(click "Yes"). This also allows you to generate your Registration Form 
on-screen. If you do not wish to view or print out documentation but 
wish to continue in QLIB and edit a CD-ROM, click "No" and QLIB will 
resume.

EDITING FUNCTIONS:

d.      QLIB performs three basic database operations:
                - install new CD-ROM;
                - edit existing installation; and
                - uninstall CD-ROM.
                
        Successful installation of new CD-ROMs or editing of existing
installations requires that the CD-ROM in question be present in the 
CD-ROM drive.        

        In setting up the database structure in QCD.INI, QLIB 
recognizes four basic types of CD-ROM, each of which is handled 
slightly differently:

                1.      CD-ROM runs from single executable file
                           (example - PC-SIG Library edition 11);
                2.      CD-ROM runs from several executable files
                           (example - CorelDraw version 3.0);
                3.      CD-ROM contains a mixture of executable 
                  files and archived files that must be accessed 
                  directly  (example - HamCall); and
                4.      CD-ROM contains archived files only with 
                  no executable files or shell (example - GIFs Galore).

        In each case, the executable file may run from the CD-ROM 
itself, may have been installed previously on your hard drive, or 
may (rarely) require a floppy disk. Additionally, the executable 
file may run appropriately after a command consisting of path:\filename 
only, or may require specification or additional parameters. All 
these possibilities are acceptable in QLIB.                                                


INSTALLING A NEW CD-ROM:

e.      Information on a new CD-ROM will normally be appended to 
the end of QCD.INI, increasing the total number of CDs included in 
the library by 1. However, if a CD-ROM has previously been deleted 
from the library, its place in  numerical sequence is held (the 
[CDTitle] section of QCD.INI, and CDLIST.INI, both contain the 
word "Deleted" at that number in sequence; see below for further
details or the CD-ROM deletion process). In that case, the next new
installation will take the place in numerical sequence of the deleted
CD-ROM and the index for the total number of CD-ROMs in the library
(NCD in the [main] section of QCD.INI) will not be incremented.

f.      QLIB requires the CD-ROM to be installed in the CD-ROM 
drive. It will ask for confirmation that the correct CD-ROM is in
place, and will prompt for a change and eject the current CD-ROM
(if drive design permits) if the CD-ROM for installation is not in
place. (In many systems, ejecting the CD-ROM may produce an "Unable 
to Read Drive" System Error message that clears by clicking "Retry" 
after the new CD-ROM is inserted.) 

g.      Many CD-ROMs (especially those that are DOS-based rather 
than native Windows applications) require separate and unique setup 
procedures to copy files from (usually) the CD-ROM or (rarely) a 
floppy disk onto your hard drive to allow the CD-ROM to run. QLIB 
asks if you need to run the CD-ROMs setup procedure. In all cases 
where this is necessary, this should be completed before the QLIB 
database is established. (You don't need to if you've completed 
setting up the CD-ROM before running QLIB, if the CD-ROM is archival 
only with no executable files, or if the CD-ROM executable files 
explicitly require no specific setup.) A menu shell appears at this 
point to allow you to run the CD-ROM's setup routines without 
leaving QLIB. Answering the questions, you create the installation 
directory for the CD-ROM; and select the setup path, program, and 
additional parameters from the files on the CD-ROM. When this is 
complete, QLIB will run the setup procedures to install the 
CD-ROM to your hard drive before continuing with the QLIB database 
functions. (Note that many CD-ROM's have unusual or unique setup 
procedures. Some,  especially those that shell from Windows to DOS, 
may conflict unpredictably with QLIB or your Windows system. While 
the CD-ROM setup procedure from within QLIB is convenient, it may 
prove unstable. If time permits you are better off running the 
CD-ROM setup procedures before entering QLIB; OR exiting QLIB 
at this point, performing the setup, and returning to QLIB for 
database management only.)

h.      QLIB then prompts for entry of a working title for the 
CD-ROM. This will be recorded in the CD-ROM library file QCD.INI 
section [CDTitle] and in CDLIST.INI and be used as the name or 
title by which the CD-ROM is normally referred to. A blank entry 
is not acceptable.

i.      QLIB then creates a shell of subdirectories and files
on the CD-ROM to allow you select a single file on the CD-ROM that
will be recorded in QCD.INI and used by QCD as a unique identifier
for the CD-ROM. You may select any file from any subdirectory - but
are best to select a subdirectory and file that are unlikely to be
found on another CD-ROM. Blank entries are not acceptable. Before
accepting the identifier file, QLIB scans QCD.INI to ensure that no
other CD-ROM is using a file of the same path and name as its
identifier. If a file of the same path and name IS found in QCD.INI,
QLIB generates an error message ("Identifier File is Not Unique") 
and returns to the file shell menus to allow selection of another
identifier file.

j.      QLIB then asks you to select from a menu to identify the 
CD-ROM as one of the four basic types (see d. above). QLIB operation 
from this point on varies slightly according to the CD-ROM type.
      
k.      If the CD-ROM runs from a single executable file, QLIB asks
if the CD-ROM is a native Windows application. If not, it advises 
you to select from existing Windows .PIF file or to create a new 
Windows .PIF file for best application execution. If an existing
.PIF file is available, QLIB shows a menu shell to allow its selection. 
If you wish to create a new .PIF file, QLIB shells to the Windows
.PIF editor to allow you to create it and automatically accepts 
that new file name as the path and file name for the CD-ROM executable
file. If you do not use a .PIF file at this time, or if this is a 
native Windows application, QLIB prompts you to enter the path and 
file name for the file. This is a mandatory entry. You are then 
prompted to enter any optional parameters that the CD-ROM executable 
file will need to run correctly. These are stored in a separate 
section of QCD.INI for each CD-ROM in the format:
        [CDx] - where x=sequential CD number in QCD.INI
        u=1 (CD-ROM type is single executable file);
        a=identifier file path:\filename 
        x=executable file path:\filename
        p=optional parameters
        
l.      If the CD-ROM is an archive only without an operating shell
or other executable files, QLIB automatically creates an entry in 
the format:
        [CDx]
        u=4
        a=identifier file path:\filename
        x=Search Archival Files
        p=

m.      If the CD-ROM contains multiple executable files, QLIB 
requests the same information as in k. above, as well as a working 
title for each executable file. This then creates two new sections 
of QCD.INI in the format:         
         [CDx] - where x=sequential CD number in QCD.INI
         u=2
         a=identifier file path:\filename
         
         [CDxmenu]
         title1=executable file path:\filename optional parameters
         title2=... etc. for all the individual executable files
         
         If no optional parameter is specified, QLIB concatenates
an ampersand ("&") following the executable file path:\filename as
a place-holder.

n.      If the CD-ROM mixes executable and archival files, QLIB
requests the same information as in m. above, and creates two new
sections in QCD.INI in the format:
        [CDx]
        u=3
        a=identifier file path:\filename
        
        [CDxmenu]
        title1=executable file path:\filename optional parameters
        title2=... etc. for all executable files
        Search Archival Files=      

o.      At the completion of each successful installation, the index
NCD for total number of CDs installed in the [main] section of QCD.INI
is incremented by 1 - unless the new CD-ROM has been installed in 
place of a prior deletion. A brief message window confirms successful
installation. QLIB then asks if you wish to install or edit another 
CD-ROM. The program exits if you click "No". "Yes" returns you to
QDOC and to the full installation procedure from step c. above.
         
UNINSTALLING a CD-ROM:

p.      QLIB does not require you to place the CD-ROM to be uninstalled
into the CD-ROM drive. Selecting the "Uninstall CD-ROM" option from 
the main menu brings up a master menu (from CDLIST.INI) showing CD-ROM 
index number and title for all CD-ROMs currently installed. Click 
the mouse on the title of the CD-ROM you wish to be deleted from 
QCD.INI and CDLIST.INI.

q.      QLIB asks you to confirm your selection for deletion. If 
you click "yes" to confirm, QLIB proceeds to:
-       back-up QCD.INI and CDLIST.INI in the QCD working directory 
as QCD.REM and CDLIST.REM for recovery in case of malfunction;
-       delete the [CDx] and [CDxmenu] sections from QCD.INI (x is 
the CD-ROM index number);
-       delete the CD-ROM title from the [installed] section of 
CDLIST.INI and the [CDTitle] section of QCD.INI, in each case 
replacing   the title after the index number with the place-holder 
"Deleted";
-       if not already present, creates a section [deleted] in 
QCD.INI;
-       increments the total number of deletions "nd=" in section 
[deleted] of QCD.INI by 1; 
-       adds a new line to the [deleted] section cross-referencing 
the CD-ROM index number (x) to the corresponding value of the deletion 
index (nd), in the form "del(nd)=x"; and
-       confirms successful deletion.

r.      QLIB then asks if you wish to edit or install another CD-ROM. 
Clicking "yes" returns you to the main operating menu of QLIB. Clicking
"no" concludes the program.

s.      Installation of a new CD-ROM in place of one that has been 
deleted reverses the order of operations in q, above. Specifically, 
-       new [CDx] and (if appropriate) [CDxmenu] sections are built 
in QCD.INI; 
-       the new CD-ROM title is substituted for "Deleted" in [CDTitle]
in QCD.INI and in [installed] in CDLIST.INI; 
-       the index nd in the [deleted] section of QCD.INI decrements 
by 1; 
-       the last line for del(nd)=x is removed from the [deleted] 
section of QCD.INI; and
-       the index value x is assigned to the new CD-ROM.

EDIT EXISTING INSTALLATION:

t.      The basic menu structure for CD-ROM access is determined by 
QLIB in the installation and removal routines already described. 
QLIB allows all  CD-ROM installation parameters to be edited or 
modified separately. These include modification of the CD-ROM title 
and identifier file; modification of the title or path\fileneame 
for individual  executable files; and addition of new executable 
files or archival search capabilities or deletion of existing executable
files or search capabilities in current installations. The sequence 
steps and messages presented to the user are as described in sections 
f through o, above, for installation of a new CD-ROM. The CD-ROM 
whose installation is to be edited must be in the CD-ROM drive for 
QLIB to run. At each step, QLIB prompts the user for confirmation 
before making any modifications.


COMPLETION and EXIT:

u.      When you complete your editing or installation operations, 
QLIB resumes control to ask if you wish to change CD-ROMs and load 
another. Click "No" to exit QLIB. 

        If you click "Yes", QLIB shells to QDOC (see c. above) so 
you may review documentation if you wish. It then prompts for 
selection   of a new editing or installation operation. If you 
choose no new operation, QLIB terminates.
                   
                ENJOY YOUR CD-ROMs!       
