All the fields on this panel are explained in the Libraries and
Data Sets topic in the
z/OS ISPF User's Guide Vol I,
except these:
- Search String
- A
string to be searched for. No distinction is made between uppercase
and lowercase characters. Use the Extended Search-For utility (option
3.15) to specify case-sensitive searches.
Four keywords—C, PREFIX,
SUFFIX, and WORD—can help you narrow the scope of a search. See Search-For strings and keywords for information about these keywords
and the rules that govern search string entry.
- Specify additional search strings
- Select this field to have the Search-For utility
search for more than one string. The
Search-For utility displays the panel shown in Figure 1, on which you can specify
additional search strings. This panel precedes a member list request.
If you do not select this option, the Search-For utility searches
only for the string entered in the Search String field.
- Mixed Mode
- Select this field to have the Search-For utility scan and parse
the input data set lines for DBCS text strings.
Note: The Word, Prefix,
and Suffix Search-For qualifiers have no effect on DBCS strings.
- Bypass Selection List
- When a member pattern is entered in the PDS Member List field
or the member name portion of the data set field (such as MY.DATA.SET(pattern)),
selecting this field causes SuperC to process all members matching
that pattern without displaying a member selection list. Leaving this
field blank causes the member list to be displayed.
- Execution Mode
- The
processing mode you want to use when searching the data sets. Specify
one of these:
- 1
- Foreground. Searches the data sets and stores
the results in the data set specified in the Listing Data Set Name
field. You can browse the listing data set at the terminal.
- 2
- Batch. Causes the display
of the Search-For Utility - Submit Batch Jobs panel so that you can
specify job card and print disposition information or edit the JCL
statements. Then, Search-For submits the batch job to search the data
sets. See Submitting a Search-For job in batch mode for more information.
Note: You cannot specify a data set password in batch mode. If your
data sets are password protected, use foreground mode.
- Output Mode
- The output mode you want to use when displaying the listing file.
Choose one of these:
- 1
- View. This enables
the listing file to be displayed in view mode. All View functions
are enabled in this mode.
- 2
- Browse. This enables
the listing file to be displayed in the browse mode. All Browse
functions are enabled in this mode.
- Listing Data Set
- The
name of the listing data set to which the SuperC program writes the
results of the search. If you leave this field blank, the Search-For
utility allocates a listing data set, using default data set attributes
and this data set name:
prefix.userid.SRCHFOR.LIST
where prefix is
your TSO prefix and userid is your user ID.
If your prefix and user ID are identical, only your prefix is used.
Also, if you do not have a prefix, only your user ID is used.
Note: If
the ISPF configuration table field USE_ADDITIONAL_QUAL_FOR_PDF_DATA_SETS
is set to YES, an additional qualifier defined with the ISPF_TEMPORARY_DATA_SET_QUALIFIER
field is included before the SRCHFOR qualifier.
If you
enter a fully qualified data set name SuperC uses it as specified.
Otherwise, SuperC only appends your TSO prefix to the front of the
data set name specified. If you run with TSO PROFILE NOPREFIX, SuperC
uses the name as you entered it, which can result in an attempt to
catalog the name in the master catalog.
If you enter the name
of a data set that does not exist, the Search-For utility allocates
it for you. The data set is allocated as a sequential data set unless
you enter a member name after it, in which case it is allocated as
a partitioned data set.