Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

/EXACT

/EXCLUDE

/FORMAT

/HEADING

/LOG

/MATCH

/NUMBERS

/OUTPUT

/REMAINING

/STATISTICS

/WINDOW

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:

ParametersQualifiers

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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026