Search-For Utility panel fields

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.