Search/Update Utility screen
The following figure is displayed when you select option 6 from the File-AID Extended Utilities menu or enter the appropriate jump command (for example, =3.6) from any File-AID screen.
The File-AID Search/Update utility can also be accessed with the line command 6 when viewing a list of data sets presented by File-AID’s Catalog utility (3.4) or VTOC utility (3.7).
In addition, File-AID provides an F36 primary command to let you recursively invoke the Search/Update Utility function. You can enter the F36 command from any File-AID screen with an OPTION or COMMAND field. You can enter a dataset name parameter when specifying the F36 command. If a dataset name is not supplied, File-AID uses the last data set accessed as the default. When you invoke the Search/Update utility recursively, use the END command (PF3) on the Search/Update Utility screen or the RETURN command (PF4) from anywhere in the function to display the original screen from which you entered the F36 command. After the second session is completed, the original session is continued.
Search/Update Utility Screen
Field Descriptions
OPTION
Specify one of the following options:
M
Generates a member list based on the PDS processing options and optional selection criteria that you may specify. Option M provides a one-step FIND or CHANGE (PDS only) command that processes all members of the PDS. Option M’s member list allows you to use line commands to exclude members from the list and browse or edit members on the list using ISPF Browse or Edit.
Enter an M in the OPTION field and the name of the PDS in the Dataset name field (without specifying a member name). When you press Enter, File-AID displays the PDS Processing Options screen, as shown in section PDS-Processing-Options-screen.
After any selection criteria information is entered and processed, File-AID displays the PDS Find/Change screen, as shown in PDS Find/Change Member List Screen. On this screen, you may use the FIND or CHANGE primary commands to process the listed members, or use the B (browse), E (edit), S (select), or X (exclude) line commands to select one or more members to browse or edit with ISPF Browse or Edit or to exclude from further processing.
B
When processing online, option B allows you to browse one or more selected files. If you specify selection criteria information, File-AID performs standard selection processing. It processes an entire set of selected files globally, as one file, inserting file and member identification into its display. For each selected partitioned data set, File-AID displays the PDS Processing Options screen, as shown in section PDS-Processing-Options-screen. PDS Processing Options enable selection of members based on member name and PDS statistics.
Process option B in batch to print records matching the selection criteria of one or more selected data sets regardless of access method. When processing a PDS in batch, the List entire member field on the PDS Processing Options screen controls whether the entire member or only the records that meet the selection criteria are printed.
U
Processes global changes to one or more selected files based on the change criteria that you specify. When the Preview and confirm update field is set to Y (Yes), File-AID gives you a preview of the changes you have specified before applying them to the selected data set(s).
Enter a U in the OPTION field and a valid dataset name pattern in the Dataset name field. When the selected data set(s) are PDS (or CA Panvalet or CA Librarian data set), File-AID displays the PDS Processing Options screen for each selected PDS, as shown in section PDS-Processing-Options-screen. For other data set types, File-AID displays the Selection Criteria Options screen, as shown in Selection Criteria Options Screen.
File-AID ignores anything else entered in the Specify Selection Criteria Information fields. After it completes any member or record selection entered on the PDS Processing Options or Selection Criteria Options screen, File-AID displays the Search/Update Change Criteria screen, as shown in Search/Update Change Criteria Screen.
Specify Search/Update Dataset Information:
Dataset name
Specify the dataset name. Use the naming conventions described in Specifying a dataset name and Specifying a zFS Pathname.
A pattern dataset name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern data set names for a complete description.
Option M:
You can enter a pattern dataset name in this field to display a list of data sets (see Displaying Results of Pattern Data set Name Search) from which you select one data set.
Option B and U:
You can enter a pattern dataset name in this field to display a list of data sets from which you can select one or more data sets (see Data set List). Multiple data set processing is available for both batch and online processing. For Batch processing, the maximum number of data sets that can be processed is 100.
Data set With List of Files:
Another way of specifying multiple data sets is to specify a > followed by the name of a flat file containing a list of data sets to be processed, for example:
Dataset name ===> >'userid.DSN.LIST'
The file must be QSAM F 80 and can't be a pattern data set. The file must list one dataset name per line (record). The names within the file must be fully qualified with or without quotes; if there are no quotes File-AID adds the userid as usual. DSN(MEMBER) is not allowed. File-AID processes the file and displays the included dataset names in the Data set List with their current status. All data sets are automatically SELECTED. Use the available primary and line commands to modify the selection list (see Dataset List).
For PDSs, a member name is not required.
After multiple data sets are processed (Option B and U) and you return to the Search/Update Utility screen (Search/Update Utility Screen), the Dataset Name field shows the originally entered data set name pattern or list file.
Option B only:
When your pattern dataset name or List of Files includes one or more Version 2 PDSEs, you can specify how many member generations to include in the search in the PDS Processing Option screen. Refer to Version 2 PDSE (Option B, Browse) for more information.
Disposition
Specify a disposition of SHR or OLD. You are responsible for data integrity when performing an update:
SHR - (Default) Other users may access the data set.
OLD - Restricts other users from accessing the data set.
Volume serial
If the data set is not cataloged, specify the volume serial of the direct access volume that contains the data set.
I/O Exit Name (Optional)
If the I/O exit option has been installed, this input field is provided. See the File-AID Installation and Configuration Guide or your system programmer for more information. I/O exit install options are:
NO - I/O exit name field does not appear.
YES - I/O exit name field is presented blank for entry of a site-written I/O exit program name.
exitname - I/O exit name field is presented prefilled with the name of a site-written I/O exit program name.
Specify Execution Information:
Process online or batch
Specify a processing value: O (Online) or B (Batch). The default is O (Online). See Online Processing and Batch Processing.
Specify Execution Information (option U online):
Create audit trail
Specify Y (Yes) or N (No -- default). When Y is specified, before and after images of changed records are written to the audit trail dataset. Disposition of Audit Trail describes the Disposition of Audit Trail screen that is displayed when File-AID has completed an online update. For more information on the audit trail feature, see Audit Trail Feature and Print Audit Trail.
Preview and confirm update
Specify Y (Yes -- default) to display the Preview Changes with ISPF Browse screen. When this field is set to N (No), File-AID does the update without displaying the preview screen.
Maximum changes
Specify a number to control the number of changes that File-AID makes or provides for preview. The ALL (default) or 0 value enables all changes to be previewed or made.
When preview and confirm update is set to Y (Yes), the Maximum changes value limits the number of changes shown in the preview. The Search/Update Confirm Update screen then allows you to modify the Maximum changes value for the actual update.
Specify Selection Criteria Information (Options M and B):
Refer to Selection-criteria-6 for a complete description of selection criteria.
Selection criteria usage
Specify one of the following valid entries:
E
Use existing selection criteria. Enter a dataset name in the Selection criteria dataset field.
T
Create temporary selection criteria. File-AID displays the Temporary Selection Criteria Menu. Temporary selection criteria is not automatically saved. Use the SAVE primary command to retain temporary selection criteria.
M
Modify existing selection criteria. Enter a dataset name in the Selection criteria dataset field.
Q
Quick selection criteria. File-AID displays the Unformatted Selection Criteria screen for you to enter temporary selection criteria. You cannot save quick selection criteria.
N
(Default) None -- Do not use selection criteria.
Selection dataset name
Specify the name of the data set containing existing selection criteria for options E and M.
You can enter a pattern dataset name in this field to display a list of data sets from which you can make a selection. A pattern dataset name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern data set names for a complete description.
Member name
Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.
Dataset list
When you specify a pattern in the Dataset name field on the Search/Update Utility Screen for Option B (Browse) or U (Update), the following figure displays and lists all the data sets that meet the specified pattern.
The Dataset List also displays when you specified a > followed by a file containing a list of data sets in the Dataset name field (see also Data set name).
A global browse or update can be performed across multiple MVS data sets with any combination of data set attributes. The resulting report lists each data set that has records to display, showing the dataset name and file attributes, followed by its record(s). For option U (Update), the report shows the records that will be changed. An Exception report, if any, at the end of the report lists the data sets that were not processed.
Displaying Results of Pattern Dataset Name Search for Options B and U
Use the SELECT ALL primary command to select all listed data sets or the S or SS, or X and XX line commands to select or exclude one or more data sets.
After completing your selection, press END to continue.
Primary Commands
The following commands can be entered on the Dataset List screen for the Search/Update Utility:
CANCEL
Cancels the list display and returns to the Search/Update Utility screen (Search/Update Utility Screen).
END
Processes the selection and continues the selected function (B or U).
FIND (F)
Searches for the specified string and scrolls to the data set with the matching string. Use RFind to repeat the search.
LOCATE (L)
Locates and scrolls to the data set starting with the specified string.
PRINT (P)
Prints the list.
RESET (RES)
Resets the status of all listed data sets to blank (not selected), allowing you to start the selection process over again.
SELECT (S, SEL) ALL
Selects all listed data sets. The status for each listed data set will change to SELECTED. You can the use the line commands to exclude or select individual or ranges of data sets.
Line Commands
S (Select)
The S (select) line command adds selected data sets to the selection list.
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 an X line command is issued before an S line or primary command, the status for the selected data sets changes to blank, making the data sets with blank status SELECTED or NOT EXCLUDED.
SELECT Line Command Syntax
SS
S
Selects the specified data set from the selection list.
SS
Specifies the first and last lines of a block to be selected from the selection list.
Guidelines
The effect of the S line command is cumulative; lines affected by the S line command are selected from the list. (Previously selected lines remain selected.)
Multiple S line commands can be executed on different lines at the same time.
X (Exclude)
The X (exclude) line command removes selected data sets from the selection list.
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.
If a SELECT primary or line command is issued before an X line command, the status for the excluded data sets changes from SELECTED to blank, making the data sets with blank status EXCLUDED or NOT SELECTED.
EXCLUDE Line Command Syntax
XX
X
Excludes the specified data set from the selection list.
XX
Specifies the first and last lines of a block to be excluded from the selection list.
Guidelines
The effect of the X line command is cumulative; lines affected by the X line command are excluded from the selection list. (Previously excluded lines remain excluded.)
Multiple X line commands can be executed on different lines at the same time.
Online Processing
When online processing is complete, File-AID redisplays the Search/Update utility screen with a message confirming task completion. If the function fails, File-AID displays an error message in the upper-right corner of the screen.
Batch Processing
When you request batch processing and you have completed your specifications, press Enter and File-AID displays the Search JCL Specification screen, as shown in the following figure.
Search JCL Specification Screen
The following commands can be entered on the Search JCL Specification screen:
JCL
File-AID generates the JCL to process the job and displays the Generated JCL Edit screen as shown in Generated JCL Edit Screen.
SUBMIT
SUBMIT submits the batch job.
END
END cancels the function and returns to Search/Update Utility screen.
The following figure is displayed by entering the JCL primary command on the Search - JCL Specification screen.
Generated JCL Edit Screen
You can edit the generated JCL, submit it with the SUBMIT primary command, and save it by using the CREATE or REPLACE primary commands.
Related topics