home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / ZSUS / Z3HELP-6.LBR / X.LBR / XCAT.HZP / XCAT.HLP
Text File  |  2000-06-30  |  10KB  |  174 lines
  1. ;
  2.                                    XCAT.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.               10k (73)   70BC  6.0g       Hal Bower 2/89           Z3COM17
  6.  
  7.   1- Syntax  2- Operation  3- Configuration  4- Notes  5- Examples of Use     
  8.  
  9.    MCAT and its companion program, XCAT, form a powerful system for cataloging
  10. and accessing a  data base of files and disks.   With the addition of a single 
  11. file name on a disk, the entire contents of the disk directory, and members of
  12. Library files, may be captured for later retrieval.   MCAT builds and modified 
  13. the data base while XCAT permits customized queries of the contents.
  14.  
  15.    Version 6 expands date support to include ZSDOS and CP/M Plus type of Date/
  16. Time stamps,  as well as  providing  automatic support  for ZCPR3  environment 
  17. features (screen addressing and attributes, named directory support, etc.). No
  18. installation is necessary under any ZCPR version 3.0 or later.
  19. :1
  20.  
  21.   Syntax        XCAT            <-- Enter interactive mode
  22.                 XCAT o[o..]     <-- Immediate Execution
  23.   
  24.  Options        $[d][u]         <-- Show dates[d] users[u]
  25.                 <[d][u]         <-- Get MAST.CAT from DU:
  26.                 >[d][u]         <-- Put output file to DU:
  27.                 [P][C][F]       <-- Output to Printer, Console, File
  28.                 +[>,<,=][date]  <-- Date comparison and spec
  29.                 [fn.ft]         <-- File names to find
  30.                 [nnn]           <-- Match only this disk #
  31. :2
  32.  
  33.  Operation 
  34.  
  35.    In addition to the  re-designed user interface  similar  to  that in MCAT6, 
  36. XCAT  also  includes retrieve-by-date  facilities,  and the ability to display 
  37. library  files and  their  members.   This  latter  feature  is  automatically 
  38. included,  and uses two  methods  to signify  that a file  entry is  a library 
  39. member.  First, the last character is displayed in reverse video, if available 
  40. under ZCPR3,  and secondly,  the first location  entry  consists of the parent 
  41. library name enclosed in angle braces (<>).
  42.  
  43.    XCAT is invoked by  entering its name followed by  optional parameters.  If 
  44. no arguments are detected, the interactive mode of operation is selected,  and 
  45. XCAT will pause after painting the screen.  You may then change parameters and 
  46. re-execute the program successively  as desired.   If arguments  are passed on 
  47. the command line,  the screen will be painted  as in the interactive case, but 
  48. execution will immediately begin according to the interpreted parameters.  The 
  49. XCAT screen appears as follows:
  50.  
  51.  
  52. +------------------------------------------------------------------------------+
  53. |Catalog X-Ref Pgm V6.0   (ZSDOS)                      05 Feb 1989    09:02:41 |
  54. | ^Search : (???) ????????.???           ^Log MAST.CAT : C8:                   |
  55. | ^Dates  : = ??/??/??                   ^Z-Redraw                             |
  56. | ^Output : Console                                                            |
  57. | ^Format : User Date                                                          |
  58. |==============================================================================|
  59. |For Help, reboot then type : XCAT //                                          |
  60. |                                                                              |
  61. |READY - (^C = Abort, Space or <cr> = Continue) : _                            |
  62. |                                                                              |
  63. |                                                                              |
  64. +------------------------------------------------------------------------------+
  65.  XCAT Commands - 1/3 
  66.  
  67.    Six commands are available to adjust data presentation and search criteria.
  68. Five of these are also  available from the command line mode.   Changing of an 
  69. option is done by holding down the  "Control"  key and pressing the letter for 
  70. the command.   This is  shown  symbolically by the  letter prefixed by  the up 
  71. arrow as in "^C" for Control-C which is the entry to exit XCAT.  The available 
  72. commands are:
  73.  
  74.   S - Set Name and Disk Search criteria.   Two entries  may  be entered.   The 
  75.      first is for a disk specification which expects a one  to three character 
  76.      entry to select a specific,  or group of disk IDs.   If an unambiguous ID 
  77.      is entered, the data is  displayed in  a "Directory" type display similar 
  78.      to that produced by a normal directory list routine.   An ambiguous entry 
  79.      uses the normal XCAT type file oriented display.  The second entry is for 
  80.      a filename and type, which may also be ambiguous or unambiguous.   If the 
  81.      first character of the name  is unambiguous,  XCAT will terminate reading 
  82.      of the  Master Catalog when no  further  matches  are  possible,  thereby 
  83.      speeding  operation.   These options  are available from the command line 
  84.      mode as well.
  85.  XCAT Commands - 2/3 
  86.  
  87.   D - Select Date Search criteria.   Boolean operators  are available for date 
  88.      specification as: before (<),  equal (=) and after (>).   The date may be 
  89.      ambiguously or unambiguously specified with the normal CP/M  "?" and  "*" 
  90.      operators and numbers.   This option is  also  available from the command 
  91.      line mode.
  92.  
  93.   O - Select Output Device.   Output from XCAT can be directed to the Console, 
  94.      Printer or to a disk file.   If file output is selected, the default name 
  95.      of MAST.LST may be used, or a different name entered.   The specification 
  96.      may also  be  preceeded  by a drive and  user  designation  for  complete 
  97.      flexibility.  This option is also available from the command line mode.
  98.  
  99.   F - Select Format of display.   This entry controls display  of the optional 
  100.      User area and Date fields of MAST.CAT entries.  If the format of the data 
  101.      base does not match that set in the header, a warning will be issued, and 
  102.      you will have the options of Changing  the program settings  to match the 
  103.      data base, Aborting the operation and returning to the command prompt, or 
  104.      Proceeding with the  settings in the program.   This option is  available 
  105.      from the command line mode as well.
  106.  XCAT Commands - 3/3 
  107.  
  108.   L - Log in Drive/User for MAST.CAT.   This  permits  selecting  a  different 
  109.      drive and user there a catalog should be found.   In this way,  different 
  110.      catalogs may be maintained for specialized purposes, and easily accessed.  
  111.      This option is available from the command line mode as well.
  112.  
  113.   Z - Redraw the screen.   This command is  used to re-draw the screen in case 
  114.      something messed it up.   One such  case where  this  is  desired in with 
  115.      BackGrounder ii(tm) where no  screen  driver is installed  to  retain the 
  116.      current display when  swapping tasks.   When the XCAT context is restored 
  117.      from a swap, Control-Z may be used to restore the proper screen.  This is 
  118.      not available nor needed from the command line.
  119.  XCAT Command Line Options 
  120.  
  121. Command line arguments may  be intered in any sequence,  but must be separated 
  122. by  one or  more  spaces to be  properly  deciphered  by XCAT.   The  list  of 
  123. parameters recognized by XCAT is:
  124.  
  125.      $[U][D]        Desired output contents with Users(U)/Dates (D)
  126.      <[D][U]        Get MAST.CAT from the Drive/User in DU form
  127.      >[D][U]        Put output file to Drive/User in DU form
  128.      -[P][C][F]     Output device is (P)rinter, (C)onsole, or (F)ile
  129.      ,[nnn]         Select list for disk with following 1-3 char ID
  130.      +[<,>,=]dd     List only files Older ("<"), Newer (">") or Same ("=")
  131.                     as the following date specification (dd), or default
  132.                      date spec if none listed
  133.      fn[.ft]        Match this file specification
  134.  
  135. File specifications,  disk IDs,  and date specifications may  be  entered with 
  136. ambiguous characters in the standard  manner with "*" and "?".   The  asterisk 
  137. will cause the remainder of the field to be filled  with the  single-character 
  138. ambiguous match, the question mark.  
  139. :3
  140.  Configuration 
  141.  
  142.    XCAT is easily configured using Al Hawley's excellent ZCNFG tool, Vs 1.3 or
  143. later.   Options and default  settings  are  contained  in the XCAT6.CFG file.  
  144. Configuration should be relatively self-explanatory, and Help is available for
  145. from within ZCNFG.  
  146.  
  147.    For those  who  desire  a graphics string to  generate  a  horizontal  line 
  148. instead of  a single character,  a method of defining a character string of up 
  149. to  16 characters by  using the file CAT6GPH.Z80.   This file  defines  a flag 
  150. value and the user-supplied string at the needed address in the header section
  151. of XCAT6.   It should be assembled to a HEX file and overlayed on the programs
  152. with MLOAD or a debugger such as DDT.
  153. :4
  154.  XCAT Notes 
  155.  
  156.    a. If no recognizable  clock  driver is found  (Plu*Perfect Systems'  Date-
  157.       Stamper (tm), ZSDOS or CP/M Plus) when executing  either  MCAT or  XCAT,  
  158.       you will be prompted to enter the current month, day and year.   When  a 
  159.       catalog including  Date information  is updated with  MCAT,  the current 
  160.       date is then added to the  pseudo  file  '+++nnnk.FRE'  which  shows the 
  161.       number of  free  kilobytes on the disk.   By examining this entry in the 
  162.       Master Catalog, the date of cataloging is then known.   With XCAT,  this 
  163.       current date is presented  in printed  and file output listings.   As  a 
  164.       side  effect,  if  a  disk  is  cataloged  on  different  days  with  no 
  165.       intervening changes,  you will observe that one file is deleted, and one 
  166.       added in the second operation.
  167. :5
  168.  Examples of Use 
  169.  
  170.    a. XCAT <B8 ,50? *.BIN +<*.*.87
  171.  
  172.       - searches  a MAST.CAT in user  area 8 of drive B for all files  of type
  173.         ".BIN" on disks 500-509 and 50A-50Z with a date earlier than 1987.
  174.