                               TS (Text Search)


Description:   Searches for specified text in one or more files, on an entire
               disk, or in the unallocated areas of a disk.


Syntax:        Version 3.0:   TS [/N]


               Version 3.1:   TS [(drive:)] [(path)] [(filespec)]
                              [(search-text)] [/EBCDIC] [/EUR] [/LOG] [/N]
                              [/S] [/T]

                              TS [(search-text)] {/D | /E} [/EBCDIC] [/EUR]
                              [/LOG] [/N]

               Version 4.0:   TS [(drive:)] [(path)] [(filespec)]
                              [(search-text)] [/A] [/CS] [/EBCDIC] [/LOG]
                              [/N] [/S] [/T] [/WS]

                              TS [(search-text)] {/D | /E} [/A] [/CS] [/C(n)]
                              [/EBCDIC] [/LOG] [/N] [/WS]



               Version 4.5:   TS [(drive:)] [(path)] [(filespec)]
                              [(search-text)] [/A] [/CS] [/EBCDIC] [/LOG]
                              [/S] [/T] [/WS]

                              TS [(search-text)] {/D | /E} [/A] [/CS] [/C(n)]
                              [/EBCDIC] [/LOG] [/WS]



                                 Parameters:

(drive:)       The single-letter specifier (A:, B:, C:, etc.) for the drive
               containing the file you want to search. Follow the letter with
               a colon. The current drive is the default.

(path)         The full name (C:\WP\LETTERS) of the directory containing the
               files you want to search. The current directory for the
               designated drive is the default.

(filespec)     The name of the file you want to search. The default
               (filespec) is ..

(search-text)  A text string for which you want to search. If the text string
               is more than a single word, you must enclose it in quote
               marks. If the text string contains a single-quote character,
               enclose the text in double-quote marks. If the text contains a
               double-quote character, enclose the text in single-quote
               marks.

/A             Searches automatically by responding ``yes'' to all prompts.

/CS            Makes the search case sensitive. If you do not use this
               switch, TS ignores case when comparing (search-text) with data
               on disk or in a file.

/C(n)          Specifies the starting cluster number when searching either
               the entire disk (see /D) or the erased areas on the disk (see
               /E).

/D             Searches the entire disk, including both allocated and
               unallocated areas.

/E             Searches the erased (unallocated) clusters in the data area.

/EBCDIC        Specifies that the files you are searching use Extended Binary
               Coded Decimal Interchange Code rather than ASCII.

/EUR           Specifies the European character set and includes character
               codes 128 through 255 in the search. The default is to ignore
               characters with a code greater than 127.

/LOG           Displays diagnostic output as separate (not overlaid) output
               lines that can be redirected to either a printer or a disk
               file. You can send the output to a printer or a disk file by
               including the MS-DOS redirection character ()) followed by a
               printer name or filename at the end of the command.

/N             Lets you run TS if your machine is not fully IBM-compatible.
               If you use this switch, you might first need to enable
               ANSI.SYS in the CONFIG.SYS file and then restart your
               computer.

/S             Searches all files in all subdirectories under the current or
               specified path.

/T        Displays the names of only the files that contain (search-text) and
          the total number of these files in each directory.

/WS       In a WordStar input file, removes the high-order bit from all
          characters to restrict the search range of codes to 0 through 127.
          The default in versions 4.0 and 4.5 includes character codes 128
          through 255 in the search.

                                   Notes:

In versions 4.0 and later, if you include no parameters, TS prompts you for
(search-type) (file, entire disk, or erased area), for (filespec) if it is
performing a file search, and for (search-text). In earlier versions, TS
prompts you for (filespec) and for (search-text).

If you include either the /D or the /E switch, TS asks you whether you want
to collect clusters containing matching data and copy the clusters to an
output file. The output file must be on a drive other than the one TS is
searching.

Use the data search feature in the NU (Norton Utility) command to scan for
characters you cannot enter on the keyboard.

Example:       To search for all occurrences of ``word processing'' in all
               files with the TXT extension in all directories in drive C.

               Enter:    TS c:\.txt "word processing" /S

See <NUNU>.
