Search-ForE Utility panel fields

The panel requires only the entry of character string(s). The fields on this panel are:

Search DS Name

Specify the name of a sequential data set, PDS, or membered PDS. Use standard TSO naming conventions, including quotes for fully qualified names. Leave this field blank to display a panel on which you can specify concatenated, uncataloged, and password-protected data sets. This panel is shown in Figure 1.

PDS Member List

Leave this field blank to display a list of all the members in the search data set. Otherwise, enter a pattern or an asterisk (*). See Search-For member lists for more information.

pattern

Entering a pattern causes ISPF to display a list of the members in the search data set that match the pattern unless Bypass Selection List was selected. See the topic about Displaying Member Lists in the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I for more information about using patterns. For example:

PDS Member List . . . ISR*

*

Entering an asterisk causes all the members in the search data set to be searched.

You can also use SELECT process statements in the statements data set to specify an optional set of PDS members to be searched. However, the SELECT statement turns off the PDS member list function.

CAPS

A search string that you want the Extended Search-For utility to find. This search string is converted to uppercase before the search begins and is found only if it exists in the search data set in uppercase.

The ANYC process option causes the string to be found in any case, (uppercase, lowercase, or mixed case) even if you enter the string in the CAPS field.

You can enter up to three uppercase search strings, one in each CAPS field. Here are some examples:

example 1

Either of these strings may be found in the search data set:

CAPS . . . . THEN
CAPS . . . . IF

example 2

The two strings shown must be found on the same line because of the continuation (C) keyword. THEN must be a complete word, while ISR must be the prefix of a word.

CAPS . . . . THEN WORD
CAPS . . . . ISR PREFIX C

example 3

In the next example, a hexadecimal string is specified as the search string. Use this to find unprintable characters.

CAPS . . . . X'7B00'

example 4

This example searches for the string JOE'S CLIST. Notice that the string is enclosed in single quotation marks and the apostrophe following Joe's name has been doubled.

CAPS . . . . 'JOE'S CLIST'

ASIS

A search string that you want the Extended Search-For utility to find. This search string is searched for as it is when you enter it in the ASIS field. Therefore, the Extended Search-For utility does not find the string unless it exists in the data set exactly as you enter it in an ASIS field. You can enter one search string in each ASIS field.

The examples following the CAPS field definition apply to the ASIS field as well.

See Search-For strings and keywords for a list of rules that determine the format required for entering search strings and for definitions of the keywords that are shown in the examples.

The SRCHFOR and SRCHFORC process statements override any strings entered in the CAPS and ASIS fields.

Listing DS Name

The name of the list data set to which the Extended Search-For utility writes the listing information. If you leave this field blank, Extended Search-For allocates a list 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 already exists, the contents of that data set are replaced by the new listing output. However, if the data set is sequential, you can add this listing to the data set instead of replacing it by using the APNDLST process option.

If you enter the name of a data set that does not exist, Search-For 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.

Process Options

Keywords that tell SuperC how to process the search-for operation. You can type these keywords in the Process Options field or select them from a panel. See Process options for tables of keywords.

Bypass Selection List

When a member pattern is entered in the PDS Member List field, 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.

Statements Dsn

The name of the data set that contains your search-for process statements, which you can create or change by using option E on the Extended Search-For Utility panel. SuperC reads these process statements before conducting the search. All statements data sets must be fixed block with 80-byte records (FB 80).

Execution Mode

Foreground

If you choose option 1, Foreground, and you leave the Search DS Name field blank, the Extended Search-For - Concatenation Data Set Entry panel, shown in Figure 1, is displayed.

Figure 1. Extended Search-For - concatenation data set entry panel (ISRSFCON)

                Extended Search-For Concatenation Foreground Entry

                               "Search" Concatenation
    DS1 . . .                                                        
    DS2 . . .                                                        
    DS3 . . .                                                        
    DS4 . . .                                                        

                        Other "Search" Partitioned, Sequential or VSAM Data Set
 Data Set Name . . .                                                        
 Volume Serial . . .           (If not cataloged)
 Password  . . . . .           (Password allowed only in foreground mode)









 Command ===>                                                                 
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F12=Cancel

For fields DS1 through DS4, use normal TSO naming conventions. You can specify a series of concatenated data sets, an uncataloged or password-protected data set, or a cataloged data set name.

Up to four data sets can be concatenated. Make sure the data sets are concatenated in the proper sequence, as follows:

If two or more sequential data sets are concatenated as one input data set, the data set attributes, such as block size, must be identical.
PDS concatenations must have the data set with the largest block size as the first in any concatenation.
Search-For uses only the first occurrence of a member in the concatenated series of PDSs as source input for a search. Any other occurrences of the member are ignored. You may specify the SDUPM process option to cause SuperC to search for and report all occurrences of the string for the entire concatenated series of PDS members.

Other partitioned or sequential data sets, volume serials, and data set passwords are specified as on any other data entry panel. For more information, see the "ISPF Libraries and Data Sets" topic in the z/OS ISPF User's Guide Vol I.

Note: The Password field applies only to the other partitioned or sequential data set. TSO prompts you if any concatenated data sets are password-protected.

Batch

Option 2 causes SuperC to process the data sets in batch mode. This choice frees the keyboard, allowing you to continue using ISPF while waiting for SuperC to search the data sets. The output listing is sent to the destination specified on the Search-For Utility - Submit Batch jobs panel (Figure 1).

This panel is displayed if you select option 2 and leave the Search DS Name field blank on the Extended Search-For Utility panel. You can concatenate up to four data sets that have like attributes. For example, all must be either sequential or partitioned.

Figure 2. Extended Search-For - concatenation batch entry panel (ISRSFCON)

                  Extended Search-For Concatenation Batch Entry

                               "Search" Concatenation
    DS1 . . .                                                        
    DS2 . . .                                                        
    DS3 . . .                                                        
    DS4 . . .                                                        

                        Other "Search" Partitioned, Sequential or VSAM Data Set
 Data Set Name . . .                                                        
 Volume Serial . . .           (If not cataloged)
 Password  . . . . .           (Password allowed only in foreground mode)









 Command ===>                                                                 
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F12=Cancel

This panel is the same as the panel shown in Figure 1, except the Password field is omitted. If your data sets are password-protected, search the data sets in foreground mode by leaving the Option field on the Extended Search-For Utility panel blank.

If you selected the Batch option on the Extended Search-For Utility panel, the panel shown in Figure 1 is displayed before the job is submitted. Use this panel to specify whether your Search-For listing is to be printed or written to a list data set.

Output Mode

The output mode you want to use when displaying the listing file. Choose one of these:

View: This enables the listing file to be displayed in view mode. All View functions are enabled in this mode.
Browse: This enables the listing file to be displayed in the browse mode. All Browse functions are enabled in this mode.