HP 3000 Manuals HP 3000 Manuals
Output Format
If no output-related options are specified on the command line, HP Search
sends output to your terminal and to the temporary file SRCHLIST. Output
from your last execution of HPSEARCH will overwrite any previous contents
of SRCHLIST. However, by specifying the options discussed in this
section, you can choose the way you want HP Search to display its output.
If you specify the QUIET option, only prompts and error messages are
displayed on your terminal during a search. All other output goes only
to SRCHLIST (or the file you specified with the LIST option).
If you specify the LIST option without the QUIET option, output goes to
the terminal and to the file indicated in the LIST argument. HP Search
will not send output to SRCHLIST if you specify a different output file
with the LIST option. Similarly, output generated by the MATCHLOG and
SEARCHLOG options goes to the files specified after these options.
Matching Lines
Probably the most important information derived from running HP Search is
the location of the lines in your files that match the patterns you have
specified. A discussion of the various formats of this output
information is given below.
The Default Format. Before listing the first matching line in a file, HP
Search prints a blank line and a line containing the file name. On the
line following the file name line, HP Search prints the first matching
line. Additional matching lines are printed one per line. Any line that
cannot be printed on one screen line is truncated, and a $ character is
printed in the first or last column to indicate that HP Search has
truncated the line. At the end of every search, HP Search prints the
number of files searched and the number of matching lines found. An
example is shown below:
FILE COBFILE.MYGROUP.ACCOUNT
124.01 $ This item must be the last item in the record.
6200.1 $ This should only be a last-resort action.
FILE MYFILE.MYGROUP.ACCOUNT
141 The last option requested was an option that required an $
2 files searched 3 matching lines found
Format Using the COUNT Option. If you specify the COUNT option, HP
Search prints the number of matches and the file name for each matching
file. The output of the matching lines is suppressed. The output format
is shown below:
Matches Filename
------- --------
14 MYFILE .MYGROUP .ACCOUNT
2 YOURFILE.MYGROUP .ACCOUNT
Line and Record Numbers. All text lines are printed with the first ten
columns reserved for numbering unless you specify the UNN option. If
this option is used, the text is printed starting in column 1. For
unnumbered files, the first five columns contain a right-justified record
number and the next five columns are blank, as shown below:
FILE UNNUMBER.MYGROUP.ACCOUNT
95 This matching line is the 95th record in the file.
10000 This matching line is the 10,000th record in the file.
325089 HP Search overrides right justification if necessary.
For standard numbered and COBOL-numbered files, the first five columns
contain the implied whole part of the number (that is, the first five
digits for standard numbered files and the first three digits for
COBOL-numbered files). If the last three digits are other than "000", a
decimal point is placed in column 6 and the implied decimal portion is
placed in the next three columns; otherwise, columns 6 through 9 are
blank. For example:
FILE STDNUM.MYGROUP.ACCOUNT
0.001 This is the smallest valid standard number.
10 This line in STDNUM contains "00010000" in the last 8 columns.
10.1 This line in STDNUM contains "00010100" in the last 8 columns.
FILE COBOLNUM.MYGROUP.ACCOUNT
0.001 This is the smallest valid COBOL number.
10 This line contains "010000" in columns 1 through 6.
999.999 This is the largest COBOL line number allowed.
KSAM files that have a record length of 86 bytes and contain numbers in
columns 81 through 86 are considered to be COBOL copy library files. The
numbers in columns 81 through 86 are treated as line numbers within the
member. HP Search prints the member name, found in columns 73 through
80, after the line number. An example is shown below.
FILE COBLBNUM.MYGROUP.ACCOUNT
1 MODNAME1 This is the smallest valid coblib number.
10000 MODNAME2 This line contains "010000" in the last six columns.
999998 MODNAME3 This line contains "999998" in the last six columns.
NOTE HP Search reads the first 10 lines of each file to determine its
numbering type. If HP Search finds a record after the first 10
that is not the same numbering type as the first 10, that record
and all records after it are treated as if they are unnumbered.
File Name Listings
If you specify the SEARCHLOG option, HP Search prints the fully qualified
file names of the files searched, one per line, to the output file given
as the SEARCHLOG argument. If you specify $STDLIST as the output file
argument, HP Search displays the names of the files searched and saves
them in the temporary output file SRCHLOG. When displaying the SEARCHLOG
information on your terminal screen, HP Search also prints the line
"Files searched:" before printing the file names. The example below
shows output to the terminal screen.
Files searched:
FILE1.MYGROUP.ACCOUNT
FILE2.MYGROUP.ACCOUNT
MYFILE1.MYGROUP.ACCOUNT
MYFILE2.MYGROUP.ACCOUNT
If you specify the MATCHLOG option, HP Search prints the fully qualified
file names of the files containing lines that match the given patterns.
These file names are printed in the same format found in SEARCHLOG output
files. If you specify $STDLIST as the output file argument for MATCHLOG,
HP Search displays the names of the files with matching lines and saves
these names in the temporary output file SRCHMTCH. When displaying the
MATCHLOG information on your terminal screen, HP Search prints the line
"Files with matches:" before printing the file names.
Output from Subsystem Breaks
To interrupt a search in progress, press "Controly". When you do this,
HP Search will print one of the following three message types:
1. Beginning search on first file.
2. Beginning search in file MYFILE.MYGROUP.ACCOUNT
3. Currently searching file MYFILE.MYGROUP.ACCOUNT, line nnn
This message will be followed with the prompt:
Press [RETURN] to continue or type "n" to exit.
If you stop a search with Controly and do not resume searching to
conclusion, HP Search creates the SRCHPAT, SRCHLOG, and SRCHMTCH files
with all of the information processed at the time of the Controly. HP
Search redirects the output to those files specified in the PATTERNLOG,
SEARCHLOG, or MATCHLOG options.