home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / catbox14.zip / CATBOX.DOC < prev    next >
Text File  |  1993-03-07  |  99KB  |  2,003 lines
  1.                                The Catalog ToolBox
  2.                                     (CATBOX)
  3.  
  4.                      Copyright 1992, 1993 by Parity Solutions
  5.  
  6.                                                 
  7.                                  Gary C. Crider
  8.                                 Parity Solutions
  9.                                1105 Burgess Court
  10.                                Arlington, TX 76015
  11.  
  12.  
  13.  
  14.  
  15.                                 TABLE OF CONTENTS
  16.  
  17.  
  18.             TOPIC                                                       SECTION
  19.  
  20.       WHAT IS CATBOX? ................................................. 1.0
  21.       INSTALLING CATBOX ............................................... 2.0
  22.       RUNNING CATBOX .................................................. 3.0
  23.       CONFIGURING CATBOX .............................................. 4.0
  24.       THE CATBOX MENU STRUCTURE ....................................... 5.0
  25.         FILE MENU ..................................................... 5.1
  26.         VIEW MENU ..................................................... 5.2
  27.         SORT .......................................................... 5.3
  28.         DELETE MENU ................................................... 5.4
  29.         EXTRACT MENU .................................................. 5.5
  30.         MOVE MENU ..................................................... 5.6
  31.       USING CATBOX .................................................... 6.0
  32.         MENU AND DATA ENTRY BASICS .................................... 6.1.1
  33.         SHORTCUT KEYS ................................................. 6.1.2
  34.         USING A MOUSE ................................................. 6.1.3
  35.         FILE FUNCTIONS ................................................ 6.2
  36.           OPENING A CATALOG ........................................... 6.2.1
  37.           SAVING A CATALOG ............................................ 6.2.2
  38.           SAVING A NONSTANDARD CATALOG IN STANDARD CIS FORMAT ......... 6.2.3
  39.           LOADING A TEMPLATE .......................................... 6.2.4
  40.           PRINTING A CATALOG .......................................... 6.2.5
  41.           PRINTING A CATALOG USING AN EXTERNAL PRINT UTILITY .......... 6.2.6
  42.           TEMPORARILY EXIT TO DOS ..................................... 6.2.7
  43.           VIEW CATBOX VERSION AND COPYRIGHT INFORMATION ............... 6.2.8
  44.           EXIT CATBOX ................................................. 6.2.9
  45.         VIEW FUNCTIONS ................................................ 6.3
  46.           BROWSE THE CATALOG .......................................... 6.3.1
  47.           SEARCH THE CATALOG .......................................... 6.3.2
  48.           VIEW NEWER .................................................. 6.3.3
  49.           VIEW LATER .................................................. 6.3.4
  50.         SORT FUNCTION ................................................. 6.4
  51.           SORT THE CATALOG ............................................ 6.4.1
  52.         DELETE FUNCTIONS .............................................. 6.5
  53.           SELECTING ENTRIES TO DELETE ................................. 6.5.1
  54.           DELETE ENTRIES MATCHING A SEARCH STRING ..................... 6.5.2
  55.           DELETE ENTRIES NOT MATCHING A SEARCH STRING ................. 6.5.3
  56.           DELETE ENTRIES NEWER THAN A GIVEN DATE ...................... 6.5.4
  57.           DELETE ENTRIES OLDER THAN A GIVEN DATE ...................... 6.5.5
  58.           DELETE DUPLICATE ENTRIES .................................... 6.5.6
  59.         EXTRACT FUNCTIONS ............................................. 6.6
  60.           SELECTING ENTRIES TO EXTRACT ................................ 6.6.1
  61.           EXTRACT ENTRIES MATCHING A SEARCH STRING .................... 6.6.2
  62.           EXTRACT ENTRIES NOT MATCHING A SEARCH STRING ................ 6.6.3
  63.           EXTRACT ENTRIES NEWER THAN A GIVEN DATE ..................... 6.6.4
  64.           EXTRACT ENTRIES OLDER THAN A GIVEN DATE ..................... 6.6.5
  65.         MOVE FUNCTIONS ................................................ 6.7
  66.           SELECTING ENTRIES TO MOVE ................................... 6.7.1
  67.           MOVE ENTRIES MATCHING A SEARCH STRING ....................... 6.7.2
  68.           MOVE ENTRIES NOT MATCHING A SEARCH STRING ................... 6.7.3
  69.           MOVE ENTRIES NEWER THAN A GIVEN DATE ........................ 6.7.4
  70.           MOVE ENTRIES OLDER THAN A GIVEN DATE ........................ 6.7.5
  71.         A NOTE ABOUT DATES ............................................ 6.8
  72.         GREEN WINDOWS ................................................. 6.9
  73.       TEMPLATES ....................................................... 7.0
  74.         SUPPLIED TEMPLATES ............................................ 7.1
  75.         EXAMPLE TEMPLATE .............................................. 7.2
  76.         CREATING TEMPLATES ............................................ 7.3
  77.       CREATING DOWNLOAD SCRIPTS (CAT2DL.EXE) .......................... 8.0
  78.       FSORT.EXE ....................................................... 9.0
  79.       FILETIME.EXE .................................................... 10.0
  80.       PERFORMANCE AND PROBLEMS ........................................ 11.0
  81.       DISCLAIMER ...................................................... 12.0
  82.       SUPPORT ......................................................... 13.0
  83.       REGISTRATION .................................................... 14.0
  84.       CREDITS ......................................................... 15.0
  85.  
  86.  
  87.  
  88.  
  89. 1.0 WHAT IS CATBOX?
  90.  
  91.     If you do a lot of downloading from any or many CompuServe (CIS) forums,
  92. the Catalog ToolBox (CATBOX) is a necessary tool for managing the long listings
  93. of the library contents, also known as a catalog or index.  This is the list of
  94. files that are available for downloading with complete textual descriptions. 
  95. Although you can get short index listings, I, for one, certainly do not want to
  96. invest my money and time downloading a file based on the short descriptions
  97. available in a short index.
  98.  
  99.     The long list catalogs are often quite large and cumbersome.  It can be
  100. quite difficult to locate the programs you want to download.  They usually are
  101. not sorted in the order you like, and most CIS managers only let you search on
  102. the keyword field.  Some uploaders are real klutzes when it comes to composing
  103. and spelling on the keyword list and naturally, they do not include the word
  104. you would logically use for a search.  Even using a program that allows text 
  105. search to scan the entire body of the library entries will usually not find the 
  106. phrase you are looking for due to the fact that the phrase may be split across 
  107. two lines.
  108.  
  109.     CATBOX offers the following features to let you get a grip on the library
  110. contents:
  111.  
  112.       SORTING - You can sort the catalog by up to four keys in ascending or
  113.       descending order by key.  The allowable sort keys are:
  114.       
  115.             File name
  116.             File extension
  117.             Upload date
  118.             Uploader ID
  119.             Library number
  120.             File type
  121.             Download count
  122.             File size
  123.  
  124.       Each logical entry is kept intact.  The result looks like your original
  125.       catalog in a different order.  I like to keep catalogs in library, date,
  126.       file name order so that I can see the latest uploads first in each
  127.       library.
  128.  
  129.       VIEWING - Display one entry at a time on the screen with the ability to
  130.       page down and back, return to the top or go to the bottom by pressing a
  131.       single key.
  132.  
  133.       SEARCHING - Search for any string of characters up to 40 characters long
  134.       with leading or embedded spaces.  The entire entry is searched including
  135.       the headings, title, keywords and text body.  The lines are strung
  136.       together in such a way during the search that if the phrase is split
  137.       across lines, it will still be located.  The search is insensitive to case
  138.       so that weird capitalization combinations do not effect the search.
  139.  
  140.       DATE CRITERIA - If you wish, view, delete, extract or move entries that 
  141.       are either older or newer than a given date.
  142.  
  143.       REMOVAL OF DUPLICATES - Many library listings contain multiple entries for
  144.       the same file.  Merging multiple libraries into one often results in even
  145.       more duplicates.  CATBOX lets you remove these duplicates.
  146.  
  147.       SELECTIVE DELETION - You can choose entries to be deleted from the catalog
  148.       by browsing, inclusive searching, non-inclusive searching or by date.  You 
  149.       can delete the records automatically or with prompting for each selected 
  150.       entry.
  151.  
  152.       SELECTIVE EXTRACTION - Copy selected entries to another existing or new
  153.       catalog.  You can use all of the same selection criteria available for
  154.       deleting entries.  Extraction of an entry may be prompted or automatic.
  155.  
  156.       SELECTIVE MOVE - Move entries to another catalog.  This incorporates the
  157.       extraction function followed by deleting the entries from the current
  158.       catalog.
  159.  
  160.  
  161.       NON-DESTRUCTIVE - All of the above can be done without ever modifying your
  162.       original catalog.  None of the changes to the catalog are saved
  163.       permanently until you tell CATBOX to save the file.  Even then you can
  164.       specify a different name for the saved catalog, keeping your original
  165.       intact.
  166.  
  167.       PRINT FUNCTIONS - You can print (to any port) the modified catalog without
  168.       ever having to save a permanent copy.  You can even use your favorite file
  169.       print utility to format the output!  Print only those entries you want to
  170.       see.
  171.  
  172.       FORMAT CONVERSION - Any catalog can be saved in standard CIS format if you
  173.       have a template describing the source catalog's format.  See TEMPLATES
  174.       below.
  175.  
  176.       TEMPLATES -  You will discover that the format of a catalog entry can
  177.       vary.  The NOVLIB forum, for example, has a listing of all files in the
  178.       forum called FORUM.ZIP.  They preprocess and rearrange the order and
  179.       format of the entries before they build the file and post it for
  180.       downloading.  Also, there is no guarantee that CIS will always use the
  181.       same format.  Templates give you the ability to handle modified and
  182.       changing formats.  Templates are small files that, in a very simple but
  183.       flexible manner, define the structure of a catalog's entries.  You merely
  184.       load the appropriate template to process the catalog that you will open. 
  185.       I supply some templates, but you can easily construct your own.
  186.  
  187.       CONTEXT-SENSITIVE HELP - No matter what you are doing inside CATBOX,
  188.       pressing F1 pops up a USEFUL help screen that pertains to what you are
  189.       trying to do.  From any help screen, you can access the help index of all
  190.       topics.  Nearly all of the information in this document is available in 
  191.       help screens.
  192.  
  193.       DOS SHELL - Shell out to DOS to execute external commands and return to
  194.       CATBOX by typing EXIT.  All of your unsaved work remains as it was when
  195.       you went to DOS.
  196.  
  197.     
  198.     My typical usage of CATBOX might be the following scenario:
  199.  
  200.       I have a catalog for XYZ forum, but it is not very current.  It is about a
  201.       month old.  I capture a long library listing of all new files that have
  202.       been updated in the last 40 days.  I the use the DOS COPY command to
  203.       append the new listings to my old catalog.  I then crank up CATBOX and
  204.       open the merged catalog.  Since there is probably some overlap in the
  205.       entries I just captured and what I already had, I first delete duplicate
  206.       entries.  Then I sort the catalog by library, date (descending), name and
  207.       extension.  This is my preferred arrangement, so I save the catalog at
  208.       this point.
  209.  
  210.       After using CATBOX's extensive search and viewing features, I now know
  211.       what files I want to download, and have moved these entries to another
  212.       XYZ catalog that I print in library/date/name order.  The target for the 
  213.       move is a catalog in which I keep entries that I have already downloaded.  
  214.       Since the catalog already exists, the entries I move to it are just added 
  215.       to its current contents.  Now I can go online and download them.  My 
  216.       original catalog no longer contains entries for the downloaded files since 
  217.       I don't like to browse through catalog entries for files which I have 
  218.       already downloaded.
  219.  
  220.       I now have a catalog of files that I may someday want to download and
  221.       another for those that I have already downloaded-- two excellent
  222.       references for the files available on XYZ forum.
  223.  
  224.     There are many other uses for CATBOX limited only by your imagination and
  225. sense of organization.  Have a ball with it and send me a mail message if you
  226. discover some new and exciting blockbuster application for CATBOX.  We'll let
  227. all the CATBOX users in on it.
  228.  
  229.     There are many ways to obtain long library listings.  You can capture them
  230. with your favorite communications program's CAPTURE or LOG feature, or you may
  231. find, as I do, that many CIS managers such as OZCIS, TAPCIS and AUTOSIG will
  232. capture them for you very easily.  OZCIS even has the capability of updating
  233. existing catalogs, capturing only the newer uploads.  Most forums also keep a
  234. ZIPed catalog available for downloading.  This is much faster than capturing
  235. the entries as they roll down your screen.
  236.  
  237.  
  238.  
  239. 2.0 INSTALLING CATBOX
  240.  
  241.     CATBOX is distributed in a ZIP file called CATBOX.ZIP.  It contains the
  242. following files:
  243.  
  244.         CATBOX.EXE      The executable file for CATBOX.
  245.         CATBOX.DOC      The documentation file
  246.         CATBOX.HLP      The context-sensitive help text for CATBOX's help 
  247.                         function.
  248.         CBOXSTD.TPL     The standard CIS long library listing format template.
  249.                         DO NOT RENAME THIS FILE!
  250.         CBOXNOV.TPL     Template for NOVLIB's preprocessed library listings.
  251.         FSORT.EXE       Standalone sort utility invoked by CATBOX.
  252.         FILETIME.EXE    Standalone utility to change a file's date/time stamp.
  253.         CAT2DL.EXE      Create download file/script from extracted catalog.
  254.         CATBOX.Vnn      Text file of version information for changes that were 
  255.                         made to the previous version in creating the new 
  256.                         version.
  257.         PRDOUCTS.DOC    This is a description of other Parity Solutions
  258.                         products available on CopuServe and ZiffNet.
  259.  
  260.     For best results, unzip the file into a directory on your PATH.  If you
  261. don't use a directory in your path, you will have to change to the directory
  262. containing CATBOX.EXE before running the program.  CATBOX searches the current
  263. directory and PATH directories to find where CATBOX.EXE is located.  CATBOX
  264. expects the CATBOX.HLP file to be in the same directory and saves configuration
  265. information in a CATBOX.CFG file in that directory.
  266.  
  267.     If you have a utility directory that is on your PATH, this is an excellent
  268. location for CATBOX.  An example installation would be:
  269.  
  270.     C:
  271.     CD \UTIL
  272.     COPY [path]CATBOX.ZIP
  273.     PKUNZIP CATBOX
  274.     DEL CATBOX.ZIP
  275.  
  276.     The PKUNZIP program is by PKWARE, Inc. and is available in many CompuServe
  277. forums under the file name of PKZ110.EXE.  Since you are reading this doc
  278. files, you have obviously already managed to unZIP the distribution file.  If 
  279. it is not currently in your path, simply copy all of the files to a directory 
  280. in your path.  Keep the CATBOX.ZIP file anywhere you like, but give plenty of
  281. copies, as is, to your friends.  If you register CATBOX, you are not licensed
  282. to give your serial number to anybody without first removing the serialization
  283. from your copy.
  284.  
  285.  
  286.  
  287. 3.0 RUNNING CATBOX
  288.  
  289. If you installed CATBOX.EXE in a directory on your path, simply type CATBOX at
  290. a DOS command line.  If you installed it in a directory that is not on your
  291. path, change to that drive and directory before typing CATBOX.
  292.  
  293. If you have problems with the menuing system displaying properly, or a blank
  294. screen, try loading CATBOX with the /B switch.  This tells CATBOX to perform
  295. all video functions through the BIOS rather than directly manipulating video
  296. memory.  Although screen writes are slower, it is a safer approach that may
  297. be required for some large, nonstandard video modes.
  298.  
  299. Add a /M switch to the command line to remap colors for easier viewing on
  300. monochrome monitors.
  301.  
  302.  
  303.  
  304. 4.0 CONFIGURING CATBOX
  305.  
  306.     The first time you run CATBOX, a configuration file is created called
  307. CATBOX.CFG in the same directory as CATBOX.EXE.  It is first created with some
  308. default information that may or may not be satisfactory to you.  Exit CATBOX
  309. and load CATBOX.CFG into any text (ASCII) file editor such as DOS 5.0's EDIT.  If
  310. you like the defaults, all you have to do is exit, otherwise edit the defaults
  311. to anything you want.  A sample config file (mine) is:
  312.  
  313. PATH=E:\OZCIS\NOVLIB\NOVLIB.L10
  314. TEMP=G:\WORK\
  315. TPL=C:\UTIL\CBOXSTD.TPL
  316. LINES=66
  317. PORT=LPT1
  318. USING=2PR %s 
  319.  
  320.     PATH=         This is the path and filename of the last catalog you opened. 
  321.                   It is updated each time you open a new catalog using CATBOX.
  322.  
  323.     TEMP=         This is a directory where temporary files created by CATBOX 
  324.                   such as indexes, will be created.  It defaults to any directory
  325.                   specified with the TEMP= environment variable.  FSORT.EXE, 
  326.                   which is used for sorting, does not use the config file, but it 
  327.                   will use the TEMP= environment variable.  See the section on
  328.                   FSORT.EXE for more information.  Change this parameter to point
  329.                   anywhere you would like the temp files kept.  Specification
  330.                   here overrides the TEMP= variable.
  331.  
  332.     TPL=          This is the file name and path of the last template you loaded. 
  333.                   It is updated each time you load a new template.  It defaults 
  334.                   to CBOXSTD.TPL in the directory where CATBOX.EXE is located.
  335.  
  336.     LINES=        This is the number of lines per page for your printer.  The
  337.                   default is 60.  This parameter can be modified from the PRINT
  338.                   menu.  It is updated each time you print a catalog.
  339.  
  340.     PORT=         This is the printer port to which print output will be sent. It
  341.                   defaults to LPT1.  This parameter can be modified from the 
  342.                   PRINT menu.  It is updated each time you print a catalog.
  343.  
  344.     USING=        This is the print utility command used by the PRINT USING
  345.                   function.  See the section on PRINT USING for format details. 
  346.                   It defaults to TYPE %s >PRN.  This parameter can be changed 
  347.                   from the PRINT USING dialogue box.
  348.  
  349.  
  350.     DEST=         This is the last destination path/filename specified for a
  351.                   MOVE or EXTRACT function.  It is updated during execution
  352.                   of these functions.
  353.  
  354.  
  355.  
  356. 5.0 THE CATBOX MENU STRUCTURE
  357.  
  358. 5.1 FILE MENU
  359.  
  360. The file menu lets you perform the following functions:
  361.  
  362.   OPEN            Read a library catalog file and build an index of the entries.
  363.  
  364.   SAVE            Read the index and catalog while writing a new catalog or
  365.                   replacing the existing catalog.  All sorts and deletes per-
  366.                   formed on the index are now saved in the new/replacement 
  367.                   catalog.
  368.  
  369.   CONVERT         Save a nonstandard format catalog in CIS standard format.
  370.  
  371.   TEMPLATE        Load a new template to be used on subsequent loads.
  372.  
  373.   PRINT           Print the catalog as it will look when saved.
  374.  
  375.   PRINT USING     Print the catalog as it will look when saved.  Use your 
  376.                   favorite file print utility to format the print.
  377.  
  378.   DOS SHELL       Exit to DOS to execute DOS commands.  Return to CATBOX with
  379.                   EXIT.
  380.  
  381.   ABOUT...        Display copyright and version information.
  382.  
  383.   EXIT            Exit CATBOX and return to DOS.
  384.  
  385.  
  386.  
  387.  
  388. 5.2 VIEW MENU
  389.  
  390. The view menu lets you perform the following functions:
  391.  
  392.   BROWSE          Display the catalog, one entry at a time allowing forward and
  393.                   backward movement.
  394.  
  395.   SEARCH          Display entries which contain a specified string.  The entire
  396.                   entry is searched disregarding case.  
  397.  
  398.   VIEW NEWER      Browse only those files that have an upload date more recent
  399.                   than a date you specify.
  400.  
  401.   VIEW OLDER      Browse only those files that have an upload date older than a
  402.                   date you specify.
  403.  
  404.  
  405.  
  406. 5.3 SORT
  407.  
  408. The SORT menu item lets you sort the index by up to four keys.  When you SAVE,
  409. the resulting catalog will be in the sorted order.
  410.  
  411.  
  412.  
  413. 5.4 DELETE MENU
  414.  
  415. The delete menu lets you select records to delete by using the following
  416. functions:
  417.  
  418.   SELECT                      Step through catalog entries one at a time speci-
  419.                               fying whether or not the record will be deleted.
  420.  
  421.   DELETE MATCHING             Specify a search string.  All matching entries will 
  422.                               be displayed to let you select them for deletion.
  423.  
  424.   DELETE NON-MATCHING         Specify a search string.  All entries NOT con-
  425.                               taining the string will be displayed to let you 
  426.                               select them for deletion.
  427.  
  428.   DELETE NEWER                Specify a date.  All records with an upload date 
  429.                               more recent than the specified date will be dis-
  430.                               played to let you select them for deletion.
  431.  
  432.   DELETE OLDER                Specify a date.  All records with an upload date 
  433.                               older than the specified date will be displayed to 
  434.                               let you select them for deletion.
  435.  
  436.   DELETE DUPLICATES           Delete duplicate index entries.  When you SAVE, the
  437.                               resulting catalog will not contain the duplicate 
  438.                               entries.
  439.  
  440.  
  441.  
  442. 5.5 EXTRACT MENU
  443.  
  444. The extract menu lets you select records to extract to another file by using
  445. the following functions:
  446.  
  447.   SELECT                      Step through catalog entries one at a time speci-
  448.                               fying whether or not the record will be extracted.
  449.  
  450.   EXTRACT MATCHING            Specify a search string.  All matching entries will 
  451.                               be displayed to let you select them for extraction.
  452.  
  453.   EXTRACT NON-MATCHING        Specify a search string.  All entries NOT con-
  454.                               taining the string will be displayed to let you 
  455.                               select them for extraction.
  456.  
  457.   EXTRACT NEWER               Specify a date.  All records with an upload date 
  458.                               more recent than the specified date will be dis-
  459.                               played to let you select them for extraction.
  460.  
  461.   EXTRACT OLDER               Specify a date.  All records with an upload date 
  462.                               older than the specified date will be displayed to 
  463.                               let you select them for extraction.
  464.  
  465.  
  466.  
  467.  
  468. 5.6 MOVE MENU
  469.  
  470. The move menu lets you select records to move to another file by using the
  471. following functions:
  472.  
  473.   SELECT                      Step through catalog entries one at a time speci-
  474.                               fying whether or not the record will be moved.
  475.  
  476.   MOVE MATCHING               Specify a search string.  All matching entries will 
  477.                               be displayed to let you select them to be moved.
  478.  
  479.   MOVE NON-MATCHING           Specify a search string.  All entries NOT con-
  480.                               taining the string will be displayed to let you 
  481.                               select them to be moved.
  482.  
  483.   MOVE NEWER                  Specify a date.  All records with an upload date 
  484.                               more recent than the specified date will be dis-
  485.                               played to let you select them to be moved.
  486.  
  487.   MOVE OLDER                  Specify a date.  All records with an upload date 
  488.                               older than the specified date will be displayed to 
  489.                               let you select them to be moved.
  490.  
  491.  
  492.  
  493.  
  494. 6.0 USING CATBOX
  495.  
  496. 6.1.1 MENU AND DATA ENTRY BASICS
  497.  
  498.  
  499.     When you first enter CATBOX you are on a menu bar that contains the items
  500. FILE, VIEW, SORT, DELETE, EXTRACT and MOVE.  You can move the red selection bar
  501. between items by using the left and right arrow keys.  Pressing ENTER while the
  502. selection bar is on an item invokes that function.  Most of the functions will
  503. then display a pull-down menu with additional selection items.  In pull down
  504. menus, you move the red selection bar by using the up and down arrow keys.
  505. Again, you select an item by pressing ENTER.
  506.  
  507.     Some functions require input from you.  In this case, a data entry window
  508. (dialogue box) will appear.  The current data entry field will appear with
  509. white letters on a blue background.  This is where you can type information.
  510. To move between data entry fields, use the TAB key.  Pressing ENTER will also
  511. move to the next field unless you are currently on the last data entry field in
  512. the dialogue box.  In this case, data entry is terminated and all data (if it
  513. passes audits) is accepted and the function proceeds.  Before you are allowed
  514. to move to another data entry field, sometimes audits are performed on the data
  515. entered in the current field.  If the data is invalid, you will not be able to
  516. proceed to the next field until good data is entered in the current field.
  517.  
  518.     Within a data entry field, certain keys can be used with the following
  519. effects:
  520.  
  521.        KEY                 ACTION
  522.  
  523.     Left arrow          Cursor moves left
  524.     Right arrow         Cursor moves right
  525.     Up arrow            Cursor up (on multiline fields)
  526.     Down arrow          Cursor down (on multiline fields)
  527.     CTRL-Left arrow     Move cursor one word left
  528.     CTRL-Right arrow    Move cursor one word right
  529.     TAB                 Next field
  530.     BACK TAB            Previous field
  531.     ENTER               Process field (on last field- process all fields)
  532.     CTRL-ENTER          Process all fields
  533.     HOME                Cursor to beginning of field
  534.     END                 Cursor to end of data on current line
  535.     CTRL-HOME           Cursor to start of first field
  536.     CTRL-END            Cursor to end of data on last field
  537.     INSERT              Toggle insert mode on/off
  538.     DELETE              Delete character at cursor
  539.     BACKSPACE           Delete character to left of cursor
  540.     CTRL-BACKSPACE      Delete word to left of cursor
  541.     CTRL-R              Restore field to original contents
  542.     CTRL-T              Delete word to right of cursor
  543.     CTRL-U              Delete from cursor to end of field
  544.     CTRL-Y              Delete from cursor to end of last field
  545.     ESCAPE              Abort data entry
  546.  
  547.  
  548.  
  549. 6.1.2 SHORTCUT KEYS
  550.  
  551.     The following shortcut keys may be accessed from anywhere in the menu
  552. structure to invoke the function as if the menu had been entered and the
  553. function selected:
  554.  
  555.   ALT-O - File/Open
  556.   ALT-S - File/Save
  557.   ALT-P - File/Print
  558.   ALT-U - File/Print using
  559.   ALT-X - File/Exit
  560.   CTL-S - Sort
  561.  
  562.     The shortcut keys may not be invoked from within dialog boxes or while
  563. viewing/selecting entries.
  564.  
  565.  
  566. 6.1.3 USING A MOUSE
  567.  
  568.     Limited mouse support has been added if you have a mouse driver loaded.
  569. The mouse works in the following circumstances:
  570.  
  571.     You may select any menu item from the current menu with the mouse.
  572.  
  573.     If you are in a pull-down menu you must close the menu with the right
  574.     mouse button before you can select another item from the main menu bar.
  575.  
  576.     While in dialog boxes, you can move the input cursor between fields by
  577.     moving the mouse.  Pressing the left button is the same as pressing ENTER
  578.     with the cursor in that field.  Pressing the right button is the same as
  579.     pressing ESCAPE.
  580.  
  581.  
  582. 6.2 FILE FUNCTIONS
  583.  
  584. 6.2.1 OPENING A CATALOG
  585.  
  586.     In order to perform any operation on a library catalog you must first open
  587. it.  Opening a file creates an index in the work directory that will be used to
  588. determine the order of all operations performed by CATBOX.  Opening a file
  589. closes any file that has already been opened.  If the current file has not
  590. been saved, you will be prompted and given a chance to save or discard it
  591. before the new file is opened.
  592.  
  593.     A data entry window will appear that allows you to enter a path and file
  594. name.  In the data entry areas will appear the path and file name of the last
  595. file you opened.  Press CTRL_ENTER to accept the current contents.  To change
  596. the path simply type over or modify the contents of the field.  Press CTRL-U
  597. to clear the field before typing if so desired.
  598.  
  599.     Once you press ENTER or TAB to move the cursor to the name field, a pick
  600. list of file names in the specified path appears.  You can select the file you
  601. want to open by moving the selection bar with the arrow keys and pressing
  602. ENTER.  If you prefer to type the file name, just press ESCAPE and the pick
  603. list will disappear.
  604.  
  605.     Pressing ENTER on the name field accepts the data as entered.  Pressing TAB
  606. returns you to the path field.
  607.  
  608.     If there are entries which obviously do not fit the template, they are
  609. copied to a file in the same directory as CATBOX.EXE called CATBOX.REJ.  This
  610. file is a continuous log of rejected entries.  Each entry in the log is pre-
  611. ceeded by a date and time stamp (when logged) and the catalog name of the
  612. catalog that was being opened.  CATBOX continues to add rejects to the log file
  613. until you clear it by deleteing, renaming or moving the CATBOX.REJ file.  A new
  614. reject log will be started the next time an entry is rejected.
  615.  
  616.  
  617.  
  618. 6.2.2 SAVING A CATALOG
  619.  
  620.     To store a copy of the new library catalog incorporating any changes you 
  621. have made to the content or order, you must save the file.  Saving a file reads 
  622. the index to determine the order of records and the location of the text in the 
  623. original catalog.  The text is read from the original catalog and a new catalog 
  624. is built.
  625.  
  626.  
  627.     A data entry window will appear that allows you to enter a path and file 
  628. name.  In the data entry areas will appear the path and file name of the last 
  629. file you opened.  Press CTRL_ENTER to accept the current contents.  To change 
  630. the path simply type over or modify the contents of the field.  Press CTRL-U to 
  631. clear the field before typing if so desired.  If you save the file to the same 
  632. path and file name as was originally opened, the original contents are replaced 
  633. with the new catalog.  You can specify a different path and/or file name so 
  634. that your original catalog remains intact.
  635.  
  636.     "Use same file time?" lets you decide whether or not you wish to copy the
  637. date/time stamp from the last opened catalog to the output catalog.  This is
  638. handy for users who use the update feature of OZCIS, since OZCIS begins cap-
  639. turing new entries based on the file date/time stamp.  Enter Y to copy the
  640. date/time stamp or N to use the current date and time.
  641.  
  642.     Pressing ENTER on the last field accepts the data as entered.  Pressing TAB
  643. returns you to the path field.
  644.  
  645.  
  646.  
  647. 6.2.3 SAVING A NONSTANDARD CATALOG IN STANDARD CIS FORMAT
  648.  
  649.     If you have opened a catalog using a template other than CBOXSTD.TPL, you
  650. can convert it to standard CIS format.  
  651.  
  652.     Selecting CONVERT performs in the same manner as SAVE except that CATBOX
  653. uses the CBOXSTD.TPL template to determine the output format.  Once the catalog
  654. has been saved, CBOXSTD.TPL becomes the loaded template for further processing. 
  655. As with the SAVE function, you will be able to specify a different path and/or
  656. file name or you can overwrite the original catalog.
  657.  
  658.     There will be one difference (besides format) in the header information of
  659. the output file.  Sometimes there are two dates specified in a header, the
  660. initial upload date and a last updated date.  The new output catalog will only
  661. contain the last updated date, which I consider the only date of real
  662. importance to the potential downloader.
  663.  
  664.  
  665.  
  666. 6.2.4 LOADING A TEMPLATE
  667.  
  668.     Templates are used to describe the location of information in catalog
  669. entries.  This allows you to open and process non-standard catalog formats. 
  670. Templates must be named with a file extension of .TPL.  See the section on
  671. TEMPLATES for instructions on constructing custom templates.  If the template
  672. selected does not match the format of the catalog entries, you will experience
  673. problems opening, viewing and sorting files.  The primary cause of data errors
  674. in CATBOX will be caused by mismatched catalogs and templates. 
  675.  
  676.     A data entry window will appear that allows you to enter a path and file 
  677. name.  In the data entry areas will appear the path and file name of the last 
  678. template you opened.  Press CTRL_ENTER to accept the current contents.  To
  679. change the path simply type over or modify the contents of the field.  Press
  680. CTRL-U to clear the field before typing if so desired.
  681.  
  682.     Once you press ENTER or TAB to move the cursor to the name field, a pick
  683. list of template file names in the specified path appears.  You can select the
  684. template you want to open by moving the selection bar with the arrow keys and
  685. pressing ENTER.  If you prefer to type the template name, just press ESCAPE
  686. and the pick list will disappear.
  687.  
  688.     Pressing ENTER on the name field accepts the data as entered.  Pressing TAB
  689. returns you to the path field.
  690.  
  691.  
  692.  
  693. 6.2.5 PRINTING A CATALOG
  694.  
  695.     Selecting the PRINT option will allow you to print the currently opened
  696. catalog as it has been processed by CATBOX.  The catalog need not have been
  697. previously saved.
  698.  
  699.     A data entry window will appear that allows you to enter the number of 
  700. lines per page and the printer port.  In the data entry areas will appear the
  701. values you last used.  Press CTRL_ENTER to accept the current contents.  To
  702. change the lines per page simply type over or modify the contents of the field. 
  703. Press CTRL-U to clear the field before typing if so desired.
  704.  
  705.     Once you press ENTER or TAB to move the cursor to the printer port field, a
  706. pick list of allowable ports appears.  You can select the port you want to use
  707. by moving the selection bar with the arrow keys and pressing ENTER.  If you 
  708. prefer to type the port name, just press ESCAPE and the pick list will
  709. disappear.
  710.  
  711.     Pressing ENTER on the printer port field accepts the data as entered. 
  712. Pressing TAB returns you to the lines per page field.
  713.  
  714.  
  715.  
  716. 6.2.6 PRINTING A CATALOG USING AN EXTERNAL PRINT UTILITY
  717.  
  718.     The PRINT USING option allows you to enter a command line just as you would
  719. at the DOS command prompt to invoke your favorite file print utility to format 
  720. the printed output and direct it to the proper port.  The only difference in
  721. entering the command here and at the DOS prompt is that you use the characters
  722. %s (lower case s) in the command line spot where you would normally type the
  723. file name of the file to be printed.  Batch files (.BAT) may be executed with
  724. PRINT USING.
  725.  
  726.     Do not invoke Terminate-and-stay-resident (TSR) programs with the PRINT 
  727. USING command.  DOS has a PRINT command that buffers and prints files.  It is a 
  728. TSR, so DO NOT use it.
  729.  
  730.     The catalog does not have to be saved before you use PRINT USING.  CATBOX
  731. will use the current index and create a temporary file that will be printed by
  732. the print utility.
  733.  
  734.  
  735.  
  736. 6.2.7 TEMPORARILY EXIT TO DOS
  737.  
  738.     By selecting DOS SHELL you will be taken to the DOS prompt on a clear 
  739. screen.  You can execute almost any DOS command or program while in the DOS
  740. shell.  Do not load any terminate-and-stay-resident (TSR) program while in the
  741. DOS shell unless you can remove it from memory before returning to CATBOX.  To 
  742. return to CATBOX from the DOS shell, simply type EXIT at any DOS prompt.
  743.  
  744.  
  745.  
  746. 6.2.8 VIEW CATBOX VERSION AND COPYRIGHT INFORMATION
  747.  
  748.     Selecting ABOUT... will display a pop-up window with version, serialization
  749. and copyright information about CATBOX.  Pressing any key removes the window
  750. and returns you to the CATBOX menu bar.
  751.  
  752.  
  753.  
  754. 6.2.9 EXIT CATBOX
  755.  
  756.     Selecting EXIT will leave CATBOX and return to DOS. You can also exit via
  757. the ALT-X shortcut key combination.
  758.  
  759.     If you have made changes to the current catalog that have not been saved,
  760. you will be asked if you want to save the catalog before exiting.  Pressing
  761. ESCAPE in this prompt window aborts the exit process and returns you to the
  762. main menu bar.
  763.  
  764.  
  765. 6.3 VIEW FUNCTIONS
  766.  
  767. 6.3.1 BROWSE THE CATALOG
  768.  
  769.     Browsing lets you display entries on the screen moving forward and backward
  770. through the catalog.
  771.  
  772.     Selecting BROWSE displays the first catalog entry on the screen.  Pressing
  773. PageDown will display the next entry.  Pressing PageUp will display the
  774. previous entry.  If the entry does not change when you press PageDown or PageUp
  775. you are viewing the last or first entry in the catalog, respectively.  The
  776. entry number that you are viewing appears in the upper right corner of the
  777. screen on the menu bar line.
  778.  
  779.     Pressing ESC terminates the browse function and you are returned to the
  780. menu bar.
  781.  
  782.     There are seven keys available that do not appear in the prompt on the
  783. bottom line of the screen.  Pressing HOME, CTRL-PageUp or T will position the
  784. display at the top, or first entry, of the catalog.  Pressing END, CTRL-
  785. PageDown or B will position the display at the bottom, or last entry, of the
  786. catalog.  Pressing P prints the entry you are viewing.
  787.  
  788.  
  789.  
  790. 6.3.2 SEARCH THE CATALOG
  791.  
  792.     Searching lets you display only those entries on the screen that contain a
  793. given word, phrase or other string of characters.  You can then move the
  794. display forward and backward through the matching entries.  A search on a new
  795. string always begins by testing the first entry and proceeds forward until a
  796. match is found or all entries have been searched.  The search is case-
  797. insensitive (small letters are treated the same as capitals).  The entire entry
  798. is searched from the start of the heading to the last of the text.  If the
  799. search string exists starting at the end of one line of the entry text and
  800. continues at the beginning of the next line, the search will still find the
  801. match.
  802.  
  803.     When you select SEARCH a dialogue box appears that lets you input the
  804. string that you want located.  The data entry field will contain the last
  805. search string that you entered during this session.  You may type over, edit or
  806. delete (CTRL-U) the current contents of the field.  Pressing ENTER accepts the
  807. string as entered and begins the search.
  808.  
  809.     The first matching catalog entry will be displayed on the screen.  Pressing
  810. PageDown will display the next matching entry.  Pressing PageUp will display
  811. the previous matching entry.  If the entry does not change when you press
  812. PageDown or PageUp you are viewing the last or first matching entry in the
  813. catalog, respectively.  The current entry number is displayed on the right side 
  814. of the menu bar.
  815.  
  816.     Searching backward (PageUp) is much slower than searching forward due to
  817. the fact that DOS files were not designed to be read backwards.  If any search
  818. appears to be taking too long, you may press ESC to terminate the search.
  819.  
  820.     Pressing ESC terminates the browse function and you are returned to the
  821. menu bar.
  822.  
  823.     There are seven keys available that do not appear in the prompt on the 
  824. bottom line of the screen.  Pressing HOME, CTRL-PageUp or T will position the 
  825. display at the top, or first entry, of the catalog.  Pressing END, CTRL-
  826. PageDown or B will position the display at the bottom, or last entry, of the 
  827. catalog.  When you go to the top or bottom, the search is aborted and you 
  828. revert to BROWSE mode.  Pressing P prints the entry you are viewing.
  829.  
  830.  
  831.  
  832. 6.3.3 VIEW ENTRIES NEWER THAN A GIVEN DATE
  833.  
  834.     Choosing VIEW NEWER begins a variation of the BROWSE function where you are 
  835. only shown entries in which the upload date is more recent than a given date.  
  836.  
  837.     When you select VIEW NEWER, a dialogue box appears that lets you input
  838. the cut-off date that you want to use.  The data entry field will contain
  839. the last date that you entered during this session.  You may type over, edit or
  840. delete (CTRL-U) the current contents of the field.  Pressing ENTER accepts the
  841. date as entered and begins the search.
  842.  
  843.     It searches the file and displays the first entry more recent than the
  844. specified date. Pressing PageDown will display the next entry.  Pressing
  845. PageUp will display the previous entry.  If the entry does not change when you 
  846. press PageDown or PageUp you are viewing the last or first entry in the 
  847. catalog, respectively.  The entry number that you are viewing appears in the 
  848. upper right corner of the screen on the menu bar line.
  849.  
  850.     Pressing ESC terminates the browse function and you are returned to the
  851. menu bar.
  852.  
  853.     There are seven keys available that do not appear in the prompt on the 
  854. bottom line of the screen.  Pressing HOME, CTRL-PageUp or T will position the 
  855. display at the top, or first entry, of the catalog.  Pressing END, CTRL-
  856. PageDown or B will position the display at the bottom, or last entry, of the 
  857. catalog.  When you go to the top or bottom, the date search is aborted and you 
  858. revert to BROWSE mode.  Pressing P prints the entry you are viewing.
  859.  
  860.  
  861.  
  862. 6.3.4 VIEW ENTRIES OLDER THAN A GIVEN DATE
  863.  
  864.     Choosing VIEW OLDER begins a variation of the BROWSE function where you are 
  865. only shown entries in which the upload date is older than a given date.  
  866.  
  867.     When you select VIEW OLDER, a dialogue box appears that lets you input
  868. the cut-off date that you want to use.  The data entry field will contain
  869. the last date that you entered during this session.  You may type over, edit or
  870. delete (CTRL-U) the current contents of the field.  Pressing ENTER accepts the
  871. date as entered and begins the search.
  872.  
  873.     It searches the file and displays the first entry older than the specified
  874. date.  Pressing PageDown will display the next matching entry.  Pressing PageUp
  875. will display the previous matching entry.  If the entry does not change when
  876. you press PageDown or PageUp you are viewing the last or first entry in the
  877. catalog, respectively.  The entry number that you are viewing appears in the 
  878. upper right corner of the screen on the menu bar line.
  879.  
  880.     Pressing ESC terminates the browse function and you are returned to the
  881. menu bar.
  882.  
  883.     There are seven keys available that do not appear in the prompt on the 
  884. bottom line of the screen.  Pressing HOME, CTRL-PageUp or T will position the 
  885. display at the top, or first entry, of the catalog.  Pressing END, CTRL-
  886. PageDown or B will position the display at the bottom, or last entry, of the 
  887. catalog.  When you go to the top or bottom, the date search is aborted and you 
  888. revert to BROWSE mode.  Pressing P prints the entry you are viewing.
  889.  
  890.  
  891.  
  892. 6.4 SORT FUNCTION
  893.  
  894. 6.4.1 SORT THE CATALOG
  895.  
  896.     Selecting SORT will allow you to sort the index of catalog entries.  Once
  897. the index has been sorted, subsequent actions will treat the catalog as if it
  898. is in the sorted order.  Only SAVE will actually store the file on disk in the
  899. sorted order, even though functions such as VIEW and PRINT make it appear that
  900. the order of the catalog has been changed.
  901.  
  902.     When SORT is selected, a dialogue box appears that looks like this:
  903.  
  904.                  ┌─────────────────────────────────────────┐
  905.                  │ Select up to four sort keys followed by │
  906.                  │ A (Ascending) or D (Descending):        │
  907.                  │                                         │
  908.                  │    N - File name                        │
  909.                  │    E - File extension                   │
  910.                  │    D - Upload date                      │
  911.                  │    I - Uploader ID                      │
  912.                  │    L - Library number                   │
  913.                  │    F - File type                        │
  914.                  │    C - Download count                   │
  915.                  │    S - File size                        │
  916.                  │                                         │
  917.                  │ LA DD NA EA                             │
  918.                  └─────────────────────────────────────────┘
  919.  
  920.  
  921.     There are four data entry fields at the bottom of the screen.  This is
  922. where you determine the order in which the index will be sorted.  The list
  923. shows the fields by which you can sort.  Enter the letter for the field
  924. followed by an A or D.  The A or D determines whether that field will be sorted
  925. ascendingly or descendingly.  The order of priority of the sort field is from
  926. left to right.  For example, as the keys are entered in the figure above, the
  927. catalog is primarily sorted in ascending library order (i.e. LIB 1, LIB 2, ...
  928. LIB n).  Within each library grouping, the entries will be sorted in descending
  929. date order, in other words, the newest will appear first down to the oldest. 
  930. If more than one entry exist for a given date, those entries appear in file
  931. name and extension order.  This is my favorite sort order because I can easily
  932. see the newest entries in each library  without having to look though the
  933. entire catalog.
  934.  
  935.     Pressing CTRL-ENTER at any time or ENTER on the last field, accepts the
  936. keys as entered and begins the sort.  Naturally, in most cases, the more
  937. entries that are in a catalog, the longer it takes to sort.  The QuickSort
  938. algorithm is used for the sort by invoking the FSORT.EXE program.  For more
  939. information about the sort program, see the section on FSORT.EXE.  You can also
  940. use it as a stand alone sort utility to sort almost any text file of almost any
  941. size by invoking FSORT on the DOS command line.
  942.  
  943.  
  944.  
  945.  
  946. 6.5 DELETE FUNCTIONS
  947.  
  948.     NOTE- Pressing P while an entry is displayed and awaiting a Y/N response
  949. for deletion, will print the entry.
  950.  
  951.  
  952. 6.5.1 SELECTING ENTRIES TO DELETE
  953.  
  954.     Choosing SELECT begins a process very similar to the VIEW/BROWSE function. 
  955. It displays one entry at a time from the start of the catalog to the end asking
  956. if you want to delete the entry.  To delete the entry, press Y.  To retain the
  957. entry, press N.
  958.  
  959.     This function only moves forward through the catalog.  Once an entry is
  960. selected for deletion by pressing Y, it cannot be recovered except by pressing
  961. ESC.  Pressing ESC terminates the selection/deletion process, returns the index
  962. to its condition before the selection pass began, and returns you to the menu
  963. bar.  END also terminates selection, but any selected entries are deleted. 
  964.  
  965.     When you reach the end of the catalog you are returned to the menu bar.  A
  966. new index has been created that no longer contains those entries that you
  967. selected for deletion.
  968.  
  969.  
  970.  
  971. 6.5.2 DELETE ENTRIES MATCHING A SEARCH STRING
  972.  
  973.     Choosing DELETE MATCHING begins a process very similar to the VIEW/SEARCH
  974. function.  It searches the file and displays one matching entry at a time from
  975. the start of the catalog to the end asking if you want to delete the entry.  To
  976. delete the entry, press Y.  To retain the entry, press N.
  977.  
  978.     The search is case-insensitive (small letters are treated the same as
  979. capitals).  The entire entry is searched from the start of the heading to the
  980. last of the text.  If the search string exists starting at the end of one line
  981. of the entry text and continues at the beginning of the next line, the search
  982. will still find the match.
  983.  
  984.     When you select DELETE MATCHING a dialogue box appears that lets you input
  985. the string that you want located.  The data entry field will contain the last
  986. search string that you entered during this session.  You may type over, edit or
  987. delete (CTRL-U) the current contents of the field.  Pressing ENTER accepts the
  988. string as entered and begins the search.
  989.  
  990.     This function only moves forward through the catalog.  Once an entry is
  991. selected for deletion by pressing Y, it cannot be recovered except by pressing
  992. ESC.  Pressing ESC terminates the selection/deletion process, returns the index
  993. to its condition before the selection pass began, and returns you to the menu
  994. bar. END also terminates selection, but any selected entries are deleted. 
  995.  
  996.     When you reach the end of the catalog you are returned to the menu bar.  A
  997. new index has been created that no longer contains those entries that you
  998. selected for deletion.
  999.  
  1000.     Non-matching entries are not displayed and are always retained.
  1001.  
  1002.     At any time that a matching entry is being displayed, you may press A to
  1003. stop displaying the matches and prompting for deletion.  CATBOX will continue
  1004. through the file deleting all matching entries and keeping those that do not
  1005. match.
  1006.  
  1007.  
  1008.  
  1009. 6.5.3 DELETE RECORDS NOT MATCHING A SEARCH STRING
  1010.  
  1011.     Choosing DELETE NON-MATCHING begins a process very similar to the DELETE
  1012. MATCHING function except that you are prompted to delete records which DO NOT
  1013. contain the search string.  It searches the file and displays one non-matching
  1014. entry at a time from the start of the catalog to the end asking if you want to
  1015. delete the entry.  To delete the entry, press Y.  To retain the entry, press N.
  1016.  
  1017.     The search is case-insensitive (small letters are treated the same as
  1018. capitals).  The entire entry is searched from the start of the heading to the
  1019. last of the text.  If the search string exists starting at the end of one line
  1020. of the entry text and continues at the beginning of the next line, the search
  1021. will still find the match.
  1022.  
  1023.     When you select DELETE NON-MATCHING a dialogue box appears that lets you
  1024. input the string that you want located.  The data entry field will contain the
  1025. last search string that you entered during this session.  You may type over,
  1026. edit or delete (CTRL-U) the current contents of the field.  Pressing ENTER
  1027. accepts the string as entered and begins the search.
  1028.  
  1029.     This function only moves forward through the catalog.  Once an entry is
  1030. selected for deletion by pressing Y, it cannot be recovered except by pressing
  1031. ESC.  Pressing ESC terminates the selection/deletion process, returns the index
  1032. to its condition before the selection pass began, and returns you to the menu
  1033. bar. END also terminates selection, but any selected entries are deleted. 
  1034.  
  1035.     When you reach the end of the catalog you are returned to the menu bar.  A
  1036. new index has been created that no longer contains those entries that you
  1037. selected for deletion.
  1038.  
  1039.     Matching entries are not displayed and are always retained.
  1040.  
  1041.     At any time that a non-matching entry is being displayed, you may press A
  1042. to stop displaying the entries and prompting for deletion.  CATBOX will
  1043. continue through the file deleting all non-matching entries and keeping those
  1044. that match.
  1045.  
  1046.  
  1047.  
  1048. 6.5.4 DELETE ENTRIES NEWER THAN A GIVEN DATE
  1049.  
  1050.     Choosing DELETE NEWER begins a process very similar to the DELETE
  1051. MATCHING function except that you are prompted to delete records in which the
  1052. upload date is more recent than a given date.  It searches the file and 
  1053. displays one newer entry at a time from the start of the catalog to the end 
  1054. asking if you want to delete the entry.  To delete the entry, press Y.  To 
  1055. retain the entry, press N.
  1056.  
  1057.     When you select DELETE NEWER, a dialogue box appears that lets you input
  1058. the cutoff date that you want to specify.  The data entry field will contain
  1059. the last date that you entered during this session.  You may type over, edit or
  1060. delete (CTRL-U) the current contents of the field.  Pressing ENTER accepts the
  1061. date as entered and begins the search.
  1062.  
  1063.     This function only moves forward through the catalog.  Once an entry is
  1064. selected for deletion by pressing Y, it cannot be recovered except by pressing
  1065. ESC.  Pressing ESC terminates the selection/deletion process, returns the index
  1066. to its condition before the selection pass began, and returns you to the menu
  1067. bar. END also terminates selection, but any selected entries are deleted. 
  1068.  
  1069.     When you reach the end of the catalog you are returned to the menu bar.  A
  1070. new index has been created that no longer contains those entries that you
  1071. selected for deletion.
  1072.  
  1073.     Entries with upload dates equal to or older than the specified date are not
  1074. displayed and are always retained.
  1075.  
  1076.     At any time that an entry is being displayed, you may press A to stop
  1077. displaying the entries and prompting for deletion.  CATBOX will continue
  1078. through the file deleting all newer entries and keeping the older entries.
  1079.  
  1080.  
  1081.  
  1082. 6.5.5 DELETE ENTRIES OLDER THAN A GIVEN DATE
  1083.  
  1084.     Choosing DELETE OLDER begins a process very similar to the DELETE
  1085. MATCHING function except that you are prompted to delete records in which the
  1086. upload date is older than a given date.  It searches the file and displays one
  1087. older entry at a time from the start of the catalog to the end asking if you
  1088. want to delete the entry.  To delete the entry, press Y.  To retain the entry,
  1089. press N.
  1090.  
  1091.     When you select DELETE OLDER a dialogue box appears that lets you input
  1092. the earliest date that you want retained.  The data entry field will contain
  1093. the last date that you entered during this session.  You may type over, edit or
  1094. delete (CTRL-U) the current contents of the field.  Pressing ENTER accepts the
  1095. date as entered and begins the search.
  1096.  
  1097.     This function only moves forward through the catalog.  Once an entry is
  1098. selected for deletion by pressing Y, it cannot be recovered except by pressing
  1099. ESC.  Pressing ESC terminates the selection/deletion process, returns the index
  1100. to its condition before the selection pass began, and returns you to the menu
  1101. bar. END also terminates selection, but any selected entries are deleted. 
  1102.  
  1103.     When you reach the end of the catalog you are returned to the menu bar.  A
  1104. new index has been created that no longer contains those entries that you
  1105. selected for deletion.
  1106.  
  1107.     Entries with upload dates equal to or later than the specified date are not
  1108. displayed and are always retained.
  1109.  
  1110.     At any time that an entry is being displayed, you may press A to stop
  1111. displaying the entries and prompting for deletion.  CATBOX will continue
  1112. through the file deleting all older entries and keeping the newer entries.
  1113.  
  1114.  
  1115.  
  1116. 6.5.6 DELETING DUPLICATE ENTRIES
  1117.  
  1118.  
  1119.     Selecting DELETE DUPLICATES allows you to delete any entries that exist
  1120. more than once.  This can happen if you combine multiple catalogs into one. 
  1121. Sometimes downloaded catalogs also contain duplicate entries.  An entry is
  1122. considered a duplicate if the name, extension, uploader ID and size are
  1123. identical.
  1124.  
  1125.     In order to determine if duplicates exist, CATBOX sorts the index by name,
  1126. extension, uploader ID and size.  If you had previously sorted the index in a
  1127. different order, you will need to sort it again after the duplicates are
  1128. deleted.
  1129.  
  1130.     You are not prompted for deletion of individual entries once the process
  1131. begins.  They are automatically deleted when encountered.
  1132.  
  1133.     If you are processing a catalog that contains entries for more than one
  1134. library and the same entry is present in more than one library, the entry will
  1135. be deleted from all but the highest numbered library.
  1136.  
  1137.  
  1138.  
  1139. 6.6 EXTRACT FUNCTIONS
  1140.  
  1141.     The extract functions allow you to select a subset of entries and copy them
  1142. to another catalog.  If the target catalog does not exist, a new catalog is
  1143. created.  If the target catalog exists, the entries are added to the end of the
  1144. catalog.
  1145.  
  1146.     NOTE- Pressing P while an entry is displayed and awaiting a Y/N response
  1147. for extraction, will print the entry.
  1148.  
  1149.  
  1150.  
  1151. 6.6.1 SELECTING ENTRIES TO EXTRACT
  1152.  
  1153.     Choosing SELECT begins a process very similar to the VIEW/BROWSE function. 
  1154. It displays one entry at a time from the start of the catalog to the end asking
  1155. if you want to extract the entry.  To extract the entry, press Y, otherwise
  1156. press N.
  1157.  
  1158.     When you choose SELECT, a dialogue box appears to let you enter the name of
  1159. the destination, or target catalog.  This field will contain the last desti-
  1160. nation that you specified.  You may type over, edit or delete (CTRL-U) the 
  1161. current contents of the field.  Pressing ENTER accepts the path as entered and 
  1162. begins processing.
  1163.  
  1164.  
  1165.     This function only moves forward through the catalog.  Once an entry is
  1166. selected for extraction by pressing Y, it is immediately copied and cannot be
  1167. deselected.  Pressing ESC terminates the selection/extraction process at that
  1168. point and returns you to the menu bar.  Any entries previously selected for
  1169. extraction have already been copied to the target file.  END also terminates 
  1170. selection, with the same results as ESC. 
  1171.  
  1172.     When you reach the end of the catalog you are returned to the menu bar. 
  1173. The new catalog has been created that contains those entries that you selected
  1174. for extraction.
  1175.  
  1176.  
  1177.  
  1178. 6.6.2 EXTRACTING ENTRIES MATCHING A SEARCH STRING
  1179.  
  1180.     Choosing EXTRACT MATCHING begins a process very similar to the VIEW/SEARCH
  1181. function.  It searches the file and displays one matching entry at a time from
  1182. the start of the catalog to the end asking if you want to extract the entry. 
  1183. To extract the entry, press Y, otherwise press N.
  1184.  
  1185.     The search is case-insensitive (small letters are treated the same as
  1186. capitals).  The entire entry is searched from the start of the heading to the
  1187. last of the text.  If the search string exists starting at the end of one line
  1188. of the entry text and continues at the beginning of the next line, the search
  1189. will still find the match.
  1190.  
  1191.     When you choose EXTRACT MATCHING, a dialogue box appears to let you enter
  1192. the name of the destination, or target catalog.  This field will contain the
  1193. last destination that you specified.  You may type over, edit or delete (CTRL-
  1194. U) the current contents of the field.  Pressing ENTER accepts the path as 
  1195. entered.
  1196.  
  1197.     Next a dialogue box appears that lets you input the string that you want
  1198. located.  The data entry field will contain the last search string that you
  1199. entered during this session.  You may type over, edit or delete (CTRL-U) the
  1200. current contents of the field.  Pressing ENTER accepts the string as entered
  1201. and begins the search.
  1202.  
  1203.     This function only moves forward through the catalog.  Once an entry is
  1204. selected for extraction by pressing Y, it is immediately copied and cannot be
  1205. deselected.  Pressing ESC terminates the selection/extraction process at that
  1206. point and returns you to the menu bar.  Any entries previously selected for
  1207. extraction have already been copied to the target file.  END also terminates 
  1208. selection, with the same results as ESC. 
  1209.  
  1210.     When you reach the end of the catalog you are returned to the menu bar. 
  1211. The new catalog has been created that contains those entries that you selected
  1212. for extraction.
  1213.  
  1214.     Non-matching entries are not displayed and are never extracted.
  1215.  
  1216.     At any time that a matching entry is being displayed, you may press A to
  1217. stop displaying the matches and prompting for extraction.  CATBOX will continue
  1218. through the file extracting all matching entries and ignoring those that do not
  1219. match.
  1220.  
  1221.  
  1222.  
  1223. 6.6.3 EXTRACT RECORDS NOT MATCHING A SEARCH STRING
  1224.  
  1225.     Choosing EXTRACT NON-MATCHING begins a process very similar to the EXTRACT
  1226. MATCHING function except that you are prompted to extract records which DO NOT
  1227. contain the search string.  It searches the file and displays one non-matching
  1228. entry at a time from the start of the catalog to the end asking if you want to
  1229. extract the entry.  To extract the entry, press Y, otherwise press N.
  1230.  
  1231.     The search is case-insensitive (small letters are treated the same as
  1232. capitals).  The entire entry is searched from the start of the heading to the
  1233. last of the text.  If the search string exists starting at the end of one line
  1234. of the entry text and continues at the beginning of the next line, the search
  1235. will still find the match.
  1236.  
  1237.     When you choose EXTRACT NON-MATCHING, a dialogue box appears to let you
  1238. enter the name of the destination, or target catalog.  This field will contain
  1239. the last destination that you specified.  You may type over, edit or delete 
  1240. (CTRL-U) the current contents of the field.  Pressing ENTER accepts the path 
  1241. as entered.
  1242.  
  1243.     Next a dialogue box appears that lets you input the string that you want
  1244. located.  The data entry field will contain the last search string that you
  1245. entered during this session.  You may type over, edit or delete (CTRL-U) the
  1246. current contents of the field.  Pressing ENTER accepts the string as entered
  1247. and begins the search.
  1248.  
  1249.     This function only moves forward through the catalog.  Once an entry is
  1250. selected for extraction by pressing Y, it is immediately copied and cannot be
  1251. deselected.  Pressing ESC terminates the selection/extraction process at that
  1252. point and returns you to the menu bar.  Any entries previously selected for
  1253. extraction have already been copied to the target file.  END also terminates 
  1254. selection, with the same results as ESC. 
  1255.  
  1256.     When you reach the end of the catalog you are returned to the menu bar. 
  1257. The new catalog has been created that contains those entries that you selected
  1258. for extraction.
  1259.  
  1260.     Matching entries are not displayed and are never extracted.
  1261.  
  1262.     At any time that a non-matching entry is being displayed, you may press A
  1263. to stop displaying the entries and prompting for extraction.  CATBOX will
  1264. continue through the file extracting all non-matching entries and ignoring
  1265. those that match.
  1266.  
  1267.  
  1268.  
  1269. 6.6.4 EXTRACT ENTRIES NEWER THAN A GIVEN DATE
  1270.  
  1271.     Choosing EXTRACT NEWER begins a process very similar to the EXTRACT 
  1272. MATCHING function except that you are prompted to extract records in which the
  1273. upload date is more recent than a given date.  It searches the file and 
  1274. displays one newer entry at a time from the start of the catalog to the end, 
  1275. asking if you want to extract the entry.  To extract the entry, press Y, 
  1276. otherwise press N.
  1277.  
  1278.     When you select EXTRACT NEWER, a dialogue box appears to let you enter the 
  1279. name of the destination, or target catalog.  This field will contain the last 
  1280. destination that you specified.  You may type over, edit or delete (CTRL-U) 
  1281. the current contents of the field.  Pressing ENTER accepts the path as entered.
  1282.  
  1283.     Next, a dialogue box appears that lets you input the cutoff date that you 
  1284. want to use.  The data entry field will contain the last date that you entered
  1285. during this session.  You may type over, edit or delete (CTRL-U) the current 
  1286. contents of the field.  Pressing ENTER accepts the date as entered and begins 
  1287. the search.
  1288.  
  1289.     This function only moves forward through the catalog.  Once an entry is
  1290. selected for extraction by pressing Y, it is immediately copied and cannot be
  1291. deselected.  Pressing ESC terminates the selection/extraction process at that
  1292. point and returns you to the menu bar.  Any entries previously selected for
  1293. extraction have already been copied to the target file.  END also terminates 
  1294. selection, with the same results as ESC. 
  1295.  
  1296.     When you reach the end of the catalog you are returned to the menu bar. 
  1297. The new catalog has been created that contains those entries that you selected
  1298. for extraction.
  1299.  
  1300.     Entries with upload dates equal to or older than the specified date are not
  1301. displayed and are never extracted.
  1302.  
  1303.     At any time that an entry is being displayed, you may press A to stop
  1304. displaying the entries and prompting for extraction.  CATBOX will continue
  1305. through the file extracting all newer entries and ignoring the older entries.
  1306.  
  1307.  
  1308. 6.6.5 EXTRACT ENTRIES OLDER THAN A GIVEN DATE
  1309.  
  1310.     Choosing EXTRACT OLDER begins a process very similar to the EXTRACT
  1311. MATCHING function except that you are prompted to extract records in which the
  1312. upload date is older than a given date.  It searches the file and displays one 
  1313. older entry at a time from the start of the catalog to the end, asking if you 
  1314. want to extract the entry.  To extract the entry, press Y, otherwise press N.
  1315.  
  1316.     When you select EXTRACT OLDER, a dialogue box appears to let you enter the 
  1317. name of the destination, or target catalog.  This field will contain the last 
  1318. destination that you specified.  You may type over, edit or delete (CTRL-U) 
  1319. the current contents of the field.  Pressing ENTER accepts the path as entered.
  1320.  
  1321.     Next, a dialogue box appears that lets you input the cutoff date that you 
  1322. want to use.  The data entry field will contain the last date that you entered
  1323. during this session.  You may type over, edit or delete (CTRL-U) the current 
  1324. contents of the field.  Pressing ENTER accepts the date as entered and begins 
  1325. the search.
  1326.  
  1327.     This function only moves forward through the catalog.  Once an entry is
  1328. selected for extraction by pressing Y, it is immediately copied and cannot be
  1329. deselected.  Pressing ESC terminates the selection/extraction process at that
  1330. point and returns you to the menu bar.  Any entries previously selected for
  1331. extraction have already been copied to the target file.  END also terminates 
  1332. selection, with the same results as ESC. 
  1333.  
  1334.     When you reach the end of the catalog you are returned to the menu bar. 
  1335. The new catalog has been created that contains those entries that you selected
  1336. for extraction.
  1337.  
  1338.     Entries with upload dates equal to or newer than the specified date are not
  1339. displayed and are never extracted.
  1340.  
  1341.     At any time that an entry is being displayed, you may press A to stop
  1342. displaying the entries and prompting for extraction.  CATBOX will continue
  1343. through the file extracting all older entries and ignoring the newer entries.
  1344.  
  1345.  
  1346.  
  1347. 6.7 MOVE FUNCTIONS
  1348.  
  1349.     The move functions allow you to select a subset of entries and move them to
  1350. another catalog.  If the target catalog does not exist, a new catalog is
  1351. created.  If the target catalog exists, the entries are added to the end of the
  1352. catalog.  The entries are removed from the index being processed.
  1353.  
  1354.     NOTE- Pressing P while an entry is displayed and awaiting a Y/N response
  1355. for moving, will print the entry.
  1356.  
  1357.  
  1358. 6.7.1 SELECTING ENTRIES TO MOVE
  1359.  
  1360.     Choosing SELECT begins a process very similar to the VIEW/BROWSE function. 
  1361. It displays one entry at a time from the start of the catalog to the end asking
  1362. if you want to move the entry.  To move the entry, press Y, otherwise press N.
  1363.  
  1364.     When you choose SELECT, a dialogue box appears to let you enter the name of
  1365. the destination, or target catalog.  This field will contain the last desti-
  1366. nation that you specified.  You may type over, edit or delete (CTRL-U) the 
  1367. current contents of the field.  Pressing ENTER accepts the string as entered 
  1368. and begins processing.
  1369.  
  1370.  
  1371.     This function only moves forward through the catalog.  Once an entry is
  1372. selected for extraction by pressing Y, it is immediately moved and cannot be
  1373. deselected.  Pressing ESC terminates the selection/move process at that point
  1374. and returns you to the menu bar.  Any entries previously selected to be moved
  1375. have already been copied to the target file, but will not be deleted from
  1376. the catalog.  END also terminates selection, but any selected entries are 
  1377. moved to the destination and deleted from the source. 
  1378.  
  1379.     When you reach the end of the catalog you are returned to the menu bar. 
  1380. The new catalog has been created that contains those entries that you moved.
  1381.  
  1382.  
  1383.  
  1384. 6.7.2 MOVE ENTRIES MATCHING A SEARCH STRING
  1385.  
  1386.     Choosing MOVE MATCHING begins a process very similar to the VIEW/SEARCH
  1387. function.  It searches the file and displays one matching entry at a time from
  1388. the start of the catalog to the end asking if you want to move the entry.  To
  1389. move the entry, press Y, otherwise press N.
  1390.  
  1391.     The search is case-insensitive (small letters are treated the same as
  1392. capitals).  The entire entry is searched from the start of the heading to the
  1393. last of the text.  If the search string exists starting at the end of one line
  1394. of the entry text and continues at the beginning of the next line, the search
  1395. will still find the match.
  1396.  
  1397.     When you choose MOVE MATCHING, a dialogue box appears to let you enter the
  1398. name of the destination, or target catalog.  This field will contain the last
  1399. destination that you specified.  You may type over, edit or delete (CTRL-U) 
  1400. the current contents of the field.  Pressing ENTER accepts the string as 
  1401. entered.
  1402.  
  1403.     Next a dialogue box appears that lets you input the string that you want
  1404. located.  The data entry field will contain the last search string that you
  1405. entered during this session.  You may type over, edit or delete (CTRL-U) the
  1406. current contents of the field.  Pressing ENTER accepts the string as entered
  1407. and begins the search.
  1408.  
  1409.     This function only moves forward through the catalog.  Once an entry is
  1410. selected for moving by pressing Y, it is immediately moved and cannot be
  1411. deselected.  Pressing ESC terminates the selection/move process at that point
  1412. and returns you to the menu bar.  Any entries previously selected to be moved
  1413. have already been copied to the target file, but will not be deleted from
  1414. the catalog.  END also terminates selection, but any selected entries are 
  1415. moved to the destination and deleted from the source. 
  1416.  
  1417.     When you reach the end of the catalog you are returned to the menu bar. 
  1418. The new catalog has been created that contains those entries that you moved.
  1419.  
  1420.     Non-matching entries are not displayed and are never moved.
  1421.  
  1422.     At any time that a matching entry is being displayed, you may press A to
  1423. stop displaying the matches and prompting for move.  CATBOX will continue
  1424. through the file moving all matching entries and retaining those that do not
  1425. match.
  1426.  
  1427.  
  1428.  
  1429. 6.7.3 MOVE RECORDS NOT MATCHING A SEARCH STRING
  1430.  
  1431.     Choosing MOVE NON-MATCHING begins a process very similar to the MOVE
  1432. MATCHING function except that you are prompted to move records which DO NOT
  1433. contain the search string.  It searches the file and displays one non-matching
  1434. entry at a time from the start of the catalog to the end asking if you want to
  1435. move the entry.  To move the entry, press Y, otherwise press N.
  1436.  
  1437.     The search is case-insensitive (small letters are treated the same as
  1438. capitals).  The entire entry is searched from the start of the heading to the
  1439. last of the text.  If the search string exists starting at the end of one line
  1440. of the entry text and continues at the beginning of the next line, the search
  1441. will still find the match.
  1442.  
  1443.     When you choose MOVE NON-MATCHING, a dialogue box appears to let you enter
  1444. the name of the destination, or target catalog.  This field will contain the
  1445. last destination that you specified.  You may type over, edit or delete (CTRL-
  1446. U) the current contents of the field.  Pressing ENTER accepts the string as 
  1447. entered.
  1448.  
  1449.     Next a dialogue box appears that lets you input the string that you want
  1450. located.  The data entry field will contain the last search string that you
  1451. entered during this session.  You may type over, edit or delete (CTRL-U) the
  1452. current contents of the field.  Pressing ENTER accepts the string as entered
  1453. and begins the search.
  1454.  
  1455.     This function only moves forward through the catalog.  Once an entry is
  1456. selected for moving by pressing Y, it is immediately moved and cannot be
  1457. deselected.  Pressing ESC terminates the selection/move process at that point
  1458. and returns you to the menu bar.  Any entries previously selected to be moved
  1459. have already been copied to the target file, but will not be deleted from
  1460. the catalog.  END also terminates selection, but any selected entries are 
  1461. moved to the destination and deleted from the source. 
  1462.  
  1463.     When you reach the end of the catalog you are returned to the menu bar. 
  1464. The new catalog has been created that contains those entries that you moved.
  1465.  
  1466.     Matching entries are not displayed and are never moved.
  1467.  
  1468.     At any time that a non-matching entry is being displayed, you may press A
  1469. to stop displaying the entries and prompting for move.  CATBOX will continue
  1470. through the file moving all non-matching entries and retaining those that
  1471. match.
  1472.  
  1473.  
  1474.  
  1475. 6.7.4 MOVE ENTRIES NEWER THAN A GIVEN DATE
  1476.  
  1477.     Choosing MOVE NEWER begins a process very similar to the MOVE MATCHING
  1478. function except that you are prompted to move records in which the upload date
  1479. is more recent than a given date.  It searches the file and displays one newer 
  1480. entry at a time from the start of the catalog to the end asking if you want to
  1481. extract the entry.  To extract the entry, press Y, otherwise press N.
  1482.  
  1483.     When you select MOVE NEWER, a dialogue box appears to let you enter the 
  1484. name of the destination, or target catalog.  This field will contain the last 
  1485. destination that you specified.  You may type over, edit or delete (CTRL-U) 
  1486. the current contents of the field.  Pressing ENTER accepts the path as entered.
  1487.  
  1488.     Next, a dialogue box appears that lets you input the cutoff date that you 
  1489. want to use.  The data entry field will contain the last date that you entered 
  1490. during this session.  You may type over, edit or delete (CTRL-U) the current 
  1491. contents of the field.  Pressing ENTER accepts the string as entered and 
  1492. begins the search.
  1493.  
  1494.     This function only moves forward through the catalog.  Once an entry is
  1495. selected for moving by pressing Y, it is immediately moved and cannot be
  1496. deselected.  Pressing ESC terminates the selection/move process at that point
  1497. and returns you to the menu bar.  Any entries previously selected to be moved
  1498. have already been copied to the target file, but will not be deleted from
  1499. the catalog.  END also terminates selection, but any selected entries are 
  1500. moved to the destination and deleted from the source. 
  1501.  
  1502.     When you reach the end of the catalog you are returned to the menu bar. 
  1503. The new catalog has been created that contains those entries that you moved.
  1504.  
  1505.     Entries with upload dates equal to or older than the specified date are not
  1506. displayed and are never moved.
  1507.  
  1508.     At any time that an entry is being displayed, you may press A to stop
  1509. displaying the entries and prompting for move.  CATBOX will continue through
  1510. the file moving all newer entries and retaining the older entries.
  1511.  
  1512.  
  1513.  
  1514. 6.7.5 MOVE ENTRIES OLDER THAN A GIVEN DATE
  1515.  
  1516.     Choosing MOVE OLDER begins a process very similar to the MOVE MATCHING
  1517. function except that you are prompted to move records in which the upload date
  1518. is older than a given date.  It searches the file and displays one older entry
  1519. at a time from the start of the catalog to the end asking if you want to
  1520. extract the entry.  To extract the entry, press Y, otherwise press N.
  1521.  
  1522.     When you select MOVE OLDER, a dialogue box appears to let you enter the 
  1523. name of the destination, or target catalog.  This field will contain the last 
  1524. destination that you specified.  You may type over, edit or delete (CTRL-U) 
  1525. the current contents of the field.  Pressing ENTER accepts the path as entered.
  1526.  
  1527.     Next, a dialogue box appears that lets you input the cutoff date that you 
  1528. want to use.  The data entry field will contain the last date that you entered 
  1529. during this session.  You may type over, edit or delete (CTRL-U) the current 
  1530. contents of the field.  Pressing ENTER accepts the string as entered and 
  1531. begins the search.
  1532.  
  1533.     This function only moves forward through the catalog.  Once an entry is
  1534. selected for moving by pressing Y, it is immediately moved and cannot be
  1535. deselected.  Pressing ESC terminates the selection/move process at that point
  1536. and returns you to the menu bar.  Any entries previously selected to be moved
  1537. have already been copied to the target file, but will not be deleted from
  1538. the catalog.  END also terminates selection, but any selected entries are 
  1539. moved to the destination and deleted from the source. 
  1540.  
  1541.     When you reach the end of the catalog you are returned to the menu bar. 
  1542. The new catalog has been created that contains those entries that you moved.
  1543.  
  1544.     Entries with upload dates equal to or newer than the specified date are not
  1545. displayed and are never moved.
  1546.  
  1547.     At any time that an entry is being displayed, you may press A to stop
  1548. displaying the entries and prompting for move.  CATBOX will continue through
  1549. the file moving all older entries and retaining the newer entries.
  1550.  
  1551.  
  1552.  
  1553. 6.8 A NOTE ABOUT DATES
  1554.  
  1555.     In most forum catalogs, the original upload date is preserved if a new
  1556. version of the file replaces the original file.  An update date is the appended
  1557. to the original date and bracketed by parentheses as follows:
  1558.  
  1559.     01-Jan-91(27-Sep-92)
  1560.  
  1561.     CATBOX uses the second (update) date when sorting or selecting entries by
  1562. date.  In defining the date field for templates, you must allow for the area
  1563. containing both dates and the parentheses (See CREATING TEMPLATES).
  1564.  
  1565.  
  1566. 6.9 GREEN WINDOWS
  1567.   
  1568.     Sometimes white text will appear in a green window and then go away.  These
  1569. windows are status windows and are informative only.  They tell you what CATBOX
  1570. is doing during long operations.  If you have a very fast computer or are
  1571. processing a very small catalog, the window may appear to just flash on the 
  1572. screen and vanish before you have a chance to read it.  If so, do not be con-
  1573. cerned.  It is not important that you read these messages.
  1574.     Any informative messages that I think you need to read will not be removed
  1575. from the screen until a key is pressed.
  1576.  
  1577.  
  1578.  
  1579. 7.0 TEMPLATES
  1580.  
  1581.     You will discover that the format of a catalog entry can vary.  The NOVLIB
  1582. forum, for example, has a listing of all files in the forum called FORUM.ZIP. 
  1583. They preprocess and rearrange the order and format of the entries before they
  1584. build the file and post it for downloading.  Also, there is no guarantee that
  1585. CIS will always use the same format.  Templates give you the ability to handle
  1586. modified and changing formats.  Templates are small files that, in a very
  1587. simple but flexible manner define the structure of a catalog's entries.  You
  1588. merely load the appropriate template to process the catalog that you will open. 
  1589. I supply some templates, but you can easily construct your own.
  1590.  
  1591.     Templates must reside in the same directory as CATBOX.EXE.
  1592.  
  1593.  
  1594. 7.1 SUPPLIED TEMPLATES
  1595.  
  1596.     CBOXSTD.TPL -       This is a template for the standard CIS format for long
  1597.                         listings.  This format is also used by OZCIS, TAPCIS 
  1598.                         and AUTOSIG when catalogs are captured using these 
  1599.                         programs.  This is the default template that is 
  1600.                         assigned when the config file is first constructed.
  1601.                         So that the CONVERT function will perform properly,
  1602.                         DO NOT RENAME THIS FILE.
  1603.  
  1604.     CBOXNOV.TPL -       This template may be used to process NOVLIB's FORUM.ZIP
  1605.                         file described above.  NOVLIB also has a listing of 
  1606.                         files in standard format call TAPLIB.ZIP.  When I last 
  1607.                         looked, it was in LIB 17.  Downloading TAPLIB.ZIP is 
  1608.                         preferable to downloading FORUM.ZIP if you use a CIS 
  1609.                         manager.  If you do download FORUM.ZIP and decide it's 
  1610.                         not the format you wanted, you can use CONVERT on the 
  1611.                         FILE menu to save the catalog in standard CIS format.
  1612.  
  1613.  
  1614.  
  1615. 7.2 EXAMPLE TEMPLATE
  1616.  
  1617.    The following template is CBOXNOV.TPL:
  1618.  
  1619.                NOVLIB FORUM.ZIP (FORUM.DOS) format template. 
  1620. -NOVLIB,S
  1621. -Bytes:,S
  1622.  
  1623. ID=2,2,11
  1624. LIB=1,72,3
  1625. NAME=1,1,16
  1626. BYTES=1,23,7
  1627. COUNT=1,38,5
  1628. DATE=1,45,20
  1629.  
  1630.  
  1631.     CBOXNOV.TPL processes an entry format that looks like this:
  1632.  
  1633. 12REQ1.ZIP /Bin Bytes: 302205, Count:  172, 21-Aug-92            NOVLIB 5
  1634. [76702,414]
  1635.      Title   : NetWare Requester for OS/2 v1.2
  1636.      Keywords: OS OS2 2 REQUESTER NETWARE 12REQ1.ZIP UTILITIES
  1637.  
  1638.      This file contains part of the NetWare Requester for OS/2 v1.2.  The
  1639.      files in this ZIP file include the .SYS drivers and .DLL data link
  1640.      libraries. The files should be placed on a diskette labeled REQUESTER.
  1641.      This file is the updated file for NetWare Requester for OS/2 v1.2. 
  1642.      The two files that have been updated are NWREQ.SYS and NWIFS.IFS.
  1643.      (Novell Upload!)
  1644.  
  1645. ----|---10----|---20----|---30----|---40----|---50----|---60----|---70----|---
  1646.  
  1647.  
  1648.  
  1649. 7.3 CREATING TEMPLATES
  1650.  
  1651.     Use any ASCII file text editor to create the template and make sure you
  1652. name it with a .TPL file extension.  The following describes the contents of
  1653. template records according to the character(s) at the beginning of the line:
  1654.  
  1655.  
  1656.     space         Comment line.  Any line beginning with a space is ignored by 
  1657.                   the template processor.
  1658.  
  1659.     -             Start of entry identifier.  There must be at least one.  Two 
  1660.                   are allowed.  This is used to tell CATBOX how to identify the 
  1661.                   first line of a new catalog entry.  An entry includes two 
  1662.                   lines of header information, a "Title:" line and a 
  1663.                   "Keywords:" line followed by the body of text describing the 
  1664.                   file.
  1665.       
  1666.                   A start of entry identifier is made up of two parameters
  1667.                   following a dash in column 1 and separated by a comma.  
  1668.       
  1669.                   The first parameter is a string (or character) that exists on
  1670.                   line 1 of a new entry.  Do not enclose it in quotes.
  1671.       
  1672.                   The second is either a number or the letter S.  The number
  1673.                   indicates the starting column on the line where the character 
  1674.                   or string can be found.  If you use S instead of the number, 
  1675.                   you tell CATBOX to scan for the existence of the string any-
  1676.                   where on the line.
  1677.  
  1678.                   Each line of the library listing is scanned for the existence 
  1679.                   of these fields.  If two are specified, they must BOTH be 
  1680.                   present before CATBOX will recognize the line as the starting 
  1681.                   line of a new entry.  When they are both found on the same 
  1682.                   line, CATBOX begins processing a new entry.
  1683.  
  1684.     XXX=          The remainder of the lines in the template describe the 
  1685.                   location and length of fields CATBOX needs to identify in 
  1686.                   order to process.  After the equal sign, 3 parameters are 
  1687.                   specified. These are:
  1688.  
  1689.                   1. Line number within the record where the field can be found.
  1690.                   2. Starting column of the field on the line. 
  1691.                   3. Length of the field in columns.
  1692.  
  1693.                   All of the field descriptors are required.  They are:
  1694.  
  1695.                   ID=         The CIS ID number of the uploader.  CIS uses ID
  1696.                               numbers from 9 to 11 bytes long.  Specify at least 
  1697.                               11 to cover the max.  CATBOX will take care of 
  1698.                               deleting the trailing "]".
  1699.  
  1700.                   LIB=        This is the library number in which the file 
  1701.                               resides.
  1702.  
  1703.                   NAME=       This is a field that is made up of the file name,
  1704.                               extension and type. An example: NWL11F.ZIP/Bin.  
  1705.                               In the CIS standard format it is currently the 
  1706.                               starting field on the second line.  CATBOX will 
  1707.                               break it down into it's individual components.
  1708.  
  1709.                   BYTES=      This is the file size. 
  1710.  
  1711.                   COUNT=      This is the number of downloads for the file.
  1712.  
  1713.                   DATE=       This is the date the file was uploaded or placed 
  1714.                               in the library.  Its usual format is 16-Oct-92 
  1715.                               but sometimes an update date is supplied in 
  1716.                               parentheses following the original upload date.  
  1717.                               Please allow enough space for this type date 
  1718.                               because CATBOX uses the second date if it exits.  
  1719.                               An example is: 04-Jan-91(15-Nov-92).
  1720.  
  1721.     Leading and trailing blanks will be deleted by CATBOX.  This cuts down on
  1722. the precision required to build a template.  When you are not sure exactly how
  1723. big a field can get, you can be liberal.
  1724.  
  1725.  
  1726.  
  1727. 8.0 CREATING DOWNLOAD SCRIPTS (CAT2DL.EXE)
  1728.  
  1729.     One of the most-used applications of CATBOX is to use the EXTRACT (or 
  1730. MOVE) function to select files to be downloaded.  You can print the extracted 
  1731. file and use it to select files from within your information manager.  The 
  1732. CAT2DL program automates this process further by creating download file/scripts 
  1733. from the extracted catalog.  Then, all you have to do is log in to CIS, go to 
  1734. the forum and execute your script.  With OZCIS, its even simpler, just start 
  1735. OZCIS and begin an automated second pass.
  1736.  
  1737.     Format: CAT2DL [path]catalog [[path]downloadfile]
  1738.  
  1739.     The "catalog" is the extracted input catalog (or any catalog) that is in
  1740. standard CIS format.  The "downloadfile" is the output download file.script
  1741. name.  If it is not specified, the output file will be name the same as
  1742. the catalog file with a .DL extension and be placed in the same directory as 
  1743. the catalog.  If "path" is not specified, the current directory is assumed.
  1744.  
  1745.     CAT2DL requires that CBOXSTD.TPL be located in the current directory or
  1746. in a directory included in yout PATH evironment variable.
  1747.     
  1748.     Currently, only the OZCIS download file format is supported, but it is
  1749. intended that CAT2DL will let you specify the format for most major infor-
  1750. mation managers and comm programs (TAPCIS, CIM, AUTOSIG, PCPLUS, etc.).
  1751. Currently, OZCIS is the only information manager we have at Parity Solutions.  
  1752. If you would like to supply a file format and/or sample for your favorite 
  1753. program, send it in or CIS mail it to us.
  1754.  
  1755.  
  1756.  
  1757. 9.0 FSORT.EXE
  1758.  
  1759.     When CATBOX sorts an index, it calls a general file sort utility I wrote
  1760. several years ago.  It can be used from the DOS prompt to sort almost any text
  1761. file.  When FSORT expends available memory for sorting, it uses disk space. 
  1762. Thus, you can sort a file of almost any size.
  1763.  
  1764.     Work files used by FSORT are created in the current directory unless a
  1765. TEMP= environment variable exists that specifies another directory.  To use the
  1766. TEMP= environment variable, create a line such as the following in your
  1767. autoexec.bat file and reboot:
  1768.  
  1769.     SET TEMP=C:\WORK\
  1770.  
  1771.     Specify the directory you want to use.  Make sure the directory exists.
  1772.  
  1773.     Typing FSORT with no parameters will display a help screen that tells you
  1774. how to use it.
  1775.  
  1776.  
  1777.  
  1778. 10.0 FILETIME.EXE
  1779.  
  1780.     I wrote a simple program called FILETIME.EXE that will allow you to reset
  1781. the last update date/time for any file.  This is the timestamp that appears
  1782. when DOS's DIR command is executed.
  1783.  
  1784.     Format: FILETIME [d:][path]filename
  1785.  
  1786.     A window will appear with the file name and current date/time stamp.  
  1787. Modify the date and time as desired.  The edit keys are the same as used by
  1788. CATBOX.
  1789.  
  1790.     If you enter wildcards in the filename, each matching file is displayed 
  1791. and you may enter the same or a different time for each file.  If you press 
  1792. ESCAPE when an entry is displayed, that file's timestamp is not modified.
  1793.  
  1794.     The default drive and path is the current drive and directory.
  1795.  
  1796.     The reason I am including this program with CATBOX is that OZCIS uses the
  1797. file date stamp to determine when a catalog was last updated with new entries.  
  1798. When you go online and ask OZCIS to update the catalog, it captures only those 
  1799. entries from the file date onward.  Thus, if you have modified a catalog, with 
  1800. or without using CATBOX, the new modification date cause OZCIS to think it has 
  1801. already captured entries up to that date, thus some entries can be skipped.
  1802.  
  1803.     Use FILETIME to reset the date to whatever date you wish to resume 
  1804. capturing catalog entries.  You can use CATBOX's sort feature to sort the
  1805. catalog by date and see the date on the latest entry you captured.  If you
  1806. back up the date far enough that duplicate entries are captured, use the 
  1807. Delete Duplicates function in CATBOX to remove the duplicates.
  1808.  
  1809.  
  1810.  
  1811. 11.0 PERFORMANCE AND PROBLEMS
  1812.  
  1813.     I only have a 50 mhz 486 with 16 meg of RAM and a 650 meg SCSI drive at 
  1814. home and a 25 mhz PS/2 model 90 486 with 16 meg of RAM at work to test with.  
  1815. The 50 mhz machine will only slow down to a creeping 45 mhz when you take it 
  1816. off turbo.  So you can see that what I may judge as good performance, you 
  1817. might dispute on a 286 or 386 machine.  If some processes take too long, let 
  1818. me know and I'll see if I can tune them up.
  1819.  
  1820.     The three slowest operations in CATBOX are sorting, saving (or converting) 
  1821. and searching (especially backwards searching).  Sorting is a slow process that 
  1822. gets exponentially slower as the size of the catalog increases.  FSORT uses the 
  1823. QuickSort algorithm that is usually pretty fast, but as a quirk, actually gets 
  1824. slower the closer the original file is to the sorted order.  Since FSORT will 
  1825. use disk if it exceeds low memory capacity, larger files can get even slower.  
  1826. I do not think that a catalog of a single library is going to cause much 
  1827. problem, but if you sort the 1 meg full forum catalog of NOVLIB, for instance, 
  1828. it takes a good five to ten seconds on my system.  If I use a RAM disk and 
  1829. disk cache as suggested below, I can trim it to 3-4 seconds.
  1830.  
  1831.     I/O is one of the slowest processes on any system.  Since saving or con-
  1832. verting a catalog entails reading each index entry, positioning the heads in 
  1833. the old catalog to locate the text of each entry, reading the text and writing 
  1834. it to a work file, possibly deleting the old catalog (if overwriting) and 
  1835. renaming the work file, you can see that a whole lot of I/O will take place.  
  1836.  
  1837.     Searching involves almost as much I/O as saving and searching backward is 
  1838. absolutely the slowest process in CATBOX.
  1839.  
  1840.     To optimize performance, break your huge catalogs up by library number or 
  1841. other criteria.  Use the MOVE feature to accomplish this.  Working on smaller
  1842. catalogs is always faster.
  1843.  
  1844.     Another thing you can do is to use a RAM disk for the work files.  To do 
  1845. this, point the TEMP= parameter in the CATBOX.CFG file to a directory on your 
  1846. RAM disk.  Make sure that you have enough room on your RAM disk.  You need 
  1847. about as much space as the size of the largest catalog you plan to process.  
  1848. I/Os to RAM are very much faster than I/Os to disk.
  1849.  
  1850.     Using a disk cache with both cached reads and writes will speed up all of 
  1851. the processes.  If you use Microsoft's SMARTDRV, use the SMARTDRV.EXE program 
  1852. from Windows 3.1 instead of the SMARTDRV.SYS program that comes with DOS 5.  
  1853. It is a much better cache.
  1854.  
  1855.     If you have problems with the menuing system displaying properly try 
  1856. loading CATBOX with the /B switch.  This tells CATBOX to perform all video 
  1857. functions through the BIOS rather than directly manipulating video memory.  
  1858. Although screen writes are slower, it is a safer approach.
  1859.  
  1860.     If you try to load a catalog and 0 records get loaded, or the data in the
  1861. header appears mixed up when viewing or printing, you probably do not have the
  1862. right template loaded for the format of the catalog you are trying to process. 
  1863. This has the potential of being the biggest single cause of problems with
  1864. CATBOX although it is also one of its most powerful features.  Be sure you load
  1865. the right template.  If none seem to work properly, you may have to create a
  1866. new one.  The instructions in this document should allow you to accomplish this
  1867. easily.
  1868.  
  1869.     NOTE TO NETWORK USERS - CATBOX does not lock a file after it has been 
  1870. loaded.  This could cause problems if two or more users are working on the same 
  1871. catalog listing.
  1872.  
  1873.  
  1874.  
  1875. 12.0 DISCLAIMER
  1876.  
  1877. BECAUSE OF THE DIVERSE NATURE OF COMPUTER EQUIPMENT AND EXPERTISE OF USERS,
  1878. PARITY SOLUTIONS AND GARY C. CRIDER MAKE NO WARRANTY ON THE CATALOG TOOLBOX,
  1879. FILETIME OR FSORT WHATSOEVER, EXPRESS OR IMPLIED.  THE USER ASSUMES ALL RISK OF DAMAGE TO
  1880. DATA OR EQUIPMENT RESULTING DIRECTLY OR INDIRECTLY FROM THE USE OR MISUSE OF 
  1881. THESE PROGRAM PRODUCTS.
  1882.  
  1883. USERS ARE ADVISED TO TEST THESE PROGRAMS THOROUGHLY ON DATA FOR WHICH A BACKUP
  1884. EXITS.  ANY LIABILITY OF THE AUTHOR OR PARITY SOLUTIONS IS LIMITED TO
  1885. REPLACEMENT OR REFUND OF THE REGISTRATION FEE.
  1886.  
  1887.  
  1888.  
  1889. 13.0 SUPPORT
  1890.  
  1891.     I have tried to test the programs to the fullest, but I am limited as to
  1892. systems and configurations with which to test.  I have been programming for 18 
  1893. years and the one thing I know for sure is that bug free programs are very few 
  1894. and far between.  I can only promise to support the program to the best of my
  1895. ability and provide fixes as expeditiously as possible.
  1896.  
  1897.     Anyone can report problems and suggest changes.  Registered users get top
  1898. priority in resolving their problems.  There are three ways you can report
  1899. problems.  The preferred method is to contact me through CIS mail (not forum
  1900. messages).  My CIS ID is 71760,3413.  You can also write me at:
  1901.  
  1902.    Gary C. Crider
  1903.    Parity Solutions
  1904.    1105 Burgess Court
  1905.    Arlington, TX 76015
  1906.  
  1907.     The last method is to phone (817) 467-7818.  Since I am the sole technical
  1908. support and the line is also used for my network consulting business, it is
  1909. often hard to get through to me.  Please call and leave a message between 7:30
  1910. am and 5:30 pm Central time.
  1911.  
  1912.     No matter which method you use, please give a brief description of your
  1913. problem, your registration serial number if you are registered, and your phone 
  1914. number.  If I need more information, I will contact you as soon as I can.  
  1915. When I have a solution, I will contact you however you prefer.  Do not post
  1916. serial numbers on forum messages, they are not private.  I don't have time
  1917. to read forum messages, so be sure to use CIS mail to cpntact me.
  1918.  
  1919.     I work full time, have a consulting business to run in my spare time and 
  1920. write programs instead of sleeping.  So please be a little patient with me.
  1921.  
  1922.     To keep the price this low, new releases are distributed on CompuServe
  1923. in the NOVLIB, IBMCOM and TAPCIS forums and on ZiffNet in the TIPS and PBS
  1924. forums.
  1925.  
  1926.  
  1927. 14.0 REGISTRATION
  1928.  
  1929.  
  1930.     I begin with an apology.  I hate programs that in any way inhibit func-
  1931. tionality or performance for the shareware version.  But when it came down to 
  1932. feeding the family and paying the bills, I had a change of heart and inserted 
  1933. a pesky window that pops up every now and then and gets on your nerves.  I 
  1934. chose this approach above that of limited functionality.  The program's full 
  1935. capabilities are available for you to evaluate before you invest your hard-
  1936. earned money.
  1937.  
  1938.     Registered users will receive a unique serial number and instructions on 
  1939. how to serialize the program.  Serialization can be re-applied to updated
  1940. versions and in no way hinders your use of the program.  You can compress or
  1941. decompress the program with no effect (LZEXE or PKLITE).  I use Fabrice
  1942. Bellard's LZEXE program on the programs before distribution.
  1943.  
  1944.     As a registered user, you will be able to update without re-registration 
  1945. or additional fees.  You will also be kept on my PRIVATE mailing list to 
  1946. receive additional information on other Parity Solutions products or perhaps a 
  1947. Windows version of CATBOX if I can get around to writing one.  Registered users 
  1948. will be entitled to a discount on any present or future Parity Solutions 
  1949. software.
  1950.  
  1951.     To register your copy, please send $30 check or money order (sorry, no 
  1952. credit cards yet) to:
  1953.  
  1954.    Gary C. Crider
  1955.    Parity Solutions
  1956.    1105 Burgess Court
  1957.    Arlington, TX 76015
  1958.  
  1959.     International orders outside the U. S. postal system, Canada and Mexico
  1960. add $1 for return postage for each order, regardless of the number of 
  1961. licenses ordered.
  1962.     
  1963.     Each license gives you or your company a single use permit for the Catalog
  1964. Toolbox and FSORT.  It is not restricted to a single machine as long as no two 
  1965. users can be simultaneously using the program.  As Borland says, "treat it like 
  1966. a book."  As an example, if you register CATBOX for your home computer, but 
  1967. during the day you use a portable or a computer at work,  you may keep CATBOX 
  1968. on both machines as long as no one is at home using it on your home computer.  
  1969.  
  1970.     You may install it on a LAN or WAN as long as there is one license for each
  1971. possible concurrent user.  License limiter program control is acceptable.  If 
  1972. no license limiter is used, you must purchase a license for each user or 
  1973. workstation that has privileges to access CATBOX.
  1974.  
  1975.     You may freely distribute the original CATBOX.ZIP file in any way you see 
  1976. fit other than selling it.  Users' groups and shareware distribution services 
  1977. may charge a reasonable fee for the medium and duplication costs.  Bulletin 
  1978. boards may not charge additional fees for downloading this specific program, 
  1979. other than normal connect-time and/or membership charges.  
  1980.  
  1981.     You are NOT licensed to give anyone your serial number unless you first 
  1982. remove all serialization from your computer.  You may then no longer use that 
  1983. serial number.  Only Parity Solutions has the authority to issue serial 
  1984. numbers.
  1985.  
  1986.  
  1987.  
  1988. 15.0 CREDITS
  1989.  
  1990.  
  1991. The following are trademarks or copyrights of:
  1992.  
  1993.       BORLAND, BORLAND C++          Borland International, Inc.
  1994.       CXL                           Mike Smedley and/or Innovative Data Concepts
  1995.       OZCIS                         Steve Sneed
  1996.       TAPCIS                        Support Group, Inc.
  1997.       AUTOSIG                       Vernon D. Buerg
  1998.       PKUNZIP, PKLITE               PKWARE, Inc.
  1999.       LZEXE                         Fabrice Bellard
  2000.       COMPUSERVE, CIS               H&R Block
  2001.       SMARTDRV, WINDOWS             Microsoft Corporation
  2002.  
  2003.