home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / serch4a.zip / MANUAL.DOC < prev    next >
Text File  |  1993-02-23  |  104KB  |  2,837 lines
  1.  
  2.  
  3.  
  4.                       SUPER*SEARCH  File Location Utility
  5.  
  6.                  Copyright (c)  1989, 1993 by Thomas L. Price
  7.  
  8.  
  9.  
  10.  
  11.                                Table of Contents
  12.                                -----------------
  13.  
  14.      INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  15.            About this Manual . . . . . . . . . . . . . . . . . . . . .   1
  16.      GENERAL FEATURES  . . . . . . . . . . . . . . . . . . . . . . . .   2
  17.            Pattern match Wildcards . . . . . . . . . . . . . . . . . .   2
  18.            Size Search Options . . . . . . . . . . . . . . . . . . . .   2
  19.            Date Search Options . . . . . . . . . . . . . . . . . . . .   2
  20.            Attribute Search Options  . . . . . . . . . . . . . . . . .   3
  21.            Configuration Options . . . . . . . . . . . . . . . . . . .   3
  22.      IMPROVEMENTS  . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  23.            Simplified Configuration  . . . . . . . . . . . . . . . . .   4
  24.            Context Sensitive Help  . . . . . . . . . . . . . . . . . .   4
  25.            Relaxed Entry Order . . . . . . . . . . . . . . . . . . . .   4
  26.            Helpscreen shows Configuration Status . . . . . . . . . . .   4
  27.            Faster Search performance   . . . . . . . . . . . . . . . .   4
  28.            Specify Directory to start search . . . . . . . . . . . . .   4
  29.            Shortcut Notation . . . . . . . . . . . . . . . . . . . . .   5
  30.            Hidden Directories  . . . . . . . . . . . . . . . . . . . .   5
  31.      NEW FEATURES of SUPER*SEARCH  . . . . . . . . . . . . . . . . . .   5
  32.            Option Stacking . . . . . . . . . . . . . . . . . . . . . .   5
  33.            File Commands . . . . . . . . . . . . . . . . . . . . . . .   5
  34.            Directing the Output  . . . . . . . . . . . . . . . . . . .   5
  35.            Text Search for Word  . . . . . . . . . . . . . . . . . . .   6
  36.      SHAREWARE AND SUPER*SEARCH  . . . . . . . . . . . . . . . . . . .   6
  37.            How do I Register ? . . . . . . . . . . . . . . . . . . . .   6
  38.      RESTRICTIONS  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  39.      REQUIREMENTS  . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  40.      INSTALLATION  . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  41.      Reading the SUPER*SEARCH output screen  . . . . . . . . . . . . .   7
  42.      PROGRAM USAGE . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  43.            Context Sensitive Help  . . . . . . . . . . . . . . . . . .   9
  44.            Wildcard Basics . . . . . . . . . . . . . . . . . . . . . .  11
  45.            Extending Wildcards . . . . . . . . . . . . . . . . . . . .  11
  46.            Using DATE OPTIONS  . . . . . . . . . . . . . . . . . . . .  12
  47.                 The TODAY Option . . . . . . . . . . . . . . . . . . .  12
  48.                 The SINCE number of days (ago) Option  . . . . . . . .  13
  49.                 The BEFORE and AFTER Options . . . . . . . . . . . . .  13
  50.                 The PERIOD Option  . . . . . . . . . . . . . . . . . .  14
  51.                 The DATE (specific) Option . . . . . . . . . . . . . .  14
  52.                 The DATE (wildcard) Option . . . . . . . . . . . . . .  14
  53.            Using SIZE OPTIONS  . . . . . . . . . . . . . . . . . . . .  15
  54.                 The GREATER THAN Option  . . . . . . . . . . . . . . .  15
  55.                 The LESS THAN Option . . . . . . . . . . . . . . . . .  16
  56.                 The EQUAL TO Option  . . . . . . . . . . . . . . . . .  16
  57.            Using ATTRIBUTE OPTIONS . . . . . . . . . . . . . . . . . .  16
  58.            Using TEXT SEARCH for Word  . . . . . . . . . . . . . . . .  17
  59.  
  60.  
  61.  
  62.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page i
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.            Using FILE MANIPULATION COMMANDS  . . . . . . . . . . . . .  18
  71.                 Command Smarts . . . . . . . . . . . . . . . . . . . .  19
  72.                 Special VERIFY features  . . . . . . . . . . . . . . .  19
  73.                 The COPY Command . . . . . . . . . . . . . . . . . . .  20
  74.                 The MOVE Command . . . . . . . . . . . . . . . . . . .  20
  75.                 The DELETE Command . . . . . . . . . . . . . . . . . .  21
  76.                 Command Usage  . . . . . . . . . . . . . . . . . . . .  21
  77.      CUSTOM CONFIGURATION of SUPER*SEARCH  . . . . . . . . . . . . . .  23
  78.            Starting CONFIGURE  . . . . . . . . . . . . . . . . . . . .  23
  79.      HELP SCREEN Features  . . . . . . . . . . . . . . . . . . . . . .  25
  80.      TRICKS and TRAPS of SUPER*SEARCH  . . . . . . . . . . . . . . . .  26
  81.            Shortcut Tricks . . . . . . . . . . . . . . . . . . . . . .  26
  82.            Command Tricks  . . . . . . . . . . . . . . . . . . . . . .  27
  83.            STRICT versus RELAXED relation Tricks . . . . . . . . . . .  28
  84.            Range Tricks with Relational Options  . . . . . . . . . . .  29
  85.            Summary Report Trick 1  . . . . . . . . . . . . . . . . . .  31
  86.            Summary Report Trick 2  . . . . . . . . . . . . . . . . . .  31
  87.            Comparing File-search utilities Trap  . . . . . . . . . . .  32
  88.            Multiple version Tricks . . . . . . . . . . . . . . . . . .  32
  89.            More Filespec Tricks And Traps  . . . . . . . . . . . . . .  33
  90.            Directory Tricks with TURBO mode  . . . . . . . . . . . . .  35
  91.            Duplicate File elimination Trick  . . . . . . . . . . . . .  37
  92.            Batch File Trick  . . . . . . . . . . . . . . . . . . . . .  38
  93.            Sizing Directories and Drives Trick . . . . . . . . . . . .  39
  94.      SUPER*SEARCH Specifications and limitations . . . . . . . . . . .  39
  95.      DISCLAIMER of WARRANTEE and LIABILITY . . . . . . . . . . . . . .  41
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page ii
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.   INTRODUCTION
  140.   ============
  141.   
  142.   This is the fourth release of SUPER*SEARCH, a powerful File-Find and File
  143.   Manipulation utility designed for the IBM PC and compatible computer.   
  144.     
  145.   SUPER*SEARCH offers many Options such as search by  Date, Size, Attribute, 
  146.   Filespec, and Text word. These Options can be combined in almost unlimited 
  147.   ways.
  148.   
  149.   SUPER*SEARCH has  (smart)  File Commands. You can COPY, MOVE, or DELETE 
  150.   files that are qualified by search parameters. A built in VERIFY feature 
  151.   allows you to interactively control the action on a file by file basis.
  152.  
  153.   SUPER*SEARCH can be customized to suit your needs. Select features such 
  154.   as Pause, screen Colors, Turbo mode, Drives to search, and more. You can 
  155.   even make copies of the program and give each copy its own custom setup.
  156.  
  157.   SUPER*SEARCH is easy to learn and use.  Friendly, context sensitive  
  158.   messages will assist you.  A HELP screen is available to recall program
  159.   Options and report Configuration Status.
  160.  
  161.   Overall, the mission of the program is to provide;
  162.   
  163.             *  efficient file location and manipulation
  164.             *  easy to learn and use command line
  165.             *  ergonomic (kind to the eyes) viewing
  166.             *  configurable features
  167.             *  flexibility
  168.    
  169.  
  170.   SEE THE DISCLAIMER AT THE END OF THIS DOCUMENT BEFORE USING SUPER*SEARCH.
  171.                                                                                                                                                                                            ------
  172.    
  173.  
  174.                             About this Manual
  175.                             -----------------
  176.  
  177.   The features of  SUPER*SEARCH  are presented in a series of short 
  178.   descriptions. Most areas of operation can be found as a topic in the Table 
  179.   of Contents.  Some information is repeated to enhance using the manual as a 
  180.   look-up reference.
  181.  
  182.   It is assumed that you are familiar with DOS and the IBM PC. If this is not 
  183.   the case, be sure to read the sections on Wildcard Basics and Using File 
  184.   manipulation Commands.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 1
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.   GENERAL FEATURES
  205.   ================ 
  206.   
  207.  
  208.                            Pattern match Wildcards
  209.                            -----------------------
  210.   Wildcards act as a substitute for portions of a file name (specification). 
  211.   If you forget part (or all) of a target file NAME, you can still view a list 
  212.   of files that have similar Names and home in on what you're seeking. The 
  213.   basic idea is;
  214.  
  215.      Find files that    START             (with a text pattern)
  216.      Find files that    END               (with a text pattern)
  217.      Find files that    MATCH             (text pattern  within  file Name)
  218.  
  219.   SUPER*SEARCH allows only one filespec per search. However, that filespec is 
  220.   (very) powerful and supports nearly any combination of letters and 
  221.   wildcards.  
  222.  
  223.  
  224.  
  225.                              Size Search Options
  226.                              -------------------
  227.   The program will conduct searches qualified by File size.  A review of 
  228.   filenames that meet a SIZE specification can often turn up an elusive file.
  229.   The Size Options are; 
  230.  
  231.      Find files         GREATER           (than  nnn  bytes)
  232.      Find files         LESS              (than  nnn  bytes)
  233.      Find files         EQUAL             (to    nnn  bytes)
  234.  
  235.   You can combine the GREATER and LESS  Options to search for a specific SIZE 
  236.   range.  See the TRICKS and TRAPS section for more. 
  237.  
  238.  
  239.      
  240.                              Date Search Options
  241.                              -------------------
  242.   When other methods fail to turn up a target file, a DATE qualified search 
  243.   can be revealing.  SUPER*SEARCH offers flexible Date Options including;
  244.  
  245.  
  246.      Find files dated   TODAY
  247.      Find files dated   SINCE             (number of days ago)
  248.      Find files dated   BEFORE            (month_day_year)
  249.      Find files dated   AFTER             (month_day_year)
  250.      Find files of a    SPECIFIC          (month_day_year)
  251.      Find files in a    PERIOD            (month_year  to  month_year)
  252.      Find files using   WILDCARD DATE     (any_month any_day any_year)
  253.  
  254.   
  255.   You'll be in the driver's seat like never before when date oriented searches 
  256.   are required. You can combine the BEFORE and AFTER Options to achieve custom 
  257.   DATE range searches.
  258.  
  259.  
  260.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 2
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                           Attribute Search Options
  272.                           ------------------------
  273.   There are times when you may want to search out files that have certain 
  274.   attributes or attribute patterns. The ATTRIBUTE Options are; 
  275.  
  276.      Find files with    READ_ONLY         (attribute set)
  277.      Find files with    HIDDEN            (attribute set)
  278.      Find files with    ARCHIVE           (attribute set)
  279.  
  280.   SUPER*SEARCH does not offer the SYSTEM attribute but will allow you to stack 
  281.   the other three Options to search out attribute combinations.
  282.  
  283.  
  284.                             Configuration Options
  285.                             ---------------------
  286.   SUPER*SEARCH is one of the few file location programs to offer configuration 
  287.   that is NOT based on the DOS ENVIRONMENT. Because of this, the user may copy 
  288.   the program to another NAME and configure that copy to have different 
  289.   features, colors, etc. 
  290.  
  291.   The following CONFIGURATION features can be turned ON or OFF, like a switch. 
  292.   They are accessed using the  /C  Option.  The status of these features (ON 
  293.   or OFF) is reported each time you invoke the  HELP  screen.  They are;
  294.  
  295.  
  296.      AUTOSCREEN PAUSE       When enabled, pauses for a screen full condition.
  297.      (default = ON)         (Automatic detection of 80 by xx screen sizes.)
  298.  
  299.      SUMMARY REPORT         When enabled, a Summary of the last search details
  300.      (default = ON)         items such as files found, dirs searched, true
  301.                             storage, megabytes spanned, etc.
  302.  
  303.      MULTI DRIVE SEARCH     When enabled, the program searches all drives
  304.      (default = ON)         preset in the internal User-Drive-List. When
  305.                             disabled, the program always confines the search
  306.                             to the current logged Drive or a specified Drive.
  307.  
  308.      COMMAND VERIFY         When disabled, command execution proceeds on all
  309.      (default = ON)         files that meet search criteria. When enabled, the 
  310.                             user interacts with the program, on a file by file 
  311.                             basis.
  312.  
  313.      TURBO  SEARCH          When enabled, faster search performance on the
  314.      (default = ON)         average of 25% to 35%.
  315.  
  316.      SKIPPED DRIVE ECHO     When enabled, Drive letters missing within the
  317.      (default = OFF)        User-Drive-List sequence, are echoed as being
  318.                             'skipped !'.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 3
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.   IMPROVEMENTS
  336.   ============
  337.   
  338.   Suggestions from registered users and Beta-testers prompted many changes to 
  339.   the program.  The following list outlines the result.
  340.  
  341.  
  342.                           Simplified Configuration
  343.                           ------------------------
  344.   All Configuration selections are presented in menu format. You need only 
  345.   read your choices and enter the corresponding keys. The program walks you 
  346.   through the process one step at a time.  You can enter the CONFIGURATION 
  347.   menu to check out what is available without changing any of the settings.
  348.   Just hit the <enter> key to step through each menu. 
  349.  
  350.  
  351.                            Context Sensitive Help
  352.                            ----------------------
  353.   When you enter the command line, the Context Help facility will identify 
  354.   omissions, out of range parameters, and improper syntax. The error message 
  355.   usually states which Option or parameter is at fault. The proper format for 
  356.   an Option is recalled when appropriate.
  357.  
  358.  
  359.                             Relaxed Entry Order
  360.                             -------------------
  361.   Previous versions forced the user to adhere to a rigid entry order for 
  362.   Options and filespec. You may now enter Options and filespec in any 
  363.   convenient order. The only exception to this is, the Output Redirection 
  364.   feature, which must be last on the command line.
  365.  
  366.  
  367.                     Helpscreen shows Configuration Status
  368.                     -------------------------------------
  369.   Since the program has a wide range of presetable Options, the HELP screen 
  370.   indicates the current configuration (status). At a glance, you can determine 
  371.   how the program will perform when run. This feature is helpful when multiple 
  372.   versions (with different configurations) are in use.
  373.  
  374.  
  375.                           Faster Search performance
  376.                           -------------------------
  377.   You have the choice of HIGHER SPEED searches at the expense of ignoring 
  378.   directories which include an extension in their Name. The speed increase is 
  379.   on the order of 25% to 35% .  More about this later.
  380.  
  381.  
  382.                       Specify Directory to start search
  383.                       ---------------------------------
  384.   The program accepts a filespec that includes a starting path. The search is 
  385.   confined to the STARTING DIRECTORY and ANY OF ITS SUBDIRECTORIES. This is
  386.   superior to the fixed (DRIVE:FILESPEC) limitations of previous versions.
  387.  
  388.   However, remember that the subdirectories of a specified directory (if they 
  389.   exist) ARE included in any program operation!
  390.  
  391.  
  392.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 4
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.                               Shortcut Notation
  403.                               -----------------
  404.   The program will support certain OMISSIONS (from filespecs) for easier
  405.   typing. You will find that these enhancements do not interfere with any 
  406.   legal DOS filespec.  See the Tricks and Traps section for details.
  407.  
  408.   
  409.                              Hidden Directories
  410.                              ------------------
  411.   Earlier versions of the program failed to find files that were on HIDDEN 
  412.   directories.  My thanks to the user who let me know. (let me hear from you)
  413.  
  414.  
  415.  
  416.  
  417.   NEW FEATURES of SUPER*SEARCH
  418.   ============================
  419.  
  420.  
  421.                               Option Stacking
  422.                               ---------------
  423.   You can stack multiple Options in the program command line. This increases 
  424.   the power of the program.  Using various combinations, the program will 
  425.   conduct searches with complex criteria (including a filespec) such as;
  426.    
  427.                   AFTER      a given date          AND/OR
  428.                   BEFORE     a given date          AND
  429.                   GREATER    than a given size     AND/OR
  430.                   SMALLER    than a given size     
  431.                   
  432.   Don't worry if this seems complicated. The good news is that you can mix 
  433.   various search criteria in almost unlimited ways.  As you grow proficient, 
  434.   you'll find stacking quite useful.  Previous versions allowed only one Date 
  435.   or Size Option to be utilized in a search.
  436.  
  437.  
  438.  
  439.                                 File Commands
  440.                                 -------------
  441.   SUPER*SEARCH offers three (3) basic File Commands - COPY, MOVE, and DELETE. 
  442.   The Commands first check that there is enough space at the destination, when 
  443.   files are COPIED or MOVED.  The VERIFY Option will keep the Commands under 
  444.   your control, on a file by file basis.  Files that have attributes of 
  445.   Read_Only, Hidden, or System are ignored by the DELETE command.
  446.  
  447.  
  448.                             Directing the Output
  449.                             --------------------
  450.   You may direct the output to your printer, a disk file, or a device such as 
  451.   a parallel or serial port. However, YOU MUST SUBSTITUTE a right-brace (}) 
  452.   for the DOS  right-angle-bracket (> redirection symbol), in your command 
  453.   line.
  454.  
  455.  
  456.  
  457.  
  458.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 5
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                            Text Search for Word
  468.                            --------------------
  469.   The program READS files that meet search criteria to locate a specified text 
  470.   WORD. The internal text search is limited to the first 2048 bytes (one 80x25 
  471.   text page).
  472.  
  473.   This search method will find TITLES and/or SUBJECTS of documents, NAMES in 
  474.   letters, and other applications that you'll think of. Files with certain 
  475.   extensions are automatically skipped, such as .EXE, .COM, .ZIP, etc.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.   SHAREWARE AND SUPER*SEARCH
  483.   ==========================
  484.  
  485.   SUPER*SEARCH is user supported Shareware.
  486.  
  487.   With Shareware, you can determine if a software product meets your needs - 
  488.   before you hand over your cash!  You become a satisfied customer (without) 
  489.   risking money.  Contrast this to purchasing software over the counter.
  490.       
  491.   IF YOU LIKE SUPER*SEARCH AND INTEND TO USE IT, YOUR SUPPORT IS NEEDED AND 
  492.   APPRECIATED!  
  493.  
  494.  
  495.                              How do I Register ?
  496.                              -------------------
  497.   Please print the REGISTER.FRM file to your printer.  Write in your name, 
  498.   address, and comments.  Place the form and your donation in an envelope and 
  499.   mail it to the indicated address.
  500.  
  501.   Thanks in advance for your understanding and support! It is appreciated.
  502.  
  503.  
  504.  
  505.  
  506.  
  507.   RESTRICTIONS
  508.   ============
  509.  
  510.   You must use DOS version 3.0 or later. Earlier DOS versions will not support 
  511.   Configuration changes. 
  512.  
  513.   SUPER*SEARCH is intended as a Hard Disk utility and should be installed on a
  514.   Hard Disk. 
  515.  
  516.   The program does not use the (<) and (>) symbols as these are reserved for
  517.   DOS redirection control. While you can send program output to a file or
  518.   printer, it is NOT intended for piping, filtering or other DOS I/O schemes.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 6
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.   REQUIREMENTS
  534.   ============
  535.  
  536.   The program is intended for the IBM PC and compatible computer.  Install it 
  537.   on a Hard Disk following recommendations in the INSTALLATION section of this 
  538.   manual.
  539.  
  540.   While SUPER*SEARCH is designed for Color systems, it will work fine in a 
  541.   Monographic system.
  542.  
  543.   It is best to run the program with at least 100k of free ram. If file 
  544.   Commands are NOT used, 65k of ram will suffice.
  545.  
  546.   Be sure that you fully understand the (COPY, MOVE, and DELETE) commands
  547.   BEFORE you use them. 
  548.   
  549.   SUPER*SEARCH is EXTREMELY POWERFUL and can do a lot of damage if improperly 
  550.   used!  LEAVE THE COMMAND VERIFY OPTION  ENABLED, until you are expert with 
  551.   the program.  (Even then, leave it enabled).
  552.  
  553.   READ THE DISCLAIMER AT THE END OF THIS DOCUMENT BEFORE RUNNING SUPER*SEARCH!
  554.                                                   ------
  555.  
  556.  
  557.   INSTALLATION
  558.   ============
  559.  
  560.   Copy the file  SS.EXE  to a Hard Disk directory that is in your PATH. If you 
  561.   are not sure about the PATH, see your DOS manual.  SUPER*SEARCH is ready for 
  562.   action.
  563.  
  564.  
  565.  
  566.   Reading the SUPER*SEARCH output screen
  567.   ======================================
  568.  
  569.   When you run the program, file name(s) and statistics that meet search 
  570.   criteria are listed to the screen. Here is a breakdown of program output;   
  571.                                                                   
  572.                                                                            
  573.                                 File NAME                                
  574.                                    |                                        
  575.                                    |     File EXTENSION                  
  576.                                    |        |                               
  577.     DATE        TIME      SIZE     |        |       LOCATION
  578.       |          |         |       \        /          |
  579.       |          |         |        |      |           |                     
  580.    -----------------------------+--------------+--------------              
  581.    Sep 10-88   9:52p     10,756 | EUROMAP .MAP | C:\GRAFMAPS
  582.    Sep 10-88   9:52p     10,330 | USMAP   .MAP | C:\GRAFMAPS                    
  583.    -----------------------------+--------------+--------------
  584.    Mar 12-89  12:02a      1,221 | TREX    .MAP | D:\PASCAL\PROJ 
  585.    -----------------------------+--------------+--------------
  586.   
  587.  
  588.  
  589.  
  590.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 7
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.   Left to right the output shows file Statistics, file Name and Extension, and 
  600.   the file Location. Separation of file Name and Location eases viewing when 
  601.   large numbers of files are listed.
  602.  
  603.   Top to bottom, we see that drive (C:) files were separated by a horizontal
  604.   line, from drive (D:) files. 
  605.  
  606.   Below the file listing is the optional Summary report (see below). If this 
  607.   Option is ON or enabled, it will provide information about the last search. 
  608.   Among other things, the search FileSpec is recalled. This is handy when many 
  609.   files were listed and the last command line has scrolled off the screen.  
  610.  
  611.   The Summary provides storage information in the form of two numbers. The 
  612.   first is APPARENT STORAGE. This is the sum of all file sizes that met search 
  613.   parameters. Added together, you have the apparent storage requirements to 
  614.   save these files to any disk. Stated another way, this number reflects the 
  615.   least amount of storage needed. The truth is, that these files almost always 
  616.   use more than this (apparent) number. The TRUE STORAGE number reflects how 
  617.   much disk space is currently allocated to these files. 
  618.  
  619.   Other file information is available such as FILES FOUND, POSSIBLE MATCH, 
  620.   DIRECTORIES SEARCHED, and MEGABYTES (or kilobytes) SPANNED. When Commands 
  621.   are executed, you'll see a flashing message (in the empty line on the right 
  622.   part of the Summary), indicating, how many files were COPIED, MOVED, or 
  623.   DELETED. 
  624.  
  625.  
  626.   Here is an example of the Summary report;
  627.  
  628.  
  629.            Specific Search              General Search
  630.                  info                        info 
  631.                   |                           |
  632.                   |                           |
  633.    -----------------------------------------------------------
  634.    File  Spec .....        (*.C)  Possible Match .....   3,269
  635.    Files FOUND ....          14   Dirs  Searched .....     111
  636.    Appnt Storage ..      51,165                               
  637.    True  Storage ..      64,544   Megabytes Spanned ..   108.6
  638.    -----------------------------------------------------------
  639.  
  640.   
  641.  
  642.   Additional information may follow the file list and the Summary report. The 
  643.   program adds statements about any Options or special search functions that 
  644.   were used.  These include  Date Options, Size Options, Attribute Options and 
  645.   Text Search.
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 8
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.   The following is typical program output;
  666.  
  667.  
  668.  
  669.    SUPER*SEARCH  V1.4  - Copyright (c) 1989 -  by Thomas Price 
  670.    -----------------------------+--------------+--------------
  671.    Apr 15-89   2:28p      6,495 | DR      .COM | C:\BATCH                       
  672.    Apr 15-89   2:28p      6,495 | DC      .COM | C:\BUTLS                       
  673.    -----------------------------+--------------+--------------
  674.    Apr 19-89   5:28a      7,291 | DIRCHK  .COM | G:\                            
  675.    -----------------------------+--------------+--------------
  676.    File  Spec .....     (D*.COM)  Possible Match .....     199
  677.    Files FOUND ....           3   Dirs  Searched .....     111
  678.    Appnt Storage ..      19,485                               
  679.    True  Storage ..      22,912   Megabytes Spanned ..   108.6
  680.    -----------------------------------------------------------
  681.    AFTER   . . . .  Apr 10 1989  
  682.    BEFORE  . . . .  Apr 20 1989  
  683.    GREATER than           6,000
  684.    LESS    than           8,000
  685.  
  686.  
  687.  
  688.   The above example lists files that met search requirements, a Summary of 
  689.   what transpired, and comments about additional search criteria.
  690.  
  691.   You'll always know what happened at the end of a  SUPER*SEARCH  operation.
  692.  
  693.   When output is directed to a file or the printer, the Summary report and the 
  694.   extra comments are echoed to the screen.
  695.  
  696.  
  697.  
  698.  
  699.   PROGRAM USAGE
  700.   =============
  701.   
  702.   The interface between user and program is a DOS command line. A command line 
  703.   consists of typing a program NAME and any additional switches, parameters, 
  704.   plus the final step of hitting the <enter> key.
  705.  
  706.   The SUPER*SEARCH command line format can be thought of as;   
  707.  
  708.     SS  [/Options]  [Filespec]  [(TextWord)]  ['Command <dest>']  <enter>
  709.  
  710.   All of the choices after  SS  and before <enter> are optional!  Use the ones 
  711.   that help you find and manipulate your target files.                  
  712.   
  713.   The ORDER of the Options, Filespec, etc is up to you. 
  714.  
  715.  
  716.                            Context Sensitive Help
  717.                            ----------------------
  718.   When you type a command line, the context sensitive help facility will alert 
  719.   you about any syntax or parameter errors. If your command line is okay, the 
  720.  
  721.  
  722.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 9
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.   program will start the search operation.
  732.  
  733.   The following is an example of the context help facility as it catches 
  734.   command line errors. The program output is contained in asterisks for 
  735.   clarity;
  736.  
  737.  
  738.     SS /w  <enter>
  739.  
  740.   ****************************************************************************
  741.   *                                                                          *
  742.   *  SUPER*SEARCH - Copyright (c) 1989 by T. L. Price                        *
  743.   *                                                                          *
  744.   *    illegal Option letter /w                                              *
  745.   *                                                                          *
  746.   *  Type:      SS <enter>         to get HELP screen                        *
  747.   *                                                                          *
  748.   ****************************************************************************
  749.  
  750.   The facility detected the use of an illegal option letter. Here is another 
  751.   example;
  752.  
  753.     SS /p  <enter> 
  754.  
  755.   ****************************************************************************
  756.   *                                                                          *
  757.   *  SUPER*SEARCH - Copyright (c) 1989 by T. L. Price                        *
  758.   *                                                                          *
  759.   *    bad (month) in   /P mm yy <mm yy>    PERIOD opt                       *
  760.   *                                                                          *
  761.   *  Type:      SS <enter>         to get HELP screen                        *
  762.   *                                                                          *
  763.   ****************************************************************************
  764.  
  765.   The notation   /P mm yy <mm yy>   is the format for the PERIOD Option.
  766.   This Option will qualify file locations occurring within the parameters of 
  767.   starting Month-Year (the first  mm yy  numbers) and an optional ending 
  768.   Month-Year (the second <mm yy> numbers).
  769.  
  770.   From the error message [ bad (month) in ..], you can deduce that you're 
  771.   having  problems with the (mm) parameter of this Option. In fact, that 
  772.   parameter was omitted to force the error message. If the parameter was 
  773.   present, but not numeric or out of range, the same error message would be 
  774.   output.   
  775.  
  776.   Most Commands, parameters, and Options are checked for proper range and 
  777.   type, as is required to support a program feature.  The context help 
  778.   facility pinpoints any problems.
  779.  
  780.   Filespecs (as opposed to numeric parameters) can be almost anything. 
  781.   Therefore, you will not receive any bad filespec messages.  However, your 
  782.   Filespec cannot use any special SWITCH CHARACTERS in the FIRST LETTER 
  783.   POSITION. These characters are [ / ' ( } ], not including the square 
  784.   brackets. The (/) character may not be used in any position of a filespec.
  785.  
  786.  
  787.  
  788.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 10
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.                                Wildcard Basics
  799.                                ---------------
  800.   As you become more experienced with file-find utilities, you'll discover
  801.   that much can be accomplished using 'wildcards'.  Wildcards are used in the
  802.   filespec part of search criteria.  Filespec is another way of saying we are
  803.   specifying a file NAME (and extension) using letters and wildcards.
  804.  
  805.   DOS provides some useful shortcuts for typing file Names and Extensions. The
  806.   DOS wildcards are the characters (* and ?). They act as a substitute for
  807.   portions (or all) of a file Name and/or extension.
  808.  
  809.   To illustrate this, you could issue a (DOS) DIR command with a filespec of
  810.   (*.BAT).  All files in the current directory that have any NAME but an
  811.   EXTENSION of (.BAT) will be listed to your screen.  In this case, DOS 
  812.   (ignores) the Name portion - and shows those files that match the Extension
  813.   specification. The command line would be;
  814.  
  815.         DIR  *.BAT  <enter>  
  816.  
  817.   You can think of the DOS (*) wildcard as having an (operative definition) of
  818.   IGNORE ALL AFTER.  Since it showed up at the beginning of the Name portion
  819.   of the above example filespec, the entire Name field was (ignored) by DOS. 
  820.   Only the Extension field determined the outcome of the command.
  821.  
  822.   The IGNORE ALL AFTER operative is very useful when you know the STARTING 
  823.   letters of a file Name.
  824.  
  825.   Some example filespecs using this concept are;
  826.  
  827.         ed*.*         Names that  START  with (ED)     {ignore after (ED)}
  828.         comm*         Names that  START  with (COMM)   {ignore after (COMM)}
  829.  
  830.   This is fine, unless you can't remember the starting text of those files you 
  831.   seek? If you want to search for files that  END  in a text pattern, you need 
  832.   a different operative.
  833.  
  834.  
  835.  
  836.                              Extending Wildcards
  837.                              -------------------
  838.   Some file-finder and directory programs  extend  the wildcard (operative 
  839.   definition) to include a case of  IGNORE ALL BEFORE.  Typical filespecs 
  840.   using this concept could be;
  841.  
  842.         *nd.com       Names that  END  with (ND)     { ignore before ND }
  843.         *exec.bat     Names that  END  with (EXEC)   { ignore before EXEC }
  844.  
  845.   Once you become accustomed to using the regular and extended wildcards, it 
  846.   is natural to try both techniques at once.  This would imply that you can 
  847.   find files that have an INSTANCE of a text pattern, anywhere within the Name 
  848.   field. This is sometimes referred to as pattern match or mid-string 
  849.   searching.
  850.   
  851.   Some example filespecs might be;
  852.  
  853.  
  854.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 11
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.         *er*          Names with the PATTERN  (ER)   { ignore before/after } 
  864.         *omma*        Names with the PATTERN  (OMMA) { ditto }
  865.  
  866.   SUPER*SEARCH provides all of these wildcard operatives.  You can locate 
  867.   files that BEGIN, END, or have some INSTANCE of a text pattern. 
  868.  
  869.   The following examples show how you can use regular and extended wildcards.
  870.   
  871.  
  872.     SS  er*        <enter>                   Find files  STARTING  in  'er'.
  873.                                              Regular DOS wildcard.
  874.  
  875.     SS  *er        <enter>                   Find files  ENDING    in  'er'.
  876.                                              EXTENDED wildcard.
  877.  
  878.     SS  *er*       <enter>                   Find files  INSTANCE  of  'er'.
  879.                                              EXTENDED wildcard.
  880.  
  881.   
  882.  
  883.   Using DATE OPTIONS
  884.   ==================
  885.  
  886.   SUPER*SEARCH provides comprehensive, DATE qualified file location.  If you 
  887.   can't remember a file Name, searching by Date might hit the bulls-eye.
  888.  
  889.  
  890.                               The TODAY Option
  891.                               ----------------
  892.   This Option will find all files that have the current DOS system date. The 
  893.   files would have been created or updated - not copied.  Therefore, they 
  894.   would bear  TODAYS'  month, day, and year.
  895.  
  896.   Note that a copied file will still retain its original (or last updated) 
  897.   date/time values.  Only when you edit a file or somehow write to it (or 
  898.   create it), will it bear the current DOS date/time values.
  899.  
  900.   The following command lines are typical:
  901.  
  902.  
  903.     SS  /t         <enter>                   Find all files that bear
  904.                                              TODAYS' DOS date (*.* implied).
  905.  
  906.     SS  /t  *.bak  <enter>                   Same as above but with a file
  907.                                              extension qualifier.
  908.  
  909.     SS  /t  *er*   <enter>                   Find all files with pattern
  910.                                              (er) that bear TODAYS' DOS
  911.                                              date -  any extension.
  912.  
  913.  
  914.   If you create files on a daily basis, you'll find the TODAY Command handy to 
  915.   recap what got changed or created, TODAY.
  916.  
  917.  
  918.  
  919.  
  920.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 12
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.                       The SINCE number of days ago Option
  930.                       -----------------------------------
  931.   This Option finds files whose dates range from the current system date (IE 
  932.   today's date) back some arbitrary number of days. The number specified can 
  933.   range from zero to thousands of days.  SUPER*SEARCH calculates month sizes 
  934.   and leap years, to land on the correct starting date.
  935.  
  936.   If you specify that you want to list files dated SINCE 6 days ago, you will 
  937.   get those 6 days PLUS whatever files are dated TODAY.  I know this may sound 
  938.   confusing, but it will make sense to you after you use the command. 
  939.  
  940.   The following examples illustrate using the SINCE Option;
  941.  
  942.  
  943.     SS  /s  0      <enter>                   Finds files SINCE zero days ago
  944.                                              plus todays files. Same result as
  945.                                              the TODAY Option.
  946.  
  947.     SS  /s  7      <enter>                   Find files dated over the last
  948.                                              week (plus today).
  949.  
  950.     SS  /s  365    <enter>                   Find files dated over the last
  951.                                              year (plus today).
  952.  
  953.  
  954.  
  955.  
  956.                         The BEFORE and AFTER Options
  957.                         ----------------------------
  958.   These Options qualify files dated either  BEFORE  or  AFTER,  a given date. 
  959.   You can stack the BEFORE and AFTER options, to give you a specific 
  960.   date-range. 
  961.  
  962.  
  963.     SS  /b  12 05 81         <enter>         Find all files that bear a DOS
  964.                                              date occurring BEFORE 12/5/81.
  965.                                              (*.* implied).
  966.  
  967.     SS  /b  12 05 81 *.exe   <enter>         Same as above, but with file
  968.                                              extension qualifier.
  969.  
  970.     SS  /A  02 06 89         <enter>         Find all that bear a DOS date
  971.                                              occurring AFTER 2/6/89.
  972.  
  973.  
  974.     SS /A 7 7 90  /b 7 21 90 <enter>         Find all that bear dates AFTER
  975.                                              7/7/90 and BEFORE 7/21/90
  976.                                              STACKED OPTIONS.
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 13
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.                              The PERIOD Option
  996.                              ------------------
  997.   This Option qualifies files that occur across a (monthly) range of dates. 
  998.   The usage is a bit more involved.
  999.  
  1000.   First, you specify months and years - NOT days. This feature spans from the 
  1001.   FIRST day of the first (mm yy) parameters thru the LAST day of the second 
  1002.   (mm yy) parameter.  { mm yy notation denotes month and year }
  1003.  
  1004.   If you give only one set of (mm yy) parameters, you will get a search report
  1005.   based on a (single month span) for the given month and year.
  1006.  
  1007.   The usage is as follows;
  1008.  
  1009.  
  1010.     SS /p  1 88  12 89        <enter>        Find all files from Dec 1, 88
  1011.                                              thru Dec 31, 89 (implied *.*).
  1012.  
  1013.     SS /p 12 88  12 89 *.bak  <enter>        Same as above but with file
  1014.                                              extension qualifier.
  1015.  
  1016.     SS /p 10 89  10 89        <enter>        Find all files whose dates
  1017.                                              range from Oct 1,89 thru
  1018.                                              October 31,89.  see below.
  1019.  
  1020.     SS /p 10 89               <enter>        Same as above. Find all files
  1021.                                              for the MONTH of October 1989
  1022.                                              (implied *.*).
  1023.  
  1024.  
  1025.  
  1026.                          The DATE (specific) Option
  1027.                          --------------------------
  1028.   Very few (search) programs let you locate files that occur on a SPECIFIC 
  1029.   date. Sooner or later, you'll find that this Option is a must.
  1030.  
  1031.   The DATE Option will allow you two distinct ways to locate files. The first 
  1032.   way is to specify a (specific) date.  Examples follow;
  1033.  
  1034.  
  1035.     SS /d  12 25 89           <enter>        Find all files of Dec 25, 1989.
  1036.                                              (implied *.*).
  1037.  
  1038.     SS /d  12 25 89  *.exe    <enter>        Same as above but with
  1039.                                              EXTENSION QUALIFIER.
  1040.  
  1041.  
  1042.  
  1043.                          The DATE (wildcard) Option
  1044.                          -------------------------- 
  1045.   The second way to utilize the DATE Option is to substitute a (?) for a DATE 
  1046.   Option PARAMETER.  The Option supports the use of (? or ??) in ANY or ALL of 
  1047.   the parameter fields.  The following examples illustrate;
  1048.  
  1049.  
  1050.  
  1051.  
  1052.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 14
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.     SS /d    ?  03  86       <enter>         Find files that occurred the
  1062.                                              THIRD of (ANY MONTH) - 1986.
  1063.  
  1064.     SS /d   12   ?  89       <enter>         Find files that occurred on
  1065.                                              DEC 1989 (ANY DAY). Same as
  1066.                                              the PERIOD Option for a ONE
  1067.                                              month range, but faster.
  1068.  
  1069.     SS /d   12  09   ?       <enter>         Find files that occurred  on
  1070.                                              DEC 09   (ANY YEAR).
  1071.  
  1072.     SS /d   12  09  ??  *er* <enter>         Same as above but with a TEXT
  1073.                                              PATTERN QUALIFIER.
  1074.  
  1075.     SS /d   ??  ??  90       <enter>         Find all files dated in 1990.
  1076.  
  1077.  
  1078.   This DATE WILDCARD feature is currently a SUPER*SEARCH exclusive. There are 
  1079.   many more ways to apply it to your search needs. Try it, you'll like it.
  1080.  
  1081.  
  1082.  
  1083.   Using SIZE OPTIONS
  1084.   ==================
  1085.  
  1086.   Finding files that are greater or smaller than some size value can help you 
  1087.   zero in on what you're looking for.  One application is to identify (large) 
  1088.   files that use a lot of storage.
  1089.   
  1090.   If your hard disk has a cluster size of 2048 or 4096 bytes, then all really 
  1091.   small files are allocating (at least) one cluster each. The waste of many 
  1092.   small files could be horrendous. 
  1093.  
  1094.   When you run the following examples, watch the values of the  APPARENT  and 
  1095.   TRUE STORAGE  figures, in the Summary report. You may be surprised at what 
  1096.   you learn about your storage situation.
  1097.  
  1098.   
  1099.  
  1100.                            The GREATER THAN Option
  1101.                            -----------------------
  1102.   This works just like it sounds. You can locate files that are (greater than) 
  1103.   the size parameter entered. Here are some examples;
  1104.  
  1105.  
  1106.     SS  /G  1000000         <enter>          Find files greater than
  1107.                                              1 million bytes.
  1108.  
  1109.     SS  /G  1000000  *.asm  <enter>          As above but with extension
  1110.                                              qualifier.
  1111.  
  1112.  
  1113.   In case you're wondering, DOS reserves the symbols (<) and (>) for I/O 
  1114.   redirection.  They cannot be used to substitute for the (/option-letter) 
  1115.   used to invoke the Size features. Therefore, you must enter (/g nnn) 
  1116.  
  1117.  
  1118.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 15
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.   instead of (> nnn).
  1128.  
  1129.  
  1130.  
  1131.                             The LESS THAN Option
  1132.                             --------------------
  1133.   This Option will allow you to find files that are (less than) the size 
  1134.   parameter. Examples are;
  1135.  
  1136.  
  1137.     SS  /L  100             <enter>          Find files less than 100
  1138.                                              bytes.
  1139.  
  1140.     SS  /L  100  *.bat      <enter>          As above but with qualifier.
  1141.  
  1142.  
  1143.   It is also possible to define a specific Size-range by stacking the (GREATER 
  1144.   than)  and (LESS than) Options.  This is illustrated as below;
  1145.  
  1146.  
  1147.     SS /G 100 /L 500        <enter>          Find files with size values
  1148.                                              GREATER than 100 bytes (and)
  1149.                                              LESS    than 500 bytes.
  1150.  
  1151.  
  1152.  
  1153.                              The EQUAL TO Option
  1154.                              -------------------
  1155.   You can find files of a specific size using this Option.  Usage is;
  1156.  
  1157.  
  1158.     SS  /E  0               <enter>          Find all zero byte files.
  1159.  
  1160.     SS  /E  1024            <enter>          Find all 1024 byte files.
  1161.  
  1162.     SS  /E  12  *e?r*       <enter>          Find all 12 byte files with
  1163.                                              an instance of the pattern
  1164.                                              (*e?r*).
  1165.  
  1166.  
  1167.  
  1168.   Using ATTRIBUTE OPTIONS 
  1169.   =======================  
  1170.  
  1171.   These options are useful when looking for files with Read_Only, Hidden, or 
  1172.   Archive attributes set. I needed these Options when my file compression 
  1173.   software refused to move certain areas of my disk. This was usually a result 
  1174.   of lost clusters, but it also turned out that Read_Only or Hidden files 
  1175.   could lead me on a merry chase (through dozens of directories). 
  1176.  
  1177.  
  1178.   **NOTE**
  1179.  
  1180.   The READ_ONLY Attribute Option is only concerned with the Read_Only file
  1181.   attribute. It ignores other file attributes.  Files that have this attribute 
  1182.  
  1183.  
  1184.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 16
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.   set will be (found) during its use.
  1194.  
  1195.   The HIDDEN Attribute Option is only concerned with the Hidden file
  1196.   attribute. It ignores other file attributes. Files that have this attribute 
  1197.   set will be (found) during its use.  
  1198.  
  1199.   The ARCHIVE Attribute Option is only concerned with the Archive file
  1200.   attribute. It ignores other file attributes. Files that have this attribute 
  1201.   set will be (found) during its use. 
  1202.  
  1203.  
  1204.  
  1205.   USAGE is;
  1206.  
  1207.  
  1208.     SS  /R                  <enter>          Find any files with the 
  1209.                                              READ_ONLY attribute set.
  1210.  
  1211.     SS  /H                  <enter>          Find any files with the 
  1212.                                              HIDDEN    attribute set.
  1213.  
  1214.     SS  /V                  <enter>          Find any files with the
  1215.                                              ARCHIVE attribute set.
  1216.  
  1217.  
  1218.  
  1219.   Using TEXT SEARCH for Word
  1220.   ==========================
  1221.  
  1222.   This feature finds files that have a specific text word in the first 2000 
  1223.   bytes.  The assumption is that the general Subject or Title (word) of the 
  1224.   file will be in the first text page.
  1225.  
  1226.  
  1227.   The general format for this Option is;
  1228.  
  1229.     SS  (textword)    <enter>  
  1230.  
  1231.                           or 
  1232.  
  1233.     SS   (-textword)  <enter>
  1234.  
  1235.  
  1236.   The program ignores many file extensions of NON text files. This includes 
  1237.   extensions of .EXE, .COM, .ARC, .ZIP, .ZOO, and numerous others. 
  1238.  
  1239.   To improve speed, this feature is CASE-SENSITIVE. Therefore (Tho) is 
  1240.   different from (tho).  Syntax requires you to enclose your text word in 
  1241.   parenthesis (). You must not use more than one word  or any spaces.
  1242.  
  1243.   For maximum flexibility, there are two ways to specify the word search. One 
  1244.   way is to just type part of the word (pattern). However, this method could 
  1245.   find files with similar words. To overcome this possibility, it is best to 
  1246.   type the entire word.  In cases where this fails, you can use a (dash) 
  1247.   modifier to explicitly specify an exacting search that won't be confused by 
  1248.  
  1249.  
  1250.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 17
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.   similar pattern words. 
  1260.    
  1261.   You must take care to specify the word correctly. 
  1262.  
  1263.   The following examples are NOT CORRECT;
  1264.  
  1265.  
  1266.     (sammy )                                 WRONG - space in parenthesis.
  1267.     ( sammy)                                 WRONG - space in parenthesis.
  1268.     (Me and sammy)                           WRONG - space in parenthesis.
  1269.                                              More than one word illegal.
  1270.   
  1271.   
  1272.   These examples are CORRECT;
  1273.  
  1274.     (Sammy)                                  Correct  specification.
  1275.     (Tho)                                    Correct  specification.
  1276.     (-resume)                                Correct  specification.
  1277.  
  1278.  
  1279.   The last example above (IE -resume), has a dash modifier to help discern 
  1280.   between true (words) and pattern likenesses. The text word (resume) could be 
  1281.   'found' in similar words such as (presume and resumed). Using (-resume) 
  1282.   modifies the search to look for the word ' resume ', which has a leading and 
  1283.   trailing space.
  1284.  
  1285.  
  1286.   The proper usage is as follows;
  1287.  
  1288.  
  1289.     SS  (Tho)              <enter>           Find any text files that have
  1290.                                              an instance of  'Tho'  in the 
  1291.                                              first 2048 bytes.
  1292.  
  1293.     SS  (Tho) /A 12 9 89   <enter>           Same  as above - but only check
  1294.                                              text files dated AFTER 12/9/89.
  1295.  
  1296.     SS  .asc  (-January)   <enter>           Find any text files with the
  1297.                                              extension (.ASC) with an instance
  1298.                                              of ' January ' in the first 2048
  1299.                                              bytes.
  1300.  
  1301.  
  1302.  
  1303.   Using FILE MANIPULATION COMMANDS 
  1304.   ================================
  1305.  
  1306.   SUPER*SEARCH provides three (smart) file manipulation Commands. They are 
  1307.   COPY, MOVE, and DELETE. With them, you have the ability to perform file 
  1308.   maintenance tasks across multiple drives. 
  1309.                    
  1310.   File Commands have the FORMAT ...   'CommandWord  <Destination>' .
  1311.  
  1312.   You must surround the Command with single (right) quotes (').
  1313.  
  1314.  
  1315.  
  1316.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 18
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.   The COPY and MOVE commands will optionally accept what is called a 
  1326.   DESTINATION directory. It is TO this directory that files are MOVED or 
  1327.   COPIED. If no destination is specified, the program assumes the current 
  1328.   logged directory is the intended destination.  Should you specify a 
  1329.   destination that does not exist, the program aborts with an error message.
  1330.  
  1331.  
  1332.                                *** WARNING ***
  1333.  
  1334.   USE THESE COMMANDS WITH CARE. IT IS POSSIBLE TO ERASE AN ENTIRE HARD DISK, 
  1335.   DIRECTORY BY DIRECTORY, AND PARTITION BY PARTITION.  
  1336.   READ THIS MANUAL CAREFULLY AND BE SURE YOU UNDERSTAND WHAT COMMANDS DO AND 
  1337.   HOW TO USE THEM SAFELY - BEFORE YOU OPERATE THEM !
  1338.         
  1339.  
  1340.     
  1341.                                Command Smarts
  1342.                                --------------
  1343.   The Commands check for adequate space at the specified destination. The 
  1344.   DELETE command will not act on Read_Only, System, or Hidden files.  If there 
  1345.   is a problem, the commands will 'ask' permission to continue.
  1346.  
  1347.   SUPER*SEARCH will not attempt to COPY or MOVE files that are encountered in 
  1348.   a specified (destination) directory. This prevents copying and/or moving 
  1349.   files over themselves.
  1350.  
  1351.   To safeguard against large amounts of data loss, Command VERIFY is built in.
  1352.   This feature (can) be defeated for use with batch files - or if you are 
  1353.   brave.  Each time a Command is used (and VERIFY is enabled), you will be 
  1354.   asked if you want to proceed. This VERIFY question will include File Name 
  1355.   and Path along with the Operation involved.
  1356.  
  1357.   As the program COPIES, MOVES, or DELETES files, it reports the result of 
  1358.   each completed operation with a (check mark), located to the right of each 
  1359.   file Location. 
  1360.    
  1361.  
  1362.    
  1363.                            Special VERIFY features
  1364.                            -----------------------
  1365.   VERIFY has certain special abilities.  IF you issue a Command and you are 
  1366.   sure that all is well, you can answer the (Y/N  ?) query from VERIFY - with 
  1367.   the 'A' key. This tells VERIFY to complete (ALL) file manipulation 
  1368.   operations, with files that meet search criteria.  No further queries from 
  1369.   VERIFY will be received and the program runs to completion. 
  1370.  
  1371.   If you do use the (ALL) key, you can restore VERIFY by hitting any other 
  1372.   key. This is also true when the VERIFY feature is CONFIGURED to be OFF (not 
  1373.   recommended). Tapping a key, during search operations, will recall VERIFY 
  1374.   for that particular run.  When you try this, remember that the current file 
  1375.   operation must be completed before VERIFY is re-enabled. Be prepared for a 
  1376.   delay.
  1377.  
  1378.   
  1379.  
  1380.  
  1381.  
  1382.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 19
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.                               The COPY Command
  1393.                               ----------------
  1394.   COPY checks for adequate space at the destination drive to accept the source 
  1395.   file. If there is not enough, COPY sends the following message;
  1396.  
  1397.   ' Not enough space in destination disk - proceed ? Y/N '
  1398.  
  1399.   If you have a floppy disk set as the destination, you can change disks and 
  1400.   enter (Y) for the Command to continue. If your destination is a Hard Disk, 
  1401.   then you have little choice but to enter (N). The Command ALWAYS checks to 
  1402.   see if there is enough space, before execution.  
  1403.  
  1404.   If there is enough space, COPY then checks if the file already exists at the 
  1405.   specified destination. If the file exists, the Command sends the following 
  1406.   message;
  1407.  
  1408.    '  D:\PATH\FILENAME.EXT  already exists!  COPY ?  Y/N  '
  1409.  
  1410.   If you enter (Y), COPY will overwrite the existing (destination) file with 
  1411.   the source file. If you enter (N), then the next file in the Search 
  1412.   operation is processed.
  1413.  
  1414.  
  1415.  
  1416.                               The MOVE Command
  1417.                               ----------------
  1418.   This command moves files from  anywhere (per your drive list) in your system 
  1419.   to a specified destination directory.  MOVE first writes the source file to 
  1420.   the destination, then erases the source file.
  1421.  
  1422.   MOVE knows to RENAME files when the source and destination directories are 
  1423.   within the same Drive Partition. This is not only faster but prevents 
  1424.   unnecessary fragmentation of files. In this case, additional disk space is 
  1425.   not needed, as only the DOS directory information is changed instead of 
  1426.   executing a copy/erase procedure.
  1427.  
  1428.   When the source and destination Drive or Partitions are different, MOVE 
  1429.   checks for enough space at the destination. If there is not enough, the 
  1430.   Command sends;
  1431.  
  1432.   ' Not enough space in destination disk - proceed ? Y/N '
  1433.  
  1434.   Again, if the destination is removable media, you can change the media and 
  1435.   enter (Y) to continue.
  1436.  
  1437.   MOVE then checks if the file already exists at the destination. If the file 
  1438.   exists, the program sends the following message;
  1439.  
  1440.     ' D:\PATH\FILENAME.EXT  already exists!  MOVE ?  Y/N '
  1441.  
  1442.   If (Y), then MOVE writes the source file over its destination counterpart 
  1443.   and erases the source file.
  1444.  
  1445.  
  1446.  
  1447.  
  1448.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 20
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.                              The DELETE Command
  1458.                              ------------------
  1459.   The Delete Command will erase files that meet search criteria. This command 
  1460.   has the potential to do a lot of damage, if used improperly.  The Command 
  1461.   will NOT delete files that have the READ_ONLY, HIDDEN, or SYSTEM attributes 
  1462.   set.
  1463.  
  1464.   When a file with any of these attributes is encountered, the program ignores
  1465.   it - but leaves you an indication that an attempt to erase a protected file 
  1466.   was made. The indicator is a (!) character - in place of the check mark 
  1467.   character. Completed file manipulations are indicated by a check mark on the 
  1468.   far right of the CRT screen.  
  1469.  
  1470.    
  1471.  
  1472.                                 Command Usage
  1473.                                 -------------
  1474.   All File Commands must be surrounded in single quotes. The format for all 
  1475.   commands is;
  1476.  
  1477.   'CommandWord <Destination>' 
  1478.  
  1479.   The DELETE Command does not use a Destination. If you do include one, DELETE 
  1480.   will ignore it. The notation  <Destination>  implies that it is an optional 
  1481.   parameter. If you do not include a destination with COPY or MOVE, the 
  1482.   Commands will assume the current logged directory to be the destination. 
  1483.  
  1484.   If you wish, you can shorten the CommandWords down to a single letter.
  1485.   
  1486.  
  1487.   The following is usage for  COPY;
  1488.  
  1489.  
  1490.     SS  *.bak  'copy a:\'  <enter>            COPY all (.BAK) files to  A:\ .
  1491.  
  1492.     SS  /T  'cop'          <enter>            COPY all files with TODAY's 
  1493.                                               date to the current logged 
  1494.                                               directory.  Short CommandWord.
  1495.  
  1496.     SS  /T  'c'            <enter>            Same as above but using shortest
  1497.                                               CommandWord.
  1498.  
  1499.     SS .exe  /A 7 7 90  'c  d:\work' <ent>    COPY (.EXE) files that are 
  1500.                                               dated AFTER 7-7-90  to  D:\WORK.
  1501.                                               Implied leading (*) in (21s). 
  1502.                                               Short CommandWord.
  1503.  
  1504.  
  1505.   The following is usage for MOVE;
  1506.  
  1507.  
  1508.     SS  C:*.asc  'move a:' <enter>            MOVE all (.ASC) files of
  1509.                                               Drive C:  to   Drive A: .
  1510.  
  1511.     SS  /T  *.txt 'm'      <enter>            MOVE (.TXT) files with TODAY's
  1512.  
  1513.  
  1514.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 21
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.                                               date to the current directory.
  1524.                                               Short CommandWord.
  1525.  
  1526.     SS  /E 1020 *.BAT 'mov  E:\SAV' <ent>     MOVE (.BAT) files whose size
  1527.                                               equals 1020 bytes to E:\SAV.
  1528.                                               Short CommandWord.
  1529.  
  1530.  
  1531.  
  1532.   The following is usage for DELETE;
  1533.  
  1534.  
  1535.     SS  *.bak  'delete'       <enter>         DELETE   all  (.BAK)  files.
  1536.                                               All drives that are in the
  1537.                                               USER-DRIVE-LIST are affected
  1538.                                               if MULTI-DRIVE Search is ON.
  1539.  
  1540.     SS  /T  *.map  'del'      <enter>         DELETE all (.MAP) files that
  1541.                                               bear  TODAY's  date.
  1542.                                               Short CommandWord.
  1543.  
  1544.     SS  /B  2 1 80 .zip 'd'   <enter>         DELETE  all  (.ZIP) files
  1545.                                               dated  BEFORE  2-1-80.
  1546.                                               Shortest CommandWord.
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 22
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.   CUSTOM CONFIGURATION of SUPER*SEARCH
  1590.   ====================================
  1591.  
  1592.   The program has a menu style method for you to custom set features and 
  1593.   action. You can select Screen Colors, Multi-drive searches, Turbo speed, 
  1594.   Drives to search, and more.  After completion, you can verify all settings 
  1595.   by viewing the HELP screen.    
  1596.  
  1597.   The following illustrates how to CONFIGURE the program.
  1598.  
  1599.  
  1600.  
  1601.                              Starting CONFIGURE
  1602.                              ------------------
  1603.  
  1604.   The first step is to issue this command;
  1605.  
  1606.     SS /C  <enter>
  1607.  
  1608.   The program will present the following menu.
  1609.                         
  1610.        
  1611.     # 1 -  REPORT  SKIPPED  DRIVES  - NO 
  1612.     # 2 -  SEARCH  MULTIPLE DRIVES  - YES 
  1613.     # 3 -  SUMMARY REPORT INCLUDED  - YES 
  1614.     # 4 -  VERIFY  COMMAND  ACTION  - YES 
  1615.     # 5 -  SEARCH  at  TURBO SPEED  - YES 
  1616.     # 6 -  PAUSE   if  SCREEN FULL  - YES
  1617.  
  1618.     # 7 -  STRICT  BEFORE/AFTER op  - YES
  1619.     # 8 -  STRICT  GREATER/LESS op  - YES
  1620.  
  1621.  
  1622.   The current status of each item is indicated by a YES or NO. To set any item 
  1623.   to your preference, simply hit the <key #> that corresponds to an item. To 
  1624.   set the  'REPORT SKIPPED DRIVES' item to 'YES', just hit the (1) key. If you 
  1625.   wish to reset that feature, hit the (1) key again.  The selections will 
  1626.   toggle between YES and NO each time you hit the corresponding key.
  1627.  
  1628.   When you have the items set to your preference, you hit the <enter> key to 
  1629.   accept the choices.  
  1630.  
  1631.   Next you are shown the following;
  1632.  
  1633.  
  1634.     LAST DRIVE LIST WAS:  CDEFG  
  1635.      
  1636.     ENTER the Drive LETTERS to SEARCH --> _
  1637.      
  1638.     (Or just <enter> to use current list)    
  1639.  
  1640.  
  1641.  
  1642.   Enter your Drive-list letters.  Be sure to enter them without spaces or 
  1643.   separators.  For example use (cde<enter>) instead of ( c d e <enter>).
  1644.  
  1645.  
  1646.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 23
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.   SUPER*SEARCH comes to you with a default Drive-list of (CDEFG). In most
  1656.   cases this gets everyone up and running for trial purposes.  I recommend 
  1657.   that you enter (your own Drive-list) to be sure all works properly on your 
  1658.   system.
  1659.  
  1660.   Next you are shown the following chart and text;
  1661.  
  1662.  
  1663.     0 1 2 3 4 5 6 7 8 9 : ; < = > ?   
  1664.     @ A B C D E F G H I J K L M N O   
  1665.     P Q R S T U V W X Y Z [ \ ] ^ _                                 
  1666.     ` a b c d e f g h i j k l m n o   
  1667.     p q r s t u v w x y z { | }    
  1668.             
  1669.     Using characters from the above chart;  
  1670.         
  1671.     Enter COLOR OFFSET for  FILENAMES  or <enter> to accept
  1672.  
  1673.  
  1674.   Each letter in the chart, will have a different foreground/background color 
  1675.   combination.  These colors are  relative  to your current foreground and 
  1676.   background screen colors.
  1677.  
  1678.   Choose the character that has your color preference and hit that key. Be
  1679.   alert to upper/lower case selections.  
  1680.  
  1681.   If you have a Monographic system, you'll see very little difference, 
  1682.   although some choices (may) appear brighter than others. In this case you 
  1683.   can just hit <0> for no color.  If you are satisfied with the current colors 
  1684.   and do not wish a change, just hit <enter>.
  1685.  
  1686.   Last you are shown the following;
  1687.  
  1688.  
  1689.     Enter COLOR OFFSET for  SUMMARY    or <enter> to accept
  1690.  
  1691.  
  1692.   The same rules apply as before. The Summary Report fields can be of a color 
  1693.   in the chart. Choose a character that has the color combo you want and hit 
  1694.   that same key. 
  1695.  
  1696.   If you wish no color be used, just hit <0>.  If you are satisfied with the 
  1697.   current colors, just hit <enter>.
  1698.   
  1699.   Note that the above words - SUMMARY and FILENAMES, appear in the (preset) 
  1700.   foreground/background colors which were chosen at the last Configuration 
  1701.   setup. 
  1702.  
  1703.   That's all there is to it. Your selections are fixed into the program.
  1704.   
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 24
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.   HELP SCREEN Features
  1722.   ====================
  1723.  
  1724.   Whenever you configure a copy of SUPER*SEARCH, you can check that the
  1725.   operation was successful by viewing (that copy's) HELP screen.  To view  
  1726.   HELP, just type the program name with no parameters.  Assuming that the 
  1727.   program is still named SS.EXE, you would enter the following to view  HELP ;
  1728.  
  1729.     SS <enter>
  1730.  
  1731.   the helpscreen appears as below;
  1732.  
  1733.  
  1734.   ----------------------------------------------------------------------------
  1735.  
  1736.    V1.4             SUPER*SEARCH      Copyright  1989, 1990   by  T. L. Price 
  1737.  
  1738.    USAGE     *  SS [ /Options <mm dd yy nnn> ]   [ Filespec ]   [ (TextWord) ]
  1739.                    [ 'Copy, Mov, Del <dest>' ]   [ }File,  }Device  or  }Prn ]
  1740.  
  1741.                    /T                    TODAY        system  date 
  1742.                    /S   nnn              SINCE        system  date - nnn days
  1743.                    /P   mm yy <mm yy>    PERIOD       date to date 
  1744.                    /B   mm dd yy         BEFORE       date.
  1745.                    /A   mm dd yy         AFTER        date.
  1746.                    /D   m? d? y?         DATE        (specific or wildcard)
  1747.  
  1748.                    /G   nnn              GREATER      than (bytes).
  1749.                    /L   nnn              LESS         than (bytes).
  1750.                    /E   nnn              EQUAL        to   (bytes)
  1751.  
  1752.                    /R /H /V              ATTRIBUTE    rd_only, hid, arc
  1753.                    /Q                    QUIET        batch file mode
  1754.                    /C                    CONFIGURE    CDEFG 
  1755.  
  1756.    COMMAND  VERIFY (*)        AUTOSCREEN PAUSE (-)        HI-SPEED SEARCH (*)
  1757.    SUMMARY  REPORT (*)        MULTI-DRV SEARCH (*)        SKIPPED DRV IND (-)   
  1758.  
  1759.   ----------------------------------------------------------------------------
  1760.  
  1761.  
  1762.  
  1763.   At the top, we have the USAGE line followed by various slash-type (/) 
  1764.   Options and Parameter info.
  1765.  
  1766.   When we look down to the (/C) CONFIGURE line, we see the DRIVE LIST. The 
  1767.   list uses slightly different colors so it is easy to identify. The list is a 
  1768.   series of capital letters - signifying which drives are searched in 
  1769.   MULTI-DRIVE mode.  There is room for 26 letters.
  1770.  
  1771.   At the bottom, is an area devoted to the display of the current action 
  1772.   Options. This is called the STATUS. Items such as Pause, Verify, Hi-Speed 
  1773.   Search, etc  are shown to be either enabled or disabled. The indication for 
  1774.   ENABLED is a (diamond symbol) on the CRT or a star (*), if output is 
  1775.   directed to a file or printer. The indication for NOT ENABLED is a (flashing 
  1776.  
  1777.  
  1778.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 25
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.   minus-sign) on the CRT - or a fixed dash, if output direction is used.
  1788.  
  1789.   Additionally, the colors you choose during the CONFIGURATION setup, are used 
  1790.   with two areas of the HELP screen. The USAGE lines are written using the 
  1791.   colors associated with the File NAME field.  The status lines use the colors 
  1792.   that are associated with the SUMMARY REPORT.
  1793.  
  1794.   At a glance, you can quickly learn about the programs' personality.  This is 
  1795.   especially useful if you decide to use multiple copies for different 
  1796.   applications.
  1797.  
  1798.  
  1799.  
  1800.   TRICKS and TRAPS of SUPER*SEARCH
  1801.   ================================
  1802.  
  1803.   SUPER*SEARCH is designed to make your file-search time productive.  There 
  1804.   are some (not so) obvious enhancements and tricks to getting maximum program 
  1805.   benefit. It is presumed that you are now familiar with the program and have 
  1806.   read the sections dealing with Commands and Options. 
  1807.      
  1808.  
  1809.   Shortcut Tricks
  1810.   --------------
  1811.   One feature you should know about is the programs ability to deal with 
  1812.   shortcut notation. The following list of filespecs will illustrate ways for 
  1813.   you to save keystrokes.  You may be surprised to learn that DOS supports 
  1814.   some of these conveniences directly.
  1815.  
  1816.   The format of this list is .....        (shortcut way == the old way).
  1817.   The (==)  means  (IS the SAME AS).
  1818.  
  1819.  
  1820.     Shortcut  Rule                           Comments
  1821.     -------------------------------------------------------------------
  1822.  
  1823.     (*)      ==    (*.*)                     All Names and Extensions.
  1824.   
  1825.     (.bat)   ==    (*.bat)                   search by file extension.
  1826.     (.exe)   ==    (*.exe)                   implied leading star.
  1827.  
  1828.     (.)      ==    (*.)                      search for Names with NO 
  1829.                                              extension, implied leading star.
  1830.  
  1831.     (text)   ==    (text.*)                  implied trailing dot-star.
  1832.     (abc*)   ==    (abc*.*)                     |             
  1833.     (*xyz)   ==    (*xyz.*)                     |             
  1834.     (*pat*)  ==    (*pat*.*)                 implied trailing dot-star.
  1835.  
  1836.     (\)      ==    (Drive:\*.*)              Root dir symbol (\) will give
  1837.                                              current logged drive starting at 
  1838.                                              root.
  1839.  
  1840.     (\subd)  ==    (Drive:\subd\*.*)         Root dir symbol (\) plus sub 
  1841.                                              dir. 
  1842.  
  1843.  
  1844.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 26
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.   TRAP! 
  1855.   =====
  1856.   You may think that you can get the current logged directory of another drive 
  1857.   by using the DOS notation of (Drive-letter + colon - IE [C:]).  The truth is 
  1858.   SUPER*SEARCH treats this notation as if you meant the entire drive. You must 
  1859.   enter a specific path in deference to searching an entire drive.   
  1860.  
  1861.  
  1862.  
  1863.   Command Tricks
  1864.   --------------
  1865.   Disk maintenance is a task that we all deal with from time to time. For 
  1866.   example, you may have certain files cropping up as a result of editor or
  1867.   word processor operation. These files may carry extensions of (.BAK). If you 
  1868.   are running out of space and don't feel you 'need' these files, its a snap 
  1869.   to hunt them down and either  MOVE  them to a holding area or to  DELETE  
  1870.   them.
  1871.  
  1872.   The command for such an operation might be;
  1873.  
  1874.     SS  .bak  'd' <enter>                    DELETE all (.BAK) files
  1875.  
  1876.   This would find (.BAK) files and allow you to eliminate them, one-by-one, 
  1877.   assuming VERIFY is ON. The first query from VERIFY will let you examine the 
  1878.   file Name and Command operation that is underway.  IF you are confident that 
  1879.   all is well, you may hit the (ALL) key to complete the operation in one 
  1880.   pass.  This would free you from verifying each file. 
  1881.  
  1882.   The MOVE version of the above, would probably include a destination 
  1883.   directory.  The command for that operation might be;
  1884.  
  1885.    SS  .bak  'm  d:\baksav'  <enter>         MOVE all (.BAK) files to the
  1886.                                              directory of BAKSAV in drive D:.
  1887.  
  1888.  
  1889.   Another application for Commands could be to back-up or save files that are 
  1890.   of some specific date, date range, or size.
  1891.  
  1892.   SUPER*SEARCH is no substitute for a good back-up program. However, it can 
  1893.   (selectively) COPY or MOVE critical files to a holding area (such as a 
  1894.   floppy) until a proper back-up operation can be performed.  For example;
  1895.  
  1896.     SS .doc  /a 9 9 90  'c a:\' <enter>      Find (.DOC) files dated AFTER
  1897.                                              Sept 9 1990 - COPY to  A:\ .
  1898.  
  1899.     SS   /g 1000  /t  'c a:\'   <enter>      Find files GREATER than 1000
  1900.                                              bytes - that bear TODAYS date.
  1901.                                              COPY to A:\ .
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 27
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.   STRICT versus RELAXED relation Tricks
  1921.   -------------------------------------
  1922.   When you view the HELP screen of SUPER*SEARCH, you may notice that certain 
  1923.   Option descriptions end in a period (.). These include the relational 
  1924.   Options of; 
  1925.  
  1926.          GREATER than size
  1927.          LESS    than size
  1928.  
  1929.          AFTER        date
  1930.          BEFORE       date
  1931.  
  1932.   The periods (at the end of the description statements in the HELP screen) 
  1933.   are a different type of STATUS indicator. Their presence indicates that the 
  1934.   operators act in the STRICT sense of their definition.  If no periods are 
  1935.   visible, then these specific Options are in a RELAXED mode.
  1936.  
  1937.   For example, if we are in the STRICT mode and using the (LESS than size) 
  1938.   Option with a parameter of 10 bytes, we should expect to see files that are 
  1939.   really LESS than 10 bytes - NOT INCLUDING 10 bytes. 
  1940.  
  1941.   On the other hand, if we are in the RELAXED mode with the above relation and 
  1942.   10 byte parameter, it IS possible to see files listed with LESS than 10 
  1943.   bytes - INCLUDING 10 bytes.
  1944.  
  1945.   Okay, so why confuse your life with yet another complexity. Well, the answer 
  1946.   is to make the program flexible enough to meet your needs in an intuitive 
  1947.   fashion.  That is - I am giving you a choice as to how you wish to 'think' 
  1948.   about using the relational Options.
  1949.  
  1950.   If you use the relational Options in their STRICT sense, it may be that you 
  1951.   will need to do some mental arithmetic to define your parameters prior to 
  1952.   issuing a search command line.  Doing mental arithmetic may NOT be to your 
  1953.   liking as the following example will illustrate.
  1954.  
  1955.   Suppose you want to find files dated (from) January 1, 1987 (to) May 5 of 
  1956.   the same year. You will need to use the relational DATE Options of BEFORE 
  1957.   and AFTER along with appropriate parameters. If you are in the STRICT mode 
  1958.   of operation, you'll find that you must calculate parameters that are 
  1959.   different from the above. If you don't do this mental calculation, you will 
  1960.   actually skip the starting day of January 1 and the ending day of May 5.  In 
  1961.   order to include these days in your search (IE using BEFORE and AFTER), you 
  1962.   must use December 31, 1986 and May 6, 1987 for the proper result.
  1963.  
  1964.   While the above calculations are easy enough, they present a distraction 
  1965.   that can affect productive use of valuable time.  To make things more 
  1966.   intuitive, you can RELAX the relation to include the parameter in the 
  1967.   search.
  1968.  
  1969.   The CONFIGURE Option offers you this choice in its opening menu. You can
  1970.   choose to separately select either the Date or Size relations (or both) to 
  1971.   be STRICT or RELAXED.  The program comes to you with the STRICT modes set to 
  1972.   ON.
  1973.  
  1974.  
  1975.  
  1976.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 28
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.   Try it both ways and choose the modes that suit you.
  1986.   
  1987.         
  1988.  
  1989.   Range Tricks with Relational Options
  1990.   ------------------------------------
  1991.   Hang on to your hats folks. This is rather involved, but I'll attempt to 
  1992.   explain it in a way that makes sense.  For the purposes of the following 
  1993.   text, we will assume STRICT relations hold true.          
  1994.  
  1995.   When we refer to a single-range operation in SUPER*SEARCH, we mean a (window
  1996.   or span) of Dates or Sizes used to qualify a search operation.
  1997.  
  1998.   A specification for a single-range (SIZE) window might be expressed as 
  1999.   GREATER than 100 bytes [ AND ]  LESS than 200 bytes.  Files larger than the 
  2000.   upper-limit or smaller then the lower-limit, will NOT be found in this 
  2001.   search specification.  Graphically, this single-range span could be drawn 
  2002.   like this;
  2003.  
  2004.  
  2005.           GREATER than Size   [AND]    LESS than Size
  2006.                    \                         /
  2007.                      \                     /
  2008.                  (100)|                   | (200)
  2009.    0 -------------------------------------------------------------->    
  2010.    bytes /////////////|                   |///////////////////   Gigabytes
  2011.    ///////////////////|   found  files    |/////////////////////////
  2012.    ///////////////////|<----------------->|/////////////////////////
  2013.                                           
  2014.  
  2015.   
  2016.   This relationship has a definite LOGICAL connotation - the logical operator 
  2017.   [AND]. This means that both conditions must be true to fall inside the range 
  2018.   window.  Stated another way, a file must be (both) GREATER than the 100 
  2019.   parameter [AND] LESS than the 200 parameter for a search 'hit'.
  2020.  
  2021.  
  2022.   Similar statements could be made for DATE ranges. A (single) DATE-range 
  2023.   would be AFTER (some earlier date) [AND]  BEFORE (some later DATE).  
  2024.   Graphically, a single Date-range would appear as;
  2025.  
  2026.  
  2027.             AFTER this date   [AND]    BEFORE this date
  2028.                    \                         /
  2029.                      \                     /
  2030.              (1-5-87) |                   | (12-25-91)
  2031.    1980 ----------------------------------------------------------->    
  2032.    ////////////////// |                   | /////////////// the future    
  2033.    ////////////////// |   found  files    | ////////////////////////
  2034.    ////////////////// |<----------------->| ///////////////////////
  2035.  
  2036.                           
  2037.  
  2038.   No doubt, you will usually search out files using single-range techniques. 
  2039.   However, you should know that SUPER*SEARCH will accurately search out files 
  2040.  
  2041.  
  2042.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 29
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.   using SPLIT-RANGES.  What is a split-range? It occurs when there are TWO 
  2052.   WINDOWS of values to search through instead of one.  
  2053.  
  2054.   An example of split range parameters might take the form;
  2055.  
  2056.       GREATER than a   (Larger   parameter = 200)   [ OR ]  <*****
  2057.       LESS    than a   (Smaller  parameter = 100)
  2058.  
  2059.  
  2060.   A graphical depiction of a SPLIT-RANGE (SIZE) span might be;
  2061.  
  2062.             LESS than Size    [OR]    GREATER than Size
  2063.                    \                         /
  2064.                      \                     /
  2065.                  (100)|                   | (200)
  2066.    0 -------------------------------------------------------------->    
  2067.    bytes              |///////////////////|                      Gigabytes
  2068.        found  files   |///////////////////|       found  files
  2069.    <----------------->|///////////////////|<----------------------->
  2070.  
  2071.   
  2072.                                           
  2073.  
  2074.   A graphical depiction of the SPLIT-RANGE  (DATE)  span  might be;
  2075.  
  2076.             BEFORE this Date   [OR]    AFTER this Date
  2077.                    \                         /
  2078.                      \                     /
  2079.               (1-9-82)|                   | (9-9-90)
  2080.    1980 ---------------------------------------------------TIME---->   
  2081.                       |///////////////////|                      
  2082.      found  files     |///////////////////|    found  files
  2083.    <----------------->|///////////////////|<----------------------->
  2084.  
  2085.                                           
  2086.  
  2087.  
  2088.   SUPER*SEARCH  recognizes these different range cases from the relationship 
  2089.   and mix of Option parameters.  You can freely mix SIZE  and/or  DATE  
  2090.   ranges.  The program knows which logical combinations of  AND / OR  are 
  2091.   required.  You need only decide what you wish to search for.
  2092.  
  2093.   One possible use for split-ranging is the (exclusion) of a span of dates or 
  2094.   sizes from a given search. For example, lets suppose you are searching for 
  2095.   all (.DOC) files that were (not) dated in 1988, but before and after that 
  2096.   year - are of vital interest.  A good command line to accomplish this would 
  2097.   be;
  2098.  
  2099.     SS .doc /b 1 1 88  /a 12 31 88 <enter>   Find files  BEFORE  Jan 1 1988
  2100.                                              OR  AFTER  Dec 31 1988 that have
  2101.                                              (.DOC) extension.
  2102.  
  2103.  
  2104.  
  2105.   Perhaps you seek files that are either LESS than 10 bytes (or) GREATER than 
  2106.  
  2107.  
  2108.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 30
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.   750,000 bytes.  The reasons for such a search would be localized to your 
  2118.   particular system, file environment, and needs. In any case, the command 
  2119.   line might take the form;
  2120.  
  2121.     SS /L 10  /g 750000   <enter>            Find files GREATER than 750,000
  2122.                                              bytes OR LESS than 10 bytes.
  2123.  
  2124.  
  2125.  
  2126.   Summary Report Trick 1
  2127.   ----------------------
  2128.   The Summary report has two STORAGE indicators called out as APPARENT and 
  2129.   TRUE. These readouts can provide you with information about waste in your 
  2130.   system. Since DOS allocates files on a cluster basis, no file can ever 
  2131.   allocate less than one cluster of storage.  Also, no two files can share the 
  2132.   same cluster. 
  2133.  
  2134.   If you agree with the above, the next consideration is how big is a cluster 
  2135.   and how many are needed to hold a file? The answer depends on your disk 
  2136.   (hard or floppy) and DOS version.  Generally, hard disk cluster size is 
  2137.   2,048 or 4,096 bytes.  Some older disk systems used clusters as large as 
  2138.   8,192 and more.   DOS allocates as many clusters as it needs to accommodate 
  2139.   the APPARENT size of any file in storage.
  2140.  
  2141.   Assuming a cluster size of 2,048 and a batch file whose APPARENT size is 54 
  2142.   bytes, how much space is WASTED?   The answer is (2048-54 = 1994).  That is 
  2143.   equivalent to 93 percent waste. The TRUE (allocated) size of the batch file 
  2144.   is one cluster. The reason is that one cluster is the smallest allocation 
  2145.   unit available.
  2146.  
  2147.   To see if (your) system has large amounts of waste, try the following 
  2148.   command line;
  2149.  
  2150.     SS /L 500  <enter>                       Find all files LESS than 500 
  2151.                                              bytes in size.
  2152.  
  2153.     
  2154.   Summary Report Trick 2
  2155.   ----------------------
  2156.   You can learn how many of any type file exists on your system by viewing the 
  2157.   POSSIBLE MATCH figure in the Summary. This value indicates how many files 
  2158.   were actually checked per the Filespec.
  2159.  
  2160.   If the Filespec was (*.*), such as in a lone TODAY Option, the total amount
  2161.   of files on your system would be indicated.  This presumes that your 
  2162.   Drive-list includes all drives (or partitions).
  2163.  
  2164.   If the Filespec was (*.BAK), then the total number of (.BAK) files would be
  2165.   indicated. 
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 31
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.   Comparing File-search utilities Trap
  2184.   ------------------------------------
  2185.   No doubt, some of you will compare SUPER*SEARCH to other file-finder 
  2186.   programs. I have learned that you must take certain steps to be sure you 
  2187.   don't fool yourself.
  2188.  
  2189.   The physical location of a program (on disk) can impact its loading time. 
  2190.   Since most file-search programs are of the (command line) variety, the time 
  2191.   to load the program accounts for some of its apparent execution time.
  2192.  
  2193.   Different areas of a hard disk exhibit different loading times. The closer 
  2194.   the file is to the start of the disk partition, the faster the access 
  2195.   (generally). The farther the file is from the start of the drive (or 
  2196.   partition), the longer the access. This has to do with disk head 
  2197.   positioning.
  2198.  
  2199.   With the above in mind, it is easy to incorrectly compare one program to 
  2200.   another. This is especially true when one program ends in (.COM) and the 
  2201.   other ends in (.EXE) - and a disk compression utility has just 'ordered' all 
  2202.   your disk files (by name and extension).
  2203.  
  2204.   To sidestep this problem, you need to create a ram disk. A ram disk is so
  2205.   much faster than a hard disk, physical file placement has little to do with 
  2206.   access time. Once you move the files to the ram disk, you'll find your 
  2207.   program comparisons are more repeatable and accurate.  
  2208.  
  2209.   Also, after getting both files in a ram disk, be sure to explicitly use the 
  2210.   ram drive LETTER with the program name. I use a ram disk as drive (G:). When 
  2211.   I compare SUPER*SEARCH to other utilities, I am careful to use (G:) in the 
  2212.   command line. For example;
  2213.  
  2214.     TIMER  G:SS.EXE  [filespec]  <enter>
  2215.    
  2216.   This guarantees that the copy of SS.EXE in the ram disk is used for the 
  2217.   timer run.  
  2218.  
  2219.   See your DOS manual about RAM disks and Config.sys .
  2220.  
  2221.  
  2222.   Multiple version Tricks
  2223.   -----------------------
  2224.   Because SUPER*SEARCH does NOT use DOS environment strings to control its 
  2225.   actions, it can be replicated and configured to serve you in various ways.
  2226.  
  2227.   Why would you bother? One reason is to make life easier. You now have at 
  2228.   least one copy of the program on your disk. As time goes by, you'll decide 
  2229.   to fine tune the CONFIGURATION to meet your needs. It may be that one day 
  2230.   you'll run into a situation where you are compelled to change the 
  2231.   configuration in a drastic sense, to solve some problem, or accomplish a 
  2232.   specific maintenance task. 
  2233.  
  2234.   When you encounter this situation, I recommend you copy the program to a new 
  2235.   NAME. Configure the copy to fulfill the new task requirements. At 40k 
  2236.   bytes or so per copy (TRUE allocation), you can afford to have two or more 
  2237.   versions resident at the same time.
  2238.  
  2239.  
  2240.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 32
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.   Here is a specific example. I want to have one version of SUPER*SEARCH that 
  2250.   will search all drives and include a Summary at completion. I need another 
  2251.   version that is set for Single-drive searches and has NO Summary. The first 
  2252.   version already exists on my system. Here is how to create the second.
  2253.  
  2254.   First, copy the program to a new name.
  2255.  
  2256.     Copy  SS.EXE  MYFIND.EXE  <enter>
  2257.  
  2258.   Next configure the new copy using the CONFIGURE Option.
  2259.  
  2260.     MYFIND  /C  <enter>
  2261.  
  2262.   Using the menu selections, set MYFIND to Single-drive-search and No Summary.
  2263.  
  2264.   Now there are two versions of SUPER*SEARCH, each with its own personality 
  2265.   and purpose. You can use different color sets to enhance recognizing which 
  2266.   is which.  
  2267.  
  2268.   When you view the HELP screen for MYFIND, you'll see that the status readout 
  2269.   reflects its CONFIGURATION. To get the HELP screen for the new version, you 
  2270.   would type;
  2271.  
  2272.   MYFIND <enter>
  2273.   
  2274.   
  2275.  
  2276.   More Filespec Tricks And Traps
  2277.   ------------------------------
  2278.   One major concern with any search (or directory) utility is its ability to 
  2279.   deliver flexible and fast Filespec performance. Filespecs are the primary 
  2280.   search criteria for file location. If a file-search utility is weak in this 
  2281.   area, it is weak in general.
  2282.  
  2283.   It is not obvious, but some file-search utilities cannot mix different
  2284.   wildcards in just any combination (including SUPER*SEARCH). This requires 
  2285.   additional program size, performance tradeoffs, and (if you're lucky) 
  2286.   additional documentation.  
  2287.  
  2288.   SUPER*SEARCH offers users flexible wildcard variations, including nearly any 
  2289.   mix of the (*) and the (?) wildcard. There are times when using (exotic) 
  2290.   Filespecs (with mixed wildcards) can zero in on exactly what you're 
  2291.   searching for. This equates to being able to find files in a minimum number 
  2292.   of search operations (IE less time wasted).
  2293.  
  2294.   But there are some unexpected traits associated with certain wildcards and 
  2295.   wildcards mixes that you should watch out for. They do not present any 
  2296.   barriers to the objective of finding a given file, but may give you cause 
  2297.   for concern.
  2298.  
  2299.   The best way to illustrate this is to show a series of example command 
  2300.   lines;
  2301.  
  2302.   
  2303.     SS  ?         <enter>         Files with single letter names
  2304.  
  2305.  
  2306.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 33
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.     SS  ??        <enter>         Files with  2  OR LESS letter names
  2316.  
  2317.     SS  ???       <enter>         Files with  3  OR LESS letter names
  2318.  
  2319.     SS  ??er      <enter>         Files that end in (ER) with EXACTLY 2 
  2320.                                   preceding letters!
  2321.  
  2322.     SS  er??      <enter>         Files that start in (ER) that end in
  2323.                                   2 OR LESS letter names.
  2324.  
  2325.  
  2326.   Okay, lets discuss this. When the (?) wildcard is used alone or at the end 
  2327.   of a Filespec (no star wildcards), the operation of the wildcard seems 
  2328.   somewhat relaxed.  This is why certain explanations say (2 or less) instead 
  2329.   of (exactly) the number of wildcards.  WHY is it this way?  I don't know - 
  2330.   but it IS how DOS performs and as such, SUPER*SEARCH emulates the DOS action 
  2331.   to be compatible. (If I get enough requests [read that as registrations], I 
  2332.   may change this in a future version).
  2333.  
  2334.   If you try using DIR commands with the above wildcard combinations, you'll 
  2335.   see that DOS does indeed act this way. Okay, lets carry things a little 
  2336.   further.
  2337.  
  2338.  
  2339.     SS  *ee?      <enter>         Files that have ANY starting pattern and
  2340.                                   have (EE) plus EXACTLY 1 additional letter.
  2341.  
  2342.     SS  *ee??     <enter>         Files that have ANY starting pattern and 
  2343.                                   have (EE) plus EXACTLY 2 additional letters.
  2344.  
  2345.  
  2346.   Now you're really confused, right?  Well, I don't blame you. 
  2347.   
  2348.   The catch with this apparent reversal of the above rules is that the 
  2349.   wildcard is EXTENDED. It is not available from DOS. DOS would respond to a 
  2350.   leading (*) with the (IGNORE ALL AFTER) operative. The result would be as 
  2351.   though you typed in (*.*).  A different subroutine is used to accomplish the 
  2352.   above wildcard operations and it is not so flexible as DOS.
  2353.  
  2354.  
  2355.   Here we go for some more;
  2356.  
  2357.     SS  ?ee*      <enter>         Files that have EXACTLY 1 starting letter
  2358.                                   and (EE) followed by anything (or nothing).
  2359.  
  2360.     SS  ??ee*     <enter>         Files that have EXACTLY 2 starting letters
  2361.                                   and (EE) followed by anything (or nothing).
  2362.  
  2363.  
  2364.   Looks like were getting onto solid ground  but, guess what?  DOS accepts the 
  2365.   above filespec and gets rigid about how many letters are leading. In this 
  2366.   case, the results via DOS are exactly the same.  
  2367.  
  2368.  
  2369.   The above text illustrates that mixing wildcards is certainly feasible and 
  2370.  
  2371.  
  2372.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 34
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.   definitely useful but not without a few snags. The easy way for you to track 
  2382.   down files is to use the MID-STRING or PATTERN-MATCH techniques in your 
  2383.   Filespecs. At the risk of repeating myself, here are some examples;
  2384.  
  2385.     SS  *123*     <enter>         Files with (123) in their name.
  2386.  
  2387.     SS  *op*      <enter>         Files with (OP)  in their name.
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.   TRAP**********************************************************************
  2395.  
  2396.   You can NOT do the following with the (*) wildcard;
  2397.  
  2398.     SS  com*nd    <enter>         ILLEGAL - treated as (COMND).
  2399.  
  2400.     SS  *co*mnd   <enter>         ILLEGAL - treated as (*COMND).
  2401.  
  2402.   **********************************************************************TRAP
  2403.  
  2404.   The (*) wildcard is either for the start or finish of a filespec. Don't get 
  2405.   caught in this trap.  It (is) possible to achieve such a wildcard function, 
  2406.   but it would be quite slow compared to the more conventional approaches.
  2407.   
  2408.    
  2409.   More examples of legal wildcard usage in SUPER*SEARCH are;
  2410.  
  2411.  
  2412.     SS  *e?r  <enter>             Files that END   with (E, any letter, R).
  2413.  
  2414.     SS  e?r*  <enter>             Files that START with (E, any letter, R).
  2415.  
  2416.     SS *e?r*  <enter>             Files with an INSTANCE of (E?R) pattern.
  2417.  
  2418.  
  2419.   While this section on wildcards can certainly seem confusing, the purpose 
  2420.   was to illustrate what you can and can not do. The irregularities will prop 
  2421.   ably not give you any trouble because the worst that can happen is that 
  2422.   you'll see more files listed than expected. You'll find that this is not a 
  2423.   hardship. 
  2424.  
  2425.   
  2426.  
  2427.   Directory Tricks with TURBO mode
  2428.   -------------------------------
  2429.   WARNING ***  The following is for advanced users. If you are new to 
  2430.   computers and/or DOS, skip this section. The author will not be responsible 
  2431.   for damage to data or media. See the disclaimer at the end of this manual!
  2432.  
  2433.   Not long ago, a user registered his copy of SUPER*SEARCH and added an 
  2434.   interesting request. Could the program be improved to ignore (certain) 
  2435.   directories in a searched drive? 
  2436.  
  2437.  
  2438.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 35
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.   At first, I thought that this was impossible. But, then the answer came. The 
  2448.   TURBO mode was a way to improve search speed, at the expense of ignoring 
  2449.   directories that had an EXTENSION added to their name.  If the user wished 
  2450.   to have the program ignore those directories, then all that was necessary 
  2451.   was to;
  2452.  
  2453.  
  2454.     1)   Enable the TURBO speed mode (ON by default).
  2455.  
  2456.     2)   Back up your hard disk to floppy or appropriate storage.
  2457.  
  2458.     3)   Make a new directory or Rename an existing directory with an 
  2459.          extension in its name.   
  2460.     
  2461.   If the the user wished to include these (extended) directories in a search, 
  2462.   at a later time, disabling the TURBO mode or renaming the directory would 
  2463.   return things to normal.
  2464.  
  2465.   Renaming directories (back to their non-extended name) is too awkward for an 
  2466.   occasional search. A better way would be to create another copy of 
  2467.   SUPER*SEARCH that was CONFIGURED to have the TURBO mode switched (OFF).
  2468.  
  2469.   This way, the user could run the appropriate program to search his or her
  2470.   system for either situation. The tradeoff would be the speed of the 
  2471.   non-TURBO search. However, this would be far faster than renaming one (or 
  2472.   more) directories.
  2473.  
  2474.   To rename a directory you need to find a directory renaming utility. They 
  2475.   are available through several sources, including most BBS systems. The one I 
  2476.   use (infrequently) is RENDIR, by a well known computing magazine. I believe 
  2477.   that there are high-level disk utilities that allow you to edit the name 
  2478.   directly, as well (for advanced users only).
  2479.  
  2480.   Your alternative, is to create a new directory with an (extended) name and
  2481.   then move the contents from the (non-extended) directory to the new 
  2482.   (extended) directory.
  2483.  
  2484.   For example, you may have an existing directory on drive (C:) named 
  2485.   (C:\SAVDOCS). Lets assume that you wish to NOT have SUPER*SEARCH locate 
  2486.   files in this directory BUT you do want the program to search the rest of 
  2487.   drive (C:).  Since you have the TURBO mode enabled (recommended), all you 
  2488.   need do the (C:SAVDOCS) NAME is add an extension. 
  2489.  
  2490.   If you do NOT have a renaming utility, you could try the following steps;
  2491.  
  2492.  
  2493.     1)  Make a new directory. The command is;
  2494.      
  2495.         MD SAVDOCS.DIR <enter>
  2496.  
  2497.     2)  Move the contents from the old directory to the new one. One way to do 
  2498.         this is to use the DOS COPY command, then go back and remove the old 
  2499.         files with DOS DELETE.
  2500.   
  2501.         An easier way is to use SUPER*SEARCH to do the file (moving) for you. 
  2502.  
  2503.  
  2504.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 36
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.     **  Remember - we are assuming that (C:SAVDOCS) has NO SUB-DIRECTORIES!  
  2514.         The command to move the files is;
  2515.  
  2516.         SS  c:\savdocs  'move c:\savdocs.dir'  <enter>
  2517.  
  2518.     3)  Now remove the old (C:SAVDOCS) directory.
  2519.   
  2520.         To accomplish that, you must be (above) the directory (in the 
  2521.         directory tree). Our example directory is subordinate to the root 
  2522.         directory of drive (C:).  Therefore, the commands are;
  2523.  
  2524.         CD ..         <enter>               (go up the directory tree)
  2525.         RD  SAVDOCS   <enter>               (remove the old directory)
  2526.  
  2527.  
  2528.   ***TRAP***
  2529.  
  2530.   Performing the above will leave your storage area in a rather untidy state.
  2531.   It is highly recommended that you double check that all files are moved. A 
  2532.   disk compression utility should be used to compact your disk and unfragment 
  2533.   any files! 
  2534.  
  2535.  
  2536.  
  2537.   Duplicate File elimination Trick
  2538.   --------------------------------
  2539.   SUPER*SEARCH is not intended as a duplicate file elimination utility. 
  2540.   However, it will easily allow you to perform such an operation - IF you know 
  2541.   the NAME or SIZE or DATE of the file. 
  2542.  
  2543.   For example, you may have multiple versions of the same utility stored in 
  2544.   different directories. To eliminate the duplicates, you would first locate 
  2545.   all of those files and compare them by DATE. The most recent dated file is 
  2546.   likely to be the one you wish to save. Next you would repeat the search 
  2547.   adding a DELETE Command - and eliminate all but one of these files.
  2548.  
  2549.   An example of the first search command line could be;
  2550.  
  2551.     SS  someutil.exe        <enter>
  2552.   
  2553.   If multiple versions of the file exist, they will be listed in different 
  2554.   directories. The second search operation would include a DELETE Command in 
  2555.   the command line. If VERIFY is ON (highly recommended!), you can eliminate 
  2556.   the dupes, one by one, and skip (NOT DELETE) the desired copy.
  2557.  
  2558.   An example of the second search command line could be;
  2559.  
  2560.     SS  someutil.exe  'del' <enter>
  2561.  
  2562.   At this point the VERIFY query will interact with you on a file-by-file 
  2563.   basis to completion.  
  2564.  
  2565.  
  2566.     
  2567.       
  2568.  
  2569.  
  2570.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 37
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.   
  2580.   Batch File Trick
  2581.   ----------------
  2582.   There is another /Option available to enhance batch file operation. That 
  2583.   Option is the QUIET mode otherwise known as /Q.
  2584.  
  2585.   It may be desirable to suppress SUPER*SEARCH screen output but to utilize
  2586.   its power, via a batch utility file.  To accomplish this, merely include the
  2587.   /Q option in the command line with your other search parameters.  The screen
  2588.   does advance two line feeds to indicate that the program did indeed operate.
  2589.  
  2590.   To make batch file operation more useful, SUPER*SEARCH returns (errorlevel)
  2591.   codes to indicate if files were found (based on search criteria). An 
  2592.   errorlevel of (1) indicates that files were found. An errorlevel of (0) 
  2593.   indicates that files were not found. This provides the user a means to 
  2594.   automate SUPER*SEARCH operations as desired. If you do not understand how to 
  2595.   use errorlevel codes with batch files, then refer to you DOS manual.
  2596.  
  2597.   The following text is source for a batch utility that you can try to confirm 
  2598.   proper operation on your system. You will need to create the file with an 
  2599.   editor and then run it as an executable file. This batch file is written for 
  2600.   DOS version (3.3).
  2601.  
  2602.  
  2603.   ---------------------------------------------------------------------------
  2604.  
  2605.   @Rem   Batch file to illustrate QUIET mode and ERRORLEVEL operation
  2606.   @Rem   with the SUPER*SEARCH program
  2607.  
  2608.   @Rem   We assume that SUPER*SEARCH is resident at the root of drive C:
  2609.  
  2610.   @echo off
  2611.  
  2612.   SS/q /a 10 9 90
  2613.  
  2614.   @if errorlevel 1 goto FOUNDEM
  2615.  
  2616.   @echo No files found after October 9, 1990
  2617.  
  2618.   goto alldone
  2619.  
  2620.  :foundem
  2621.  
  2622.   @echo Files dated after  October 9, 1990  were found by SUPER*SEARCH
  2623.  
  2624.  :alldone
  2625.  
  2626.   @echo off
  2627.  
  2628.   @Rem   End of Batch file test
  2629.  
  2630.   ---------------------------------------------------------------------------
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 38
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.   Sizing Directories and Drives Trick
  2648.   -----------------------------------
  2649.  
  2650.   You can use SUPER*SEARCH as a directory TREE sizing tool (similar to 
  2651.   TREECALC - another program by the author) by issuing a filespec that is only 
  2652.   a drive or a path. The program assumes a local filespec of (*.*) and then 
  2653.   'finds' all files in the specified directory (and all of its subdirectories) 
  2654.   or the entire specified drive.
  2655.                          
  2656.   The following examples illustrate;
  2657.  
  2658.     SS  c:\wp  <enter>                    show all files in drive C:\WP and 
  2659.                                           all subdirectories.  (*.*) implied.
  2660.   
  2661.  
  2662.  
  2663.   
  2664.   SUPER*SEARCH Specifications and limitations
  2665.   ===========================================
  2666.  
  2667.   The following specifications outline the abilities and limitations of the 
  2668.   SUPER*SEARCH file location program. 
  2669.  
  2670.  
  2671.   WILDCARDS:                   Support for regular and extended wildcards.
  2672.                                Usage of (*) at beginning, end, or both of 
  2673.                                filespec.  Flexible mixing of (*) and (?).  
  2674.   
  2675.   limitations;                 (*) may not be used mid-filespec.
  2676.  
  2677.                                
  2678.  
  2679.   FILESPEC:                    Any mix of numeric, alpha, and punctuation
  2680.                                characters less the exceptions noted below.
  2681.  
  2682.   limitations;                 The characters  ( ' /  and }  may not be used 
  2683.                                in the first letter position of any FILESPEC. 
  2684.                                The  /  character may not appear anywhere 
  2685.                                in a filespec.
  2686.  
  2687.                                Only one filespec per search is available.
  2688.                                If multiple filespecs are issued in a 
  2689.                                command line, the last filespec is used.
  2690.  
  2691.                                
  2692.  
  2693.   OPTIONS (search):            Search by Date, Size, Attribute and text Word.
  2694.  
  2695.   limitations;                 MONTH parameter must be in the range of 1 to 
  2696.                                12, corresponding to January thru December.
  2697.  
  2698.                                DAY parameter must be in range of 1 thru 31.
  2699.  
  2700.  
  2701.  
  2702.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 39
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.                                YEAR parameter must be in range of 80 thru 99.
  2712.  
  2713.                                SIZE parameter 2.147 Gigabytes max.
  2714.  
  2715.                                System ATTRIBUTE search not available.
  2716.  
  2717.                                2048 byte search depth (per file) maximum in 
  2718.                                TEXT WORD search.
  2719.  
  2720.                                Program does NOT conduct searches within 
  2721.                                compressed files such as ARC, PAK, ZIP, etc.
  2722.  
  2723.  
  2724.                                
  2725.  
  2726.   OPTIONS (Configure)          User may selectively turn ON or OFF action 
  2727.                                options of;
  2728.                                                          
  2729.                                File Command   VERIFY,
  2730.                                Screen full    PAUSE,
  2731.                                High Speed     TURBO, 
  2732.                                Report         SUMMARY,
  2733.                                Single drv or  MULTI,
  2734.                                Indicator drvs SKIPPED,
  2735.                                Relaxed or     STRICT   relational operators.
  2736.  
  2737.                                User may enter a custom drive list - up to
  2738.                                26 drives (A..Z)
  2739.  
  2740.                                User may select color offsets for File NAME 
  2741.                                and SUMMARY display fields.
  2742.  
  2743.  
  2744.                                
  2745.  
  2746.   OPTION (/Q)                  QUIET mode for batch processing. Errorlevel
  2747.                                returns 0 for search failure and 1 for search 
  2748.                                success. 
  2749.   
  2750.   limitation;                  sends two carriage-return line-feeds to the 
  2751.                                screen.
  2752.  
  2753.  
  2754.  
  2755.   
  2756.   COMMAND LINE                 Context sensitive help facility catches syntax 
  2757.                                and range errors. Options and Filespec may be 
  2758.                                stacked in any order. 
  2759.                                
  2760.   limitations;                 Only one filespec per search will be used. You 
  2761.                                may not repeat the same options with different 
  2762.                                parameters (reliably).  OUTPUT direction must 
  2763.                                be the last parameter in a command line.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.   SUPER*SEARCH V1.4  Manual  ________________________________________  Page 40
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.                                
  2778.  
  2779.   DISPLAY                      Program output is formatted for ergonomic
  2780.                                enhancement.  Meant for color systems but will 
  2781.                                operate in mono systems.  Output can be 
  2782.                                directed to printer or other device.
  2783.  
  2784.  
  2785.   limitations;                 Long file locations are truncated at far right
  2786.                                of screen.  
  2787.  
  2788.  
  2789.                                
  2790.  
  2791.  
  2792.   FILE COMMANDS                Built in (smart) Copy, Move, and Delete 
  2793.                                functions. VERIFY feature available for safe 
  2794.                                operation.
  2795.  
  2796.   limitations;                 Commands do NOT check for overflow on root 
  2797.                                directory (max number of entries) limits set by 
  2798.                                DOS.  VERIFY can be disabled.
  2799.  
  2800.                                DELETE will ignore files bearing Hidden, Read 
  2801.                                Only, and System attributes (any or all).
  2802.  
  2803.                                COPY works only on files - not with devices.
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.   DISCLAIMER of WARRANTEE and LIABILITY
  2810.   =====================================
  2811.  
  2812.   The  SUPER*SEARCH  program, its documentation, and last minute README 
  2813.   files are provided "AS IS", without warrantee of any kind, either express 
  2814.   or implied, including without limitation, fitness for a particular 
  2815.   purpose or performance.
  2816.  
  2817.   You are granted a one time 60 day LICENSE, to perform a TRIAL of the 
  2818.   program.  By using the program, or acting on the information included 
  2819.   herein, YOU EXPLICITLY AGREE TO ASSUME THE ENTIRE RISK, for any result, 
  2820.   performance, or lack of performance, including damage to data or 
  2821.   property.     
  2822.  
  2823.   Neither Thomas Price, his agents, nor any third parties shall be liable 
  2824.   to you, for any use of this program (including ANY INABILITY to use), for 
  2825.   its performance, for any incidental or consequential damages, or for any 
  2826.   claim by any other party.
  2827.  
  2828.   In any COUNTRY, STATE, COUNTY, PROVINCE, or AREA where the above 
  2829.   conditions are ILLEGAL, or don't apply, your LICENSE is specifically NOT 
  2830.   GRANTED.    
  2831.  
  2832.  
  2833.  
  2834.  
  2835.   SUPER*SEARCH V1.4 Manual ________________________________________ Page 41
  2836.  
  2837.