Criteria Set Update Utility panel

Panel and field definitions

 Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 FM/IMS                 Criteria Set Update Utility

 Criteria:
    Data set name . . .                                               
    Member  . . . . . .         
    Template filter . .                                            
 Output Criteria Set:
    Data set name . . .                                               
    Member mask . . . .         

 Template:
    Data set name . . .                                               

 Processing Options:
    Enter "/" to select option
       Batch execution                       Replace member
       Advanced member selection             Specify Template data set
       Skip member list                      Check mode - no update
       Forced update                         Specify subsystem
Command ===>                                                       Scroll PAGE
 F1=Help      F2=Split     F3=Exit      F4=CRetriev  F7=Backward  F8=Forward
 F9=Swap     F10=Actions  F12=Cancel

Criteria

Data set name

(Required) A fully-qualified or generic data set name used to identify the data set which must be partitioned.

In a generic data set name, use the percent sign (%) to represent a single character, and an asterisk (*) to represent any number of characters within a qualifier. Two asterisks (**) represent any number of characters within any number of qualifiers.

The TSO prefix (as defined for your user ID) is used as the high-level qualifier for any name that is not enclosed in quotation marks.

For performance reasons, you should qualify the data set name as much as you can.

You can combine the member name with the dataset name in the form Data set name(Member).

Member

Name of a member of a partitioned data set. If you leave the member name blank, or specify a member name pattern, FM/IMS displays a member name list. You can then select the required member by entering S in the Select field for the appropriate member.

A member name pattern can consist of any characters that are valid in a member name and two special pattern characters, the asterisk (*) and the percent sign (%):

*

Represents any number of characters. As many asterisks as required can appear anywhere in a member name. For example, if you enter *d*, a list all members in the data set whose name contains "d" is displayed.

%

A place holding character that means a single character. As many percent symbols as necessary may appear anywhere in a member name. For example, if you enter: %%%%, a list of all members in the data set whose name is 4 characters in length is displayed.

Template filter

Enter up to four template member names or patterns to limit the selection and processing to those criteria that are based on one of the specified templates, or a template that matches one of the specified patterns.

Note: As the Template member name is the same as the name of the database, this is also a database filter.

Output Criteria Set

Data set name

(Optional) A fully-qualified or generic data set name used to identify the output data set which must be partitioned. If this field is not specified, then the update takes place on the input data set.

You can specify a generic data set name using the percent (%) sign and asterisk (*) as described for the criteria set data set name above.

The TSO prefix (as defined for your user ID) is used as the high-level qualifier for any name that is not enclosed in quotation marks. For performance reasons, you should qualify the data set name as much as you can.

You can combine the member name with the dataset name in the form Data set name(Member).

Member mask

Specify a pattern to rename members in the output partitioned data set based upon the member names in the input partitioned data set. A member name pattern can consist of any characters that are valid in a member name and two special pattern characters: the asterisk (*) and the percent sign (%).

*

A place-holding character that means multiple characters with no change. Only one asterisk should appear in the mask. Any subsequent asterisk characters are treated as percent signs.

For example, if you enter:

     ABC*

the renamed members will all begin with ABC followed by the remainder of the old member name.

%

A place-holding character that means a single character with no change. As many percent symbols as necessary may appear anywhere in a member name.

For example, if you enter:

   %%%A*

the first 3 characters of the renamed members remain unchanged, the fourth character is replaced with the letter "A", and the remainder of the old member name remain unchanged.

Template

Data set name

This field is only used when the Specify Template data set option is selected. When this option is selected, the templates in the specified data set are used to update the criteria sets (rather than the template referenced in each criteria set) and, if the update is successful, the utility changes the template data set name in the criteria set to the specified data set name.

Processing Options:

Batch execution

Presents the JCL to run the function in batch. The JCL can be edited and submitted. You can use the Set Batch Job Card Information panel to tailor the default JOB card that FM/IMS uses to generate JCL.

Advanced member selection

Allows you to specify which members are to be processed based on member name, created date, last changed date, and the user ID by which the member was last updated. For each of these criteria, a mask or range of values can be entered.

Skip member list

Run without showing the member selection list. This option bypasses the member list panel and process 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.

Forced update

Performs the update even if no changes have been detected.

Replace member

Replaces like-named members in an output partitioned data set.

Specify template data set

Allows you to specify the Template data set that the utility uses to update the criteria sets.

Select this option if you want your criteria sets to be based on templates that are in the data set you specify in the Template data set name field. The specified template data set name is stored in the updated criteria sets and they are flagged as being based on a static template.

If the Specify subsystem option is also selected, only criteria sets that are based on static templates are updated in this way. Those that are based on dynamic templates are updated as described in the help for the Specify subsystem option.

When neither of these options are selected and the criteria set is based on a static template, the utility bases the criteria set on the template whose name is stored in the criteria set.

Specify subsystem

Select this option if you want your criteria sets to be based on dynamic templates. These are templates that are dynamically generated from data in an IMS™ catalog or DBD libraries.

If this option is selected, the IMS Subsystem Specification panel is displayed. Use this panel to specify the source of the data from which the template is generated. The name of the data source is stored in the updated criteria sets and they are flagged as being based on a dynamic template.

If the Specify Template data set option is also selected, only criteria sets that are based on dynamic templates are updated in this way. Those that are based on static templates are updated as described in the help panel for the Specify Template data set option.

When neither option is selected and the criteria set is based on a dynamic template, the utility bases the criteria set on a template that is generated from the data source that is specified in the criteria set.

Check mode - no update

Runs the function without saving the resulting members. Normally used to check for errors.