Scanning data sets for specific records

Search/Update Utility - Browse PDS (Option B)

Steps:

1. Type a B in the OPTION field.
2. Type FASAMP.JCL* in the Dataset name field.
3. Press Enter.

More about multiple data set processing:

• Options B (Browse) and U (Update) allow specifying a file containing a list of files in the Dataset Name field for multiple file processing if preceded by special character >, for example:

      Dataset name ===> >'userid.DSN.LIST'

• The file containing a list of files must be QSAM F 80 and can't be a pattern data set.
• The names within the file must be fully qualified with quotes, or if without quotes, File-AID will add the userid prefix.
• All data sets in the list of files are automatically SELECTED in the “Dataset List” with their current status.
• Multiple data set processing is not available when an I/O exit is specified.

Using the data set S/X selection list

When you specify a pattern in the "Dataset name" field, File-AID displays a list of data sets that match the specified pattern.

You can either:

• Select all data sets using the S ALL primary command; or,
• Select one or more data sets using the S or SS (block) line command; or,
• Exclude one or more data sets using the X or XX (block) line command.

Only those data sets that you select are examined to see if they have any records matching any selection criteria you specify.

After using the S or X line commands to indicate which of your data set(s) are to be selected or excluded, use the END command or PF key (default PF3) to continue processing your scan.

Search/Update Utility - Dataset S/X List Processing

Steps:

1. Type S ALL primary command.
2. Press Enter.
   The Status column for all three data sets changes to SELECTED.
3. Use the END command or PF key (PF3) to continue processing.

More about the multiple data set selection list

• You may use the S ALL primary command to select all data sets;
• You may use S (or SS) to select data sets; any data sets not selected are excluded.
• You may use X (or XX) to exclude data sets; any data sets not excluded are selected.
• If the S line or S ALL primary command is issued before any X line command, the status for the selected data sets changes to SELECTED, making the remaining data sets (Status is blank) EXCLUDED.
• If the X line command is issued before any other primary or line command, the status for the excluded data sets changes to EXCLUDED, making the remaining data sets (Status is blank) SELECTED.
• At least one data set must be selected (S or X) or you return to the Search/Update Utility screen with the message NO DATASET SELECTED.
• For Batch processing, the maximum number of data sets that can be processed is 100.
• Use the PRINT primary command to print the data set list.

Requesting PDS member selection processing

Since you are scanning multiple PDSs, the PDS Processing Options (PPO) screen (see the following figure) is displayed for each selected PDS to let you specify processing options and member selection.

You select members whose names fall in the range D through U and request a display of the Member Selection List.

Search/Update Utility Option B - PDS Processing Options

Steps:

1. Type a D in the "Member name" range (from) and U in the corresponding "to" field.

2. Type a Y in the "Display member selection list" field.

   The "Display member selection list" field displays only for Search/Update options B (Browse) and U (Update) and in the Copy utility (3.3) and Print functions (5.x). You may set a default (Y/N) for this field in the 0.4 Processing Parameters function.

3. Press Enter.

Using the manual member S/X selection list

When you specify a Y in the "Display member selection list" field, File-AID displays a list of members that match the specified PPO ranges.

You must either:

• Select one or more members using the S or SS (block) line command; or,
• Exclude one or more members using the X or XX (block) line command.

Only those members that you select are examined to see if they have any records matching any selection criteria you specify.

After using the S or X line commands to indicate which of your member(s) are to be selected or excluded, use the END command or PF key (default PF3) to continue processing your scan.

Search/Update Utility - Member S/X List Processing

Steps:

1. Type XX line commands to the left of the SAMPLE01 and SKELETON members.
2. Use the END command or PF key (PF3) to continue processing.
3. As you selected 3 PDSs, File-AID returns to the PDS Processing Options (PPO) screen where you (Search/Update Utility Option B - PDS Processing Options) repeat the member selection steps for FASAMP.JCL.NEW and then FASAMP.JCL.OLD.
4. After completing the member selection steps for all selected PDSs, File-AID continues with the Unformatted Selection Criteria screen (Search/Update Utility - Quick Unformatted Selection Criteria - Inserted Line).

More about the manual member selection list

• You may use S (or SS) to select members; any members not selected are excluded.
• You may use X (or XX) to exclude members; any members not excluded are selected.
• You cannot mix the S and X line commands.
• If you press Enter after marking one or more members (S or X), each member marked is indicated with the word SELECTED or EXCLUDED.
• At least one member must be marked (S or X).

Specify selection criteria

Because you requested selection criteria usage Q (Quick), the next screen displayed is the Unformatted Selection Criteria screen (Search/Update Utility - Quick Unformatted Selection Criteria - Inserted Line). Temporary criteria last used remains in memory until you exit the current utility so that you can re-use the values.

Use the I (Insert) line command to insert a new criteria line so that you can specify your additional selection criteria.

Search/Update Utility - Quick Unformatted Selection Criteria

Steps:

1. Use the I line command to insert a new criteria line.
2. Press Enter.

Add the additional criteria to search for PGM=&P to see the difference in the browse results when using the B option instead of the M option.

Search/Update Utility - Quick Unformatted Selection Criteria - Inserted Line

Steps:

1. Type CO in the RO column in the new line.
2. Type PGM=&P in the Data Value column in the new line.
3. Press ENTER.
4. Use the END command (PF3) to continue processing.

More about selection criteria

• The selection shown above scans records from position 1 to the end of the record to see if the record contains (CO) the text string PGM=FILEAID or PGM=&P (any case).

• Line commands (Cmd) you may use include:

  D(n)	Delete (n) lines (for example, D, D2, D99)
  I(n)	Insert (n) lines (for example, I, I2, I99)
  R(n)	Repeat this line (n) times (for example, R, R2)
  C(n)	Copy (n) lines to destination marker (A (After) or B (Before)
  M(n)	Move (n) lines to destination marker (A (After) or B (Before).

• Use the CANCEL command to stop Browse processing and return to the Search/Update Utility screen.

Browsing scan results

The selected members of the selected data sets are scanned for matching records and the results are written to a temporary work file. You are then placed into an ISPF Browse session on the work file.

All standard browse commands are valid, including the scroll commands, FIND, HEX, and COLS.

Each data set name is identified with a record beginning with ==>, the data set name, and OPENED AS information.

Each PDS member is identified with a record containing a line of asterisks and the PDS member name.

Each Record is identified with a record containing a line of dashes and the record number.

A message displays indicating the number of Input data sets, Selected data sets, Records read, Records Selected (matched), and Error records skipped in the selected members.

An exception report, if any, at the end of the report lists data sets that were not processed.

Search/Update Utility Scanning Results in Work File (Option B)

Step:

1. Scroll down to view all selected records with their data set name, member name, and record number information.
2. Use the END command (PF3) to return to the Search/Update Utility screen.