home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / VIDCAT71.ZIP / VIDEOCAT.DOC < prev    next >
Text File  |  1990-09-29  |  150KB  |  3,242 lines
  1.  
  2.           Version 7.1
  3.           Serial Number BBS ZIP 01.
  4.  
  5.  
  6.                            +------------------------------+
  7.                            |  VIDEOCAT Registration Form  |
  8.                            +------------------------------+
  9.  
  10.  
  11.           Registration fee: $20.00.
  12.  
  13.           You  may try  out this  program free  of charge for  a reasonably
  14.           brief evaluation period.  If you decide that you want to continue
  15.           to use  it on  a regular  basis, please  fill out  this form  and
  16.           return it with your check for $20.00 payable to W. A. Jackson to:
  17.  
  18.                               W. A. Jackson
  19.                               6529 Matilija Avenue
  20.                               Van Nuys, California 91401
  21.  
  22.           Registration  entitles  you  to use  the  program,  get technical
  23.           support and  receive future upgrades, all in  accordance with the
  24.           terms  and  conditions  set  forth  in  the  User  Manual.    The
  25.           registration fee is  refundable if you are  dissatisfied with the
  26.           program for any reason within 90 days after registration.
  27.  
  28.  
  29.           Name:               ________________________________________
  30.  
  31.           Company:*           ________________________________________
  32.  
  33.           Street Address:     ________________________________________
  34.  
  35.           City/State/ZIP      ________________________________________
  36.  
  37.           Telephone:*         ________________________________________
  38.  
  39.           Preferred Disk Format:   _____ 5.25"         _____ 3.5"
  40.  
  41.           Do you run under (check all that apply):
  42.  
  43.                     DOS?____       Windows?____        OS/2?____
  44.  
  45.           Do you want to receive the source code?*      _____Yes _____No
  46.           (If you are not experienced in C Language programming, the source
  47.           code will be of no interest or value to you.)
  48.  
  49.           Where did you obtain your copy of VIDEOCAT?*___________________
  50.  
  51.           _______________________________________________________________
  52.  
  53.           Comments/Suggestions:* ________________________________________
  54.  
  55.           _______________________________________________________________
  56.  
  57.           * Optional entries.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                        VIDEOCAT
  66.  
  67.  
  68.                             Videocassette Catalog Program
  69.  
  70.  
  71.                                      Version 7.1
  72.  
  73.                            DOS - OS/2 Bound (FAPI) Program
  74.  
  75.  
  76.  
  77.                                      USER MANUAL
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.                                     _______                    
  87.                                ____|__     |               (tm)
  88.                             --|       |    |-------------------
  89.                               |   ____|__  |  Association of   
  90.                               |  |       |_|  Shareware        
  91.                               |__|   o   |    Professionals    
  92.                             -----|   |   |---------------------
  93.                                  |___|___|    MEMBER           
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.                                   William A. Jackson
  105.                                  6529 Matilija Avenue
  106.                               Van Nuys, California 91401
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page i
  114.           _________________________________________________________________
  115.  
  116.  
  117.  
  118.                                   Table of Contents
  119.  
  120.           GENERAL INFORMATION . . . . . . . . . . . . . . . . . . . . .   1
  121.                What this Program Does . . . . . . . . . . . . . . . . .   1
  122.                Minimal Instructions for the New User in a Hurry . . . .   3
  123.                Minimal Change Summary for the Old User in a Hurry . . .   3
  124.                System Requirements  . . . . . . . . . . . . . . . . . .   5
  125.                Known System Incompatibilities . . . . . . . . . . . . .   6
  126.                Compatibility with Prior Versions  . . . . . . . . . . .   7
  127.                License  . . . . . . . . . . . . . . . . . . . . . . . .   7
  128.                Disk Vendors, Bulletin Boards, etc.  . . . . . . . . . .   8
  129.                Registration . . . . . . . . . . . . . . . . . . . . . .   8
  130.                Warranties . . . . . . . . . . . . . . . . . . . . . .    11
  131.                ASP Ombudsman  . . . . . . . . . . . . . . . . . . . .    11
  132.                Installation . . . . . . . . . . . . . . . . . . . . .    11
  133.                General Tips on Running VIDEOCAT . . . . . . . . . . .    13
  134.                If You Have Trouble  . . . . . . . . . . . . . . . . .    14
  135.                Source Code  . . . . . . . . . . . . . . . . . . . . .    15
  136.                Development History  . . . . . . . . . . . . . . . . .    16
  137.  
  138.           FUNCTION DESCRIPTIONS . . . . . . . . . . . . . . . . . . .    19
  139.                A - Add a record to the catalog  . . . . . . . . . . .    19
  140.                     Title . . . . . . . . . . . . . . . . . . . . . .    19
  141.                     Year  . . . . . . . . . . . . . . . . . . . . . .    20
  142.                     Star 1 LAST name  . . . . . . . . . . . . . . . .    20
  143.                     Star 1 FIRST name . . . . . . . . . . . . . . . .    21
  144.                     Star 2 LAST name  . . . . . . . . . . . . . . . .    21
  145.                     Star 2 FIRST name . . . . . . . . . . . . . . . .    21
  146.                     Star 3 LAST name  . . . . . . . . . . . . . . . .    21
  147.                     Star 3 FIRST name . . . . . . . . . . . . . . . .    21
  148.                     Director LAST name  . . . . . . . . . . . . . . .    21
  149.                     Director FIRST name . . . . . . . . . . . . . . .    21
  150.                     Subject Code  . . . . . . . . . . . . . . . . . .    21
  151.                     Form Code . . . . . . . . . . . . . . . . . . . .    21
  152.                     MPAA Code . . . . . . . . . . . . . . . . . . . .    22
  153.                     Rating Code . . . . . . . . . . . . . . . . . . .    22
  154.                     Color Code  . . . . . . . . . . . . . . . . . . .    22
  155.                     Format Code . . . . . . . . . . . . . . . . . . .    22
  156.                     Cassette No.  . . . . . . . . . . . . . . . . . .    22
  157.                     Index No. . . . . . . . . . . . . . . . . . . . .    23
  158.                     Comment Lines . . . . . . . . . . . . . . . . . .    23
  159.                     Verification  . . . . . . . . . . . . . . . . . .    23
  160.                C - Change a record in the catalog . . . . . . . . . .    25
  161.                D - Delete a record from the catalog . . . . . . . . .    26
  162.                F - File Conversion from Prior Versions  . . . . . . .    27
  163.                G - Configuration Changes  . . . . . . . . . . . . . .    28
  164.                     Add-Fields  . . . . . . . . . . . . . . . . . . .    28
  165.                     Color/Mono Display  . . . . . . . . . . . . . . .    29
  166.                     Form Descriptions . . . . . . . . . . . . . . . .    29
  167.                     Subject Descriptions  . . . . . . . . . . . . . .    29
  168.                     Disk Paths for Files  . . . . . . . . . . . . . .    29
  169.                     Printer Configuration . . . . . . . . . . . . . .    30
  170.  
  171.  
  172.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page ii
  173.           _________________________________________________________________
  174.  
  175.                     System Information  . . . . . . . . . . . . . . .    31
  176.                L - Label Maker  . . . . . . . . . . . . . . . . . . .    32
  177.                R - Review Current Changes . . . . . . . . . . . . . .    34
  178.                S - Search Catalog . . . . . . . . . . . . . . . . . .    36
  179.                T - Tally Statistics . . . . . . . . . . . . . . . . .    38
  180.                U - Update Data Base . . . . . . . . . . . . . . . . .    39
  181.                W - Whole Catalog Listing  . . . . . . . . . . . . . .    41
  182.                E - Exit from program  . . . . . . . . . . . . . . . .    43
  183.  
  184.           WHAT IS SHAREWARE?  . . . . . . . . . . . . . . . . . . . .    44
  185.  
  186.           ASP MEMBERSHIP REQUIREMENTS . . . . . . . . . . . . . . . .    47
  187.                ASP Software Support Policy  . . . . . . . . . . . . .    47
  188.                ASP Registration Payment Policy  . . . . . . . . . . .    48
  189.                ASP Policy on No Crippling . . . . . . . . . . . . . .    48
  190.                ASP Ombudsman Policy . . . . . . . . . . . . . . . . .    49
  191.                ASP Misc. Standards  . . . . . . . . . . . . . . . . .    51
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                    *    *    *    *
  198.  
  199.  
  200.  
  201.                     "You have  all  your  videotapes  alphabetized  on
  202.                index cards."
  203.  
  204.                          --   Billy Crystal to Meg Ryan in "WHEN HARRY
  205.                               MET SALLY..." (1989).
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page 1
  232.           _________________________________________________________________
  233.  
  234.  
  235.  
  236.                                  GENERAL INFORMATION
  237.  
  238.  
  239.                                 What this Program Does
  240.                                 ______________________
  241.  
  242.  
  243.                VIDEOCAT  is a  specialized  database  program designed  for
  244.           cataloging a collection of movies or  similar materials stored on
  245.           videocassettes.  Each record contains the following information:
  246.  
  247.                -    title
  248.                -    year of release
  249.                -    subject type
  250.                -    form type
  251.                -    quality rating
  252.                -    MPAA audience rating code
  253.                -    actors (maximum 3 names)
  254.                -    director
  255.                -    cassette number
  256.                -    index number on cassette
  257.                -    color/black & white
  258.                -    sound type
  259.                -    running time
  260.                -    video/film format
  261.                -    free-form user comments (3 lines)
  262.  
  263.                Using the  program's Add function  you build a data  file of
  264.           records  containing  this  information for  items  in  your video
  265.           collection.    This  program  was  designed  for  collections  of
  266.           theatrical motion  pictures; however it has  custom configuration
  267.           options  which permit adaptation to different types of materials.
  268.           Other functions permit you to Change or Delete records previously
  269.           entered.
  270.  
  271.                While the program is on-line you can use the Search function
  272.           to get a screen or printed listing of records which match  search
  273.           criteria which you specify.  For  example, you can get a  listing
  274.           of all comedies,  or all movies with John Wayne,  or  all  movies
  275.           released in 1939.  You can also cause the program to print a hard
  276.           copy  complete catalog to use when  the program is off-line.  The
  277.           catalog  can  be  printed  in  title,  year  or  cassette  number
  278.           sequence.
  279.  
  280.                There  is  also  a label-printing  utility  which  can print
  281.           labels for  your  videocassettes.    A variety  of  standard  and
  282.           special label formats are supported.
  283.  
  284.                Configuration  routines allow you to specify the paths where
  285.           your  files are located,  force monochrome  operation on  a color
  286.           display,  set  up  special control  sequences  for  your printer,
  287.  
  288.  
  289.  
  290.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page 2
  291.           _________________________________________________________________
  292.  
  293.           change the subject and form  descriptions, cause the Add function
  294.           to skip fields you don't want to use, and display system data.  
  295.  
  296.                Other utilities perform  an analysis of your  collection and
  297.           convert data  files created under Version 5  or Version 6 of this
  298.           program so that they can be used under Version 7.
  299.  
  300.                This program  has been  designed with  large collections  in
  301.           mind.  Theoretically the program  could handle data files with up
  302.           to  65,535 records.   For  all practical  purposes the  number of
  303.           records is limited only by available disk space, with each record
  304.           taking up 384 bytes.
  305.  
  306.                Note  that this program  is for cataloging  YOUR collection.
  307.           The small demo file included with the distribution package is for
  308.           demonstration purposes only.  A surprising number of users assume
  309.           that  this is a database  of all videos  available for rental and
  310.           write complaining that I haven't included enough videos.
  311.  
  312.                When  I first  released VIDEOCAT,  I think  it was  the only
  313.           program of its type.  Others have come along since, some of which
  314.           are very good.   I think that VIDEOCAT  offers several advantages
  315.           which distinguish it from some of the alternatives: 
  316.  
  317.                (1)  the size of the data file is  limited only by
  318.                     the availability of disk  space; 
  319.  
  320.                (2)  supports a variety of readily available label
  321.                     stocks; 
  322.  
  323.                (3)  the  program can be  run in either  real mode
  324.                     (DOS or  the OS/2 compatibility  box) or OS/2
  325.                     protected mode; 
  326.  
  327.                (4)  the record structure is designed  to meet the
  328.                     needs of serious collectors; 
  329.  
  330.                (5)  user configuration options  enable adaptation
  331.                     to specialized applications; 
  332.  
  333.                (6)  the  user  interface   is  fairly  intuitive,
  334.                     making the program easy to learn;  
  335.  
  336.                (7)  the   program    is   distributed    with   a
  337.                     demonstration data file which permits the new
  338.                     user to immediately check out all features; 
  339.  
  340.                (8)  minimum system requirements  make the program
  341.                     accessible to  virtually anyone  operating in
  342.                     an IBM-compatible PC environment; 
  343.  
  344.                (9)  I  have an  established record  of continuous
  345.                     interaction  with users  and regular  updates
  346.                     reflecting their suggestions; and 
  347.  
  348.  
  349.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page 3
  350.           _________________________________________________________________
  351.  
  352.                (10) source code is available.  
  353.  
  354.           I  believe that  VIDEOCAT is  currently  the most  fully-featured
  355.           program available, shareware  or commercial.  Many users  tell me
  356.           that they have tried other programs and VIDEOCAT is the  only one
  357.           which meets all their needs.
  358.  
  359.                    Minimal Instructions for the New User in a Hurry
  360.                    ________________________________________________
  361.  
  362.  
  363.                Okay, you just  got this program and you want to see what it
  364.           can do right away without reading a lot of documentation.   For a
  365.           quick demo, put  the files VIDEOCAT.EXE  and VCATDEMO.DAT on  the
  366.           current path and type VIDEOCAT <return>.  The  instructions which
  367.           appear on the screen should be sufficiently informative to permit
  368.           you  to  fool  around for  a  while  and  check out  the  various
  369.           features. You will see the message "No previous setup found - use
  370.           demo data file?  (Y/N) -> ".  Enter  Y if you want to  run a demo
  371.           with the sample demo data file.  
  372.  
  373.                If you decide you  want to use  the program to catalog  your
  374.           own  videocassette   collection,   you  can   either  enter   the
  375.           Configuration  Menu (choice  G  on  the Main  Menu)  or exit  the
  376.           program and run it again, this time entering N when asked  if you
  377.           want to use the demo data file.  You might also read the rest  of
  378.           this  manual.   I have discovered  that in  the real  world users
  379.           often will not read the manual until they get into trouble.  
  380.  
  381.  
  382.                   Minimal Change Summary for the Old User in a Hurry
  383.                   __________________________________________________
  384.  
  385.  
  386.                Okay, you've used Videocat before and you don't want to read
  387.           the whole manual to try to figure out what's new.  Here's a quick
  388.           summary.  
  389.  
  390.                If you  are currently  using Version 7.0,  this is  what you
  391.           will find new in Version 7.1:
  392.  
  393.                -    Improved  code optimization  has reduced  the
  394.                     size of  the VIDEOCAT.EXE  file and may  also
  395.                     have increased execution speed a little.
  396.  
  397.                -    Some typographical  errors have  been removed
  398.                     from the display screens.
  399.  
  400.                -    Some of the  printed output routines now  ask
  401.                     whether or not you  want an initial  formfeed
  402.                     (to assure that printing starts at the top of
  403.                     a page).
  404.  
  405.  
  406.  
  407.  
  408.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page 4
  409.           _________________________________________________________________
  410.  
  411.                -    The Search  function now allows you to search
  412.                     by cassette number.
  413.  
  414.                -    The  Tally  Statistics  function  now  has  a
  415.                     printer output option and  options to produce
  416.                     reports listed  in either frequency  order or
  417.                     alphabetical order.
  418.  
  419.                -    The lower-case  translation option  of the  Update
  420.                     procedure  has  been  improved  to  recognize  and
  421.                     capitalize Roman numerals.
  422.  
  423.                -    The  editing of  name data  has  been improved  to
  424.                     eliminate errors in  handling names which  include
  425.                     commas.
  426.  
  427.                -    A new option  has been added to  the Configuration
  428.                     function which enables you to control which record
  429.                     fields  you  are  automatically prompted  to  fill
  430.                     during an Add transaction.
  431.  
  432.                -    The  Whole Catalog  function has  new  options for
  433.                     output sorted in title sequence, year sequence, or
  434.                     cassette number sequence.
  435.  
  436.                -    There  are a number  of improvements in  the label
  437.                     printing  function,  including   the  addition  of
  438.                     support  for the use  of file folder  label sheets
  439.                     and VHS label sheets in laser printers.
  440.  
  441.  
  442.  
  443.                If you  are currently using  a version earlier  than Version
  444.           7.0, then the following features will also be new for you:
  445.  
  446.                -    The new  demo routine  uses the special  file
  447.                     VCATDEMO.DAT to avoid the risk of overwriting
  448.                     your own data file when installing an update.
  449.  
  450.                -    If    the   program    finds   an    existing
  451.                     configuration file, it  uses it automatically
  452.                     without  asking   you  to  verify   the  path
  453.                     configuration.   If you do want to change the
  454.                     paths for your  data and work files,  you can
  455.                     do so through the Configuration Menu  (select
  456.                     G from the Main Menu).
  457.  
  458.                -    The Configuration  Menu also gives  access to
  459.                     new features to  custom configure the subject
  460.                     and  form   descriptions,  force   monochrome
  461.                     operation  even  though  you  have  a   color
  462.                     display, install custom codes to control your
  463.                     particular brand  of printer,  and display  a
  464.                     variety of system data.
  465.  
  466.  
  467.                         Copyright (C) 1986-1990 W. A. Jackson            VIDEOCAT Version 7.1                                       Page 5
  468.           _________________________________________________________________
  469.  
  470.                -    The  label  printing  function has  many  new
  471.                     options for different label  stocks and label
  472.                     formats.
  473.  
  474.                -    You  can now use  lower case letters  in data
  475.                     entries if you want.  The Update function has
  476.                     options  for  case  conversion  for  existing
  477.                     records.    The  search   function  is  case-
  478.                     insensitive,  so the use  of upper  and lower
  479.                     case letters  is significant  for readability
  480.                     only.
  481.  
  482.                -    Both the  Search and Whole  Catalog functions
  483.                     give  you  an expanded  choice of  screen and
  484.                     printer report formats.
  485.  
  486.                -    The Search function now  permits a search for
  487.                     a conjunctive combination  of multiple search
  488.                     keys.
  489.  
  490.                -    There  are  several new  data  fields  in the
  491.                     record structure, most significantly room for
  492.                     three 60-character free-form comment lines.
  493.  
  494.                Occasionally a user will tell me,  "I don't think I need the
  495.           new  features, so I  guess I will  just continue  running the old
  496.           version."  I  do not recommend this.   While some of  the changes
  497.           are apparent  to you as  new features, new versions  also involve
  498.           improvements  in  the  efficiency of  existing  features  and the
  499.           correction of bugs which could  cause an error under some unusual
  500.           combination of circumstances.
  501.  
  502.  
  503.                                  System Requirements
  504.                                   ___________________
  505.  
  506.  
  507.                Version 7.1  is a  "bound" or  "family applications  program
  508.           interface" (FAPI)  program; it will  run under  either DOS  (real
  509.           mode) or OS/2 (protected mode).  Although the compiler guarantees
  510.           compatibility only  with  DOS  Version 3.x,  it  appears  to  run
  511.           correctly under DOS 2.10. and DOS 4.0.
  512.  
  513.                I  have  not  attempted  to  determine  the  minimum  memory
  514.           requirement, since it seems as though just about everybody has at
  515.           least 640k installed, which  is quite adequate.  I have been told
  516.           that the program will run in 128k,  but I have not verified this.
  517.           If  you have a  whole bunch of device  drivers, virtual disks and
  518.           terminate-and-stay-resident  programs   installed  and   reducing
  519.           available memory, you might have trouble.  When running under DOS
  520.           this program  does not  make use of  expanded or  extended memory
  521.           (except  that you  can  use a  ramdisk or  vdisk  which you  have
  522.           created in expanded  or extended memory if you  have the facility
  523.           to  do so).    When running  under  OS/2 in  protected mode  this
  524.  
  525.  
  526.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page 6
  527.           _________________________________________________________________
  528.  
  529.           program can  make use of all  available memory, which  will be of
  530.           practical advantage if your  data file is large  and you use  the
  531.           Tally Statistics  function or the  sorted output  feature of  the
  532.           Whole  Catalog function (these routines do their work by creating
  533.           very large structures in memory).
  534.  
  535.                This program has been tested on the IBM PC, XT, AT  and PS/2
  536.           series of computers and  a variety of clones.  It  should work on
  537.           close    compatibles;  however  experience  with   user  comments
  538.           suggests  that some  clones  are not  as  compatible as  claimed.
  539.           Although all testing  has been on  machines  with color displays,
  540.           the program is intended to run on monochrome displays as well.  I
  541.           have found that  different brands of video adapters  and monitors
  542.           render colors differently.   Color combinations which  look great
  543.           on  my system  sometimes appear  dim and  lacking in  contrast on
  544.           other systems.   Thus I  have included a Configuration  option to
  545.           force monochrome operation  on a color system for  those who find
  546.           the color rendition unsatisfactory.
  547.  
  548.                The program  could run with  as little as one  floppy drive;
  549.           however this would limit the size of the data file which could be
  550.           created.   Dual  drives or  a  hard drive  will greatly  increase
  551.           capacity, as  will high density drives.  A RAMDISK (VDISK) can be
  552.           used  for temporary files to speed processing.   The size of your
  553.           data file  will be approximately  equal to the number  of records
  554.           multiplied  by 384 bytes.   You  need to  have enough  disk space
  555.           available for your  data file and  a temporary work  file of  the
  556.           same size.  If you  want to use the  sorted output option of  the
  557.           Whole Catalog function, you will need  additional free disk space
  558.           equal to approximately twice the size of your data file.
  559.  
  560.                A printer  is required if  printed output is selected.   You
  561.           can  get along without  a printer if  you never select  a printed
  562.           output  option.     Almost  any  standard  printer   should  work
  563.           successfully for most routines.  There is a Configuration  option
  564.           which   allows  you  to  specify  special  control  sequences  to
  565.           initialize  and  restore  your  printer  state  and  to  turn  an
  566.           emphasized print mode  on and off.   To use this option  you will
  567.           have to dig into your printer  manual to find out what to  enter.
  568.           Those output options which offer special features for the Hewlett
  569.           Packard Laserjet II  have not been tested on any  other machine. 
  570.           I have no idea whether  they will produce satisfactory results on
  571.           laser printers which claim to be HP compatible.
  572.  
  573.  
  574.                             Known System Incompatibilities
  575.                             ------------------------------
  576.  
  577.  
  578.                VIDEOCAT  is  rather  memory-intensive   and  may  not   run
  579.           correctly if you  have a small amount  of memory installed  or if
  580.           have little memory free because  you have loaded numerous  device
  581.           drivers and gadget programs that use up memory.  One user reports
  582.           apparent   conflict   with   TSR's   (terminate-and-stay-resident
  583.  
  584.  
  585.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page 7
  586.           _________________________________________________________________
  587.  
  588.           programs,  such as Sidekick) which disappear when VIDEOCAT is run
  589.           without  TSR's  loaded.   Several  users  have  reported problems
  590.           running VIDEOCAT from program selector shells and menu utilities.
  591.           I  suspect these are  also TSR's.   If VIDEOCAT does  not load or
  592.           freezes after loading,  or will not run correctly  from a program
  593.           selector, try booting with fewer TSR's and device drivers and run
  594.           VIDEOCAT directly  from the DOS  prompt rather than from  menu or
  595.           program selector shells.
  596.  
  597.                These incompatibilities have only been reported when running
  598.           under DOS.  No incompatibilities have  been reported when running
  599.           under OS/2 protected mode.
  600.  
  601.  
  602.                           Compatibility with Prior Versions
  603.                           _________________________________
  604.  
  605.  
  606.                If you  created a data file  under a version of  VIDEOCAT in
  607.           the  5.x  or   6.x  series,  you   must  convert  your   existing
  608.           BASEFIL5.DAT to the  current format in a file named VCATDATA.DAT,
  609.           which can  be  processed by  the  Version 7.x  series.   Use  the
  610.           command  for File  Conversion in  the main  menu of  the program.
  611.           Note  that if  your  data  file was  created  or converted  under
  612.           Version 4.x,  you must first  use Version  5.x or 6.x  to convert
  613.           from BASEFILE.DAT to BASEFIL5.DAT.
  614.  
  615.                There are several new fields in the new record format.  When
  616.           you perform a  file conversion  these additional  fields will  be
  617.           initialized  in an  empty state.    Since they  are all  optional
  618.           entries, the program  will work fine if  you don't bother to  add
  619.           these entries to your old records.  You can, if you wish, use the
  620.           Change function to add data in the new fields.
  621.  
  622.  
  623.                                        License
  624.                                         _______
  625.  
  626.  
  627.                This  is "user supported  software", or "shareware".   It is
  628.           NOT in  the public  domain but is  protected under  the copyright
  629.           laws of the  United States.  You are granted a limited license to
  630.           use,  copy and  distribute  VIDEOCAT  subject  to  the  following
  631.           conditions:
  632.  
  633.  
  634.                1.  You  may make personal, non-commercial use   of VIDEOCAT
  635.           during  a  reasonably  brief  trial  period;  if  you   become  a
  636.           registered  user  (see  Registration  below),  your  license  for
  637.           personal use becomes perpetual;
  638.  
  639.                2.   You may distribute copies  to others who may  also make
  640.           royalty-free use  during a relatively brief trial  period and may
  641.           obtain a perpetual license by becoming registered users;
  642.  
  643.  
  644.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page 8
  645.           _________________________________________________________________
  646.  
  647.                3.    You may  upload  copies  of the  applications  package
  648.           (executable file and manual,  but NOT source code)  to electronic
  649.           bulletin boards and information services;
  650.  
  651.                4.  You may make a modified  version of the program for your
  652.           own use only;
  653.  
  654.                5.  You  may not modify the program or  its documentation or
  655.           source code in versions you distribute to others;
  656.  
  657.                6.  You may not charge any fee for copying and  distribution
  658.           of VIDEOCAT other than reasonable costs of   copying, information
  659.           service on-line charges, shareware disk distribution charges, and
  660.           similar  nominal  costs  not  exceeding  $10  for  this  program,
  661.           provided that you clearly disclose  that the program is shareware
  662.           and that payment of your  distribution charge does not excuse the
  663.           obligation to pay a registration fee to the author.
  664.  
  665.  
  666.  
  667.                          Disk Vendors, Bulletin Boards, etc.
  668.                           ___________________________________
  669.  
  670.                Disk  vendors,  electronic  bulletin  boards,  user  groups,
  671.           computer  clubs, swap meets,  etc. are all  welcome to distribute
  672.           VIDEOCAT, subject  to the restrictions in item  6 under "License"
  673.           above.
  674.  
  675.                My current practice is to mail major releases of VIDEOCAT to
  676.           vendors  approved by the  Association of Shareware Professionals.
  677.           I simply don't have  the time or inclination to answer  mail from
  678.           other  organizations  with sure-fire,  get-rich-quick  schemes to
  679.           promote this program and help me achieve fame and fortune if only
  680.           I will part with a little front money.
  681.  
  682.                I  find that  users  who have  obtained  VIDEOCAT from  disk
  683.           vendors, bulletin boards  or swap meets often  have received very
  684.           outdated versions.   The best way  to be sure  you have the  most
  685.           recent release is, of course, to become a registered user.
  686.  
  687.  
  688.                                      Registration
  689.                                      ____________
  690.  
  691.                VIDEOCAT is shareware.  It is NOT free software.  If you are
  692.           not familiar with shareware, read the "What is Shareware" section
  693.           towards the  end of this  manual.   The author depends  upon your
  694.           integrity in becoming a registered user if you choose to continue
  695.           using the program after a brief trial period.
  696.  
  697.                The shareware  concept is  based upon  the expectation  that
  698.           users who test  a program and decide they want  to continue using
  699.           it will register with the author and  send in a registration fee.
  700.           Electronic bulletin boards and disk vendors charge only for their
  701.  
  702.  
  703.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                       Page 9
  704.           _________________________________________________________________
  705.  
  706.           distribution services and  do not pay any  royalties to shareware
  707.           authors.    Honest  vendors explain  this  system  clearly; shady
  708.           operators  obscure   it.    If   you  did  not   understand  that
  709.           registration and  payment of  a fee to  the author  was expected,
  710.           complain to  the vendor you dealt with  and any magazine in which
  711.           it advertises.   Do not sent me a letter saying that you "bought"
  712.           VIDEOCAT from some disk distributor  and now expect full  support
  713.           without compensating the author.  I also have no control over the
  714.           quality  of  diskettes  used by  disk  vendors.    If  you got  a
  715.           defective diskette from  a disk vendor, complain to  them, not to
  716.           me.
  717.  
  718.                Since  this is essentially  an honor system,  your voluntary
  719.           compliance  is  fundamental  to the  continued  viability  of the
  720.           shareware concept  which enables  the economical distribution  of
  721.           professional  quality programs for  special applications which do
  722.           not represent a large enough market to justify marketing  through
  723.           conventional  retail channels.  VIDEOCAT would never have reached
  724.           its   current  stage  of  development  without  the  support  and
  725.           encouragement of registered users.  Although it is obvious that I
  726.           am  not going  to retire  on royalties  from VIDEOCAT,  there are
  727.           costs associated with  its distribution and maintenance and  I do
  728.           expect the project to support itself financially.
  729.  
  730.                Aside from the appeal to  your integrity, there are  several
  731.           practical advantages which I would suggest make it worthwhile for
  732.           you to become a registered user:
  733.  
  734.                -    The  version you  have may  not  be the  most
  735.                     current  version; if it  is not  current, you
  736.                     will receive the most current version by mail
  737.                     on disk when your registration is received.*
  738.  
  739.                -    Registered  users   usually  get   reasonably
  740.                     prompt  responses to  questions and  requests
  741.                     for help.   (Frankly, I do not have  a lot of
  742.                     patience  or   motivation  in   dealing  with
  743.                     questions from non-registered users.)
  744.  
  745.                -    Registered   users   always  get   the   next
  746.                     significant** upgrade free of  charge by mail
  747.                     on disk shortly after it is ready for general
  748.                     distribution.  
  749.  
  750.                -    After   the   first   significant**  upgrade,
  751.                     additional upgrades will be made available to
  752.                     registered users at a nominal handling charge
  753.                     (currently estimated at $5).
  754.  
  755.                -    Registered  users  sometimes get  an  advance
  756.                     peek at new features through interim editions
  757.                     sent to them for "Beta" testing.
  758.  
  759.  
  760.  
  761.  
  762.                         Copyright (C) 1986-1990 W. A. Jackson            VIDEOCAT Version 7.1                                      Page 10
  763.           _________________________________________________________________
  764.  
  765.                -    Registered users often  see their suggestions
  766.                     reflected in changes to the program.
  767.  
  768.                -    Registered users  are provided  with complete
  769.                     source  code  on request  without  additional
  770.                     charge.
  771.  
  772.           * I'll confess  that sometimes I run a little  late in processing
  773.           registrations.  I will not, however, cash your check until I have
  774.           acknowledged your  registration and made  sure you have  the most
  775.           recent release.
  776.  
  777.           ** Interim releases are occasionally  mailed to some users with a
  778.           request  that they  act as  "Beta" testers  and  report problems,
  779.           comments and suggestions.  Mailing of an interim release does not
  780.           count as a significant upgrade.
  781.  
  782.                VIDEOCAT is  not "crippleware"  or "ransomware".   The  same
  783.           version is distributed to all and you do not have to pay extra to
  784.           get a version that really works.
  785.  
  786.                Registration   is  accomplished   by   simply  mailing   the
  787.           registration form  which is  included in  the documentation  file
  788.           with a check for $20 to
  789.  
  790.                                   William A. Jackson
  791.                                   6529 Matilija Avenue
  792.                                   Van Nuys, California 91401
  793.  
  794.                $20 is a  bargain.  I have seen authors  of clearly inferior
  795.           programs request two, three or four times as much.  If you send a
  796.           letter  with a  long list  of questions  you would  like answered
  797.           before deciding  whether to  part with your  $20, don't  expect a
  798.           reply.  If you send a check for a lesser amount, I will accept it
  799.           as a "conscience" payment, but don't expect to get the privileges
  800.           of  a fully registered user.   If you send a  check for a greater
  801.           amount, I will accept it gracefully.
  802.  
  803.                There  is no extra charge for foreign registration, although
  804.           I will send your updates by surface mail which can take  a couple
  805.           of  months to reach overseas  locations.  An international postal
  806.           money order  denominated in U.S.  dollars is the  most convenient
  807.           means  for  foreign  users  to register.    Videocat  contains no
  808.           cryptographic or other security functions and is not, to the best
  809.           of my knowledge, subject to any U.S. export restrictions.
  810.  
  811.                This  is a  one-time royalty,  although additional  upgrades
  812.           beyond the first  after registration may be subject  to a nominal
  813.           handling charge.   I  make no guarantees  as to  how long  or how
  814.           often future upgrades will be released and I reserve the right to
  815.           discontinue development and support of VIDEOCAT at any time.
  816.  
  817.  
  818.  
  819.  
  820.  
  821.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 11
  822.           _________________________________________________________________
  823.  
  824.                                       Warranties
  825.                                       __________
  826.  
  827.                Did  you  seriously  expect warranties  with  user-supported
  828.           software?  Just to make  sure that everything is perfectly clear,
  829.           this software comes  without any warranties, express  or implied,
  830.           including  warranties  of   merchantability  or  suitability  for
  831.           intended purpose.   It is  distributed to  you "as is"  and "with
  832.           faults".   Under no circumstances shall  the author be liable for
  833.           any consequential damages.
  834.  
  835.                I do have a liberal  refund policy (although no one  has yet
  836.           asked for a refund).  If for any reason you are dissatisfied with
  837.           VIDEOCAT within  90 days  after registration,  I will  cheerfully
  838.           refund your royalty payment on request.
  839.  
  840.  
  841.  
  842.                                     ASP Ombudsman
  843.                                     -------------
  844.  
  845.                This program is  produced by a member of  the Association of
  846.           Shareware Professionals (ASP).   ASP wants to make  sure that the
  847.           shareware principle works for you. If you are unable to resolve a
  848.           shareware-related  problem with an  ASP member by  contacting the
  849.           member directly, ASP may be  able to help. The ASP Ombudsman  can
  850.           help you resolve  a dispute or  problem with an  ASP member,  but
  851.           does  not provide technical support for members' products. Please
  852.           write to the ASP Ombudsman at  P.O. Box 5786, Bellevue, WA  98006
  853.           or send  a  Compuserve  message  via easyplex  to  ASP  Ombudsman
  854.           70007,3536"
  855.  
  856.  
  857.  
  858.                                      Installation
  859.                                      ____________
  860.  
  861.  
  862.                VIDEOCAT.EXE  is the  only  file you  need  to get  started.
  863.           Paths  are supported,  so you  can  install it  on  any disk  and
  864.           directory or subdirectory you want.  When the program is run (and
  865.           you do not use the demo data file), it will look in the currently
  866.           active  directory  for  the configuration  file  VIDEOCAT.CFG and
  867.           create a new configuration  file if none  is found.  The  program
  868.           will also  create the  data file VCATDATA.DAT  and the  work file
  869.           VCATDATA.TMP if these do not  already exist. The currently logged
  870.           path is the default for these two files, but the program will ask
  871.           you if you  would like to use different paths for these two files
  872.           and your choices will be recorded in the configuration file.  You
  873.           can change these paths later  from the Configuration menu. If you
  874.           have a data  file which was created under VIDEOCAT Version 5.x or
  875.           6.x, you should first convert it using the File Conversion option
  876.           from the Main Menu.  
  877.  
  878.  
  879.  
  880.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 12
  881.           _________________________________________________________________
  882.  
  883.                If you have already been running Version 7.0, the only thing
  884.           you need to  do is replace the executable  file VIDEOCAT.EXE with
  885.           the current version.  You do not need to make any changes in your
  886.           data and configuration files.
  887.  
  888.                I  will insert  a  brief description  of  paths, since  this
  889.           subject  is a mystery  to some users  new to computing.   You can
  890.           organize  a  disk  to  have  a  multi-level  file  structure with
  891.           subdirectories   to  keep  your   root  directory  from  becoming
  892.           cluttered  with a  large number  of  unrelated file  names.   You
  893.           create a subdirectory  with the DOS  command MD (Make  Directory)
  894.           and the  name of the  subdirectory you want  to create.   You can
  895.           make a subdirectory the current directory with the DOS command CD
  896.           (Change Directory)  and the  name of  the subdirectory you  want.
  897.           The  path is  the complete  specification  of the  path DOS  must
  898.           follow to find a directory or subdirectory, with levels separated
  899.           by backslashes (\).  If you want  to make a subdirectory for this
  900.           program,  then from  the C>  prompt on  your hard drive  enter MD
  901.           VIDEOCAT; to  make it the  current directory, enter  CD VIDEOCAT.
  902.           Copy your VIDEOCAT  files into that subdirectory.   When asked by
  903.           the  program  to  enter  the  path  for  your  data  file,  enter
  904.           C:\VIDEOCAT.  To return to your root directory enter CD C:\.
  905.  
  906.                Videocat does not directly support  the use of multiple data
  907.           files.   If  you  have  distinct collections  which  you wish  to
  908.           catalog  separately,  you  can  install  more  than  one  copy of
  909.           Videocat  in separate  subdirectories.   This will permit  you to
  910.           maintain separate data files.
  911.  
  912.                Note  that the  program distribution  package  comes with  a
  913.           small data file VCATDEMO.DAT.  This is for demonstration purposes
  914.           only.    If  the  program  finds this  file  and  no  preexisting
  915.           configuration files, it will ask if you want to run with the demo
  916.           file.    If you  answer Y,  the  demo file  will be  used  and no
  917.           configuration files will  be set up.   If you answer N,  the demo
  918.           file  will  be ignored  and  you  can  proceed to  configure  the
  919.           installation and create your own data file.
  920.  
  921.                Some users assume  that the message about a  demo file means
  922.           that this  is a  demo version  of the  program and  not the  real
  923.           thing.  Not true.  Once  you answer the configuration questions a
  924.           configuration file will be created and you will no longer get the
  925.           demo file  message.  Some  users assume  that the  way to  create
  926.           their own data  file is to  use the Delete  and Add functions  to
  927.           alter the  demo file.   If  you have  done this,  you can  simply
  928.           rename the  file VCATDEMO.DAT to  VCATDATA.DAT so you  won't lose
  929.           the work you did changing the demo file.
  930.  
  931.                You can put the work file on a RAM disk (VDISK) if you want,
  932.           although  recording  it on  permanent  media provides  a  sort of
  933.           automatic back-up in case of damage to the base data file, as the
  934.           content  of the  two files  is  always identical  except when  an
  935.           update is in active progress.  In the event of a power failure or
  936.           other mechanical  error during  an update, one  of the  two files
  937.  
  938.  
  939.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 13
  940.           _________________________________________________________________
  941.  
  942.           should be  readable, as they are  never both open  for writing at
  943.           the same time.
  944.  
  945.                Several  features give a  choice between printer  and screen
  946.           output.  When  printed output is called for,  the program directs
  947.           it  to  PRN:.  If you have a parallel printer (most common type),
  948.           just turn it on  and be sure it  is connected and ready.   If you
  949.           have a serial printer (typical of daisy wheel type printers), you
  950.           will need to  run the appropriate DOS  commands or OS/2 setup  to
  951.           initialize your serial port and redirect PRN: to COM1: (or COM2:,
  952.           as appropriate) BEFORE running VIDEOCAT.   See your DOS manual or
  953.           printer manual  for details.   VIDEOCAT has no  built-in routines
  954.           for  selecting and  initializing a  serial  printer.   Note: most
  955.           users have a parallel  printer, and all you have to do is be sure
  956.           it is turned on and ready to print.  If your printer is not ready
  957.           or properly connected, any of a number of things will happen: (1)
  958.           you will  get a warning  message either from  the program or  the
  959.           operating system  telling you  that there is  a problem  with the
  960.           printer; (2) the program will hang up; or (3) you will  find that
  961.           output is being sent  into the Twilight Zone.  Also  note that if
  962.           you do not have a  printer, the program will work fine as long as
  963.           you never select printer output.
  964.  
  965.  
  966.                            General Tips on Running VIDEOCAT
  967.                            ________________________________
  968.  
  969.                VIDEOCAT is run by simply entering VIDEOCAT from the prompt.
  970.           This  version adds  a quick-start  option  which can  be used  to
  971.           bypass the  three opening title  and information  screens and  go
  972.           directly to the  main menu.  To  use the quick-start option,  add
  973.           the command  line argument  Q after the  program name,  i.e. type
  974.           VIDEOCAT  Q  and  then hit  return.   The  Q  argument  should be
  975.           separated by one or more spaces from the program name and  can be
  976.           either upper case or lower case (or,  for that matter, can be any
  977.           word  beginning  with an  upper  or  lower  case  letter Q).    I
  978.           recommend that you  not use the quick-start option  until you are
  979.           comfortable with the program and its installation.
  980.  
  981.                The program is  menu-driven.  Each menu option  is described
  982.           in  detail in  this Manual.    Brief descriptions  appear on  the
  983.           screen which may be enough if you  are fairly intuitive and don't
  984.           like reading manuals.  Remember that new data adding, changing or
  985.           deleting records in the  data file will  not be reflected in  the
  986.           disk file until the Update function is invoked.  If you exit from
  987.           the program without updating, all  new data you have entered will
  988.           be lost and the disk data file will remain unchanged.
  989.  
  990.                All items  of input data can be  any  combination of letters
  991.           and numbers.   If  your entry  is  not legal  for the  particular
  992.           response requested, you will be prompted to enter it again.   All
  993.           entries are buffered, meaning that  they are not acted upon until
  994.           you hit the Return  (or Enter) key. Before hitting that  key, you
  995.           can backspace and change your entry.  Leading and trailing blanks
  996.  
  997.  
  998.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 14
  999.           _________________________________________________________________
  1000.  
  1001.           are always ignored; however  blanks between non-blank  characters
  1002.           are treated as significant.   Letters can be upper or lower case.
  1003.           The menus and Search functions ignore  the case of letters.  Thus
  1004.           if a  particular  menu choice  you want  to select  is code  'A',
  1005.           entering either 'A' or 'a' will have the same result.  In the Add
  1006.           function  any item  of requested  data can  be omitted  by simply
  1007.           hitting return.   If, for example, there  is only one actor  in a
  1008.           film, you do not have to enter any additional names when prompted
  1009.           for the second and third actor names.  It is strongly recommended
  1010.           that  you always enter  a title and  year.  These  are the fields
  1011.           that determine  the sequence  of the data  file and  every record
  1012.           must have a unique combination of title and year.
  1013.  
  1014.                It is prudent  to make a  backup copy of  at least the  data
  1015.           file on another diskette.  If your collection  is large, you will
  1016.           spend many hours building your data file.  Physical damage to the
  1017.           disk  or abnormal  termination during an  update could  result in
  1018.           loss of  your entire data file.   If you have a  backup, you will
  1019.           not have to  reconstruct the entire data file but  only the items
  1020.           added since the  last time you made  a backup copy.   BACKUP DATA
  1021.           FILES FREQUENTLY!  If you have  a casualty to your data file  and
  1022.           your work  file, VCATDATA.TMP, is  undamaged, you may be  able to
  1023.           replace the  damaged base file  by simply using the  DOS commands
  1024.           COPY or RENAME to generate a new VCATDATA.DAT.
  1025.  
  1026.                Let me  repeat, for  emphasis,  that your  backup data  file
  1027.           should be on ANOTHER diskette.  If you have a hard drive crash, a
  1028.           backup  file on your  hard drive will  not do you much  good.  If
  1029.           your data file gets to be too large to fit on a diskette, I would
  1030.           recommend that you  use a file compression utility  such as PKZIP
  1031.           or ARC.  
  1032.  
  1033.  
  1034.                                  If You Have Trouble
  1035.                                  ___________________
  1036.  
  1037.  
  1038.                My   experience  with  users  has  convinced  me  that  most
  1039.           questions  can be answered and problems  solved by simply reading
  1040.           and following the Manual carefully.  
  1041.  
  1042.                Next  to failure  to read  and follow  the Manual,  the most
  1043.           common cause of trouble is  a not-so-compatible compatible.  I do
  1044.           not have either the time or the opportunity to test this  program
  1045.           on  every kind  of  clone  produced in  the  garage workshops  of
  1046.           Taiwan.  I have  eliminated all direct calls  to the BIOS,  which
  1047.           should  reduce  compatibility   problems.    The  most     common
  1048.           manifestation of  compatibility problems  is  a messed-up  screen
  1049.           display: either very strange color combinations or characters out
  1050.           of  place.   In  most cases  these  problems do  not  prevent the
  1051.           program  from  being  functional.   Try  using  the configuration
  1052.           routine to force monochrome operation  and see if that cures your
  1053.           problems.
  1054.  
  1055.  
  1056.  
  1057.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 15
  1058.           _________________________________________________________________
  1059.  
  1060.                Another  common  cause   of  trouble  is  lack   of  general
  1061.           familiarity  with computer terminology and operations on the part
  1062.           of  novice users.    If  this is  your  problem,  try inviting  a
  1063.           computer whiz over to dinner and extract a little free tutoring.
  1064.  
  1065.                VIDEOCAT  is rather  memory-intensive and may  conflict with
  1066.           other programs which  stay resident in memory.   See the  note on
  1067.           known system incompatibilities above.
  1068.  
  1069.                Some user problems do indeed uncover bugs in the program.  I
  1070.           encourage you to  report suspected  bugs with  a fairly  complete
  1071.           description  of the  problem, the  circumstances  under which  it
  1072.           occurs,  and relevant information  about the computer  system you
  1073.           are  running it on.  If you  discover a bug due to my programming
  1074.           error, I will fix it as soon as possible.
  1075.  
  1076.                You can send questions, complaints, comments and suggestions
  1077.           by  regular  mail to the address given above.   It may be helpful
  1078.           to give me your phone number, because sometimes I have difficulty
  1079.           understanding the problem  description and  a phone  call is  the
  1080.           simplest way  to clear up  the confusion.   I  apologize for  not
  1081.           providing  my  phone  number,  but  I  have  learned  from  other
  1082.           shareware authors that  users in distant places  sometimes forget
  1083.           about time zone differences and  call at the most peculiar times.
  1084.           If you are a Compuserve subscriber, you can send E-mail to  me at
  1085.           account  number    71571,1234.   Users  who  provide PARTICULARLY
  1086.           VALUABLE bug reports or suggestions for improvement MAY be placed
  1087.           on  my subscriber  list even  if they  made no  voluntary royalty
  1088.           contribution payment.  That  is the only reward  for contributing
  1089.           ideas.
  1090.  
  1091.  
  1092.                                      Source Code
  1093.                                      ___________
  1094.  
  1095.  
  1096.                Registered  users will  be  provided  with  the  complete  C
  1097.           language  source  code for  the  current version  of  VIDEOCAT on
  1098.           request.  Previously I uploaded some earlier versions on bulletin
  1099.           boards.  More recently I have  decided that access to the  source
  1100.           code should  be one of the  privileges of registered users,  so I
  1101.           will not be making  the source code available by any  means other
  1102.           than diskette in response to a registered user request.  
  1103.  
  1104.                Version  7.1 calls  OS/2  functions, so  at  the moment  the
  1105.           Microsoft C Compiler,   Version 6.0, is the only compiler which I
  1106.           am sure can  handle it.  You can successfully  compile under DOS,
  1107.           provided  that you have  installed the protected  mode libraries;
  1108.           however you will achieve better optimization if you compile under
  1109.           OS/2.   There  are some  other OS/2 C  compilers coming  onto the
  1110.           market, but I have not tested  any other than Microsoft.  If  you
  1111.           are a programmer but use a  different compiler or are not running
  1112.           OS/2,  you might want to send me  a note that you want the source
  1113.           code for  VIDEOCAT  Version   5.0;  that version  was written  to
  1114.  
  1115.  
  1116.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 16
  1117.           _________________________________________________________________
  1118.  
  1119.           compile successfully under  either Microsoft C, Borland  Turbo C,
  1120.           or Computer Innovations C86PLUS.
  1121.  
  1122.                The source  code is extensively  commented.  I have  gone to
  1123.           great lengths to  use mnemonic data names and  make program logic
  1124.           clear.   Version 7.1  has very extensive  changes in  source code
  1125.           from Version 7.0 - far more extensive that one would suspect from
  1126.           simply observing program operation.
  1127.  
  1128.                Users who are not programmers  will not find the source code
  1129.           useful.
  1130.  
  1131.  
  1132.                                  Development History
  1133.                                  ___________________
  1134.  
  1135.  
  1136.                I first wrote VIDEOCAT  to catalog my own video  collection.
  1137.           Friends started asking  me for copies, so  I spruced it up  a bit
  1138.           and started distributing it as shareware.
  1139.  
  1140.                Versions 1 and  2 were written in UCSD  Pascal for the Apple
  1141.           II series of computers.  Versions 3  and 4 were written in C  and
  1142.           complied with the  Computer Innovations C86 compiler  for the IBM
  1143.           PC  family  of computers.    Version  4.0  was  the first  to  be
  1144.           published.    Version 4.1  quickly  followed to  correct  a user-
  1145.           reported bug.   Version 4.2 added support for  multiple drives to
  1146.           permit the creation  of larger data files and  also added printed
  1147.           output options.
  1148.  
  1149.                Version   5.0  added  support  for  paths  and  the  current
  1150.           configuration routine.   It was  also developed so as  to compile
  1151.           successfully  under three  widely  used  compilers: Microsoft  C;
  1152.           Borland Turbo C;  and Computer Innovations C86PLUS.    Because of
  1153.           differences  in the  way  that  these  compilers  implement  data
  1154.           structures, the  only way to  get all three to  produce identical
  1155.           data   files was  to change the  record structure to  fit on even
  1156.           word boundaries.  This necessitated a file conversion routine for
  1157.           data  files created  under the Version 4.x series.   Versions 5.1
  1158.           and  5.2 incorporated  a  number  of  convenience  and  aesthetic
  1159.           changes.
  1160.  
  1161.                There  were  two  major  changes  in  Version   6.0.    Most
  1162.           significantly,  it was  developed  under  OS/2  as a  "bound"  or
  1163.           "family" program.  It should run under either DOS or OS/2 without
  1164.           any apparent  difference.  The  second major change was  adding a
  1165.           label making facility.
  1166.  
  1167.                There  were  several   interim  6.x   versions  which   were
  1168.           distributed for "Beta" testing only.
  1169.  
  1170.                Version 7.0 made a number of additions to the record format,
  1171.           including  a free-form  comment field, enabled  the use  of lower
  1172.           case  letters,  added  new   display  and  printer  configuration
  1173.  
  1174.  
  1175.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 17
  1176.           _________________________________________________________________
  1177.  
  1178.           options, added  new output options  for video and  printer output
  1179.           (including   support   for   labels    specially   designed   for
  1180.           videocassettes), permitted  search by  multiple search  keys, and
  1181.           made a  number  of cosmetic  improvements,  as well  as  numerous
  1182.           programming changes not visible to the user.
  1183.  
  1184.                Reports  from  Beta   testers  of  Version  7.0   showed  an
  1185.           interesting  change   from  prior   correspondence:  instead   of
  1186.           suggesting  new features to  be added, most  suggested relatively
  1187.           minor adjustments  to make  existing features  smoother and  more
  1188.           convenient.   Some even complained  that the program now  has too
  1189.           many features!
  1190.  
  1191.                Version 7.01 was an interim release implementing a number of
  1192.           user suggestions,  including  correction  of  some  typographical
  1193.           errors, making  the initial  formfeed optional  for some  printed
  1194.           reports, adding a search by  cassette number option to the Search
  1195.           function,  and adding  a  printed  output  option  to  the  Tally
  1196.           Statistics  function.   Version  7.01  was  also  compiled  under
  1197.           Microsoft C, Version 6.0, with increased code optimization.
  1198.  
  1199.                Version 7.02 was another interim release which added options
  1200.           for sorting output in the  Whole Catalog function so that catalog
  1201.           lists could be  produced in title sequence,  location sequence or
  1202.           year sequence.  Version 7.02 also involved very extensive changes
  1203.           in the internal coding of the program which would not be apparent
  1204.           to the  user but  should improve performance  and reduce  risk of
  1205.           error.
  1206.  
  1207.                Version  7.03 (another interim  release) added a  new custom
  1208.           configuration option for  the Add function to omit  prompting for
  1209.           record  fields which  the  user does  not  desire to  fill.   The
  1210.           algorithm for translating block capital names to a normal mixture
  1211.           of upper and  lower case letters was improved  to recognize Roman
  1212.           numerals.  Data entry functions were improved to correct an error
  1213.           in handling names which include commas.
  1214.  
  1215.                Version 7.04 (another interim release) corrected a number of
  1216.           minor errors in the label printing routines and added support for
  1217.           laser printer file folder labels.   There were some minor changes
  1218.           in format for some of the label types already supported.  
  1219.  
  1220.                Version 7.05 (another interim release) added support for the
  1221.           United Ad Label  VHS label format for laser  printers, cleaned up
  1222.           some printed format options in the Tally Statistics function, and
  1223.           provided  an option  to produce  statistical  reports with  items
  1224.           listed in either alphabetical or frequency sequence.
  1225.  
  1226.                Version 7.1  incorporated the  changes made  in the  interim
  1227.           releases with  corrections of a  number of bugs reported  by Beta
  1228.           testers.
  1229.  
  1230.                Future changes  will probably involve acting on  a number of
  1231.           user suggestions  that I  just haven't gotten  around to.   Other
  1232.  
  1233.  
  1234.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 18
  1235.           _________________________________________________________________
  1236.  
  1237.           possible  enhancements might be mouse support, a Windows version,
  1238.           or a Presentation Manager version.
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 19
  1294.           _________________________________________________________________
  1295.  
  1296.  
  1297.                                 FUNCTION DESCRIPTIONS
  1298.  
  1299.  
  1300.                            A - Add a record to the catalog
  1301.                            _______________________________
  1302.  
  1303.  
  1304.                This  is the  basic  function  for adding  a  record to  the
  1305.           catalog.  It can be a video item other than a motion picture, but
  1306.           in general the formats used in this program are primarily adapted
  1307.           to theatrical motion pictures.   Note that records created by the
  1308.           Add  function are temporarily  stored in memory  and not actually
  1309.           placed in the data file until the Update function is performed.
  1310.  
  1311.                The Add function is invoked by entering A <cr> while you are
  1312.           in the main menu. [note: either 'A' or 'a' can be entered; '<cr>'
  1313.           indicates a  carriage return, a  key which may be  labeled either
  1314.           "Return" or "Enter" on your  computer]  The initial response will
  1315.           be a message telling you  to get ready to enter data  for a movie
  1316.           record  and to  hit <cr> when  you are  ready to continue.   Then
  1317.           various  items of data  will be requested.   If there  are fields
  1318.           which you do not wish to use and would like  to have omitted from
  1319.           the  Add function,  see  the  description  of  the  Configuration
  1320.           functions.
  1321.  
  1322.  
  1323.           Title ->
  1324.           ________
  1325.  
  1326.                Enter the title  of the movie  or other  item.  The  maximum
  1327.           size  is 40 characters; the program  will not permit you to enter
  1328.           more.  It is suggested  that the words "A", "An" or  "The" at the
  1329.           beginning of a title be appended to the rear after a comma.   For
  1330.           example, instead  of entering  "THE  BRIDGE ON  THE RIVER  KWAI",
  1331.           enter  "BRIDGE  ON  THE  RIVER   KWAI,  THE".    This  keeps  the
  1332.           alphabetical sequence a little more meaningful. For an episode in
  1333.           a series, it is suggested that the series title be entered first,
  1334.           then the episode title.   For example: "STAR   TREK: GAMESTERS OF
  1335.           TRISKELION" and "STAR TREK: SPOCK'S BRAIN".
  1336.  
  1337.                Note  that  since the  program  sorts  the titles  in  ASCII
  1338.           (American  Standard Code  for Information  Interchange) sequence,
  1339.           titles   beginning with  punctuation marks or  numeric characters
  1340.           will come  before titles beginning with  alphabetical characters.
  1341.           Thus the movie "1941"  will be placed near  the beginning of  the
  1342.           catalog before titles  beginning with letters and not  in the N's
  1343.           as is common in the organization of published movie guides.
  1344.  
  1345.                The title is  a semi-mandatory entry.  More  than one record
  1346.           can  have the  same title  (thus allowing  for remakes),  but the
  1347.           program will not  permit two records to have both  the exact same
  1348.           title and year of  release.  Minor variations in the  title field
  1349.           will allow cataloging of several versions of the same  film.  For
  1350.  
  1351.  
  1352.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 20
  1353.           _________________________________________________________________
  1354.  
  1355.           example:  "TOPPER"  and  "TOPPER [COLORIZED]";  "A  STAR  IS BORN
  1356.           [EDITED  FOR TV]"  and "A  STAR IS  BORN [UNCUT]";  "CITIZEN KANE
  1357.           [COPY 1]" and "CITIZEN KANE [COPY   2]"; etc..  Likewise you  can
  1358.           indicate when a title continues over more than one cassette, e.g.
  1359.           "GONE WITH THE WIND [PART 1]" and "GONE WITH THE WIND [PART 2]".
  1360.  
  1361.                The title field can also be used to keep track of blank tape
  1362.           segments.  For example, if  you decide that "PORKY'S" isn't worth
  1363.           keeping, just use  the Change function to change  the title field
  1364.           to  read "BLANK  - 94  MINUTES".   You  can then  use  the Search
  1365.           function to find all listings which have the word "BLANK" as part
  1366.           of the title field, then  use Change again when something  new is
  1367.           recorded in the same space.
  1368.  
  1369.  
  1370.           Year ->
  1371.           _______
  1372.  
  1373.                Year is intended to be the  year of release of a production,
  1374.           normally expressed as 4 numeric digits, e.g. "1939".  The program
  1375.           treats  the year  as  a 4-byte  character string,  so non-numeric
  1376.           characters will not be rejected. 
  1377.  
  1378.                Year is also  a semi-mandatory entry, as  the combination of
  1379.           title and year constitutes the "key" for  identifying and sorting
  1380.           records.  If you don't know the year for sure, either look  it up
  1381.           in a published  movie guide or make a reasonable guess.  You must
  1382.           enter something.
  1383.  
  1384.  
  1385.           Star 1 LAST name ->
  1386.           ___________________
  1387.  
  1388.                The program  allows for recording  the names of up  to three
  1389.           actors and one director.  The first prompt asks for the LAST name
  1390.           of the first of the three actors.  The maximum combined length of
  1391.           the first and last names is 30 characters; any excess length will
  1392.           be truncated from the  first name.  In response to  the LAST name
  1393.           prompt,  enter  the  actor's last  name,  including  prefixes and
  1394.           suffixes which are  properly part of the last name.  For example:
  1395.           "VON STROHEIM"  and "FAIRBANKS, JR.".   In that last  example the
  1396.           program will  replace the  comma and space  with a  single space,
  1397.           turning it into  "FAIRBANKS JR.".  This is  necessary because the
  1398.           comma character  is the delimiter which separates  first and last
  1399.           names in  the way  the name  is stored  by the  program.   Comma-
  1400.           deletion  was added  in Version  7.03; if  you have  a  data file
  1401.           created under a  prior version you may find that  any names which
  1402.           included commas  are somewhat  garbled.  You  can use  the Change
  1403.           procedure to clean them up.
  1404.  
  1405.                Try to be  consistent in the way you enter names.  Different
  1406.           spellings will be treated as different names.
  1407.  
  1408.  
  1409.  
  1410.  
  1411.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 21
  1412.           _________________________________________________________________
  1413.  
  1414.                Note that  you could use the name fields to enter some other
  1415.           type of descriptive data  which is meaningful to  you.  One  user
  1416.           who catalogs  educational material uses  the name fields  for the
  1417.           names  of courses in  which the  tape is  used rather  than actor
  1418.           names.   The  addition of the  comment filed  in Version  7.0 and
  1419.           later is intended to make it unnecessary in the future to bootleg
  1420.           comments in the name fields. 
  1421.  
  1422.  
  1423.           Star 1 FIRST name ->
  1424.           ____________________
  1425.  
  1426.                Now   enter  the  first  name.    For  example,  "ERIC"  and
  1427.           "DOUGLAS".    If middle  names  or initials  are  important, they
  1428.           should be appended to the FIRST name.   For example: "LESLIE ANN"
  1429.           and "GEORGE C.".
  1430.  
  1431.  
  1432.                Star 2 LAST name ->
  1433.                Star 2 FIRST name ->
  1434.                Star 3 LAST name ->
  1435.                Star 3 FIRST name ->
  1436.                Director LAST name ->
  1437.                Director FIRST name ->
  1438.                ______________________
  1439.  
  1440.                Respond to these  in the same manner described  above.  Note
  1441.           that  these entries are all optional and can be omitted by simply
  1442.           hitting <cr>.
  1443.  
  1444.  
  1445.                Subject Code ->
  1446.                _______________
  1447.  
  1448.                A list  of character  codes corresponding  to 42  enumerated
  1449.           subject categories will be displayed on the screen.  Pick the one
  1450.           which seems most  appropriate and enter the  corresponding single
  1451.           character.  If you enter an illegal code, the query  will recycle
  1452.           until  you enter  a legal code.   This  is an optional  entry, so
  1453.           simply hitting return without having  entered any code is a legal
  1454.           response, and the record simply will not have a subject code.  If
  1455.           you don't like the selection of subject descriptions, you can use
  1456.           one  of the  configuration routines  to  change them,  but do  so
  1457.           cautiously.
  1458.  
  1459.  
  1460.                Form Code ->
  1461.                ____________
  1462.  
  1463.                A list  of character  codes corresponding  to 24  enumerated
  1464.           form descriptions  will be  displayed on the  screen.  As  in the
  1465.           case of subject code, you must enter a legal code or  the request
  1466.           will  recycle.  It is also an  optional entry and you can skip it
  1467.  
  1468.  
  1469.  
  1470.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 22
  1471.           _________________________________________________________________
  1472.  
  1473.           by simply hitting <cr> with no code entered.  You can also custom
  1474.           configure the form descriptions.
  1475.  
  1476.  
  1477.                MPAA Code ->
  1478.                ____________
  1479.  
  1480.                A  list  of  character   codes  representing  the   audience
  1481.           suitability  ratings of the Motion Picture Association of America
  1482.           will be displayed.  Once again, selection of an illegal code will
  1483.           cause  the menu  to recycle,  but skipping  this entry  by simply
  1484.           hitting <cr> is permitted.
  1485.  
  1486.  
  1487.                Rating Code ->
  1488.                ______________
  1489.  
  1490.                A list of character codes will be displayed corresponding to
  1491.           8  enumerated rating  descriptions.   The  rating  system is  one
  1492.           commonly used in movie guides  and TV schedule listings.  Whether
  1493.           you  rate a  movie  based on  your  personal opinion  or that  of
  1494.           professional critics is up to you.  This entry is optional.
  1495.  
  1496.  
  1497.                Color Code ->
  1498.                _____________
  1499.  
  1500.                A list of character codes  corresponding to 4 types of color
  1501.           characteristics will be displayed.  You can pick one or skip this
  1502.           item by simply hitting return without a code.
  1503.  
  1504.  
  1505.                Format Code ->
  1506.                ______________
  1507.  
  1508.                A list of character codes  corresponding to 14 types of film
  1509.           and video  formats.  You can pick one or skip this item by simply
  1510.           hitting return without a code.
  1511.  
  1512.  
  1513.                Minutes Length ->
  1514.                _________________
  1515.  
  1516.                This entry may  be up to  3 characters long  and may be  any
  1517.           combination  of numbers and  letters, although it  is recommended
  1518.           that the characters be numeric  and represent the running time in
  1519.           number of minutes.
  1520.  
  1521.  
  1522.                Cassette No. ->
  1523.                _______________
  1524.  
  1525.                This entry may  be up to  4 characters long  and may be  any
  1526.           combination of numbers  and letters.  It is  recommended that you
  1527.  
  1528.  
  1529.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 23
  1530.           _________________________________________________________________
  1531.  
  1532.           use numeric  characters only.  It can be omitted, although in the
  1533.           cataloging of a  large collection this is the  most useful single
  1534.           piece of information.   So far only one user  has complained that
  1535.           this is not a  large enough field.   Perhaps  some day there will
  1536.           be a  more  powerful  version of  this  program  for  collections
  1537.           exceeding 9999 cassettes.  If you include non-numeric characters,
  1538.           you may cause unintended effects on range selection aspect of the
  1539.           label printing utility.
  1540.  
  1541.  
  1542.                Index No. ->
  1543.                ____________
  1544.  
  1545.                This entry  may  also  be any  combination  of  letters  and
  1546.           numbers up to 4 characters in length.  It is recommended that you
  1547.           use numeric  characters only.  If you  have multiple items on the
  1548.           same cassette you may either place the tape counter number or the
  1549.           sequence number.   By  sequence number, I  mean coding  the first
  1550.           movie "1", the second "2", and so on.  Fanatics may prefer to use
  1551.           tape counter  numbers.   This entry is  optional, but  I strongly
  1552.           recommend that  you use it.   When the  Label  function  prints a
  1553.           label for a cassette it will print multiple items in Index Number
  1554.           sequence.  Using non-numeric characters in this field may produce
  1555.           unintended effects on the sorting sequence for label printing.
  1556.  
  1557.  
  1558.                Comment Lines
  1559.                _____________
  1560.  
  1561.                The program will next display  a small text editor window in
  1562.           which  you  can  write  free-form  comments  in  3  lines  of  60
  1563.           characters  each.  The cursor can  be moved using the arrow keys,
  1564.           Home, End, and  the Enter/Return key.  Text  can be deleted using
  1565.           the Delete  or Backspace keys.   Text entry is  in typeover mode.
  1566.           Hit  the  Esc key  when finished.    NOTE: if  you find  that the
  1567.           operation of the backspace or  delete keys does not seem correct,
  1568.           avoid using  these keys.   I  have occasionally  encountered some
  1569.           transient bugs  in the operation  of this edit window  which have
  1570.           defied explanation but do not seem particularly harmful.
  1571.  
  1572.                This field can be used to  store any other data (e.g. Oscars
  1573.           and  other  awards)  or  a  short  plot  summary,  or  any  other
  1574.           information you  might want to  file with the record.   Since you
  1575.           can  search your  data  file  for  information contained  in  the
  1576.           comment lines,  this is an  easy way to  add new kinds  of search
  1577.           keys, such as  names of script writers,  musical score composers,
  1578.           production studios, etc.
  1579.  
  1580.  
  1581.                Verification
  1582.                ____________
  1583.  
  1584.                After all the items of  data have been entered, the complete
  1585.           record will  be displayed  on the screen  for verification.   You
  1586.  
  1587.  
  1588.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 24
  1589.           _________________________________________________________________
  1590.  
  1591.           will have three  action options: accept the record  as is; change
  1592.           the  record  (in which  case you  will  see a  display  like that
  1593.           discussed below under the Change function); or discard the record
  1594.           without attempting to change it.  Note that if you have  used the
  1595.           add-fields  feature  of  the   Configuration  function  to  block
  1596.           prompting  for some fields, you  can choose to  fill them at this
  1597.           stage.
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 25
  1648.           _________________________________________________________________
  1649.  
  1650.  
  1651.  
  1652.                           C - Change a record in the catalog
  1653.                           __________________________________
  1654.  
  1655.  
  1656.                The purpose  of the  Change function is  to change  the data
  1657.           recorded for a  record already in the  catalog.  Any item  can be
  1658.           changed.  To  invoke Change, enter C <ret> when in the main menu.
  1659.           You will be asked to enter the title and year of the record to be
  1660.           changed and warned  that unless  they exactly  match an  existing
  1661.           record the change procedure will be aborted.
  1662.  
  1663.                After you have  entered the title and year of  the record to
  1664.           be changed, the program searches for it and displays it if found.
  1665.           You will be  prompted to indicate  which data field  you want  to
  1666.           change.  Items which are currently empty can also be filled in at
  1667.           this time.   After selecting an item  and entering a  change, the
  1668.           record will  be redisplayed  with changes.   You can  continue to
  1669.           make additional  changes to the  same record until you  enter the
  1670.           code indicating that you are finished making changes.
  1671.  
  1672.                Note that the Change function searches the base file and not
  1673.           pending transactions for a record  to be changed. Thus you cannot
  1674.           change a record  which you have just  entered as an add  but have
  1675.           not  yet processed to  the base file through  an Update.  Changes
  1676.           are not effected in  the base file until after an update.  If you
  1677.           Exit before Updating, your changes will be lost.
  1678.  
  1679.                Note  also that the  Change function actually  generates two
  1680.           transactions: a delete transaction for the existing record and an
  1681.           add transaction  for  the  changed version.    This  will  become
  1682.           visible to you if you use the Review function to inspect  pending
  1683.           transactions.
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 26
  1707.           _________________________________________________________________
  1708.  
  1709.  
  1710.  
  1711.                          D - Delete a record from the catalog
  1712.                          ____________________________________
  1713.  
  1714.  
  1715.                The purpose  of this procedure  is to delete a  record which
  1716.           already exists in  the catalog disk file.   It will not  delete a
  1717.           record  which is  merely in  the current  work batch  awaiting an
  1718.           update.
  1719.  
  1720.                To invoke delete,  enter D <ret> when in the main menu.  You
  1721.           will be  warned that  you must  enter the  title and  year of  an
  1722.           existing  record; if  there is  not  an exact  match, the  delete
  1723.           transaction  will be  discarded.   Note  that the  match must  be
  1724.           EXACT, character for character (including all embedded spaces and
  1725.           punctuation).   These data items  are entered in  the same way as
  1726.           described under  the section on  the add procedure.   The program
  1727.           will search for a matching record and display it if found and ask
  1728.           you to confirm that this is the record you wish to delete.
  1729.  
  1730.                The  Delete function  was deliberately  designed  to require
  1731.           that you enter a title  and year which exactly match  an existing
  1732.           record in  order to  minimize the  risk of  accidental deletions.
  1733.           Its exacting  nature can be a  bit annoying when minor  errors in
  1734.           data entry  prevent you  from getting the  desired action.   When
  1735.           this happens, use  the Search function  to get a  display of  the
  1736.           record  in question and make  careful note of  the title and year
  1737.           you will have to enter in the Delete function.
  1738.  
  1739.                Deletes,  like   adds  and  changes,  are   not  effectuated
  1740.           immediately but  are stored  in RAM until  you invoke  the update
  1741.           function.  If you exit without updating, the transactions will be
  1742.           lost and the disk file unchanged.
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 27
  1766.           _________________________________________________________________
  1767.  
  1768.  
  1769.  
  1770.                        F - File Conversion from Prior Versions
  1771.                        _______________________________________
  1772.  
  1773.                A data file  (named BASEFIL5.DAT) which was  created under a
  1774.           version of  VIDEOCAT in  the 5.x  series or  6.x  series must  be
  1775.           converted to a new format before it  can be used with Version 7.0
  1776.           of the program.  There was  no change in format from the  Version
  1777.           5.x series to Version 6.x.  If you have a data file created under
  1778.           Version  4.x  (named BASEFILE.DAT),  you will  need to  first use
  1779.           Version 5.x or  6.x to convert to  the file format used  in those
  1780.           versions (BASEFIL5.DAT), then  use Version 7.0 to convert  to the
  1781.           latest format (VCATDATA.DAT).  If  you have never used a previous
  1782.           version of VIDEOCAT, you do  not need to be concerned about  file
  1783.           conversion at all.
  1784.  
  1785.                If you have a data file created under Version 5.x or 6.x, it
  1786.           is  named  BASEFIL5.DAT.     It  must  be   accessible  for  file
  1787.           conversion, but need  not be  on the  same drive or  path as  the
  1788.           program.   Enter  F  <ret> from  the  main  menu and  follow  the
  1789.           instructions displayed.  Your old file will not be changed, but a
  1790.           new version  in the  new format  will be created  under the  name
  1791.           VCATDATA.DAT.   Because the record  format has been  made larger,
  1792.           your new data file will be larger than your old one,  even though
  1793.           the new data  fields will be  empty until you  change them.   You
  1794.           should make sure  that you have  free disk space available  for a
  1795.           new data file about twice the size of your old one.
  1796.  
  1797.                If your old BASEFIL5.DAT is in a different subdirectory than
  1798.           the one which you have designated for the base data file  in your
  1799.           current configuration, then you will have to know the path to the
  1800.           old file so  you can enter it  when prompted.  Let's  assume that
  1801.           you installed Videocat Version 6.0, including the data file, in a
  1802.           subdirectory  on  your C  drive  called  VCAT6  and now  you  are
  1803.           installing Version 7.0 in a  new subdirectory called VCAT7.  When
  1804.           you are prompted to enter the correct path for the OLD  data base
  1805.           file, you would enter C:\VCAT6.
  1806.  
  1807.                Note that you only need to perform file conversion once.  It
  1808.           is suggested that  you keep a copy  of the old BASEFIL5.DAT  as a
  1809.           backup just in case of some problem, but all future additions and
  1810.           changes should  be made to  VCATDATA.DAT.  No provision  has been
  1811.           made for conversion  from the new format  back to the old,  as it
  1812.           would seem to serve no useful purpose.
  1813.  
  1814.                File conversion is  a nuisance,  but is  necessary when  the
  1815.           record  size is changed.   A few bytes of  the space I added this
  1816.           time has  been reserved for future use, so  it may be possible to
  1817.           avoid another file conversion in the next upgrade.
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 28
  1825.           _________________________________________________________________
  1826.  
  1827.  
  1828.  
  1829.                               G - Configuration Changes
  1830.                               _________________________
  1831.  
  1832.  
  1833.                This is a collection of new features added in Version 7.0 to
  1834.           respond to  users who  wanted  more options  to custom  configure
  1835.           VIDEOCAT for their needs
  1836.  
  1837.                Add-Fields
  1838.                __________
  1839.  
  1840.                This feature permits  you to specify the fields  you will be
  1841.           automatically prompted to  fill every time you Add  a new record.
  1842.           The initial default  setting calls for every field  in the record
  1843.           to  be prompted during an add (although you can simply hit return
  1844.           to  go on  to the next  field without  entering any data).   This
  1845.           feature  enables you  to  select which  fields  will be  prompted
  1846.           during an add so  that you will not be bothered  with prompts for
  1847.           fields you never use.  Note that even though you are not prompted
  1848.           for a field you set to N, it is still accessible during the final
  1849.           edit  phase  of   an  Add  transaction  and  through  the  Change
  1850.           procedure, so you  may also wish to turn  off automatic prompting
  1851.           for fields you  seldom use and fill them when  appropriate by one
  1852.           of the other methods.
  1853.  
  1854.                When you  invoke this feature,  all of the fields  and their
  1855.           current settings (Y or  N) will be displayed.  The  menu lets you
  1856.           select  any  field  to  change  its  value.    Enter  the  letter
  1857.           identifying the field  on the menu and  you will be prompted  for
  1858.           the new value.  Enter Y or N.  When you are done, hit the Esc key
  1859.           instead of a field letter.  Your choices  will be saved in a file
  1860.           named "VCATADDF.CFG".  When you run the program in the future, it
  1861.           will check for the presence of this file and use the values saved
  1862.           in it.   If you  erase this file,  the original defaults  will be
  1863.           restored.
  1864.  
  1865.                Note  that the Update procedure will not add a record to the
  1866.           data file which duplicates both the title and year of an existing
  1867.           record.  Thus, if you choose  not to use the year field,  you had
  1868.           better  be sure all your titles are unique.  If you don't use the
  1869.           title  fields, you had better be  sure all your years are unique.
  1870.           If you don't  use either the title  or the year field,  your data
  1871.           file will be limited to exactly one record.  If you set the title
  1872.           field to N, you will get a warning message advising you that this
  1873.           is not recommended (but you can do it if that is what you  really
  1874.           want).
  1875.  
  1876.                This  feature  was  added  to  appease  that  contingent  of
  1877.           VIDEOCAT  users who  have been  complaining that  the program  is
  1878.           getting cluttered with too many features they do not want to use.
  1879.           At the same time it does not  reduce functionality for that other
  1880.  
  1881.  
  1882.  
  1883.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 29
  1884.           _________________________________________________________________
  1885.  
  1886.           contingent of VIDEOCAT  users who are constantly  clamoring for a
  1887.           more complex record structure.
  1888.  
  1889.  
  1890.                Color/Mono Display
  1891.                __________________
  1892.  
  1893.                A few  users have had problems with  readability of displays
  1894.           because of the  color rendition on  their systems.   If you  have
  1895.           this problem, chances  are you would be better  off with VIDEOCAT
  1896.           operating in a monochrome mode.  This choice on the configuration
  1897.           menu allows  you to do that.  If you choose monochrome operation,
  1898.           a file will  be created to save  this choice so that  the program
  1899.           will automatically  start in that  mode in  the future.   You can
  1900.           change back and forth as many times as you wish.
  1901.  
  1902.                You can  also use  the monochrome option  if you  just plain
  1903.           don't like the color combinations  I have selected.  Perhaps some
  1904.           future version  will let you  selected any combination  of colors
  1905.           you like, but for the time being  your only choice is between the
  1906.           colors I chose and no colors at all.
  1907.  
  1908.                Form Descriptions
  1909.                _________________
  1910.  
  1911.                Subject Descriptions
  1912.                ____________________
  1913.  
  1914.                These two options permit you to re-define the subject and/or
  1915.           form descriptions  which are used  in the program.   Although the
  1916.           descriptions written into the program ar adequate for collections
  1917.           composed  of a variety of  theatrical motion pictures, some users
  1918.           have very specialized collections  (educational, adult, etc.) and
  1919.           would like  to change the set of subject and form descriptions to
  1920.           permit a more detailed classification scheme particularly adapted
  1921.           to their material.  
  1922.  
  1923.                These changes  are recorded  in configuration  files created
  1924.           when you use this option.  I caution you to plan carefully before
  1925.           using this feature, as frequent  changes in subject and form code
  1926.           definitions may introduce  hopeless confusion in your  data file.
  1927.           If you play with this feature and then decide that you would like
  1928.           to  go back  to the  original definitions,  just erase  the files
  1929.           VCFORMS.CFG and VCSUBJS.CFG and things will go back to normal.
  1930.  
  1931.  
  1932.                Disk Paths for Files
  1933.                ____________________
  1934.  
  1935.                The  first time  you run  VIDEOCAT (other  than in  the demo
  1936.           mode)  you will  be automatically  asked if  you want  to specify
  1937.           paths for your data and work files.  Once these paths  are stored
  1938.           in a configuration  file, VIDEOCAT  will not  ask you  to set  or
  1939.           change them  unless the  configuration file  cannot  be found  or
  1940.  
  1941.  
  1942.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 30
  1943.           _________________________________________________________________
  1944.  
  1945.           contains   invalid  path  information.     This  option   in  the
  1946.           Configuration Menu allows you  to change the paths  specified for
  1947.           your data and work files.   Before running the program you should
  1948.           make sure that  you have created any new  subdirectories you plan
  1949.           to use and  have copied the  appropriate files to  the paths  you
  1950.           intend to specify.
  1951.  
  1952.                The  program  is intended  to  give you  the  opportunity to
  1953.           correct errors  in path  specification from  within the  program.
  1954.           If, however, things seem to have become hopelessly messed up, you
  1955.           can return to  the initial  installation routine  by erasing  the
  1956.           file VIDEOCAT.CFG and starting the program again.
  1957.  
  1958.                Note  that if  you have  installed the  program or  its data
  1959.           files on  removable media (floppy  disk or removable  hard drive)
  1960.           and change the  slot in which  the media is  inserted, the  drive
  1961.           identifier  may change,  causing  your  previously verified  path
  1962.           configuration to become invalid and confuse the program.  
  1963.  
  1964.  
  1965.                Printer Configuration
  1966.                _____________________
  1967.  
  1968.                This option  allows you to  specify control sequences  to be
  1969.           sent to your printer and the beginning of a print job, at the end
  1970.           of a print  job, to turn emphasized  printing on and off,  and to
  1971.           select a special  print mode for label printing.  If you use this
  1972.           option,  these codes  will be  sent to  your printer  during each
  1973.           print  job  and the  titles  in  printed  output will  appear  in
  1974.           emphasized type; labels will be printed in whatever mode you have
  1975.           chosen (e.g., condensed print).
  1976.  
  1977.                For HP-compatible laser printers,  the control sequences you
  1978.           enter will be used in printing Search and Whole Catalog listings;
  1979.           for labels,  however, type style is completely  controlled by the
  1980.           program and  will not  be altered  by  the printer  configuration
  1981.           option.
  1982.  
  1983.                In order to use this option  you will have to dig into  your
  1984.           printer  manual (or possibly  a technical reference  manual which
  1985.           must be ordered  separately) to find  out what control  sequences
  1986.           can be  used for special  effects on your  printer.  You  will be
  1987.           asked  to enter  those  codes  in decimal  ASCII  values by  this
  1988.           configuration option.  The form of the  codes you enter must be a
  1989.           series  of DECIMAL  NUMBERS separated  by spaces.   Do  not enter
  1990.           hexadecimal numbers!  If your  printer manual lists these control
  1991.           sequences  in non-numeric  form (e.g.  "Esc E")  you must  use an
  1992.           ASCII  conversion  table  (which  seems  to  be  an  appendix  in
  1993.           virtually  every computer programming book) to convert to decimal
  1994.           ASCII numbers (e.g. "Esc  E" = 27  69).  If  you have a  Hewlett-
  1995.           Packard LaserJet, note that when Hewlett-Packard  Printer Control
  1996.           Language calls for  a number to be inserted in  a command string,
  1997.           it  is the  ASCII character  representation of  the number.   For
  1998.           example, a  pitch value  of "16.66" characters  per inch  has the
  1999.  
  2000.  
  2001.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 31
  2002.           _________________________________________________________________
  2003.  
  2004.           ASCII representation  49 54 46  54 54.  Multiple  control strings
  2005.           can  usually be concatenated; you printer will probably recognize
  2006.           that each Escape character (ASCII  27) signals the beginning of a
  2007.           new command.
  2008.  
  2009.                I  know it would be  more convenient for  you if the program
  2010.           provided you with a menu of different printers and you could just
  2011.           select yours, but I simply don't  have the resources to acquire a
  2012.           couple of  hundred different  makes and  models  of printers  and
  2013.           figure out how to adapt this program for each of them.  
  2014.  
  2015.                If none of this makes any sense to you, don't try to use the
  2016.           printer  configuration option;  just use  your  printer in  plain
  2017.           vanilla mode or  invoke special features through  switch settings
  2018.           rather than software control.
  2019.  
  2020.                If  you run  the  printer  configuration  routine  and  then
  2021.           experience  strange printer behavior and wish you hadn't tinkered
  2022.           with this option, you can  simply erase the file VCATPRNT.CFG and
  2023.           reset your printer  to its normal  state to get  back to the  way
  2024.           things were originally.
  2025.  
  2026.                If you use  more than one printer, you  can install multiple
  2027.           copies of VIDEOCAT.EXE  in different subdirectories and  create a
  2028.           different printer configuration files for each.
  2029.  
  2030.                System Information
  2031.                __________________
  2032.  
  2033.                This feature enables you to  view a lot of information about
  2034.           your  computer's hardware and operating system configuration.  It
  2035.           provides information only.
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 32
  2061.           _________________________________________________________________
  2062.  
  2063.  
  2064.  
  2065.                                    L - Label Maker
  2066.                                    _______________
  2067.  
  2068.                The label maker is invoked by entering L <ret> from the main
  2069.           menu.    You will  be  asked  to enter  the  range (lowest,  then
  2070.           highest)  of cassette  numbers  for  which  you wish  to  produce
  2071.           labels.   This function uses a great deal  of memory  to sort the
  2072.           titles out by cassette and index numbers, so there is a  limit to
  2073.           how many  labels you can process in a single run.  This will vary
  2074.           according to the amount of  memory available in your computer and
  2075.           under your  operating system.  As a rough  rule of thumb, I would
  2076.           suggest that you not print labels  for more than 200 cassettes at
  2077.           a time.  If you get a "running out  of memory" message, try again
  2078.           with  a smaller  number.    The  very first  time  you  use  this
  2079.           function, I would suggest  that you limit the  range  to 10 or 12
  2080.           cassettes just  to be  sure that your  printer setup is   working
  2081.           properly.
  2082.  
  2083.                If  you have followed my recommendation  to use only numeric
  2084.           characters in  cassette numbering,  the sequence  will be  pretty
  2085.           predictable.  If  you include alphabetic characters, you may have
  2086.           to give  more thought  to how  you would  designate ranges.   All
  2087.           entries are right-justified  and padded with leading  blanks; the
  2088.           sequence is ASCII.
  2089.  
  2090.                Before the  labels are printed,  you will be asked  to chose
  2091.           among various output options depending on the type of printer and
  2092.           labels  you  are  using.    These  choices  make  a  considerable
  2093.           difference in the format of  the labels.  Label formats currently
  2094.           supported on standard printers (continuous feed labels) are:
  2095.  
  2096.                     address labels
  2097.                     Beta spine labels
  2098.                     VHS spine labels
  2099.  
  2100.                If  you  used  the printer  configuration  option  under the
  2101.           Configuration  menu, the control code you  specified will be sent
  2102.           to the printer  before labels are printed and  the normal control
  2103.           code will  be sent to the  printer after the labels  are printed.
  2104.           This enables you  to set your printer to  condensed printing mode
  2105.           in order to get more information on small labels, if you know how
  2106.           to specify the right control sequence.
  2107.  
  2108.                You   can  get  acceptable  results  using  the  option  for
  2109.           continuous form 3.5 x  15/16 inch labels.  This is  the size most
  2110.           commonly used  for address  labels and is  readily available.   I
  2111.           recommend you use  tractor-feed if you have it,  as friction-feed
  2112.           is less precise.  Load the label strip so that the first printing
  2113.           position for the print head would  be just within the upper  left
  2114.           corner of the  first label to be  printed.  The program  will ask
  2115.           for your printing  pitch (pica, elite or condensed)  and print as
  2116.           much  information  as  can  be  squeezed  on  the  label.    Some
  2117.  
  2118.  
  2119.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 33
  2120.           _________________________________________________________________
  2121.  
  2122.           information  may  be   truncated  (cut  off)  because   of  space
  2123.           limitations.  Titles will  be printed  in  index number  sequence
  2124.           (i.e.in the order the movies are recorded).  Titles without index
  2125.           numbers  will be printed  in alphabetical order.     If there are
  2126.           more movies  than can  be printed on  a single  label, additional
  2127.           labels will be  printed for the same cassette  number to continue
  2128.           the  listing.   Make  sure  that  your  printer is  ready  before
  2129.           commencing printing operations.
  2130.  
  2131.                For  purists  who  never  record  more  than  one  film  per
  2132.           cassette, there is  an option to print only  one record per label
  2133.           and include more information.
  2134.  
  2135.                There  are  some  additional  output options  which  require
  2136.           special VHS or Beta spine  label stocks probably not available at
  2137.           your local computer store.  Suggested sources of supply (I get no
  2138.           commissions) are:
  2139.  
  2140.                     Virginia Specialty Products
  2141.                     P.O. Box 985
  2142.                     Vienna, Va 22180
  2143.                     [No telephone number available]
  2144.                     [best source for small package sizes]
  2145.                     [slow in filling orders]
  2146.  
  2147.                     United Ad Label Co.
  2148.                     650 Columbia Street
  2149.                     P.O. Box 2216
  2150.                     Brea, Ca 92622
  2151.                     [(800) 423-4643]
  2152.                     [best source for bulk packages]
  2153.                     [quick to ship]
  2154.  
  2155.           There is a separate set of options for Hewlett Packard compatible
  2156.           laser printers.   I have  only tested this  on a Hewlett  Packard
  2157.           LaserJet II,  so I  don't know  whether  there are  compatibility
  2158.           problems with other  brands. The program uses  HP printer control
  2159.           language for this option which may cause unpredictable results on
  2160.           non-compatible  printers.   The  laser printer  labels  currently
  2161.           supported are:
  2162.  
  2163.                     Poster (uncut label sheet) (HP 92285W)
  2164.                     File Folder Labels (HP 92296G)
  2165.                     VHS Spine Labels (UAL PV541)
  2166.  
  2167.           The numbers  shown are Hewlett-Packard  (HP) and United  Ad Label
  2168.           (UAL) stock numbers.  The  address and telephone number of United
  2169.           Ad Label are given above.   You can order HP items directly  from
  2170.           Hewlett Packard at:
  2171.  
  2172.                     Hewlett-Packard
  2173.                     HP DIRECT
  2174.                     P.O. Box 611298
  2175.                     San Jose, CA 95161-1298
  2176.  
  2177.  
  2178.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 34
  2179.           _________________________________________________________________
  2180.  
  2181.                     (800) 538-8787
  2182.  
  2183.                Other companies produce  similar products.  Note  that using
  2184.           labels  not specially  designed  for  laser  printers  may  cause
  2185.           damage.  
  2186.  
  2187.                I have  chosen to support  United Ad Label's VHS  labels for
  2188.           laser printers (Stock Number PV541PV).  There is an Avery product
  2189.           for VHS  labels which I  rejected because it had  both horizontal
  2190.           and vertical labels on the same sheet (the LaserJet forces a form
  2191.           eject every time  you change orientations).  The  UAL product has
  2192.           all horizontal labels.
  2193.  
  2194.                Note also that HP recommends that you open the back "Face
  2195.           -Up" door of the HPLJ II to minimize paper jams and internal wear
  2196.           when  printing labels.  If  you want to try this  on any brand or
  2197.           model of  laser printer other  than the HP  LaserJet Series   II,
  2198.           please  read your  manual carefully  to be  certain that  you are
  2199.           following all procedures prescribed for label printing.
  2200.  
  2201.                The print fonts  used are standard internal fonts  on the HP
  2202.           LaserJet II, so you don't need any font cartridges or soft fonts.
  2203.           The font is selected by the program and your own default settings
  2204.           will be restored after the program finishes printing labels.
  2205.  
  2206.                As  in the  case of  all printer  output, VIDEOCAT  uses the
  2207.           device PRN:, which is normally the primary parallel port (LPT1:).
  2208.           This  is  the usual and most  common printer interface.   If your
  2209.           printer is connected to a secondary parallel port (LPT2:, etc) or
  2210.           to  a  serial  port (COM1:,    COM2:,   etc.)  you  must  use the
  2211.           appropriate  DOS or  OS/2 commands  to  initialize your  port and
  2212.           redirect PRN: before running VIDEOCAT.  If you are  trying to run
  2213.           a  serial  printer under  OS/2,  good  luck!     [If  you  didn't
  2214.           understand anything in  this paragraph, don't worry;  chances are
  2215.           you have a common printer setup which will work fine.]
  2216.  
  2217.                The program has no way  of knowing whether you actually have
  2218.           your  printer loaded  with label stock.   Thus  you can  test the
  2219.           label maker functions  on plain paper in both  standard and laser
  2220.           printers.
  2221.  
  2222.  
  2223.  
  2224.  
  2225.                               R - Review Current Changes
  2226.                               __________________________
  2227.  
  2228.  
  2229.                The purpose of this procedure is to review changes, adds and
  2230.           deletes which have been entered but not yet processed to the disk
  2231.           file through an update.
  2232.  
  2233.                To invoke  the Review function,  enter R <cr> from  the main
  2234.           menu.  The transactions awaiting posting will be displayed on the
  2235.  
  2236.  
  2237.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 35
  2238.           _________________________________________________________________
  2239.  
  2240.           screen.   This  is useful  to remind  yourself  of what  you have
  2241.           already  entered and  to confirm  that  you want  to process  the
  2242.           changes to the  disk file before doing so.  There is no provision
  2243.           for editing  these pending  transactions.  If  you find  that you
  2244.           have made errors, your choices are: (1) update anyway and correct
  2245.           the errors  in a subsequent  batch; or (2) exit  without updating
  2246.           and discard the entire batch of pending transactions.
  2247.  
  2248.                Note that  there are  two kinds  of transactions  displayed:
  2249.           adds and  deletes.  The  Change procedure actually  generates two
  2250.           transactions: one to delete the old record  and a second to add a
  2251.           new record reflecting the changes.
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 36
  2297.           _________________________________________________________________
  2298.  
  2299.  
  2300.  
  2301.                                   S - Search Catalog
  2302.                                   __________________
  2303.  
  2304.  
  2305.                The purpose of the Search  function is to search through the
  2306.           data  file for  those records which  match some  specified search
  2307.           criteria and display or print out the matching records.
  2308.  
  2309.                To invoke  the Search function,  enter S <cr> from  the main
  2310.           menu.  The  search menu will then  appear giving you a  choice of
  2311.           search keys.  You  can specify as many as you want.  The keys are
  2312.           used conjunctively, so if you  choose the subject Western and the
  2313.           name John Wayne, only entries which satisfy both criteria will be
  2314.           displayed.
  2315.  
  2316.                Note that when you search by title or by comment, the search
  2317.           is  for  any  record  which  contains the  key  you  enter  as  a
  2318.           substring.  Thus entering "WAR",  for  example, would  match with
  2319.           "WAR  AND PEACE",  "WAR GAMES",  "WARRIORS",  "WARM HEARTS,  COLD
  2320.           FEET",  and    "PRIVATE WAR OF  MAJOR BENSON, THE",  all of which
  2321.           contain  the "WAR" character sequence somewhere within the title.
  2322.           When you are not sure  of the exact title of a movie,  this makes
  2323.           it  possible for you  to search by  entering only as  much of the
  2324.           title as you are sure of.  Similarly,  this permits searching the
  2325.           comment field for fragments of information, such as "Oscar".  The
  2326.           search is not case-sensitive, so "Oscar" will match with "Oscar",
  2327.           "OSCAR", "oscar", "OsCaR", etc..
  2328.  
  2329.                For name searches, no distinction is made between the Star1,
  2330.           Star2, Star3 and Director fields.  If the name  you enter matches
  2331.           any of these fields, the record will be considered a match.
  2332.  
  2333.                You can search by cassette  number, but not by index number.
  2334.           This simply reflects  my experience that the only time  I want to
  2335.           search by location  is when a cassette  is missing and I  want to
  2336.           find out what was on it.   The list of titles will usually remind
  2337.           me of who borrowed it.
  2338.  
  2339.                You will  be given  a variety of  screen and  printed output
  2340.           options to choose  from.  If  your collection  is large, you  may
  2341.           find that  it really speeds things along to  use one of the short
  2342.           output  options  (1 line  per  record showing  only  title, year,
  2343.           cassette and index).  The  usual advice applies to printed output
  2344.           options.
  2345.  
  2346.                If you choose a printer  output option you will be asked  if
  2347.           you want an  initial formfeed.  You  may wish to have  an initial
  2348.           formfeed to be sure that your print head is positioned at the top
  2349.           of the next  page if you have  done some printing which  has left
  2350.           your print  head in  the middle  of the  current page  (e.g., you
  2351.           decided to save something by hitting the Print Screen key).
  2352.  
  2353.  
  2354.  
  2355.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 37
  2356.           _________________________________________________________________
  2357.  
  2358.                Note that if the search  finds no matching items, there will
  2359.           be no output at all before you are returned to the main menu.
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 38
  2415.           _________________________________________________________________
  2416.  
  2417.  
  2418.  
  2419.  
  2420.                                  T - Tally Statistics
  2421.                                  ____________________
  2422.  
  2423.  
  2424.                The purpose of the Tally  function is to compile and display
  2425.           or print  certain statistics about the composition of your entire
  2426.           video collection.  The statistics shown include tables of numbers
  2427.           and  percentages  for subject, form, and rating.  Tables are also
  2428.           displayed  listing names  of  actors and  directors and  years of
  2429.           release.   You  will be  prompted  to indicate  whether you  want
  2430.           screen or printed  output and whether you wish the  items in each
  2431.           report section listed in alphabetical or frequency order.
  2432.  
  2433.                In a large collection, these tables can occupy many  screens
  2434.           or pages.  If you have chosen screen output, you will be prompted
  2435.           to indicate  whether you want to  continue to the next  screen of
  2436.           the current  table or  quit and proceed  to the  next statistical
  2437.           routine.   If you have  selected printed output, the  screen will
  2438.           tell you which statistical routine is currently being printed; if
  2439.           you hit the  Esc key the current  page will be completed  and the
  2440.           program will then jump to the next statistical routine.
  2441.  
  2442.                The algorithm  used to  construct a list  of names  or years
  2443.           sorted in  frequency or alphabetical  order uses a great  deal of
  2444.           memory.   In the  event that available  memory is  exhausted, the
  2445.           routine will  continue, but  will only be  able to  increment the
  2446.           count  for names  and  years already  encountered.  Thus if  your
  2447.           collection is large and available memory limited by your computer
  2448.           or operating system, the name and year tables may not be entirely
  2449.           complete.  Note that if you are running under DOS or in OS/2 real
  2450.           mode the  program can only  access 640k of memory,  regardless of
  2451.           how much memory  you have  installed.  If  you are running  under
  2452.           OS/2  protected  mode this  function  will  be  able to  use  all
  2453.           available memory.
  2454.  
  2455.                The algorithm also has a "Big  Oh" in excess of 1, which  is
  2456.           fancy  computer science lingo for a program whose processing time
  2457.           increases   more  than  proportionally  as  the  volume  of  data
  2458.           increases.   This  happens because  each time  another record  is
  2459.           analyzed,  the  lists of  names  and  years  to be  searched  and
  2460.           rearranged is  larger than before.   You will find  this function
  2461.           really slows down after processing a few hundred records.  I have
  2462.           designed the function to  display the title from the record it is
  2463.           currently working on so that  you will see something happening on
  2464.           the  screen and  know that  progress is  being made,  rather than
  2465.           wondering if your computer has died.
  2466.  
  2467.                This function gives you a  choice between screen and printed
  2468.           output and reports in alphabetical or frequency order.
  2469.  
  2470.  
  2471.  
  2472.  
  2473.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 39
  2474.           _________________________________________________________________
  2475.  
  2476.  
  2477.  
  2478.                                  U - Update Data Base
  2479.                                  ____________________
  2480.  
  2481.  
  2482.                The purpose  of the  Update function is  to update  the disk
  2483.           data file with  the adds, changes and deletes  entered during the
  2484.           current session.  These transactions are held in memory for batch
  2485.           update to the  disk file in the  interest of efficiency.   As the
  2486.           disk data file  grows larger, the time consumed  by a file update
  2487.           increases  significantly.  Batch updating minimizes the amount of
  2488.           physical reading and  writing of  disk files.   Do not forget  to
  2489.           Update  before exiting from the  program, however, as the current
  2490.           change   transactions  are  in   volatile  memory  and   are  not
  2491.           permanently recorded until  an Update is performed.  [Note: since
  2492.           the  C programming  language does  not  directly support  indexed
  2493.           files, a sequential update is more or less unavoidable.] 
  2494.  
  2495.                To  perform an  Update, enter  U <ret>  from the  main menu.
  2496.           Update uses a temporary data file to merge the old base file with
  2497.           the new transactions, then writes  the temporary file back to the
  2498.           base file.  At this point you will have the opportunity to select
  2499.           case conversion  options to be  performed during the update.   If
  2500.           you have a converted data  file created under a previous version,
  2501.           you can change  either the titles or the  actor/director names or
  2502.           both  converted from the previous all-uppercase to lowercase with
  2503.           leading characters capitalized.   In most cases  this will result
  2504.           in correct capitalization (although  the capitalization algorithm
  2505.           cannot  recognize that  some words  --  such as  acronyms --  are
  2506.           intended to be all caps and "Fred MacMurray" will turn into "Fred
  2507.           Macmurray").  The  algorithm does recognize and  capitalize Roman
  2508.           numerals  from I  through X.   It  also recognizes  "Mc" prefixed
  2509.           names  (but not "Mac").   If you  don't like the  result, you can
  2510.           change back the next time you perform an Update.
  2511.  
  2512.                While the Update is in  progress the screen will display the
  2513.           number of the record currently being read from or written  to the
  2514.           base  file so  that  you will  know  what is  going  on and  that
  2515.           progress  is being made.   If  there should not be enough room to
  2516.           create  the temporary  file, the  function  should abort  without
  2517.           altering the base  file. If there  should not  be enough room  to
  2518.           write  the entire temporary file back  to the base file, the base
  2519.           file will be incomplete, but  the temporary file will be complete
  2520.           and you can copy  VCATDATA.TMP to VCATDATA.DAT after making  some
  2521.           room.   An abnormal  termination (e.g. a  power loss)  during the
  2522.           update  may  result  in  making  one   of  the  files  unreadable
  2523.           (whichever one was open for writing at the time).
  2524.  
  2525.                I   have rarely had an error resulting in data loss; however
  2526.           this is a  good time to repeat  the warning that  making frequent
  2527.           backups  of  your  base  file  is a  good  way  to  minimize  the
  2528.           consequences if it should  happen.  The most common error  I make
  2529.           is  neglecting to  be  sure that  there  is enough  room for  the
  2530.  
  2531.  
  2532.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 40
  2533.           _________________________________________________________________
  2534.  
  2535.           creation of the work  file on a VDISK which I also use for editor
  2536.           backup files. This  is when the  multitasking capability of  OS/2
  2537.           really  comes in handy, because  I can invoke the session manager
  2538.           to change to  another screen group without  terminating VIDEOCAT,
  2539.           clean  up the  file space  problem, and  then return  to VIDEOCAT
  2540.           exactly where I  left off.  Under  DOS I would have to  exit from
  2541.           VIDEOCAT and lose the current  transactions in order to clear out
  2542.           space on the VDISK.
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 41
  2592.           _________________________________________________________________
  2593.  
  2594.  
  2595.  
  2596.                               W - Whole Catalog Listing
  2597.                               _________________________
  2598.  
  2599.  
  2600.                The purpose of this function is  to list all the records  in
  2601.           the entire  catalog.   The user can  select title  sequence, year
  2602.           sequence, or location sequence.   A variety of screen and printer
  2603.           output options are  available (the same options as  in the Search
  2604.           function).
  2605.  
  2606.                If  title sequence is selected, the program will immediately
  2607.           begin to  produce the listing, since  that is the order  in which
  2608.           the  permanent data  file  is  organized.   If  location or  year
  2609.           sequence is selected a sorting routine will take place before the
  2610.           listing  is produced.   During  the  sort some  messages will  be
  2611.           displayed simply to keep you informed  of what is going on.   The
  2612.           sorting  involves the creation of intermediate temporary files on
  2613.           your  currently  active  drive which  will  be  deleted when  the
  2614.           routine is  completed, but will  occupy space  while the  sorting
  2615.           process is active.  TO SUCCESSFULLY USE THE SORTED OUTPUT FEATURE
  2616.           YOU  MUST HAVE  FREE DISK  SPACE ON  YOUR  ACTIVE DRIVE  EQUAL TO
  2617.           APPROXIMATELY  TWICE THE SIZE  OF YOUR DATA  FILE (VCATDATA.DAT).
  2618.           If sufficient space is not  available the routine will  terminate
  2619.           and issue a warning  of an error in attempting to  write a sorted
  2620.           file.  If the process should be abnormally terminated (such as by
  2621.           power  loss,  rebooting   or  Ctrl-C)  you  may   find  that  the
  2622.           intermediate  files have  not been  deleted.   One  may be  named
  2623.           VCATSORT.DAT (created in  the currently active path);  others may
  2624.           have  system-assigned  names,   typically  numbers  without  file
  2625.           extensions (most likely  created in the  root directory).   These
  2626.           can be safely  deleted using the DOS erase or delete commands.  I
  2627.           expect that in  some future version I  will add an option  in the
  2628.           Configure function  which will  enable you  to designate  another
  2629.           path, such as a ramdisk, for these temporary files.
  2630.  
  2631.                If your  data file  is too large  in relation  to accessible
  2632.           memory to be sorted in one pass, the program will create a series
  2633.           of temporary  sorted files  and then merge  them.   Remember that
  2634.           under DOS or OS/2 real mode only 640k of memory is accessible; so
  2635.           if you have  a lot of memory it is definitely advantageous to run
  2636.           this program  under OS/2 protected mode so as  to be able to make
  2637.           use of all memory.
  2638.  
  2639.                Note  that  if your  collection  is  large, the  display  of
  2640.           complete data, and especially the printing of a hard copy catalog
  2641.           with complete data, can take quite a while.  You may find it more
  2642.           efficient to use the short  format options unless you really need
  2643.           all of the data  displayed.  During a long  print-out I recommend
  2644.           that you not leave your printer unattended in case of a paper jam
  2645.           or ribbon break, events which  seem to happen, in accordance with
  2646.           Murphy's law, only when you decide to step out for a coffee break
  2647.           during a long print job.
  2648.  
  2649.  
  2650.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 42
  2651.           _________________________________________________________________
  2652.  
  2653.                If you choose a printer  output option you will be  asked if
  2654.           you want an  initial formfeed.  You  may wish to have  an initial
  2655.           formfeed to be sure that your print head is positioned at the top
  2656.           of the next  page if you have  done some printing which  has left
  2657.           your  print head  in the middle  of the  current page  (e.g., you
  2658.           decided to save something by hitting the Print Screen key).
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 43
  2710.           _________________________________________________________________
  2711.  
  2712.  
  2713.  
  2714.                                 E - Exit from program
  2715.                                 _____________________
  2716.  
  2717.  
  2718.                The  purpose of this  function is to  terminate the VIDEOCAT
  2719.           program and return to DOS or OS/2.  If you have entered any adds,
  2720.           changes or deletes during the  current session, be sure to Update
  2721.           before Exiting.   If you can't remember whether  you have pending
  2722.           transactions, use Review  to check.  If the  program detects that
  2723.           you have  unprocessed changes pending, it will ask if you want to
  2724.           update  before exiting.  An Update is not performed automatically
  2725.           because you may make a deliberate choice not to update because of
  2726.           errors in data you have entered.
  2727.  
  2728.                To Exit, enter E <cr> from the main menu.  The Exit function
  2729.           does  give you  one  chance  for second  thoughts  if it  detects
  2730.           unprocessed changes; otherwise it  proceeds directly to terminate
  2731.           the program.  If  you indicate that you do wish  to update files,
  2732.           the update function will be called and the program will terminate
  2733.           when it is completed.
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 44
  2769.           _________________________________________________________________
  2770.  
  2771.  
  2772.  
  2773.  
  2774.                                   WHAT IS SHAREWARE?
  2775.  
  2776.  
  2777.                         [Reproduced from a Publication of the
  2778.                        Association of Shareware Professionals]
  2779.  
  2780.  
  2781.                This file will help you understand what shareware is and how
  2782.           the "shareware system" works.   It was written by the Association
  2783.           of  Shareware Professionals (ASP -- a professional association of
  2784.           shareware authors) at  the request of the  Shareware Distribution
  2785.           Network (SDN --  an association of BBS  Sysops providing reliable
  2786.           distribution  of shareware  around the  world),  for the  express
  2787.           purpose of giving BBS users a better understanding of shareware.
  2788.  
  2789.                You've probably heard the terms "public domain", "freeware",
  2790.           "shareware", and others like them.   Your favorite board probably
  2791.           has  many programs  described  by  one or  more  of these  words.
  2792.           There's a  lot of  confusion about and  between these  terms, but
  2793.           they actually have  specific meanings and implications.  Once you
  2794.           understand them you  will have a much easier  time navigating the
  2795.           maze  of programs available  to you, and  understanding what your
  2796.           obligations are, or aren't, with each type of program.
  2797.  
  2798.                Let's start with some basic definitions.
  2799.  
  2800.                "Public domain" has a very specific legal meaning.  It means
  2801.           that the creator  of a work (in  this case, a piece  of software)
  2802.           who had legal ownership of that work, has given up ownership and
  2803.           dedicated the work "to the public domain".  Once something is  in
  2804.           the public domain, anyone can use it in any way they  choose, and
  2805.           the author has no  control over the use and cannot demand payment
  2806.           for it.  
  2807.  
  2808.                If you  find a program  which the author has  explicitly put
  2809.           into the  public domain you  are free to  use it however  you see
  2810.           fit, without paying for the right to use it.  But use care -- due
  2811.           to  the confusion  over the  meaning of  the words,  programs are
  2812.           often described by  others as being "public domain"  when in fact
  2813.           they are shareware or free, copyrighted software.  To be sure a
  2814.           program is public domain you should look for an explicit
  2815.           statement from the author to that effect.
  2816.  
  2817.                "Copyrighted"  is  the   opposite  of  public  domain.     A
  2818.           copyrighted program is  one where the author has  asserted his or
  2819.           her legal right to control  the program's use and distribution by
  2820.           placing the legally required copyright notices in the program and
  2821.           documentation.   The law gives  copyright owners broad  rights to
  2822.           restrict how their work is distributed, and provides for
  2823.           penalties for those who violate these restrictions.  
  2824.  
  2825.  
  2826.  
  2827.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 45
  2828.           _________________________________________________________________
  2829.  
  2830.                When you find a program which is copyrighted you must use it
  2831.           in accordance with the copyright owner's restrictions on
  2832.           distribution and  payment.  Usually  these are clearly  stated in
  2833.           the program documentation.
  2834.  
  2835.                Maintaining  a copyright does not necessarily imply charging
  2836.           a fee, so  it is perfectly possible and legal to have copyrighted
  2837.           programs which are distributed free of charge.  Such programs are
  2838.           sometimes termed "freeware", though this term was in fact
  2839.           trademarked by the late Andrew  Flugelman and the legality of its
  2840.           use by  others could be questioned.  In any case, the fact that a
  2841.           program is free does not mean that  it is in the public domain --
  2842.           though this is a common confusion.
  2843.  
  2844.                "Shareware" is  copyrighted software which is distributed by
  2845.           authors through bulletin boards, on-line services,  disk vendors,
  2846.           and copies passed among friends.  It is commercial software which
  2847.           you are allowed to try out before you pay for it.
  2848.  
  2849.                Shareware authors use a variety of licensing restrictions on
  2850.           their  copyrighted  works,  but most  authors  who  support their
  2851.           software require you to pay  a "registration fee" -- the purchase
  2852.           price of the software -- if you continue to use the product after
  2853.           a trial  period.  Some  authors indicate a specific  trial period
  2854.           after which you  must pay this fee; others leave  the time period
  2855.           open and rely  on you to judge when  you have decided to  use the
  2856.           program, and therefore should pay for it.  Occasionally a
  2857.           shareware  author  requires  registration  but does  not  require
  2858.           payment -- this is so-called "$0 shareware".
  2859.  
  2860.                The  shareware  system  and the  continued  availability  of
  2861.           quality shareware products depend on your willingness to register
  2862.           and pay for the shareware you use.  The registration fees you pay
  2863.           allow authors to support and continue to develop their products. 
  2864.  
  2865.                As a software user you  benefit from this system because you
  2866.           get to try the software and determine whether it meets your needs
  2867.           before you pay for it.  Authors  also benefit because we are able
  2868.           to get our products into your hands with little or no expense for
  2869.           advertising and promotion.  As a result it is not unusual to find
  2870.           shareware products which rival retail software that costs several
  2871.           times the amount of the shareware registration fee.
  2872.  
  2873.                ASP members'  shareware meets  additional quality  standards
  2874.           beyond ordinary shareware.  Our members' programs must be fully
  2875.           functional (not crippled, demonstration, or out of date
  2876.           versions); program documentation must be complete and must
  2877.           clearly state the registration fee and the benefits received when
  2878.           registering;  members must provide free mail or telephone support
  2879.           for a  minimum of  three months  after registration; and  members
  2880.           must meet  other guidelines  which help to  insure that you  as a
  2881.           user receive good value for your money and are dealt with
  2882.           professionally.   We also provide an Ombudsman  program to assist
  2883.           in resolving disputes between authors and users.  For more
  2884.  
  2885.  
  2886.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 46
  2887.           _________________________________________________________________
  2888.  
  2889.           information on  the ASP or to contact the ASP Ombudsman, write to
  2890.           ASP, P.O. Box 5786, Bellevue, WA 98006.  You can also contact the
  2891.           Ombudsman on CompuServe via an EasyPlex (electronic mail) message
  2892.           to 70007,3536.
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.                         Copyright (C) 1986-1990 W. A. Jackson
  2946.           VIDEOCAT Version 7.1                                      Page 47
  2947.           _________________________________________________________________
  2948.  
  2949.  
  2950.  
  2951.                              ASP MEMBERSHIP REQUIREMENTS
  2952.  
  2953.                         [Reproduced from a Publication of the
  2954.                        Association of Shareware Professionals]
  2955.  
  2956.           The following  are the  general  standards that  ALL ASP  authors
  2957.           (full   members) have agreed  to follow.   Each was passed  by at
  2958.           east  a 2/3 vote  of those members  voting and is  binding on all
  2959.           authors.  They consist of a support policy, a policy on payments,
  2960.           a policy  on no crippled  software, an Ombudsman policy  and some
  2961.           miscellaneous items: 
  2962.  
  2963.  
  2964.                         **** ASP Software Support Policy ****
  2965.  
  2966.           1.   All  ASP  members'  shareware  products  must   provide
  2967.                support  (included in the purchase price) for a minimum
  2968.                of three months from the  date of registration.  If the
  2969.                support  is by telephone, there may  be a limitation on
  2970.                BOTH  the total  connect  time  and  the  period  after
  2971.                purchase   during   which  it   is   available  without
  2972.                additional cost so long as the connect time is at least
  2973.                30 minutes during  the required three months.   Support
  2974.                may be provided for a fee after this initial period has
  2975.                elapsed. The support  policy must be clearly  stated in
  2976.                the shareware documentation. 
  2977.  
  2978.           2.   Support during the initial period may be one or more of
  2979.                the following:
  2980.  
  2981.                -    mail support
  2982.  
  2983.                -    telephone  support  (if  this   is  the  only
  2984.                     support provided,  at a  minimum an answering
  2985.                     machine  must be available  4 hours  per day;
  2986.                     this  support    may  be  limited  to  thirty
  2987.                     minutes  of connect time at the option of the
  2988.                     author)
  2989.  
  2990.                -    for   communications   products,    or   ones
  2991.                     associated to a communication  product by BBS
  2992.                     or major communications service
  2993.  
  2994.                -    by any alternate method approved by the Board
  2995.                     of Directors by a two   thirds vote (of those
  2996.                     directors voting)
  2997.  
  2998.           3.   The  minimum level of  support required by  this policy
  2999.                involves answering  questions and  fixing serious  bugs
  3000.                during  the minimum three  month period.   For problems
  3001.                involving a specific  hardware or software  environment
  3002.                or feature,  the  author  may choose not to  modify the
  3003.  
  3004.  
  3005.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 48
  3006.           _________________________________________________________________
  3007.  
  3008.                program.  In  that case, if the report  is within three
  3009.                months after purchase,  then the author shall  offer to
  3010.                refund the  user's purchase price.
  3011.  
  3012.           4.   Any money sent  to an author to register an unsupported
  3013.                product  shall be promptly returned with an explanation
  3014.                that the product in question is no longer supported.
  3015.  
  3016.           5.   Known incompatibilities with other software or hardware
  3017.                and major or  unusual program limitations are  noted in
  3018.                the  documentation  that  comes  with    the  shareware
  3019.                (evaluation) program.
  3020.  
  3021.  
  3022.                       **** ASP Registration Payment Policy *****
  3023.  
  3024.           1.   The Documentation must clearly describe how to register
  3025.                the product  and what  goods and/or  services the  user
  3026.                will receive for registering.
  3027.  
  3028.           2.   Fees  must  be  expressed  in fixed  monetary  amounts.
  3029.                Voluntary   payments  or   contributions  may   not  be
  3030.                solicited,  although phrasing such  as "if you  use and
  3031.                like this product, please register" is allowed.
  3032.  
  3033.           3.   Multiple levels of registration may be set, as long  as
  3034.                each  level   individually  satisfies  the   above  two
  3035.                requirements.
  3036.  
  3037.  
  3038.                          **** ASP Policy on No Crippling ****
  3039.  
  3040.           The  principle behind  shareware is  "try before  you buy."   ASP
  3041.           believes  that users  have a  right  to try  a fully  functioning
  3042.           shareware  program  in   their  regular  computing   environment.
  3043.           Accordingly, ASP authors agree that:
  3044.  
  3045.                (1)  The executable files (and/or  items linked in
  3046.                     with  executables)  in  their  shareware  and
  3047.                     registered  versions will be the same (with  
  3048.                     the exceptions noted below)
  3049.  
  3050.                (2)  All  the  program's  features will  be  fully
  3051.                     documented.
  3052.  
  3053.                (3)  Registration  encouragement procedures  which
  3054.                     in  the  judgment  of the  Board  are  either
  3055.                     unreasonable   or   unprofessional   are  not
  3056.                     allowed.
  3057.  
  3058.           Exceptions  to a  strict  interpretation of  this  policy are  as
  3059.           follows:    
  3060.  
  3061.  
  3062.  
  3063.  
  3064.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 49
  3065.           _________________________________________________________________
  3066.  
  3067.                -    to save  disk space, tutorial  and additional
  3068.                     explanatory  material may be  left out of the
  3069.                     shareware documentation.    
  3070.  
  3071.                -    the shareware  version may  have registration
  3072.                     encouragement  procedures  absent   from  the
  3073.                     registered  version  (or  which  can   be    
  3074.                     disabled  with  a   code  only  provided   to
  3075.                     registered users).    
  3076.  
  3077.                -    the  registered  version may  include  sample
  3078.                     files not included in the shareware version.
  3079.  
  3080.                -    if source code is offered with the registered
  3081.                     version,  it   may  be   withheld  from   the
  3082.                     shareware version.
  3083.  
  3084.                -    the   author   may  provide   two   shareware
  3085.                     versions:  one  a  small  version  which  the
  3086.                     author designates the  distributed version   
  3087.                     in normal circumstances  (e.g. language tools
  3088.                     in  C only available in one model) so long as
  3089.                     the full shareware version  is available from
  3090.                     some  public source (possibly  for a small   
  3091.                     distribution fee) and may be copied for trial
  3092.                     purposes.  The  small version's documentation
  3093.                     must clearly  describe how  users may  obtain
  3094.                     the full shareware version.
  3095.  
  3096.                -    the  author may  provide  an enhanced  retail
  3097.                     version of the  program so long as it  is not
  3098.                     (in the opinion  of 60% of the BoD) merely an
  3099.                     attempt  to  circumvent   this  no  crippling
  3100.                     policy.
  3101.  
  3102.                -    registered  users   may  be   provided  bonus
  3103.                     utilities  unrelated  to  (and which  do  not
  3104.                     change)  the   basic  functionality   of  the
  3105.                     program.
  3106.  
  3107.                -    registered users may be given utilities which
  3108.                     provide  a  convenience  but  which  are  not
  3109.                     essential.
  3110.  
  3111.                -    exceptions  approved  by  the  ASP  board  of
  3112.                     directors by a 60% vote of those voting.
  3113.  
  3114.  
  3115.                             **** ASP Ombudsman Policy ****
  3116.  
  3117.           1.   The  board shall  set up  the office  of Ombudsman  and
  3118.                appoint someone to that position.  The Ombudsman's sole
  3119.                role shall be  to mediate disputes between  ASP members
  3120.                and their customers.  The Ombudsman shall report to the
  3121.  
  3122.  
  3123.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 50
  3124.           _________________________________________________________________
  3125.  
  3126.                board  situations   where  he  feels  board  action  or
  3127.                knowledge is appropriate.
  3128.  
  3129.           2.   All  ASP  members  and  vendor  associate  members  are
  3130.                required   to   cooperate  with   the   Ombudsman  when
  3131.                approached by him/her.
  3132.  
  3133.           3.   If the ASP logo  or name is used by any  full member in
  3134.                any  ads/docs  etc  in  connection  with any  shareware
  3135.                program, then  that member shall include  the following
  3136.                statement with their shareware programs: 
  3137.  
  3138.                     "This  program  is  produced by  a  member  of the
  3139.                Association  of  Shareware  Professionals  (ASP).   ASP
  3140.                wants to make  sure that the shareware  principle works
  3141.                for you.  If  you are  unable to  resolve a  shareware-
  3142.                related  problem with an  ASP member by  contacting the
  3143.                member  directly, ASP  may  be able  to  help. The  ASP
  3144.                Ombudsman can  help you  resolve a  dispute or  problem
  3145.                with  an ASP  member, but  does  not provide  technical
  3146.                support  for members' products. Please write to the ASP
  3147.                Ombudsman  at P.O. Box 5786, Bellevue, WA 98006 or send
  3148.                a Compuserve  message  via easyplex  to  ASP  Ombudsman
  3149.                70007,3536"
  3150.  
  3151.           4.   This statement  is only  required  if the  ASP name  is
  3152.                otherwise used by the author and it is only required in
  3153.                programs and/or versions distributed as  shareware.  It
  3154.                can be in any file provided  with the shareware version
  3155.                of  the program.    In addition,  members  are free  to
  3156.                include it in  printed docs, ads and other  mailings if
  3157.                they wish.
  3158.  
  3159.           5.   The  first sentence may be replaced by "<Member's name>
  3160.                is   a   member  of   the   Association   of  Shareware
  3161.                Professionals  (ASP)."   If an  author's  company  is a
  3162.                company  member,  then  the company  name  may  be used
  3163.                instead of <member's name> if the policy applies. 
  3164.  
  3165.           6.   If the  ASP logo  or name is  used by any  ASP approved
  3166.                vendor in any  ads/catalogs etc , then that vendor must
  3167.                include the following statement with their catalogs and
  3168.                newsletters  and is encouraged  to include it  with all
  3169.                disks sold:
  3170.  
  3171.                     "Company  X is  an  approved vendor  and associate
  3172.                member of  the Association  of Shareware  Professionals
  3173.                (ASP).  ASP wants  to  make  sure  that  the  shareware
  3174.                principle works for you. If you are unable to resolve a
  3175.                shareware-related  problem  with   an  ASP  member   by
  3176.                contacting  the member  directly, ASP  may  be able  to
  3177.                help. The ASP Ombudsman can help you  resolve a dispute
  3178.                or  problem with  an ASP member,  but does  not provide
  3179.                technical support  for members' products.  Please write
  3180.  
  3181.  
  3182.                         Copyright (C) 1986-1990 W. A. Jackson           VIDEOCAT Version 7.1                                      Page 51
  3183.           _________________________________________________________________
  3184.  
  3185.                to the  ASP Ombudsman  at P.O.  Box 5786,  Bellevue, WA
  3186.                98006 or send a Compuserve message  via easyplex to ASP
  3187.                Ombudsman 70007,3536"
  3188.  
  3189.  
  3190.                             **** ASP Misc. Standards ****
  3191.  
  3192.                The  program has  been thoroughly tested  by the  author and
  3193.           should  not  be  harmful  to  other files  or  hardware  if  used
  3194.           properly.
  3195.  
  3196.                Any  discussion of the shareware concept and of registration
  3197.           requirements is done in a professional and positive manner.
  3198.  
  3199.                The  program  author   will  respond  to  people   who  send
  3200.           registration   payments,    as   promised   in    the   program's
  3201.           documentation.  At a minimum, the author will acknowledge receipt
  3202.           of all payments.
  3203.  
  3204.                The author will keep the  ASP apprised of changes in mailing
  3205.           address and of any changes in the status of his programs.
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.                         Copyright (C) 1986-1990 W. A. Jackson
  3242.