home *** CD-ROM | disk | FTP | other *** search
/ Mega CD-ROM 1 / megacd_rom_1.zip / megacd_rom_1 / MISCUTL / CAT2.ZIP / CAT2.DOC < prev   
Text File  |  1985-09-23  |  14KB  |  334 lines
  1.  
  2.  
  3.  
  4.                                                                                 
  5.                                                                                 
  6.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  7.  
  8.  
  9.  
  10.                                                                                 
  11.  
  12.  
  13.  
  14.        CONTENTS
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.        Overview . . . . . . . . . . . . . . . . . . . . . . . . 1
  24.  
  25.  
  26.        Using CAT. . . . . . . . . . . . . . . . . . . . . . . . 2
  27.  
  28.  
  29.        Invoking CAT . . . . . . . . . . . . . . . . . . . . . . 2
  30.  
  31.  
  32.          Background . . . . . . . . . . . . . . . . . . . . . . 2
  33.  
  34.  
  35.            Screen Format. . . . . . . . . . . . . . . . . . . . 3
  36.  
  37.  
  38.            Manipulating the Display . . . . . . . . . . . . . . 4
  39.  
  40.  
  41.            Program Function Keys. . . . . . . . . . . . . . . . 5
  42.  
  43.  
  44.            Internal CAT Functions . . . . . . . . . . . . . . . 6
  45.  
  46.  
  47.            Using the Command area . . . . . . . . . . . . . . . 6
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                                                                 
  58.                                                                                 
  59.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  60.  
  61.                                                                                 
  62.        OVERVIEW
  63.  
  64.  
  65.  
  66.        This  document  provides information about CAT for use on the IBM
  67.        Personal Computer.  We hope the program fills  as  many  of  your
  68.        needs  as  it  did  ours.   After all, that is the reason we have
  69.        developed this integrated package.  The better tools you have  to
  70.        work with the better the end result.
  71.  
  72.        It  provides  a  full  screen list of a file set specified by the
  73.        user.  These may be presented in an  unsorted,  name,  extension,
  74.        date,  or size order, and the sorted order of presentation may be
  75.        changed dynamically.  Within each entry is displayed an  area  to
  76.        allow  the  entry  of commands.  This command area may be used to
  77.        issue commands which  pertain  to  the  files  displayed.   These
  78.        commands  are  entered in the command areas adjacent to the files
  79.        they are to affect.  Helpful facilities are  provided  to  lessen
  80.        the  typing required.  One example is the use of the "=" internal
  81.        command to repeat the last command.  To provide  additional  ease
  82.        of  use,  the  editing keys and function keys may be used to page
  83.        through the list and add or delete commands.
  84.  
  85.        When all desired commands have been entered, the user enters exec
  86.        execution  mode  to  pass the commands entered in display mode to
  87.        the PCDOS command environment.  The commands are  passed  to  the
  88.        command  environment for execution one after the other, befinning
  89.        with the command closest to the top of the  list  and  continuing
  90.        toward  the end of the list until all commands have been returned
  91.        or an internal function is encountered.  If no  internal  command
  92.        is encountered, the DOS prompt appears, with a full block cursor.
  93.        Entry of a null command (i.e.  return)  will  redisplay  the  the
  94.        file  list.  Any other entry will be immediately executed by DOS.
  95.        The DOS prompt is displayed to allow you  to  view  any  messages
  96.        which were put on the display by the executed commands.
  97.  
  98.        The  program  becomes  a  resident  extension of DOS in core.  It
  99.        occupies  approximately  7k  bytes  of  stroage.   This   storage
  100.        includes  the  necessary  resident  code  and  table space for an
  101.        unlimited amount of entries. Cat will remain active in core until
  102.        the system is rebooted.
  103.        BACKGROUND:
  104.        CAT is invoked from the DOS command environment by issuing the
  105.        command: A>cat      (refer to figure 1)
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  117.  
  118.        If the filespec is omitted, all files on the current default disk
  119.        will be listed.  If CAT is used on the IBM PC/XT only those files
  120.        within the current directory are listed.  If you specify /sn then
  121.        the  files  will be listed in alphabetical order of the filename.
  122.        If you specify /se then the files will be listed in  alphabetical
  123.        order  of  the  filename  extension.  If you specify /sd then the
  124.        files will be listed in date sequence.  The very  first  will  be
  125.        the  most  recent  entry and the last file in the listing will be
  126.        the oldest file entered.  If you specify /ss the  files  will  be
  127.        listed  by  size.   The  largest  file  first  contiuning  to the
  128.        smallest file.
  129.  
  130.  
  131.        ╔══════════════════════════════════════════════════════════════╗
  132.        ║                                                              ║
  133.        ║ CAT < fspec > < /sn | /se | /sd | /ss |  < /? >              ║
  134.        ║                                                              ║
  135.        ║ other available options are described on the intial screen   ║
  136.        ║                                                              ║
  137.        ║ If no parameter is specified the files will be listed by date║
  138.        ║                                                              ║
  139.        ╚══════════════════════════════════════════════════════════════╝
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.        SCREEN FORMAT:
  149.        The displayed format consists fo three distinct areas.  The first
  150.        line is a status line.  The dirst  two  characters  are  the  DOS
  151.        prompt  currently active.  The balance of the line gives the size
  152.        of the  allocation  unit,  the  allocation  units  used  and  the
  153.        allocation  units  free  (as  well  as  the  percentage  of  free
  154.        allocation  units)  on the listed diskette plus the number of the
  155.        first displayed entry as well as the count of active  (displayed)
  156.        entries.
  157.  
  158.        The  next  23  lines  contain displayed entries for listed files.
  159.        The first portion gives the filespec for the  listed  file.   The
  160.        next  25  postions  are  a command area.  The balance of the line
  161.        contains the attribute  indicators,  the  size  of  the  file  in
  162.        decimal  bytes,  the  number  of allocation units occupied by the
  163.        file, followed by the date and time the file was last updated.
  164.  
  165.        The last line of the screen displays the function key settings.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  173.  
  174.        Manipulating the display.
  175.  
  176.        Once the list is displayed, the editing keys on the keyboard  may
  177.        be  used  to  manipulate  the  screen.  The semantics for the key
  178.        useage follow those used for the BASIC editor.  They are:
  179.  
  180.  
  181.        PgUp    move the display to show entries nearer the beginning of
  182.         the entry sequence.
  183.  
  184.        Ctrl-PgUp move the display to  show  the  first screen of entries
  185.                  in the entry sequence.
  186.  
  187.        PgDn     move the display to  show  entries nearer the end of the
  188.                 entry sequence.
  189.  
  190.        Ctrl-PgDn move the  display  to  show  the last screen of entries
  191.                  in the entry sequence.
  192.  
  193.        Home     position  the cursor to the first postion of the command
  194.                 area on the first entry displayed on the screen.
  195.  
  196.        End      position the cursor at the last character in the command
  197.                 field on the line containing the cursor.
  198.  
  199.        Ctrl-End erase the command area from the cursor to the end of the
  200.                 field.
  201.  
  202.  
  203.  
  204.        Ins      toggle insert mode. When in insert mode, a full block
  205.                 cursor is displayed.
  206.  
  207.        Del      delete the character at the cursor.
  208.  
  209.        Cursor keys move the cursor  in  the  directions depicted  by the
  210.                 arrows.  If the  cursor movement is up or down  and  the
  211.                 movement would   result in moving onto the first or last
  212.                 line of the screen and thefile is not already positioned
  213.         with the first or last entry on the top or bottom  line,
  214.             the screen will be scrolle up or down.
  215.  
  216.        Enter    positions  the  cursor  to  the  beginning  of  the next
  217.         command area. If appropriate, the screen will be scroll-
  218.         ed as described below in the entry for Tab.
  219.  
  220.        backspace deletes the character to the left of the cursor.
  221.  
  222.        Tab        skips  to  the  first  position of the next command area
  223.                 unless the skip is off the last entry displayed. In this
  224.              case, scrolling occurs as for down  cursor  unless  pro-
  225.         hibited by file position.  In  this case, wrap to  first
  226.         displayed command area occurs.
  227.  
  228.  
  229.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  230.  
  231.        Shift-Tab skips backward to the beginning of the previous command
  232.                  field.  If the cursor is not in the first  position  of
  233.          the command area, this key will position to  the  first
  234.          position of the current command area.  If the  skip  is
  235.          off  the first entry displayed, scrolling occurs as for
  236.               up cursor unless prohibited by file  position.  In this
  237.          case, wrap to last displayed command area occurs.
  238.  
  239.  
  240.  
  241.        ESC     clear the command area to blanks then position the cursor
  242.            to the first position of the command area on the  current
  243.            entry.
  244.  
  245.        Ctrl-Return enter the execution mode.
  246.             [CR]
  247.  
  248.  
  249.        While  in  execution  mode a block cursor will be displayed along
  250.        with the DOS prompt, CAT  remains  active  in  core  and  can  be
  251.        recalled  simply  be  depressing  [CR].   CAT  will  display  the
  252.        previous entries from your previous session.  Simply depress [F1]
  253.        to refresh and update the current display.
  254.  
  255.        Program Function Keys
  256.  
  257.  
  258.        The  functions  provided on the PF keys are displayed on the 25th
  259.        line of the display.  The assignment  is  similar  to  the  BASIC
  260.        softkeys,  with  the  function key placing the assigned character
  261.        string on the command line at the first position,  then  entering
  262.        execution mode.  The function key assignments are as following:
  263.  
  264.        [F1] SUBMIT-update display with all entries in current directory.
  265.        [F2] XCLUDE-exclude entry where cursor is positioned until the
  266.                    display is re-SUBMIT-ed.
  267.        [F3] READ=C-read and display entries from drive C: in current dir
  268.        [F4] READ=A-read and display entries form the floppy diskette.
  269.        [F5] SRTNAM-sort(ascending) on name and update display.
  270.        [F6] SRTEXT-sort(ascending) on extension and update display.
  271.        [F7] SRTDTE-sort on date(most recent displayed first) and update.
  272.        [F8] SRTSIZ-sort on size(largest displayed first) and update.
  273.        [F9] EDIT  -executes IBM professional editor.*
  274.        [F0] SCAN  -executes SCAN.COM(allows you to browse your text or
  275.                    programs, no changes allowed just checking activity)
  276.                    Once in SCAN you may end the session by depressing
  277.                    the [ESC].
  278.  
  279.  
  280.  
  281.  
  282.  
  283.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  284.  
  285.        *-Send us your copy of CAT along with a check for $10.00 to cover
  286.        postage and handling and we will change the  PF  key  setting  to
  287.        execute  your  preferred editor.e.g.-WS(wordstar),VW(volkswriter)
  288.        EDLIN(editor on DOS diskette) or your personal preference.   Make
  289.        sure to include a note stating your requirements.
  290.  
  291.        Using the Command area:
  292.  
  293.        The  input  areas  after  the  fileids  may  be used to enter any
  294.        command as in the  normal  DOS  environment.   If  not  otherwise
  295.        directed,  CAT  will append the complete filespec associated with
  296.        the command area at the end of the command line.  If the  command
  297.        is  preceded  by the /O internal command, no appending will occur
  298.        and the command will be passed to the command environment without
  299.        further  processing.   The  /n internal command will allow you to
  300.        execute the current filespec.  As  noted  earlier  the  "="  will
  301.        allow you to repeat your command without having to retype it. To
  302.        copy a particular file to the A:drive use the following format
  303.        on the command line: COPY / A:-this will copy the file to drive
  304.        A. The "/" causes cat to insert the filespec located on the same
  305.        line  as  you  are  entering the command.  If you need to sort on
  306.        particular filenames then enter the following:  /r *.mem
  307.  
  308.        Then press the [Ctrl] and [CR].  The block cursor will show along
  309.        with the DOS prompt, just press [CR] for your requested list.
  310.  
  311.        Additional commands which may prove to be very valuable are HIDE,
  312.        EXPOSE and PROTECT.  Type the command  HIDE  on  the  line  of  a
  313.        filespec  you  wish  to  conceal  from prying eyes.  Then depress
  314.        [Ctrl]-[CR] to hide the file from most normal directory searches.
  315.        Press  [CR] to return to the CAT display and press [F1] to update
  316.        the display.  You will notice the capital H displayed on line  of
  317.        the  filespec  you  specified to hide.  Use the command EXPOSE to
  318.        reveal  the  hidden  file.   PROTECT  will  protect  a  file from
  319.        accidental erasure.  Use the EXPOSE command to authorize erasure.
  320.  
  321.  
  322.  
  323.     IF YOU ARE USING THIS PROGRAM AND FIND IT OF VALUE, YOUR
  324.     CONTRIBUTION ($35 SUGGESTED) WILL BE APPRECIATED !
  325.  
  326.  
  327.     STEVE O'KANE                          RON SIMMONS
  328.     4306 DIEHL WAY            OR          4303 ALCOSTA PLACE
  329.         PITTSBURG, CA. 94565                    PITTSBURG, CA 94565
  330.     415-544-6204                   415-427-4381
  331. 
  332.  
  333.     4303 ALCOSTA PLACE
  334.