HELP SEARCH — MicroVMS 4.6
Displays all occurrences of the specified string(s) within the specified files. Format SEARCH file-spec,... search-string,... Requires the Common Utilities Option.
Additional information available:
Parameters
file-spec[,...] Specification(s) of file(s) to be searched. Wild card characters are allowed. search-string[,...] Character string to be located. Enclose strings containing lowercase letter, blanks or other nonalphanumeric characters in quotation marks.
Qualifiers
Additional information available:
/EXACT/EXCLUDE/FORMAT/HEADING/LOG/MATCH/NUMBERS
/OUTPUT/REMAINING/STATISTICS/WINDOW
/EXACT
/NOEXACT (default) Distinguishes between uppercase and lowercase characters.
/EXCLUDE=(file-spec,...)
Excludes the specified files from the search. Do not include device or directory fields in the filespec. Wildcards characters are supported for file specifications. However, you cannot use relative version numbers to exclude a specific version.
/FORMAT=option
Formats output in one of four ways: +---------+----------------------------------------------------------+ | DUMP | Displays both control and nonprintable characters as | | | ANSI mnemonics. | +---------+----------------------------------------------------------+ | NONULLS | Same as DUMP, but removes any null characters. | +---------+----------------------------------------------------------+ | PASSALL | Does not translate control and nonprintable characters; | | | the terminal driver does not actually pass 8-bit | | | characters to the terminal unless SET TERMINAL/PASTHRU | | | or SET TERMINAL/EIGHT_BIT are already in effect. | +---------+----------------------------------------------------------+ | TEXT | Displays control characters as ANSI mnemonics; terminal | | | formatting characters (<HT>, <CR>, <LF>, <VT>, and <FF>) | | | are passed without change. | +---------+----------------------------------------------------------+
/HEADING (default)
/NOHEADING Includes file names in the output file and displays 30 asterisks as a window separator between groups of lines that belong to different files. (The /WINDOW qualifier displays 15 asterisks as a separator between windows.)
/LOG
/NOLOG (default) Types a message to SYS$OUTPUT for each file searched. The message includes the file name(s), the number of records, and the number of matches for each file searched.
/MATCH=option
Interprets multiple search strings in one of the following ways: +---------+----------------------------------------------------------+ | AND | A match occurs only if the record contains all the | | | strings. | +---------+----------------------------------------------------------+ | NAND | A match occurs only if the record contains none of the | | | strings. | +---------+----------------------------------------------------------+ | NOR | A match occurs only if the record does not contain all | | | of the strings. | +---------+----------------------------------------------------------+ | OR | A match occurs if the record contains any of the | | | strings. (default) | +---------+----------------------------------------------------------+
/NUMBERS
/NONUMBERS (default) Includes source line numbers in the output.
/OUTPUT[=file-spec]
/NOOUTPUT Specifies an output file. The default is SYS$OUTPUT.
/REMAINING
/NOREMAINING (default) Includes in the output all records from the first matched record to the end of the file. This qualifier overrides n2 in /WINDOW, but allows /WINDOW=n1.
/STATISTICS
/NOSTATISTICS (default) Determines whether or not statistics about the search are displayed.
/WINDOW[=(n1[,n2])]
/NOWINDOW (default) Specifies the number of lines to be displayed with the search string. If you specify the /WINDOW qualifier without n1 and n2, two lines above the search string, the search string, and the two lines below the search string are included in the output. If you specify n1 and n2, the /WINDOW qualifier displays n1 lines above the search string, the search string, and n2 lines below the search string. If you specify /WINDOW with a single number (n1), n1 specifies the number of lines to display including the search string: half the lines precede the matched search string, and half follow it. (If n is odd, 1 line is added to the lines following the matched search string.) If you specify /WINDOW=0, the file name of each file containing a match (but no records) are included in the output. If you omit the /WINDOW qualifier, only the line containing a match is displayed.