home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / vidlib.zip / VIDLIB.DOX < prev   
Text File  |  1987-12-01  |  4KB  |  161 lines
  1. ****************************************
  2. The Video Librarian:  A Short User Guide
  3. ----------------------------------------
  4.  
  5. DESCRIPTION
  6. -----------
  7.  
  8. VIDLIB is a public domain program for storing information about
  9. video cassettes.  The information stored for each tape is:
  10.  
  11.     CATEGORY:    A user-defined classification, such
  12.             as ADULT, MUSICAL, FOREIGN, etc.
  13.             
  14.     LOCATION:    A text field for where the tape
  15.             is kept, such as CLOSET, VIDEO
  16.             CABINETTE, ON LOAN, SLOT 22, etc.
  17.             
  18.     TITLES:        There are two title fields for
  19.             each tape.
  20.             
  21.     NOTES:        A text field for any other
  22.                     information you wish to keep.
  23.     
  24.     TIME:        A field for storing the
  25.             amount of time remaining on
  26.             a tape.
  27.             
  28. These fields are all optional (there are no required fields).
  29. They are also free-form, meaning that they will accept any
  30. value in any format.  Text is converted to upper case.            
  31.  
  32. MENUS
  33. -----
  34.  
  35. VIDLIB uses a bounce-bar menu system.  To select an option,
  36. use the UP and Down arrow keys to highlight your choice
  37. and press the Enter (or Carraige Return) key.
  38.  
  39. SAMPLE DATA FILE
  40. ----------------
  41.  
  42. The VIDLIB archive file contains a sample data file to
  43. help get you started.  To access this file, select the
  44. menu option, "Load an EXISTING data file".  At the
  45. file name prompt, enter the word SAMPLE.  When the ACTION
  46. MENU appears, select the option, "VIEW, MODIFY, or
  47. DELETE Tapes".  Then use the arrow keys to scroll
  48. through the data base.
  49.  
  50. FILE EXTENSIONS
  51. ---------------
  52.  
  53. When creating a NEW data file, VIDLIB appends the extension
  54. of DAT.  When loading an EXISTING data file, VIDLIB saves the
  55. previous version with the extension of BAK.  When transferring
  56. your data to an ASCII file, VIDLIB uses an extension of TXT.
  57. Existing files with these names will be overlaid.
  58.  
  59. COMBINING FILES
  60. ---------------
  61.  
  62. Two data files can be merged together with the /b option,
  63. for example:
  64.  
  65.     copy /b sample.dat + myfile.dat
  66.  
  67.  
  68.  
  69. UPDATING AND MISC TIPS
  70. ----------------------
  71.  
  72. Just like LOTUS, user interaction in VIDLIB
  73. occurs entirely in memory.  You are advised
  74. that lengthy periods of data entry should be
  75. punctuated by SAVES.
  76.  
  77. A mistake, such as an accidental deletion can
  78. be reversed in two ways:
  79.  
  80.     1.    Do not save your changes.
  81.     2.    Copying the backup file
  82.         into the data file.
  83.  
  84. Take backups.
  85.  
  86.  
  87. MEMORY REQUIREMENTS
  88. -------------------
  89.  
  90. A 256K machine with no resident software can support a data
  91. base containing about 1,000 video tapes.  As memory size
  92. increases, the size of the data base can increase
  93. correspondinly.  Of course, you can also use multiple
  94. data files to circumvent any memory constraints.
  95.  
  96. PRINTING
  97. --------
  98.  
  99. To obtain a "hard-copy" of your tapes, select the OUTBOUND
  100. INTERFACES option from the ACTION MENU.  The printer function
  101. terminates with an HP LaserJet control sequence for a page
  102. eject.
  103.  
  104. MISC
  105. ----
  106.  
  107. VIDLIB was first uploaded to CIS - go ibmsw, on 12/14/87.
  108. You can contact me through CIS:  72307, 3311.   I am especially
  109. interested in hearing from anyone who taped any of these:
  110.  
  111.      *  The Ring of the Nibelungen series (broadcast on
  112.         PBS in 1981 before I had a VCR)
  113.  
  114.      *  The Brideshead Revisited series (which I
  115.         accidentally erased to the eternal
  116.         chagrin of my wife)
  117.  
  118.  
  119. FILE LAYOUT, INTERNALS, AND OTHER GIBBERISH
  120. -------------------------------------------
  121.  
  122. The following code fragment provides the internal
  123. record layout used by VIDLIB.
  124.  
  125. typedef struct
  126.     {
  127.     qint                hash_key;
  128.     qstring05           signature;
  129.     qstring20           category;
  130.     qstring40           title[2];
  131.     qstring20           location;
  132.     qstring40           notes[1];
  133.     qstring05           times;
  134.     } tape_record;
  135.  
  136. VIDLIB uses a forward linked list data structure
  137. which is sorted by concatenating the category and title
  138. elements.
  139.  
  140. Printing is done through service 0 of interrupt 17h and
  141. directed to LPT1.  The function for doing this is...
  142.  
  143. unsigned int chr_to_lpt1
  144.     (
  145.     unsigned int chr
  146.     )
  147. {
  148. asm    mov    ax, chr
  149. asm    mov    ah, 0
  150. asm    mov    dx, 0
  151. asm    int    17h
  152. asm    mov    al, ah
  153. asm    and    ax, 1
  154. }
  155.  
  156. The program itself is written in TURBO C, using the large
  157. memory model.
  158.  
  159.  
  160.  
  161.