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