home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / UTILS / PS51.ZIP / PS.DOC < prev    next >
Text File  |  1992-05-04  |  76KB  |  1,637 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                    P S E A R C H
  9.  
  10.  
  11.  
  12.                              -------------------------
  13.                              Users Guide and Reference
  14.                              -------------------------
  15.  
  16.  
  17.  
  18.  
  19.                                    Version 5.1
  20.                                      May 1992
  21.  
  22.  
  23.  
  24.  
  25.                                           ┌─────────┐
  26.                                     ┌─────┴───┐     │              (tm)
  27.                                     │         │o    │──────────────────
  28.                                     │   ┌─────┴╨──┐ │  Association of
  29.                                     │   │         │─┘  Shareware
  30.                                     └───│    o    │    Professionals
  31.                                     ────│    ║    │────────────────────
  32.                                         └────╨────┘    * Member *
  33.  
  34.                                Patri-Soft
  35.  
  36.                           (714) 352-2820 (Voice)
  37.                           (714) 352-2825 (BBS)
  38.                           (714) 352-1527 (FAX)
  39.  
  40.               Copyright 1986, 1987, 1988, 1989, 1990, 1992 by Patri-Soft
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.      PSEARCH Users Guide/Reference                Copyright 1992 Patri-Soft
  48.      ----------------------------------------------------------------------
  49.  
  50.                                Table of Contents
  51.  
  52.  
  53.      Introduction. . . . . . . . . . . . . . . . . . . . . . . . .   1
  54.      Features. . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  55.      Patri-Soft in the Press . . . . . . . . . . . . . . . . . . .   3
  56.      Using PSEARCH . . . . . . . . . . . . . . . . . . . . . . . .   4
  57.         Using PSEARCH Menu Mode. . . . . . . . . . . . . . . . . .   4
  58.            Function Selection Menu . . . . . . . . . . . . . . . .   4
  59.            Text Search Entry Display . . . . . . . . . . . . . . .   6
  60.            File Name Search Entry Menu . . . . . . . . . . . . . .   7
  61.            Special Editing Functions . . . . . . . . . . . . . . .   8
  62.            Advanced Options Entry Menu . . . . . . . . . . . . . .  10
  63.            PSEARCH output data display . . . . . . . . . . . . . .  10
  64.            Scrollback. . . . . . . . . . . . . . . . . . . . . . .  11
  65.         PSEARCH Command Line Mode. . . . . . . . . . . . . . . . .  12
  66.            Command Parameters. . . . . . . . . . . . . . . . . . .  12
  67.         Setting Default parameters in the DOS Environment. . . . .  26
  68.      Screen Colors and Monitor Support . . . . . . . . . . . . . .  26
  69.      Pausing the Search. . . . . . . . . . . . . . . . . . . . . .  26
  70.      Maintenance History . . . . . . . . . . . . . . . . . . . . .  27
  71.      Registering PSEARCH and other Patri-Soft Utilities. . . . . .  31
  72.      Site Licenses . . . . . . . . . . . . . . . . . . . . . . . .  31
  73.      VISA/MasterCard Telephone Registration Orders . . . . . . . .  32
  74.      
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                                      i
  93.  
  94.  
  95.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  1
  96.      --------------------------------------------------------------------
  97.  
  98.      Introduction
  99.      ------------
  100.  
  101.      PSEARCH lets you easily locate lost or forgotten files on hard
  102.      disks or diskettes.  Since hard disk technology has made 70, 80,
  103.      150 megabyte, and larger hard disks commonplace, users keep more
  104.      information than ever stored in their PC systems.  It is not
  105.      uncommon for users to have over 2000 files on their hard disks.
  106.      This proliferation of files makes it very difficult to store files
  107.      with names and directory structures that can be easily remembered
  108.      and retrieved when files are later needed.
  109.  
  110.      When you need to find a file on your disk but do not know its
  111.      filename or even directory, you most always know something unique
  112.      about this file. If not, you would probably not be searching for
  113.      it.  This unique information might me a person's name, a product
  114.      name, a type of process, or even a location.  Whatever it is,
  115.      PSEARCH can take this information and use it to search all files on
  116.      the disk to identify one or more files that contain this unique
  117.      data.
  118.  
  119.      Since PSEARCH can reduce your search from a list of 2000 files to
  120.      just a few files, your job of locating a file becomes effortless.
  121.      Quick examination of a few files easily lets you know if the
  122.      desired file is on your disk.
  123.  
  124.      PSEARCH users have saved thousands of dollars in time searching for
  125.      files, and time that would have been used to recreate lost files.
  126.      PSEARCH becomes a invaluable tool for all hard disk users.
  127.  
  128.      PSEARCH goes farther than searching for data. Once files are found,
  129.      you can automatically invoke other DOS programs and utilities to
  130.      process them.  PSEARCH becomes a powerful driver for other programs.
  131.  
  132.      In addition to being flexible, PSEARCH is fast!  Our review of
  133.      available text search utilities showed PSEARCH to be the best
  134.      performer.  Our advanced search algorithm combined with
  135.      flexible selection and exclusion criteria insure PSEARCH can
  136.      find your files in the fastest possible time.
  137.  
  138.      PSEARCH has functions and features that make it useful in many
  139.      different situations.  After reviewing this documentation and use
  140.      PSEARCH, we are confident you will find a permanent place for it in
  141.      your arsenal of tools.
  142.  
  143.  
  144.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  2
  145.      --------------------------------------------------------------------
  146.  
  147.      Here are a list of some of the many possible uses for PSEARCH.
  148.  
  149.      **   List all files on a hard disk that match a wildcard
  150.           specification.
  151.  
  152.      **   Show the names of any files containing specified text
  153.  
  154.      **   Show text lines of any file containing a specified string.
  155.  
  156.      **   Scroll back and forward through search results                 |
  157.  
  158.      **   View text and WordPerfect files directly from scroll display   |
  159.  
  160.      **   Look for word "Mrs" in any file and preserve case in search.
  161.  
  162.      **   Find 123 files containing the word "BUDGET" and print their name.
  163.  
  164.      **   Compile all C programs that refer to the "RECDESC.H" include
  165.           file.
  166.  
  167.      **   Find a word processing document containing the name "Wiffle".
  168.  
  169.      **   Delete any *.DOC files containing "To: Mr. Johnson".
  170.  
  171.      **   Locate all readonly files existing on a disk.
  172.  
  173.      **   List all files updated today.
  174.  
  175.      **   Build a DOS command to archive manually selected files from one
  176.           or more directories.
  177.  
  178.      **   Search multiple drives attached to the system for text or a file
  179.           name
  180.  
  181.      **   Search for a file name even if it has been archived into .ZIP,
  182.           .ARC or .LZH formats.
  183.  
  184.      **   Limit text search to WORDS, PREFIXES, or SUFFIXES. This greatly
  185.           enhances the search by returning only the data you want.
  186.  
  187.      **   Exclude files from the search process to improve performance.
  188.  
  189.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  3
  190.      --------------------------------------------------------------------
  191.  
  192.      Patri-Soft in the press!
  193.      ------------------------
  194.  
  195.      "Fast and Safe File Copying --
  196.          DOS's COPY command is a sorry imitation of a real utility       |
  197.          and at times causes far more trouble than its worth.  How       |
  198.          many times have you copied a file only to find out the new      |
  199.          file you created has written over a file that has the same      |
  200.          name?                                                           |
  201.  
  202.          PCOPY won't let that happen.  It warns you when you are         |
  203.          about to overwrite and existing file and asks you whether       |
  204.          you want to rename the file, stop the operation, or go          |
  205.          ahead and overwrite the file.  That's just one of this          |
  206.          handy utility's many features."                                 |
  207.  
  208.                               PC Computing, July 1992                    |
  209.                               "Tame Your Hard Disk"                      |
  210.                               Preston Gralla                             |
  211.      ---------------------------------------------------------------
  212.       "PCOPY is an extremely effective and efficient utility for         |
  213.       copying and moving files.  It provides options that no other       |
  214.       utility offers.  It also makes copying, simple, fast, and          |
  215.       perhaps most importantly, safe."                                   |
  216.  
  217.                      Dr. File Finder's Guide to Shareware                |
  218.                             Mike Callahan and Nick Anis - 1990           |
  219.      ---------------------------------------------------------------
  220.       "PCOPY is a greatly enhanced version of the DOS COPY               |
  221.       command..."                                                        |
  222.  
  223.                      MS-DOS Utility Programs                             |
  224.                             Ronnie Richardson - 1989                     |
  225.      ---------------------------------------------------------------
  226.       "Patriquin offers his entire line of utilities for $45.  Since     |
  227.       we think some of the programs he's asking $15 for are worth        |
  228.       more, we highly recommend the package option.  Even if you         |
  229.       don't end up using all the utilities, you will receive a great     |
  230.       collection of programs for a great price,..."                      |
  231.  
  232.                      Public-Domain Software & Shareware                  |
  233.                            Rusel DeMaria and George R. Fontaine 1988     |
  234.      ---------------------------------------------------------------
  235.       "PCOPY a superior way to copy files..."                            |
  236.  
  237.                      Shareware Magazine - Dec 1990                       |
  238.      ---------------------------------------------------------------
  239.  
  240.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  4
  241.      --------------------------------------------------------------------
  242.  
  243.  
  244.      Using PSEARCH
  245.      -------------
  246.  
  247.      PSEARCH may be executed directly from the DOS prompt or using menus
  248.      that guide you through the process of entering search
  249.      specifications.  Both techniques use the same 'PS' command. PSEARCH
  250.      determines the difference in modes by the presence or absence of
  251.      command line parameters.  When no command parameters are used, menu
  252.      operation is selected.
  253.  
  254.  
  255.      Using PSEARCH Menu Mode
  256.      -----------------------
  257.  
  258.      To start PSEARCH using the menu mode, enter the PS command at the
  259.      DOS prompt and press the <Enter> key.  The following menu will
  260.      be displayed...
  261.  
  262.  
  263.      --------------------------------------------------------------------
  264.      PSEARCH - File Searcher                 Copyright 1992 by Patri-Soft
  265.                                                                                 
  266.                     F U N C T I O N   S E L E C T I O N                         
  267.                                                                                 
  268.             Select the PSEARCH activity you want to perform...                  
  269.                                                                                 
  270.                                                                                 
  271.                  Text Search.  Find Files Containing Text                       
  272.                  Name Search.  Find Files using name patterns
  273.                  View          Review previous search results            |
  274.                  Help                                                           
  275.                  Exit to DOS                                                    
  276.                                                                                 
  277.  
  278.      --------------------------------------------------------------------
  279.                              PSEARCH Main Menu
  280.  
  281.  
  282.      The PSEARCH menu provides entry to PSEARCH processing.  Menu items
  283.      may be selected by using an highlight bar positioned over the first
  284.      menu item when PSEARCH is started.  Use the cursor arrow keys to
  285.      move the the highlight bar to the function desired and press the
  286.      <Enter> key to start the action.  You may quickly select any item
  287.      by pressing the key relating to the first character of the menu
  288.      item.  For example, press <N> to start a file name search.
  289.  
  290.    
  291.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  5
  292.      --------------------------------------------------------------------
  293.  
  294.      Following is a description of each menu item:
  295.      Text Search.  Activates PSEARCH's text search facility.  You will
  296.                    be presented with a entry menu to allow you to enter
  297.                    specifications PSEARCH is to use to search for data.
  298.  
  299.                    Text Search is PSEARCH's ability to search within
  300.                    files to find specific text.  It allows you to
  301.                    automatically scan you systems disks to locate files
  302.                    containing specific data contents.  For example, you
  303.                    can find all files on the system that contain the
  304.                    name 'Jones'.
  305.  
  306.      Name Search.  Activates the Name search facility.  Name search
  307.                    allows you to use PSEARCH to locate files on your
  308.                    system by the contents of their file names.
  309.  
  310.                    The DIR command provied with DOS only allows you to
  311.                    locate files within any one single directory.  When
  312.                    you have many directories and maybe even multiple
  313.                    hard disks, it becomes impracticle to use the DIR
  314.                    command to locate a file when you do not know what
  315.                    directory it exists in.
  316.  
  317.                    PSEARCH name search can automatically search all
  318.                    directories and even all disk devices to find a
  319.                    specific or pattern file name.
  320.  
  321.      View          Search output from the previous execution of PSEARCH
  322.                    is saved in file PS.SBK.  You may review previous
  323.                    search results by selecting the View option from the
  324.                    menu or by specifying the /V command line option.
  325.  
  326.                    This options saves you time by preventing you from
  327.                    having to reexecute a search to see search results
  328.                    after exiting PSEARCH.
  329.  
  330.                    When viewing search results you may place the View
  331.                    scroll bar within the output for any filename and
  332.                    view that file contents.  Up to 1000 lines of output
  333.                    are displayed.  Press <Escape> to exit file viewers.
  334.  
  335.                    Other commands are available in the scroll back.      |
  336.                    Press F1 for a list.                                  |
  337.                                                                          |
  338.                      L  - Invoke either L.BAT or L.EXE, to List the file |
  339.                      E  - Invoke either E.EXE or E.BAT, to Edit the file |
  340.                      D  - Delete the file                                |
  341.                      F3 - Enter a DOS command                            |
  342.                                                                          |
  343.      Help          PSEARCH's command line help provides very complete
  344.                    help information on all of PSEARCH's facilities. The
  345.                    help is provided primarily for those that want to use
  346.                    PSEARCH's command line mode of operation but is
  347.                    useful for all to use as a quick reference of
  348.                    PSEARCH's abilities.
  349.  
  350.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  6
  351.      --------------------------------------------------------------------
  352.  
  353.                    PSEARCH help consists of several pages of scrollable
  354.                    data.  When you exit the help, you will be returned
  355.                    to PSEARCH's main menu.
  356.  
  357.      Exit to DOS.  You may exit PSEARCH menu mode by either selecting
  358.                    the Exit menu item or by simply pressing the <ESCAPE>
  359.                    key from menu mode.
  360.  
  361.                    Upon exiting, PSEARCH will display how long it has
  362.                    been active and provide a summary of its results.
  363.  
  364.      The Text Search Entry Display
  365.      -----------------------------
  366.  
  367.      The following display is shown as a result of selecting the Text
  368.      Search option from PSEARCH's main menu.  It allows you to enter
  369.      specifications indicating the data PSEARCH is to locate.
  370.  
  371.      --------------------------------------------------------------------
  372.      PSEARCH - File Searcher                 Copyright 1992 by Patri-Soft
  373.  
  374.                            Text Search Specification
  375.  
  376.       Path to Search: _______________________________________________
  377.  
  378.       Text(1): _____________________________________________
  379.       Text(2): _____________________________________________
  380.       Text(3): _____________________________________________
  381.       Text(4): _____________________________________________
  382.       Text(5): _____________________________________________
  383.  
  384.        __ Match All?   (Y=All Text must be found  N=Find any matches)
  385.        __ Search Directories  (blank=Current S=System(all)  P=Path only)
  386.        __ Exclude files and directories entered in PSEARCHT.EXC?
  387.        __ Case Sensitive Search? (Y=Match exact text   N=Ignore case)
  388.        __ Qualify (blank=none W=Find Word  P=Prefix S=Suffix)
  389.        __ Showing found text? (Y=ALL N=none F=First match R=Related Text)
  390.        __ Show linenumbers for found text? (Y/N)
  391.        __ Stop scrolling when display full (Y/N)
  392.        __ Pause on each found match?
  393.        _____    For multiple drive search drives to search
  394.        _____    If multiple text, text must within n characters
  395.  
  396.      Keys:  <F3> DOS      <F9> Advanced Options        <F10> Start Search
  397.      --------------------------------------------------------------------
  398.                             Text Search Entry Menu
  399.  
  400.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  7
  401.      --------------------------------------------------------------------
  402.                             
  403.      See the command parameter portion of this document for a complete
  404.      description of all the parameters you are allowed to specify on
  405.      this display.
  406.  
  407.      Once all data is entered, you may immediately start the search by
  408.      pressing the <F10> key, or may specify advanced search options by
  409.      pressing the <F9> key.  The advanced options entry menu allows
  410.      further specifications to be made.  You may use the <F3> key to
  411.      temporarily exit to a PSEARCH window to execute DOS commands. You
  412.      may enter any DOS command in this window.
  413.  
  414.      The F10 key may be pressed from any location on this display.  If
  415.      you use the <Enter> key to proceed through each item on the
  416.      display, pressing <Enter> on the last item will begin the search.
  417.  
  418.      All specifications on this display except for pathname and search
  419.      text are maintained in a special PSEARCH control file. This file
  420.      (PS.DAT) is created the first time you run PSEARCH and is
  421.      placed in the same directory as the PSEARCH program file (PS.EXE).
  422.      This control file allows PSEARCH to retain your search
  423.      specifications for the next time you use it.
  424.  
  425.  
  426.      The File Name Search Entry Display
  427.      ----------------------------------
  428.  
  429.      The File Name Search Display allows you to enter specifications
  430.      PSEARCH is to use while searching for files by name on your system.
  431.  
  432.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  8
  433.      --------------------------------------------------------------------
  434.  
  435.      --------------------------------------------------------------------
  436.      PSEARCH - File Searcher                 Copyright 1992 by Patri-Soft
  437.                                                                                 
  438.                          Find File Specification
  439.                                                                                 
  440.         Path to Search: ____________________________________________
  441.                                                                                 
  442.                                                                                 
  443.                                                                                 
  444.        __  Search Directories (blank=Current S=System(all) P=Path only)
  445.        __  Exclude files and directories entered in PSEARCHF.EXC?
  446.        __  Search Archived Files (ZIP/ARC/LZH)? (N=none A=Yes B=Both)
  447.        __  Stop scrolling when display full (Y/N)
  448.        __  Pause on each found match?
  449.        __  Flex Search:  =none  S=Sound like  V=NoVowels  C=CharsOnly
  450.  
  451.        _____     For multiple drive search, letter of drives
  452.  
  453.  
  454.  
  455.                                                          
  456.                                                                                 
  457.      Keys:  <F3> DOS       <F9> Advanced Options       <F10> Start Search
  458.      --------------------------------------------------------------------
  459.  
  460.  
  461.      This entry screen works like the Text Entry display discussed earlier.
  462.      See the command parameter descriptions for more information about the
  463.      parameters you may enter.
  464.  
  465.  
  466.      Special Editing Functions
  467.      -------------------------
  468.  
  469.      Special edit functions are provided to enhance your capability
  470.      to specify DOS pathname and text specifications.  These following
  471.      features are available on all specification entry screens.
  472.  
  473.         Field Edit  --  You are presented with pathname and text
  474.                         specifications from prior executions on the
  475.                         parameter input displays.  You may use the
  476.                         shown value by simply pressing <Enter>.
  477.  
  478.                         You may change the value by first pressing a
  479.                         field edit key such as left or right cursor
  480.                         arrow, <INS>, or <DEL>.  Then you may edit
  481.                         the field as desired.
  482.  
  483.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page  9
  484.      --------------------------------------------------------------------
  485.  
  486.                         Entering any other value causes the current
  487.                         field to disappear and to be replaced by the
  488.                         keyed in value.
  489.  
  490.         Restore Field   Press alt-X when you are editing a field to
  491.                         restore it to its original value.
  492.  
  493.         Lower Case      Press alt-L to convert all characters in the
  494.                         field to lower case.
  495.  
  496.         Upper Case      Press alt-U to convert all characters in the
  497.                         field to upper case.
  498.  
  499.         Captialize      Press alt-C to cause all words in the field to
  500.                         be capitalized and other characters to be changed
  501.                         to lower case.
  502.  
  503.         Reverse         Press alt-R to reverse the characters in the
  504.                         in the field (first=last and last=first).
  505.  
  506.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 10
  507.      --------------------------------------------------------------------
  508.  
  509.      Advanced Options Entry Display
  510.      ------------------------------
  511.  
  512.      The Advanced Options Entry Display allow specification of advanced
  513.      options to be used for both Text and File name searches.  These
  514.      options are not necessary for PSEARCH to function and may be
  515.      ignored if desired.
  516.  
  517.  
  518.      --------------------------------------------------------------------
  519.      PSEARCH - File Searcher                 Copyright 1992 by Patri-Soft
  520.                                                                                 
  521.                           Advanced Options Screen                               
  522.                                                                                 
  523.        __ Print and Display all results? (Y/N)
  524.        __ Log and Display all results? (Y/N)    Log file PSLOG.TXT
  525.        ____  Files Attributes U=Updated H=Hidden S=System R=Readonly
  526.  
  527.           For each matching file PSEARCH can generate and optionally
  528.           execute any desired command.  Specify the command below:
  529.  
  530.        __ Action?  blank=none  W=Write to PSCMDS.BAT file  X=Execute
  531.                                P=Execute command with pause after each
  532.  
  533.         Execute Command: _____________________________________________
  534.  
  535.           The following characters may be used in the command to
  536.           generate commands with the matching directory and filename.
  537.                &=path  #=Filename  !=File  @=/  ~=Archive name
  538.                For example, to copy all matching files to drive A:
  539.                    Command: COPY & A:
  540.  
  541.  
  542.       Keys:       <F3> DOS           <F10> Start Search
  543.      --------------------------------------------------------------------
  544.                       Advanced Options Entry Screen
  545.  
  546.      See subsequent sections in this document for more information about
  547.      the advanced specifications that may be entered on this display.
  548.      Once all specifications are entered you begin the search by
  549.      pressing the <F10> key on any field, or by pressing the <Enter> key
  550.      from the last entry field on the display.
  551.  
  552.      The PSEARCH Output Data Display
  553.      -------------------------------
  554.  
  555.      The following display is a sample of PSEARCH output as a result of
  556.      a TEXT Search request.
  557.  
  558.  
  559.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 11
  560.      --------------------------------------------------------------------
  561.  
  562.  
  563.      --------------------------------------------------------------------
  564.      PSEARCH - File Searcher                 Copyright 1992 by Patri-Soft
  565.      Searching *.* for (this)  Opt ==> SHOW MULT ANYCASE MORE
  566.      --------------------------------------------------------------------
  567.      Searching *.* files for string (this)
  568.  
  569.      ======> FINANC.LTX       3287  16FEB89  6:42p
  570.      I am unable to determine what happened to this specific order.
  571.      to me.  I may be having trouble with this new address.  I know
  572.      In any case, I have corrected the problem and hope this package
  573.      normally sent to users.  If this is
  574.  
  575.      ======> ENHANREQ.LTR     2733   1MAR89  6:04a
  576.             drives.  This invokes the no⌐window mode.
  577.  
  578.      ======> HUFFMAR          1658  10MAR89  7:35a
  579.             A copy of the agreement is supplied with this
  580.  
  581.      ======> PRINT.TXT        1104   4MAY89  7:47a
  582.             receive no royalties from this product but I have agreed
  583.  
  584.      ======> LTR.LTR          2821   9JUN89  9:54a
  585.             drives.  This invokes the no-window mode.
  586.  
  587.      ** More?  <Enter> for more, <C> for continuous, <ESC> terminate ***
  588.      --------------------------------------------------------------------
  589.      Path(#1) C:\WP                               27  FILE=  WILLAM.BRO
  590.      --------------------------------------------------------------------
  591.                          PSEARCH Output Display
  592.  
  593.  
  594.      The top and bottom portion of the output display are reserved for
  595.      statistical information to keep you aware of what PSEARCH is
  596.      searching during processing.  The center portion of the display
  597.      shows the data found that matches the search specifications.
  598.  
  599.      For each found text match, PSEARCH displays the file name and data
  600.      matching the search criteria.  The filename is shown on a line
  601.      before the matching text.  This line also shows the date and time
  602.      the file was last updated or created and the size of the file in
  603.      characters. If DOS attributes are present in the DOS directory
  604.      entry for the file, they are also shown.
  605.  
  606.      Scrollback and viewing search results                               |
  607.      -------------------------------------                               |
  608.  
  609.      Up to 500 lines displayed during a search are also saved in memory  |
  610.      for later viewing.  When more than 500 lines are generated, only the|
  611.      last 500 lines are maintained in the scroll back list.              |
  612.  
  613.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 12
  614.      --------------------------------------------------------------------
  615.  
  616.  
  617.      The scroll back list may be accessed at any time during PSEARCH     |
  618.      operation.  You may interrupt the search process and then press the |
  619.      Up Arrow key to access the list.  To continue the search, press the |
  620.      escape key to exit view processing.  At this point you can exit     |
  621.      PSEARCH by pressing escape again, or continue searching by pressing |
  622.      any other key.                                                      |
  623.                                                                          |
  624.      When in View scroll mode, use the PgUp, PgDn, Up Arrow, Down Arrow, |
  625.      End, and Home key to scroll through all search output.  You may also|
  626.      press <F3> at any time to execute a DOS command.  When the command  |
  627.      is complete, you may issue another command or return to viewing the |
  628.      search output.                                                      |
  629.                                                                          |
  630.      When searching is complete, PSEARCH automatically puts you in view  |
  631.      scrolling mode.  Pressing escape at this point will end the search  |
  632.      and return to DOS or the menu.                                      |
  633.  
  634.      PSEARCH Command Line Mode
  635.      -------------------------
  636.  
  637.      The following section describes the use PSEARCH using command
  638.      line specifications.  These specifications all you to enter
  639.      all PSEARCH options directly on the PSEARCH command when it is
  640.      entered to DOS.  Although more difficult to master, the command
  641.      line mode is the easiest and fastest to use once you learn how
  642.      to use PSEARCH.
  643.  
  644.  
  645.      Command Parameters
  646.      ------------------
  647.  
  648.      Command parameters control PSEARCH's may different features when it
  649.      is use in command line mode at the DOS prompt. They are easy to
  650.      understand and learn, and provide you need to quickly locate all
  651.      files. Remember that each parameter is summarized in the online
  652.      help display. Just type PS at the DOS promot.
  653.  
  654.  
  655.      COMMAND FORMAT:
  656.  
  657.      PS [fspec] /T:text /F /S /C /P /PR /PF /MO /O:nn/N:nn /NW /TA
  658.                 /X[F][P]:cmd /AT:c /FW /FP /FS /DR:xxx /SO /AR /AO
  659.  
  660.  
  661.      PS - PS is the name of the PSEARCH command.
  662.      PS actually refers to Patriquin's PSEARCH. Enter the command without
  663.      any parameters for menus and help.
  664.  
  665.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 13
  666.      --------------------------------------------------------------------
  667.                                        
  668.      [fspec]
  669.            Enter the DOS file specification for the directory and file
  670.            names to be searched. If no directory name is specified the
  671.            current directory will be searched. If the /S option is
  672.            specified, the directory name portion of this parameter is
  673.            not used.
  674.  
  675.            Like DOS, use the '*' to indicate the last part of a filename
  676.            or filename extension may be any set of characters.  Also
  677.            like DOS, use the '?' to indicate that any single position of
  678.            a filename may be any character.
  679.  
  680.            In addition to DOS, you may place an '*' anywhere in the
  681.            filename to indicate any set of characters may exist in this
  682.            point in the name.
  683.  
  684.  
  685.      SPECIAL FLEX FILENAME SEARCHING CONTROL CHARACTERS
  686.  
  687.            The filename specification may contain a full DOS pathname
  688.            including the standard DOS wildcard characters * and ?. In
  689.            addition the special characters '~', '!', or ';' may be
  690.            placed immediately before the filename to specify special
  691.            filename find criteria.
  692.  
  693.                 ~ SOUNDEX -- Select any filename that sounds like the
  694.                              specified name
  695.                      ~WORD would select:
  696.                             WORD WOOORD WRD WOOD WORLD
  697.  
  698.                 ; NOVOWEL -- Select equal filenames but ignore vowels
  699.                              AEIOU in name
  700.  
  701.                      !WOORD would select:
  702.                             WoRD WoooRD WieRD WRD
  703.  
  704.                 ! CHARS -- Select any filenames that contain the
  705.                            characters entered
  706.                      !WD would select:
  707.                             WorD.dat WilDone.dat lstWorD.x
  708.  
  709.  
  710.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 14
  711.      --------------------------------------------------------------------
  712.                             
  713.            Following are examples:
  714.  
  715.              1.    *.EXE
  716.              2.    TEST*.*
  717.              3.    *TEST*.*
  718.              4.    DO?FIX.*
  719.              5.    PC*XX.*
  720.              6.    C:\DOS\*.*
  721.              7.    \TEST\*.*
  722.              8.    !WD*.*
  723.              9.    ~WORD.*
  724.  
  725.      SPECIFY A LIST OF FILES TO BE SEARCHED
  726.  
  727.             As an alternative, a file containing a list of input files may
  728.             be supplied.  Create  a file containing lines  with a filename
  729.             or complete pathname on  each line.  Provide  this filename as
  730.             the source filename to PSEARCH and add an @ character before the
  731.             name.  The list of files will be processed as if they were all
  732.             specified on the input command line.
  733.  
  734.             For file list processing,  PSEARCH understands the output of the
  735.             DOS DIR command.   You may use the  DOS redirection feature to
  736.             direct DIR output  to a file, edit  the file to add  or remove
  737.             entries,  and  then  provide this  to  PSEARCH  as  input.   For
  738.             example:
  739.  
  740.             DIR \TURBOC\C\*.C > FILE.LST
  741.             PSEARCH @FILE.LST /T:TEXT
  742.  
  743.      /AO   Archive type files Only - If you have files on your system
  744.            that are compressed into archive files with DOS extension
  745.            names of .ZIP, .ARC, or .LZH, PSEARCH is to search only these
  746.            files. This parameter is only useful for file name searching.
  747.            PSEARCH does not decompress these file contents for text
  748.            search requests.
  749.  
  750.            When specified, this parameter specifies that all archive
  751.            files are to be internally searched for filenames compressed
  752.            in them that meed the specified file specification.
  753.  
  754.            Note, you do not specify .ARC, .ZIP, or .LZH in the PSEARCH
  755.            file specification.  PSEARCH will automatically find and
  756.            search these files.
  757.  
  758.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 15
  759.      --------------------------------------------------------------------
  760.  
  761.  
  762.      /AR   ARchive type files as well as normal files -  PSEARCH will
  763.            search both archive files and non-archive files for matching
  764.            filename specifications.  Use only for file name searches.
  765.            (See also the /AO command parameter).
  766.  
  767.  
  768.  
  769.      /AT:c ATtributes - Specifies that PSEARCH is to search for files
  770.            having one or more of the attributes specified by the /AT:
  771.            parameter.
  772.  
  773.                 U - Updated,the ARCHIVE bit is on to indicate the file
  774.                     has been updated since the last backup.
  775.  
  776.                 R - Readonly,Files marked with Readonly attribute.
  777.  
  778.                 H - Hidden,Files marked with Hidden attribute.
  779.  
  780.                 S - System, Files marked with System attribute.
  781.  
  782.            Use /AT:U to locate all files that have been updated since
  783.            your last backup was done.
  784.  
  785.            Use /AT:H to determine what hidden files exist on your
  786.            disks.
  787.  
  788.  
  789.      /C Case - Indicates that text search requests are to be case
  790.            sensitive.  That is, exact upper/lower case searching
  791.            will be done.
  792.  
  793.            Normally it is easier to let PSEARCH find text data
  794.            regardless of its case.  This allows you to be sure to find
  795.            any possible matches.
  796.  
  797.            Exact case searching is useful for those cases where you know
  798.            the text is specified in an exact way.  It potentially
  799.            reduces the number of false matches that may be encountered
  800.            during the search.
  801.  
  802.      /DR:  DRive list. If the drive is not specified in the main
  803.            pathname, PSEARCH will search the current disk device. /DR:
  804.            indicates one or more drives that the search is to be
  805.            performed on. The following example indicates the search is
  806.            to be done on drives C and D.
  807.  
  808.                /DR:CD
  809.      
  810.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 16
  811.      --------------------------------------------------------------------
  812.  
  813.            The drive list is especially useful for searching all drives
  814.            on a system containing multiple hard disks.  Specify this
  815.            parameter in the PSEARCH= environment variable to force it to
  816.            be in effect for all command line executions.
  817.  
  818.  
  819.  
  820.      /DS   Directory path search.  Normally PSEARCH will search only the
  821.            current directory or the entire disk of /S is also specified.
  822.            The /DS parameter indicates PSEARCH is to search the
  823.            specified or current directory and all of its subordinate
  824.            directories for files.
  825.  
  826.            This parameter is useful for those system that have well
  827.            structured hard disk directories.  For example, PSEARCH can
  828.            easily search all word processing directories if all these
  829.            directories are subordinate to a single high level directory
  830.            name.
  831.  
  832.            If you have a directory structure like the following...
  833.  
  834.                C:\                    Root directory
  835.                C:\WPSYS\              Word processing system files
  836.                C:\WP\                 Word processing data files
  837.                C:\WP\PLANNING\        Planning documents
  838.                C:\WP\MEMOS\           Memos
  839.                C:\WP\STANDARD\        Polocies and Procedures
  840.  
  841.            Use the following PSEARCH command to search for all documents
  842.            containing the text "emergency"...
  843.  
  844.                PS C:\WP\*.*/t:emergency/ds
  845.  
  846.            Only the word processing document files will be searched.
  847.            All other directories on your hard disk will be ignored.
  848.  
  849.      /EX   Exclude files.  Primarily intended for text search requests,
  850.            the exclude facility allows you to provide a list of pathname
  851.            and filename specifications that are to be excluded from
  852.            PSEARCH processing.  Since searching through data on your
  853.            hard disk requires extensive processing and disk read time,
  854.            excluding files from the process will save you time, and will
  855.            reduce the number of false matches displayed for your
  856.            requests.
  857.  
  858.            The most common files to exclude from text search processing
  859.            is product program and control files.  These files constitute
  860.            a large portion of your hard disk's used space and
  861.            unnecessarily lengthen the time it takes searches to locate
  862.            the desired data.
  863.  
  864.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 17
  865.      --------------------------------------------------------------------
  866.  
  867.            The exclude facility is implemented with two actions.  First,
  868.            you will need to create an exclude specification file and
  869.            place it in the same directory where PSEARCH is installed on
  870.            your hard disk.  This file will contain the names of all the
  871.            files and paths to be excluded.  You may specify DOS pattern
  872.            names to exclude groups of files with a single specification.
  873.  
  874.            Like DOS, use the '*' to indicate the last part of a filename
  875.            or filename extension may be any set of characters.  Also
  876.            like DOS, use the '?' to indicate that any single position of
  877.            a filename may be any character.
  878.  
  879.            In addition to DOS, two additional pattern features are
  880.            available.  You may place an '*' anywhere in the filename to
  881.            indicate any set of characters may exist in this point in the
  882.            name.  For pathnames, you may place an '**' at the end of a
  883.            directory path specification to indicate the specification
  884.            applies to the specified directory and all subordinate
  885.            directories.  Using '**', you can exclude an entire path with
  886.            a single specification.
  887.  
  888.            You must tell PSEARCH what you want selected for search, and
  889.            what you want excluded.  PSEARCH supports both of these, making
  890.            use of the SEL and EXC commands.  Placing a SEL in front of the
  891.            filename or pattern tells PSEARCH to select that file, while
  892.            putting an EXC tells PSEARCH to exclude it.  If nothing is
  893.            specified, PSEARCH assumes EXC.
  894.  
  895.  
  896.            Following are examples:
  897.  
  898.              1.    EXC *.EXE
  899.              2.    *.COM
  900.              3.    EXC TEST*.*
  901.              4.    EXC *TEST*.*
  902.              5.    EXC DO?FIX.*
  903.              6.    ESC PC*XX.*
  904.              7.    EXC C:\DOS\*.*
  905.              8.    EXC \TEST\*.*
  906.              9.    EXC D:\GAMES**\*.*
  907.              10    SEL TEST.XXX
  908.  
  909.            Explanations for the above examples:
  910.              1.  Excludes all filenames with the extension .EXE from
  911.                  processing.
  912.  
  913.              2.  Excludes all filenames ending with extension .COM.
  914.  
  915.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 18
  916.      --------------------------------------------------------------------
  917.  
  918.              3.  Excludes all filenames beginning with the letters
  919.                  "TEST" from processing.
  920.  
  921.              4.  Excludes all filenames having the characters "TEST"
  922.                  anywhere in the first portion of the filename.
  923.  
  924.              5.  Exclude files having 'DO' as the first 2 characters of
  925.                  the filename, and 'FIX' as the 4th, 5th, and 6th
  926.                  filename characters.  The 3rd character of the filename
  927.                  may be any character.
  928.  
  929.              6.  Exclude files having a name beginning with the 2
  930.                  characters PC and where the first portion of the
  931.                  filename ends with the characters 'XX'.  Any 0 to 4
  932.                  characters may exist between the 'PC' and 'XX' in the
  933.                  first portion of the filename.
  934.  
  935.              7.  Exclude all files from the DOS directory on drive C:.
  936.  
  937.              8.  Exclude all files from the TEST directory existing
  938.                  on any drive searched.
  939.  
  940.              9.  Exclude all files from the D:\GAMES\ directory and
  941.                  also exclude all files and directories subordinate
  942.                  to the GAMES directory.
  943.  
  944.              10. Even though all files containing the word TEST are
  945.                  excluded, using a SEL statment tells PSEARCH to search
  946.                  just that filename or pattern.
  947.  
  948.                 WARNING:  Do not combine SEL and EXC statements together.
  949.                 PSEARCH will find no matches if this is done.
  950.  
  951.            Exclude file names --
  952.  
  953.               Since you may want to exclude different files from
  954.               file find and text search requests, a different
  955.               exclude file name exists for each.
  956.  
  957.                  PSEARCHF.EXC  --  File Find exclude specifications
  958.                  PSEARCHT.EXC  --  Text Search exclude specifications
  959.  
  960.               These files may be created using most any word processor
  961.               or text editor.  If you have no word processor or editor
  962.               you may use the EDLIN text editor provided with your DOS
  963.               system.
  964.  
  965.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 19
  966.      --------------------------------------------------------------------
  967.  
  968.               The exclude files must exist in the same directory the
  969.               PS.EXE file is located on.  PS.EXE is the name of the
  970.               PSEARCH program file.
  971.  
  972.  
  973.  
  974.            Activating exclude --
  975.  
  976.               Exclude will only be functional when the /EX command
  977.               parameter is specified.  When /EX is specified, you must
  978.               have a valid exclude file.  PSEARCH will not continue
  979.               without one.  If you wish exclude to be active during all
  980.               executions, specify /EX as part of the PSEARCH= DOS
  981.               environment variable.  See later in the documentation for
  982.               a description of this feature.
  983.  
  984.  
  985.      /F    Find File in the current directory.  Normally PSEARCH will
  986.            search all directories to find a file.  Use the /F parameter
  987.            to limit PSEARCH to search only the specified or current
  988.            directory.
  989.  
  990.  
  991.      /FP   Find Prefix - (use with /T:) Indicates that matching text
  992.            must be at the end of an existing word.  Designed primarily
  993.            for word searches, find prefix qualifies the search to help
  994.            you find exactly the match you want.
  995.  
  996.  
  997.      /FS   Find Suffix - (use with /T:) Works like find prefix, except
  998.            finds the matching text only if it preceeds an existing word.
  999.  
  1000.      /FW   Find Word - (use with /T:) The text to be searched for is a
  1001.            word. Only select text that is a complete word. A word is
  1002.            defined as any string of characters and numbers that is not
  1003.            preceded or succeeded with other characters or numbers.
  1004.  
  1005.            In "This", "This" is a word. "is" is not a word.  A search
  1006.            like    PS *.*/t:is/fw   would show matches for is but will
  1007.            not match on the "is" characters in "this".
  1008.  
  1009.      /HA   High Ascii characters will be shown in text search lines.
  1010.            Normally these characters are not useful and occur often
  1011.            as code in .EXE files.  They are ignored by PSEARCH.  Use
  1012.            /HA to cause PSEARCH to format and display them when they
  1013.            occur in matching lines being displayed.  /HA can be used
  1014.            from the command line in menu usage for foreign customers.
  1015.  
  1016.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 20
  1017.      --------------------------------------------------------------------
  1018.  
  1019.  
  1020.      /L    Line numbers.  When you are searching DOS text files for
  1021.            specific text (/T: parm used), use the /L parameter when you
  1022.            want PSEARCH to determine and display the number of the line
  1023.            associated with the text displayed.
  1024.  
  1025.  
  1026.  
  1027.            DOS text files are those files that have a carriage return
  1028.            and line feed at the end of each line of text.  A good
  1029.            example of these is DOS batch command files (*.BAT).  Word
  1030.            processing files often do not use this format and so line
  1031.            number specifications are not often useful for them.
  1032.  
  1033.  
  1034.      /N:nnn Newdays - Indicates that only files created or updated
  1035.            within the last nnn days are to be selected for processing.
  1036.            /N:1 causes any files updated within the last day to be
  1037.            selected. To search for files updated on the current date,
  1038.            specify /N:0.
  1039.  
  1040.  
  1041.      /ND   No Data.  For text searches, PSEARCH normally displays the
  1042.            text data lines for matching data found in files searched.
  1043.            If you only need the filenames shown, use the /ND parameter
  1044.            to deactivate the text display.
  1045.  
  1046.  
  1047.      /NM   No Multiples.  For text search specifications, causes
  1048.            PSEARCH to only search for a single matching text
  1049.            in any file and displays only one match.  Other matches
  1050.            may exist in the file.
  1051.  
  1052.  
  1053.      /NO   No mOre - Normally PSEARCH will stop at the end of each full
  1054.            display of lines.  You may press <ESCAPE> to terminate
  1055.            processing, <C> to disable more and display without stopping
  1056.            again, or press any other key to display another page of the
  1057.            display and stop again.  /NO disables this feature.
  1058.  
  1059.      /NM   Use of the /NM parameter will shorten your display of
  1060.            output and may improve search performance by stopping
  1061.            the search of a file after a single match is shown.
  1062.  
  1063.  
  1064.      /NW   No Windows.  PSEARCH normally operates in full screen
  1065.            window mode.  To deactivate this feature and DISplay all
  1066.            output in normal DOS line mode specify this parameter.
  1067.  
  1068.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 21
  1069.      --------------------------------------------------------------------
  1070.  
  1071.            The /NW parameter causes PSEARCH to use BIOS type screen
  1072.            writes to display output to the display.  The /NW parameter
  1073.            may be useful when you have special devices or TSR's
  1074.            active that screen or capture output going through these
  1075.            interfaces.
  1076.  
  1077.      /NP   Suppress ALL PSEARCH output.
  1078.  
  1079.  
  1080.  
  1081.  
  1082.      /O:nnn Olddays - Indicates that only files older than nnn days are
  1083.            to be selected for processing. /O:365 will cause files over
  1084.            one year old to be selected.
  1085.  
  1086.  
  1087.      /P    Pause - Pause  PSEARCH will pause whenever a match of
  1088.            filename or text in a file is found. You may terminate the
  1089.            search or continue by pressing any key.
  1090.  
  1091.  
  1092.      /PA   Print Append.  Works exactly like the /PF command except      |
  1093.            print data is appended to the previous PSPRINT.DAT file       |
  1094.            instead of overlaying it.                                     |
  1095.  
  1096.  
  1097.      /PF   Print to File - If you want to direct print to an output
  1098.            file, enter /PR. The file PSPRINT.DAT will be created in the
  1099.            current directory.  The resulting file may be edited or
  1100.            viewed using your current word processor, text editor, or the
  1101.            DOS TYPE command.
  1102.  
  1103.  
  1104.      /PR   PRint - Causes all screen output to also be directed to the
  1105.            output printer device.  This allows you to have a printed
  1106.            record of PSEARCH results.
  1107.  
  1108.  
  1109.      /R:nnn  Near specification for multiple text searches.  You may use
  1110.            the /R parameter when you have also specified multiple /T:
  1111.            parameters to cause PSEARCH to search for multiple sets of
  1112.            text.  /R specifies a number of characters that may exist
  1113.            between the first characters of the text to be searched.  In
  1114.            other words, the text will only be considered a match if it
  1115.            is within n characters of all other text specified.
  1116.  
  1117.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 22
  1118.      --------------------------------------------------------------------
  1119.  
  1120.            Use the /R when you want to find values related to one
  1121.            another and know the values will exist within close proximity
  1122.            of each other in the file.  The following example will search
  1123.            files for the name 'Jones' and will identify a letter to this
  1124.            person by indicating the search is only to search for the
  1125.            name 'jones' when it also exists near the letter salutation
  1126.            'Dear'.  The /R:50 value indicates the two values must be
  1127.            within 50 characters of each other in the file.
  1128.  
  1129.                 PS *.*/t:jones/t:near/r:50/ta
  1130.  
  1131.  
  1132.      /RT   Related text.  During text searches /RT will cause PSEARCH
  1133.            to attempt to display up to 10 lines of text related to the
  1134.            matching text being shown.  In many cases, less than 10
  1135.            lines of text may be shown when PSEARCH detects unprintable
  1136.            data or changes in paragraph structure.
  1137.  
  1138.            When /RT is specified, each display of matched text will be
  1139.            separated by horizontal bar lines to help you better see the
  1140.            groups of text being displayed.
  1141.  
  1142.  
  1143.      /S    System - Indicates that all directories on all hard disk
  1144.            drives are to be searched.  If a directory or drive is
  1145.            specified as part of the pathname, only it will be searched.
  1146.  
  1147.  
  1148.      /SO   Turns the PSEARCH signal sounds off.
  1149.  
  1150.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 23
  1151.      --------------------------------------------------------------------
  1152.  
  1153.  
  1154.      /T:text to be searched
  1155.            Text - Specifies the text to be found for text search
  1156.            requests. The text string may contain any characters. A
  1157.            terminating command line or the following slash character
  1158.            will signal the end of the text to be searched. If this is
  1159.            the last parameter on the command any trailing spaces will
  1160.            not be included in the search. To include trailing spaces,
  1161.            terminate the string with an ending slash character.
  1162.  
  1163.            Text may be specified in upper or lower case. Unless the /C
  1164.            parameter is specified to force exact text matches, the
  1165.            search will be made for any match regardless of case.
  1166.  
  1167.            Strings may also be single or double quoted. This allows for
  1168.            special characters to be included in the search string such
  1169.            as / characters.
  1170.  
  1171.            Examples:
  1172.  
  1173.             /T:BUDGET /T:Budget /T:Mr.  Jones/
  1174.             /T:"01/01/88"
  1175.  
  1176.            Note, to include a trailing space as part of search text, you
  1177.            must follow search text by another / command parameter. For
  1178.            example:
  1179.  
  1180.             PS *.C/T: SMITH /TA
  1181.  
  1182.  
  1183.            Up to five (5) /T: parameter specifications may be included
  1184.            for text search requests.  This allows PSEARCH to search for
  1185.            five different texts on a single search of a disk or
  1186.            directory. When multiple text is specified, consider the use
  1187.            of the /TA parameter to force PSEARCH to find all text in a
  1188.            single file before considering the file a match.
  1189.  
  1190.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 24
  1191.      --------------------------------------------------------------------
  1192.  
  1193.            To facilitate use in .BAT files, the /T: parameter may be     |
  1194.            specified without any search text.  In this case it will be   |
  1195.            ignored.  This allows batch file substitution to not fill     |
  1196.            in text words.  Note, the first /T: parameter must contain    |
  1197.            a valid search string.  The following is a valid command:     |
  1198.                                                                          |
  1199.                    Batch file command in FINDT.BAT:                      |
  1200.                         PS *.*/T:%1/T:%2/T:%3/T:%4/T:%5                  |
  1201.                                                                          |
  1202.                    Command entered:                                      |
  1203.                         FINDT JONES FRED                                 |
  1204.                                                                          |
  1205.                    Command generated:                                    |
  1206.                         PSEARCH /T:JONES/T:FRED/T:/T:/T:                 |
  1207.  
  1208.            The /T: parameter serves the purpose of indicating to PSEARCH
  1209.            of the search is to be for text in a file or for file names.
  1210.            Any command line execution of PSEARCH without the /T:
  1211.            parameter will cause PSEARCH to assume the request is to
  1212.            locate files by name only.
  1213.  
  1214.  
  1215.      /TA   Text 'AND'.  Used for mutiple text searches.  Indicates
  1216.            that all text must be found in the file for a PSEARCH
  1217.            to display a match.  Without /TA specified, any matching
  1218.            text will be displayed.
  1219.  
  1220.  
  1221.      /V    Immediate view of previous search output.  When /V is         |
  1222.            specified, PSEARCH will immediately display a scrollable      |
  1223.            list of the results of output from a previous PSEARCH         |
  1224.            command.  When View is exited, control will be returned to    |
  1225.            DOS.  Use the following command to start View:                |
  1226.                               PS /V                                      |
  1227.  
  1228.  
  1229.      /X:xxx eXecute - Build and execute a DOS command whenever a
  1230.            filename match or a text match is found. xxx is the DOS
  1231.            command to be executed.
  1232.  
  1233.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 25
  1234.      --------------------------------------------------------------------
  1235.  
  1236.            The command may either be a standard DOS command or the name
  1237.            of a DOS batch command file. The command will be executed
  1238.            with a second copy of COMMAND.COM. The command data may
  1239.            contain the following special characters to allow for
  1240.            substitution values.
  1241.  
  1242.               # - Always replaced with the selected filename
  1243.  
  1244.               & - Always replaced with the selected path/filename
  1245.  
  1246.               ! - Always replaced with the filename without extension
  1247.  
  1248.               @ - Replaced with a slash to allow for command parameters
  1249.                   to be specified in executed commands.
  1250.  
  1251.  
  1252.            Examples:
  1253.  
  1254.               /X:ERASE &To delete selected files
  1255.               /X:ARC A OLD123.ARC # To use ARC utility to archive
  1256.                                     file
  1257.               /X:TYPE & To type the file
  1258.               /X:LOTUS Start 123 for the file
  1259.  
  1260.  
  1261.      /XF:xxx eXecute File - Works like /X except that the command is not
  1262.            executed, it is generated and placed in a DOS batch command
  1263.            file named PSCMDS.BAT in the current directory. This file may
  1264.            be edited before it is executed.
  1265.  
  1266.  
  1267.      /XP:xxx eXecute with Pause - Functions in the same way as the /X
  1268.            parameter except that you are asked to indicate if the
  1269.            command is to be executed for each selected file.
  1270.  
  1271.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 26
  1272.      --------------------------------------------------------------------
  1273.  
  1274.      Specification of default parameters
  1275.      -----------------------------------
  1276.  
  1277.      Default parameters are parameters that do not need to be specified
  1278.      each time PSEARCH is started. Any PSEARCH parameter may be
  1279.      specified as a default parameter.
  1280.  
  1281.      Use the DOS SET command to specify the parameter name and contents
  1282.      to be used by PSEARCH each time it is started. The following
  1283.      example indicates the /EX exclude parameter specification is to be
  1284.      automatically provided to PSEARCH each time it is used in the
  1285.      command mode.
  1286.  
  1287.        SET PSEARCH=/D/M
  1288.  
  1289.      Once this DOS command is issued, each subsequent use of PSEARCH
  1290.      will operate as if these parameters have been specified on the
  1291.      command line. The SET command is most commonly placed in the
  1292.      AUTOEXEC.BAT file so it may be in effect every time your machine is
  1293.      started.
  1294.  
  1295.      Screen colors and monitor support
  1296.      ---------------------------------
  1297.  
  1298.      PSEARCH checks the DOS equipment flags to determine what type of
  1299.      monitor you have on your system. This is usually always correct
  1300.      except for one specific information. For those users running a
  1301.      composite monitor with a color graphics card, the screens may not
  1302.      be displayed correctly. If this occurs, use the DOS MODE command to
  1303.      set your environment to black and white. This can be done at system
  1304.      startup or just before starting PSEARCH. Beware that some
  1305.      applications incorrectly reset these indicators and they may need
  1306.      to be reset before again running PSEARCH. Following is an example,
  1307.      see the DOS reference for more information about setting the
  1308.      monitor with the MODE command.
  1309.  
  1310.         DOS MODE command example ===>  MODE BW80
  1311.  
  1312.  
  1313.      Pausing the Search
  1314.      ------------------
  1315.  
  1316.      Even if the Pause parameter is not specified, you may pause the
  1317.      search at any time by pressing any keyboard key. At the end of the
  1318.      next process PSEARCH will pause. You will then have the opportunity
  1319.      to continue processing, use a function key, or exit from PSEARCH.
  1320.  
  1321.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 27
  1322.      --------------------------------------------------------------------
  1323.                                                                          
  1324.  
  1325.      Program Maintenance History
  1326.      ---------------------------
  1327.  
  1328.      There is an ongoing commitment to improve PSEARCH as long as there
  1329.      is expressed need by PSEARCH users. I do respond to your requests.
  1330.      The enhancements below reflect both user requests and my own ideas.
  1331.      Please let me know of your needs, maybe they can appear on this
  1332.      list in the future.
  1333.  
  1334.      ------------------------------------------------------------------
  1335.  
  1336.      Version 1.0      March 1, 1986
  1337.           --  PSEARCH Version 1.0 was released in March 1st, 1986
  1338.  
  1339.  
  1340.  
  1341.      Version 2.0      April 8, 1986
  1342.           PSEARCH Version 2.0 was released April 8th, 1986. It
  1343.               upgraded version 1 with the following new features.
  1344.  
  1345.           -- Ability to search in .ARC files for filenames /AR /AO
  1346.           -- Find text by WORD, PREFIX, or SUFFIX /FW /FP /FS
  1347.           -- Returns back to menus after search is complete
  1348.           -- Extract data to file implemented
  1349.           -- Fix to show found text un upper/lower case
  1350.           -- /SO to turn sound off
  1351.           -- Ability to exclude .COM and .EXE files from search
  1352.           -- Ability to search all drives attached to system /DR:abc
  1353.  
  1354.      Version 3.0      September 7, 1986
  1355.           PSEARCH Version 3.0 was released Sept. 7th, 1986. It upgraded
  1356.           version 2 with the following new features.
  1357.  
  1358.           -- Sound alike and other new filespec wildcards (! ; ~).
  1359.           -- More menu options on the Peak menu.
  1360.           -- Correction to retrieve proper environment string to be used
  1361.              when executing DOS commands.
  1362.  
  1363.      Version 3.3      July 5, 1987
  1364.           -- Change registration so there is no longer a need to have
  1365.              the PSEARCH.REG file exist in the root directory.
  1366.  
  1367.           -- Text searches will not attempt to search .ARC files. Since
  1368.              these files are compressed it makes no sense to search them
  1369.              for text.
  1370.  
  1371.           -- Use environment field PS= to specify default command
  1372.              parameters.
  1373.  
  1374.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 28
  1375.      --------------------------------------------------------------------
  1376.  
  1377.      Version 3.4      September 16, 1987
  1378.  
  1379.           -- Ignore ~ ! and ; filename search characters unless they are
  1380.              in the first position of the filename. Previous versions
  1381.              file searches would fail if these characters were found in
  1382.              any position but the first.
  1383.  
  1384.           -- Correct filename matching. If file XXX would not be found
  1385.              if pattern name of XXX.* was specified.
  1386.  
  1387.           -- When print option was used with menus, when processing
  1388.              completed, menu text was printed to the printer. Corrected.
  1389.  
  1390.  
  1391.      Version 3.8      March 1, 1988
  1392.  
  1393.           -- Add ability to accept " or ' quoted strings in text search
  1394.              input command data. This is for the /T: parameter only.
  1395.  
  1396.  
  1397.  
  1398.      Version 4.0      February 22,1990
  1399.  
  1400.           This version is essentially a rewrite of the original PSEARCH
  1401.           facility.  All the changes are too numerous to mention.
  1402.           Following is a list of the most significant changes.
  1403.  
  1404.           Enhancements...
  1405.           -- Add ability to search up to 5 text strings
  1406.           -- AND/OR capability on text strings
  1407.           -- New exclude file allows user to specify file names
  1408.           -- New menu structure
  1409.           -- Near parameter to force multiple text matches to be within
  1410.              n characters of each other.
  1411.           -- /NW implements no window mode for those that need or prefer
  1412.              DOS style displays.
  1413.           -- /DS parameter allows a single directory path including all
  1414.              subordinate directories to be searched.
  1415.           -- The limit of the number of directories that can be searched
  1416.              greatly enhanced.  The maximum number of directories is
  1417.              related to the amount of free memory available to PSEARCH.
  1418.  
  1419.           Items removed...
  1420.           -- The Peak feature has been removed.
  1421.           -- The 5 text strings replaces the ability to specify a ?
  1422.              in the text search string.
  1423.           -- The exclude file replaces the /SK command to skip
  1424.              .COM and .EXE files.
  1425.  
  1426.      PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 29
  1427.      --------------------------------------------------------------------
  1428.      Version 4.1      February 26, 1990
  1429.           -- System lockup during speaker beeps.  Also improper beeps.
  1430.           -- Set sounds off as default
  1431.           -- Set pause at full screen (more) as default in command mode
  1432.  
  1433.      Version 4.2      March 9, 1990
  1434.           -- Added /RT parm to show related text
  1435.           -- Added field edit capabilities.
  1436.           -- Removed more line from display after user pressed a key
  1437.           -- Replaced /MO with /NO.  More was made default.
  1438.  
  1439.      Version 4.3      May 4, 1990
  1440.           -- Corrected errors encountered when processing .ZIP files
  1441.              containing directory names as well as filenames.
  1442.           -- Corrected problem where PSEARCH ignored the drive
  1443.              specification for the path to be searched.
  1444.           -- Added directory name to filename display on search display
  1445.           -- Added a screen of condensed help.
  1446.           -- Improved screen I/O performance
  1447.           -- Removed requirement to place quotes around text to be
  1448.              searched for in command line.  You may now search for
  1449.              data containing spaces.
  1450.                  PS *.TXT/T:Joe Doe
  1451.  
  1452.  
  1453.           -- File find now searches all hard disk drives unless a
  1454.              specific drive is specified.
  1455.           -- /S parameter causes all hard disk drives to be scanned
  1456.              unless a specific drive is specified in the supplied
  1457.              pathname.
  1458.  
  1459.      Version 4.4a     July 11, 1990
  1460.           -- When PS *.exe/DS used.  The same directory was searched
  1461.              3 times.  This only happened when directory had no
  1462.              subdirectories.  PS was fixed to scan the directory once.
  1463.           -- For network operation  -- added auto skipping of any files
  1464.              DOS denied access to.  A message is printed for each file
  1465.              that is bypassed.
  1466.           -- Detect bad exclude file specifications and stop processing.
  1467.              Processing used to continue but not select any files.
  1468.           -- PSEARCH was searching all directories for a file even when
  1469.              a specific pathname was specified.  The search is now
  1470.              limited to just the specified pathname.
  1471.           -- Support multiple drive parameter (/DR:) when directory name
  1472.              specified.  Allows multiple drives to be searched for a
  1473.              single directory name.
  1474.           -- PS *.* /AT:u stopped displaying output when readonly,
  1475.              hidden, system, updated file displayed.
  1476.           -- Added [=blank and ]=\ to /X: command substitution
  1477.  
  1478.         PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 30
  1479.         --------------------------------------------------------------------
  1480.      Version 4.4c  December 17, 1990
  1481.           -- Added capability to specify a list of files to be searched
  1482.              on the command line using the "@" symbol.
  1483.           -- Added the /NP (No Print) parameter
  1484.           -- Enhanced the .EXC file to be able to process SELect and EXClude
  1485.              statements.
  1486.      Version 4.4D
  1487.           -- Fixed problem with registration info not displayed.
  1488.      Version 4.4E
  1489.           -- When PSEARCH.DAT found during file search IN ARCHIVES,
  1490.              program locked up.
  1491.           -- /X: parm did not work in /NW mode.  DOS returned Bad command
  1492.              or filename.
  1493.           -- A couple little comsmetics.
  1494.           -- If a corrupted .ZIP file was encounterd, PS crashed.  Now skips
  1495.              the file.
  1496.  
  1497.      Version 5.0
  1498.           -- Added /PA to append to the PSPRINT.DAT
  1499.           -- Added scroll back feature
  1500.           -- Added View feature to menu.  View prev scroll back
  1501.           -- Added text and WordPerfect file viewers.  Press enter
  1502.              when scroll bar is within a file on the scroll display.
  1503.           -- Added evaluation day message pregmsg() in pmregis.c
  1504.           -- Allow empty search strings for batch file use
  1505.                     Can have command PS /T:word/T:/T:
  1506.           -- \ characters was not considered printable. Added \\.
  1507.           -- Change PSEARCH.DAT to PS.DAT
  1508.           -- Default to "more" off in menus. Due to scroll back option
  1509.           -- Added /HA parameter to display hi-ascii chars
  1510.           -- Directories now searched in alphabetical order
  1511.           -- You may now specify incomplete pathnames such as C\*.*
  1512.              It is assumed C is a directory subordinate to the current
  1513.              directory.
  1514.  
  1515.      Version 5.1
  1516.  
  1517.           -- When using the /R parameter, PSEARCH will only display the
  1518.              parts of the file that actually matches, and not the entire
  1519.              file.
  1520.           -- PS will now remove trailing spaces on /T: specifications.
  1521.           -- /TA is now assumed when /R is specified.
  1522.           -- Show number of word matches
  1523.           -- When searching for text, 0 byte files would eventually
  1524.              cause PS to encounter DOS error 4.
  1525.           -- Scroll back counter was incorrect, often showing high
  1526.              values.
  1527.           -- /HA can be specified to display High Ascii even when
  1528.              searching from the menu.
  1529.  
  1530.  
  1531.         PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 31
  1532.         --------------------------------------------------------------------
  1533.  
  1534.         Registering The Utilities
  1535.         -------------------------
  1536.  
  1537.         PSEARCH is distributed under the Shareware concept. This allows
  1538.         users to evaluate software for a short time to determine if it
  1539.         is useful to them.  If you decide the software is of value to
  1540.         you and decide to keep and use, you are required to register it.
  1541.  
  1542.         This concept allows for quality software to be distributed at a
  1543.         reasonable cost.  Hundreds of hours of my time has been invested
  1544.         in PSEARCH.  Continued registration will justify the continued
  1545.         upgrading of this utility to insure it remains up to date with
  1546.         current technology.  In any case, I do greatly appreciate all
  1547.         users that care enough to register.  I try to provide the best
  1548.         possible software for all you faithful supporting users.
  1549.  
  1550.  
  1551.         You may use the order form in ORDER.FRM when registering.
  1552.  
  1553.         Send registration requests to:
  1554.  
  1555.                   Patri-Soft
  1556.                   5225 Canyon Crest Drive
  1557.                   Suite 71-358
  1558.                   Riverside, CA   92507
  1559.  
  1560.         The registration charge is a one time fee that entitles you to
  1561.         all future versions of the product.  These may either be
  1562.         obtained from normal Shareware sources or from me.  I do not
  1563.         automatically  send product updates to registered users.  It is
  1564.         impossible to provide automatic upgrades at the low costs of
  1565.         these utilities.  If you would like to receive the next version
  1566.         of the software, add an additional $15 to your order and
  1567.         indicate on the order form you wish to receive the next update
  1568.         version.  You will be sent the next version along with an
  1569.         optional order form to request subsequent releases.
  1570.  
  1571.    Site licensing plans for one or more Patriquin utilities:
  1572.    ---------------------------------------------------------
  1573.  
  1574.          Contact Patri-Soft for information
  1575.  
  1576.         PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 32
  1577.         --------------------------------------------------------------------
  1578.  
  1579.         VISA / Mastercard / Telephone Registration
  1580.         ------------------------------------------
  1581.  
  1582.         You may place a telephone order for the utilities using your credit
  1583.         card by calling Nelson Ford's Public (Software) Library.
  1584.  
  1585.              Telephone orders: 800-242-4775 or 713-665-7017
  1586.  
  1587.         The  PSL  supplies Shareware  software  at  a nominal  cost  to its
  1588.         customers.  Consider them for all your Shareware needs.
  1589.                              ----     OR    ------
  1590.         You may call the Patri-Soft BBS and register online.  The number
  1591.         is (714) 352-2825 1200/14000 8-N-1.  Fill out script 2 to place
  1592.         your order.  Credit card orders are also accepted through U.S. Mail.
  1593.  
  1594.  
  1595.          REGISTRATION
  1596.          ------------
  1597.  
  1598.          Patri-Soft provides full support to users, both registered and
  1599.          non-registered.  We provide support through several different way:
  1600.  
  1601.                  U.S. Mail  -  You may send us problem reports through
  1602.                                the mail. Any extended information that
  1603.                                you can provide is greatly appreciated.
  1604.                                (i.e. screen shots, the actual problem
  1605.                                file, etc).
  1606.  
  1607.                  Telephone  -  You may contact us at (714) 352-2820 to
  1608.                                discuss problems.  However, extended
  1609.                                telephone support may be limited as the
  1610.                                circumstances require.
  1611.  
  1612.                  CIS        -  You may contact us on CompuServe
  1613.                                (76347,2477).  This is usually the
  1614.                                fastest way.
  1615.  
  1616.                  FAX        -  You may FAX us problem reports and
  1617.                                orders at (714) 352-1527.
  1618.  
  1619.         PSEARCH Users Guide/Reference    Copyright 1992 Patri-Soft   Page 32
  1620.         --------------------------------------------------------------------
  1621.  
  1622.         A BBS is in operation 24 hours a day to take your enhancement
  1623.         requests and problem reports.  The number for this is (714)
  1624.         352-2825.  (1200/14000 8-N-1).  Extended access is provided to
  1625.         registered users of the utilities.
  1626.  
  1627.         Patri-Soft offers a money back guarrentee if you are not
  1628.         satisfied with the software.  Simply contact us with the reasons
  1629.         of your dissatisfaction, and we will gladly refund your money.
  1630.  
  1631.         We at Patri-Soft pride ourself on our user support.  If for some
  1632.         reason you feel that you have not gotten the service you
  1633.         deserve, PLEASE let us know.  We try to respond to ALL users
  1634.         quickly and politely.
  1635.  
  1636.  
  1637.