Updating templates in either foreground or batch using option 4 Template update

Use the Template Update Utility to update templates in foreground or batch.

You can filter the templates you want to process on either or both of these criteria:

  • Template name pattern (if you fill in one complete template name only that one template will be processed).
  • Up to four copybook 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 templates in a name range
  • Filter by userid (or a pattern or range) by whom the template was updated
  • Filter by Date created (or pattern or range)
  • Filter by Date modified (or pattern or range)

To update one or more templates in the foreground or in batch, using Option 4:

  1. Select option 4 Templates from the Primary Option menu to display the Template/View/Criteria Set menu.
  2. Select option 4 Template update to display the Template Update Utility panel.
  3. On the Template Update Utility panel, enter the details to select the templates you want to update:
    • 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).
    • In the Template Member field, you can specify a template name or a template name pattern.
    • In the Template Copybook filter field, you can specify up to four member names or patterns to be used as a filter so that only templates referencing those copybooks, or copybooks that match the member patterns, are selected for processing.
  4. In the Output Template Data set name field, you can specify a fully-qualified or generic data set name to identify the output data set where the updated templates are to be stored. If you leave this field blank, then the update takes place on the input data set.
  5. In the Output Template Member mask field, you can specify a rename mask so that the updated templates are stored under an alternative name.
  6. 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 library data sets to specify the library data sets that the utility uses to build the template. If this option is not selected, the utility uses the library data sets referenced in the template.
    • 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.
    • Specify DBD data sets to update the DBD data set name referenced in the template with one of the DBD data set names provided. You can provide up to 2 DBD data set names. The DBD data set name is changed to the first one searched that contains the matching DBD (template name). If a matching DBD member is not found, the DBD data set name is not updated.
    • Skip database segment list update to improve performance by eliminating DBD checking and key position processing when updating templates. Only select this option when there are no changes to the list of segment names specified in the DBDs that the templates are built from.
    • Check mode - no update to run the function without saving the resulting members.
    • New database segments to add new segments to an existing DBD/Template. If this option is selected and the Skip database segment list update option has not been selected, the New Database Segments panel will be displayed where you can specify the layout members for each of the new segments.
    • Forced update, if you want to perform the update when no changes have been detected.
    • Preserve copybook library to ensure that if a copybook still exists in the library that it was previously found in and that library is in the list that the update is using, then that version of the copybook is used.
      The utility searches the libraries in the order they are listed and uses the first version of the copybook that it finds when one of these cases is true:
      • This option is not selected.
      • The copybook no longer exists in the library it was previously found in.
      • That library is not in the list the update is using.
  7. 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.

  8. If Specify library data sets or Specify DBD data sets was selected then the Template Update : DBDLIB/Library lists panel will be displayed.

    In the DBD data set name fields, you can specify up to 2 data set names (which must be DBD libraries). The data sets are used as alternative DBD libraries when searching for the DBD matching the template name.

    If you have selected the Specify DBD data sets option, and the template member name exists as a DBD, then the DBD is used from this library when updating the template and the DBD data set name is updated to the first data set found containing the matching member name.

    In the Library data set name fields, you can specify up to twelve copybook library names. The copybook library names referenced in the template are changed to the copybook library names specified in these fields. The new library data sets are used to locate and compile the copybooks during the update process, so you need to ensure that all the copybooks referenced in all the templates selected are available in the libraries you specify to avoid update errors occurring.

  9. Press Enter.
  10. If New database segments was selected then the Template Update : New Database Segments panel will be displayed. You can specify up to twelve segment (or layout) name pairs. If you need more, run the update as a batch job. Before you submit the generated JCL just modify it to cater for the additional segments.
  11. Press Enter.
  12. If Advanced member selection was selected then the Advanced Member Selection panel is displayed. Here you can specify a combination of template name pattern, or a range of template names, and updated by userid (or pattern or range), and date created (or pattern or range), and date modified (or pattern or range).
  13. Press Enter.
  14. Unless you have selected Skip member list then the Template 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.
  15. 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 Template Specification 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 templates.

  16. If Batch execution was selected then the JCL will be generated.

    For any other processing option a message is displayed to show 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 Template Update Utility panel, you get a summary message like:
42 members read 23 Updated 5 Not changed 0 Not replaced  14 Errors

Related topics