Updating one or more criteria sets in the foreground or as a batch job using option 4.6

The Criteria set Update Utility allows you to update one or more criteria sets in either foreground or batch. The criteria sets you want to process can be filtered on either or both:

  • Criteria set name pattern (if you fill in one complete criteria set name only that one criteria set will be processed)
  • Up to four template names or patterns

You can also select to use the Advanced member selection option. Then it is possible to select or filter using one or more of:

  • Select criteria sets in a name range
  • Filter by userid (or a pattern or range) by whome the criteria set was updated
  • Filter by Date created (or pattern or range)
  • Filter by Date modified (or pattern or range)

Here is how you update one criteria or more sets in the foreground or as a batch job using option 6:

  1. Select option 4 Templates from the Primary Option menu to display the Template/View/Criteria Set menu.
  2. Select option 6 Criteria set update to display the Criteria set Update Utility panel.
  3. On the Criteria set Update Utility panel, enter the details to select the criteria sets you want to update:
    • In the Criteria set Data set name field, specify a fully-qualified or generic data set name to identify the data set (which must be partitioned).
    • In the Criteria set Member field, you can specify a criteria set name or a criteria set name pattern.
    • In the Template filter field, you can specify up to four member names or patterns to be used as a filter so that only criteria sets referencing those templates, or templates that match the member patterns, are selected for processing.
    • In the Output Criteria set Data set name field, you can specify a fully-qualified or generic data set name to identify the output data set where the updated criteria sets are to be stored. If you leave this field blank, then the update takes place on the input data set.
    • In the Output Criteria set Member mask field, you can specify a rename mask so that the updated templates are stored under an alternative name.
    • In the Template Data set name field, specify a fully-qualified or generic data set name to identify the data set (which must be partitioned).
  4. Select the processing options:
    • Batch execution to run the function in batch.
    • Replace member to replace like-named members in the output partitioned data set.
    • Advanced member selection to specify a range of members to be selected, rather than a specific or generic member name.
    • Specify template data sets to update the template data set name referenced in the criteria set with this template dataset. If this option is not selected, the utility uses the template data set referenced in the criteria set.
    • Skip member list to run without showing the member selection list. This option bypasses the member list panel and processes all the qualifying members. If an error (like a duplicate output name) results from the specified parameters, then the member list panel is displayed with the errors highlighted.
    • Check mode - no update to run the function without saving the resulting members.
    • Forced update if you want to perform the update when no changes have been detected.
  5. Press Enter.

    First all datasets specified as generic will be searched for and you need to select the wanted datasets. Then, depending on what options are selected, the following panels will be displayed.

  6. If Advanced member selection was selected then the Advanced Member Selection panel is displayed. Here you can specify a combination of criteria set name pattern, or a range of criteria set names, and updated by userid (or pattern or range), and date created (or pattern or range), and date modified (or pattern or range).
  7. Press Enter.

    Unless you have selected Skip member list then the Criteria set Member Selection panel is displayed. Press F11 (Right) to scroll right to display the Description column, and F10 (Left) to return to the original display.

  8. In the prefix area (Sel), type any of the following prefix commands and press Enter to perform the associated action:
    B
    The member is displayed using the ISPF Browse panel (not the File Manager Browse panel).
    E
    The member is displayed in the Subset Selection panel.
    V
    The member is displayed using the ISPF Criteria set panel.
    S
    Select one or more members to be processed.

    When the S command is entered for the criteria sets you want to process, press Enter. If you want to select all members that are displayed, you can use the primary command SELECT with the “*? parameter.

  9. If Batch execution was selected then the JCL will be generated. Else the process that is ordered is executed and a message is displayed to inform you of the result of the action performed. If any of the updates fails an error message is displayed and the status for each member is displayed in the Prompt field.
When you get back to the Criteria Set Update Utility panel you will get a summary message that will be similar to this:
47 members read 33 Updated 8 Not changed 0 Not replaced  6 Errors

Related topics