Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
Tailoring the List Entries z/OS DFSMS Using the Interactive Storage Management Facility SC23-6856-00 |
|
ISMF allows you to tailor your list to include only the entries you want, displayed in the order you want. Usually, you will need to customize your list entries before attempting to execute a command against all the entries in your list (list processing). To tailor the list entries, use the FILTER command, the HIDE line operator, or the SORT command. Filtering the ListWith the FILTER command, you use the data columns to set up filter criteria that identify a subset of your list. ISMF then displays the modified list with only those entries that meet your filter criteria. Once you have used the FILTER command to define a subset of the list, the commands you specify are performed against only the entries in the subset, without affecting the other entries in the original list. Like the list you originally selected, the subset of the list that you create with the FILTER command can be many pages long. You can use the scroll commands to move through it. FILTER is active only in the Data Set, DASD Volume, and List Applications. For example, you might want to compress all partitioned data sets in a data set list. Using data column 9, DS ORG, on the data set list, you can set up filter criteria to create a subset of the list that contains only partitioned data sets. Then, if you enter the COMPRESS list command, it affects only the subset containing partitioned data sets. Filtering and performing tasks against a subset of the list does not alter the makeup of the list that you originally selected. The original list remains intact, with the original values in all of the data columns, regardless of the tasks that might be performed against some of the data sets in the list. You can filter many times with different filter criteria and use each subset you construct for a different task. However, keep in mind that each time you specify new filter criteria, ISMF filters the data sets and values that are in the original list. Entering the FILTER CommandThere
are several ways to enter the FILTER command:
Using the FILTER Command without ParametersWhen you enter the FILTER command without parameters, ISMF displays the Filter Entry Panel for the list you are viewing. The Data Set Filter Entry Panel has four pages of input fields. The DASD Volume Filter Entry Panel has four pages of input fields. The Saved List Filter Entry Panel has only one page. The fields correspond to the data columns on the list panel. On the Filter Entry Panel, you use relational operators for each field you want to limit. You can specify a single value, a list of values, or a range of values a particular data column must have, in order to include the list entry in the filtered list. The following example creates a subset of a data set list that contains only data sets that have been referred to since September 10, 1992, and were created on or after May 29, 1992. You can filter a DASD volume list in a similar manner by using the Volume Filter Entry Panel. To display the Data Set Filter Entry Panel, enter FILTER on the command line of the data set list, as shown in Figure 1. Figure 1. Filtering
a List Using the Filter Entry Panel
ISMF displays page 1 of the Data Set Filter Entry Panel ( Figure 2). Use the relational operators EQ or NE for a single value or a list of values to complete the fields on this panel. To include only changed data sets in the filtered list, use the relational operator EQ to complete the CHANGE INDICATOR field, as shown in Figure 2. Figure 2. Completing
page 1 of the Data Set Filter Entry Panel
Next, use the DOWN command to scroll to page 3 of the Filter Entry Panel. Complete the fields on page 3 of the panel (Figure 3) using the relational operators EQ and NE to specify a single value,or the relational operators GT, GE, LT, and LE to specify a range of values. Related Reading: More information about relational operators is available in the online help panels. See Navigating Through Help Panels to find out how to use the help panels. Figure 3. Completing page 3 of the Data Set Filter Entry Panel
To filter the data set list based on the creation date and the last reference date, enter the relational operators and values as shown in Figure 2 and Figure 3. For this example you do not need to enter anything on pages 2 or 4. When you press the ENTER key, ISMF filters the list using the filter criteria you chose. Figure 4 shows the result. Only changed data sets referenced on and after September 10, 1995, and created after May 29, 1995, appear in the filtered list. The message on the warning line,**FILTERED LIST**, reminds you that you now have a subset of the original list. Figure 4. Example
of a Filtered List
Specifying and Clearing Filter Input FieldsWhen you use the FILTER command without parameters, you work with the Filter Entry Panel. The Filter Entry Panel retains all the filter criteria that you specified the last time you used the FILTER command. These previously specified values remain on the Filter Entry Panel whether you specified them using FILTER without parameters from the Filter Entry Panel or you specified them using FILTER with parameters from the list panel. ISMF uses all the filtering criteria to limit your list even when the values are from a previous session. ISMF reminds you when there are values already specified on the Filter Entry Panel by displayingan OTHER VALUES PRESENT warning in the top right corner of the panel. If you do not want to use these values as criteria for filtering, you must change or erase the input fields. You can use the CLEAR
command to set all the input fields to blanks. CLEAR is entered from
the command line on any page of the Filter Entry Panel. There are
three different ways to use CLEAR:
Using the FILTER Command with ParametersIf you have a single value and data column that you want to use as filter criteria, you can use the FILTER command with parameters to perform the filter without leaving the displayed list. Enter the FILTER command from the command line of the list panel. The syntax of the FILTER command is: FILTER [column-tag {EQ|NE|LT|LE|GT|GE}value] where:
Restriction: Not all relational operators are valid for all data columns. For instance, the only valid relational operators for the VOLSER data column are 'EQ' and 'NE'. The online help panels give a complete listing of the valid relational operators for each data column. An example of the FILTER command with parameters is shown in Figure 5. This example filters the list and displays a new list made up of data set names that have expiration dates equal to NEVER. Figure 5. Filtering a List Using the
FILTER Command
If the Filter Entry Panel is primed with values from the last time you used the FILTER command, these values are used as filter criteria along with the parameters you specify with the FILTER command. The message, OTHER VALUES ALSO USED, is displayedto remind you that ISMF filtered the list using values from the entry panel as well as those you specified from the list panel. Using the FILTER CLEAR CommandIf you want to clear or blank out some or all the filter criteria without going to the Filter Entry Panels, you can specify FILTER CLEAR from the list panel. The syntax of FILTER CLEAR is: FILTER CLEAR [ALL| (column-tag column-tag...)] where:
Unfiltering the ListTo redisplay the original list, enter the CLEAR ALL command from any page of the Filter Entry Panel to clear all input fields. (You can also use FILTER CLEAR to blank out some or all of the filter criteria.) The line operators and list commands you used appear with a history symbol in column 1 for the data set or volume affected by the line operator or list command. If you filter the list many times and use it to perform many tasks, the history symbol becomes a valuable tracking tool. When you redisplay the original list, you have a record of what you have done to the individual entries. Figure 6 shows a redisplayed list with history symbols. History symbols are lost when you exit or refresh a list. Figure 6. An Unfiltered Data Set List with History
Symbols
Using the HIDE Line OperatorThe HIDE line operator allows you to temporarily exclude one or more entries from the list.Once the HIDE line operator has been performed, the warning line contains the reminder **ENTRIES HIDDEN**.Hidden entries are not affected by list commands. Depending on the
number of entries you want to hide, there are two ways you can specify
the HIDE line operator:
Reshowing Hidden EntriesSpecify RESHOW on the command line when you want to redisplay all the data sets or volumes you have hidden. The line operator history for hidden entries is also redisplayed. If you sorted the list while entries were hidden, the entries appear in the appropriate order when you reshow the list. If you filtered the list while entries were hidden, hidden entries that do not meet the filter criteria are not included in the list when you reshow it.These entries are not redisplayed until you either unfilter the list, specify new selection criteria on the selection entry panel, or refresh the list using the REFRESH command. Sorting the ListThe SORT command reorders list entries in the desired sequence in a specific data column. To sort a list, you must follow these steps:
Restriction: You can only sort columns that are displayed in the current view. The list entries are sorted first by the major field. If two or more entries have the same value in the data column you used as a major sort field, ISMF uses the minor fields to complete the sort. For example, when sorting a group of data sets according to ALLOC SPACE (3), some data sets might have the same amount of allocated space. You can sort these data sets further by specifying ALLOC USED (4) as the first minor field. To sort even further, you can specify COMPRESSED FORMAT (6) as the second minor field.
Thus, if two data sets have the same amount of allocated space, they are sorted by allocated used space. If they also have the same amount of allocated used space, they are sorted by the number of extents. Entering the SORT CommandThere
are two ways to enter the SORT command:
Tip: Refer to ISMF help panels for details about sort order. Using the SORT Command without ParametersWhen you enter the SORT command without parameters on an ISMF list, ISMF displays the Sort Entry Panel. On the Sort Entry Panel, you enter values for major and minor sort fields and specify whether you want the list entries sorted in ascending or descending order. The following example shows how to use the Sort Entry Panel to reorder a data set list using two levels of sort criteria: one major field and one minor field. You use the same process to sort a volume list from all the other lists. To display the Sort Entry Panel, enter SORT on the command line of the Data Set List, as shown in Figure 7. Press the ENTER key. Figure 7. Sorting
a List Using the SORT Command
ISMF displays page 1 of 2 of the Data Set Sort Entry Panel, as shown in Figure 8. Tip: If any of the columns on your list are
not in the current view, their tag numbers will not appear on the
Sort Entry Panels.
Figure 8. Using the Sort Entry Panel
Enter DOWN on the command line to view page 2 of the Data Set Sort Entry Panel, as shown in Figure 9. Figure 9. Page 2
of the Data Set Sort Entry Panel
You can specify the major and minor sort fields, in ascending or descending order on either page 1 or page 2 of the Data Set Sort Entry Panel. The major sort field on the Sort Entry Panel in Figure 9 is the CREATION DATE (20). The minor sort field 1 is the LAST REF DATE (22). The minor sort field 2 is the DATA SET NAME (2). When you press ENTER, ISMF reorders the entire list using the sort criteria you chose. The SORT command sorts the entire list, including entries that extend beyond the screen and those that have been hidden or excluded. Hidden or excluded entries remain hidden or excluded. In this example, the major field, 20, and the first minor field, 22, are sorted in descending order. The second minor field, 2, is sorted in ascending order. The data set with the most recent creation date appears first on the sorted list. When two data sets have the same creation date, the data set with the most recent last reference date appears first. When two data sets have the same creation date and last reference date, the sort is alphabetical by data set name. The sorted list appears as shown in Figure 10. Figure 10. Example
of a Sorted List
Using the SORT Command with ParametersYou can use the SORT command with parameters to sort yourlist without leaving the list display. The syntax of the SORT command is: SORT [column-tag [IN {A|D}]] [column-tag [IN {A|D}]] [column-tag [IN {A|D}]] where:
An example of the SORT command is shown in Figure 11. Figure 11. Sorting a List Using the
SORT Command with Parameters
This command reorders the list with two levels of sort criteria. The major field (column 20) and the minor field (column 22) will be sorted in descending order. When you enter the SORT command with parameters, ISMF saves the values you specify. The next time you invoke the Sort Entry Panel, the panel is primed with these values. For more information on the concept of priming, see Understanding How Data Entry Panels Work. Tip: SORT criteria are saved only while you are in an application. Default values are reset upon each entry to an application. Refreshing the ListTo see an updated version of your list without going back to the selection panel, enter REFRESH on the command line of any list panel. When you specify REFRESH, ISMF lets you know that a new list is being generated from your current selection criteria. REFRESH cancels your current tailoring operations for list entries. If you have sorted the list, hidden entries from the list, or filtered out list entries, the new list reinstates these list entries in the default order. Upon completion of the command, ISMF displays the list panel with the updated list and a message indicating that the list is refreshed. |
Copyright IBM Corporation 1990, 2014
|