Updating one or more views in the foreground or as a batch job using option 5 View update

The View Update Utility allows you to update one or more views in either foreground or batch. The views you want to process can be filtered on either or both of these criteria:

  • View name pattern (if you fill in one complete view name only that one view 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 views in a name range
  • Filter by userid (or a pattern or range) by whome the view was updated
  • Filter by Date created (or pattern or range)
  • Filter by Date modified (or pattern or range)

To update one or more views in the foreground or as a batch job using option 5:

  • Select option 4 Templates from the Primary Option menu to display the Template/View/Criteria Set menu.
  • Select option 5 View update to display the View Update Utility panel.
  • On the View Update Utility panel, enter the details to select the views you want to update:
    • In the View Data set name field, specify a fully-qualified or generic data set name to identify the data set (which must be partitioned).
    • In the View Member field, you can specify a view name or a view 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 views referencing those templates, or templates that match the member patterns, are selected for processing.
    • In the Output View Data set name field, you can specify a fully- qualified or generic data set name to identify the output data set where the updated views are to be stored. If you leave this field blank, then the update takes place on the input data set.
    • In the Output View 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).
  • 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 view with this template dataset. If this option is not selected, the utility uses the template data set referenced in the view.
    • 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.
  • 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.

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

    Unless you have selected Skip member list then the View 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.

  • 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 Segment Selection panel.
    V
    The member is displayed using the ISPF View panel.
    S
    Select one or more members to be processed.
    Tip: Enter the primary command SELECT * to select all displayed members.

    Press Enter to process all of the selected views.

  • 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 View Update Utility panel you will get a summary message that will be similar to this:
4 members read 2 Updated 1 Not changed 0 Not replaced  1 Errors

Related topics