Filtering

If a displayed object list is too long, and scrolling back and forth is getting cumbersome, you may use the Filter function that lets you limit the displayed information. The Filter function is available when the action bar shows a Filter action bar choice. This is the case in a:

• Processor list
• Channel path list
• CTC connection list
• CF channel path connectivity list
• Switch list
• PCIe function list
• Port list
• Control unit list
• Device list
• Esoteric list
• I/O Path list

For example, on the device list, you can limit the displayed information by the following filter criteria:

• Device type
• Device group
• Whether the devices are defined to an operating system or not
• Serial number and description
• Volume serial number
• Device parameters and features (if you navigated to the I/O Device List via the operating system configuration list)
• Whether the devices are connected to a control unit or not
• Up to four control units, to which the devices may be connected
• Subchannel set ID

Rather than seeing all devices defined in the IODF, you see only those devices that are, for example, of a certain type connected to a certain control unit.

How to request filtering is illustrated in the following scenario:

1. Navigate to a processor's I/O Device List. Note that for XMP processors you first need to navigate to its Channel Subsystem List and then to its I/O Device List. Now tab to the action bar and select Filter from the action bar. The pull-down menu shown in Figure 39 is displayed:
   Figure 39. Filter example

      Goto  Filter  Backup  Query  Help
    ----- *-------------------------------------* ----------------------------
          |    1. Set Filter                    |         Row 1 of 6 More:       >
    Comma |    2. Clear Filter                  | __________ Scroll ===> CSR
          |    3. Count rows on (filtered) list |
    Selec *-------------------------------------* To add, use F11.
   
    Processor ID : TSPROC1    Proc supporting multiple SSs       CSS ID : 0
   
      ----------Device--------- --#-- --------Control Unit Numbers + --------
    / Number   Type +        SS IM OS 1--- 2--- 3--- 4--- 5--- 6--- 7--- 8---
    _ 0001     3390A         0  0  1  0001 0002 ____ ____ ____ ____ ____ ____
    _ 0001     3390A         1  2  1  0001 ____ ____ ____ ____ ____ ____ ____
    _ 0002,4   3390A         1  2  1  0001 ____ ____ ____ ____ ____ ____ ____
    _ 0002,8   3390A         0  2     0001 0002 ____ ____ ____ ____ ____ ____
    _ 0006,3   3390             2  1  0001 ____ ____ ____ ____ ____ ____ ____
    _ 000A     3380             2  1  0001 ____ ____ ____ ____ ____ ____ ____
    ******************************* Bottom of data ********************************
   
     F1=Help      F2=Split     F3=Exit      F4=Prompt    F5=Reset     F7=Backward
     F8=Forward   F9=Swap     F10=Actions  F11=Add      F12=Cancel   F13=Instruct
    F20=Right    F22=Command

2. Select Set Filter. This displays the Filter I/O Device List (Figure 40), tailored for the underlying I/O Device List, where you can specify your filter criteria. Note that for example, the 'Subchannel set ID' filter criteria is only available for the I/O Device List if invoked from the Channel Subsystem List of a z9 EC processor or later model, or from the Operating System Configuration List (action code  u  in both cases). Similar panels are displayed for the other lists.

   An alternative way to select filtering is to tab to the command line and type in FILTER SET.

   Figure 40. Filter I/O Device List

   *------------------ Filter I/O Device List -------------------*
   |                                                             |
   |                                                             |
   | Specify or revise the following filter criteria.            |
   |                                                             |
   | Device type  . . . . 3390A___  +                            |
   | Device group . . . . ________  +                            |
   | Subchannel set ID  . 0  +                                   |
   |                                                             |
   | Defined to OSs . . . Y  (Y = Yes; N = No)                   |
   |                                                             |
   | Serial number  . . . __________                             |
   | Description  . . . . ________________________________       |
   |                                                             |
   | Volume serial number . . . . . . . ______  (for DASD)       |
   |                                                             |
   | Connected to CUs . . _  (Y = Connected; N = Not connected)  |
   | Specific CUs . . . . ____  or  ____  or  ____  or  ____     |
   |                                                             |
   |                                                             |
   |  F1=Help     F2=Split    F3=Exit     F4=Prompt   F5=Reset   |
   |  F9=Swap    F12=Cancel                                      |
   *-------------------------------------------------------------*

3. On this filter panel you can specify one or more filter criteria. All specified filter criteria must match to display the item. For example, if you specify a device type and a subchannel set where the devices of this type should be defined, and then press the Enter key, the I/O Device List is displayed again, now showing only those devices that match these filter criteria. Figure 41 shows an example of a filtered list. If Filter Mode is displayed in the right top corner of the panel, it indicates that the filter mode is active.
   Figure 41. Reduced I/O Device List (using a filter)

     Goto  Filter  Backup  Query  Help
   --------------------------------------------------------------------------
                                I/O Device List        Filter Mode. More:       >
   Command ===> ___________________________________________ Scroll ===> CSR
   
   Select one or more devices, then press Enter. To add, use F11.
   
   Processor ID : MSSPROC1   Proc with multiple SSIDs           CSS ID : 0
   
     ----------Device--------- --#-- --------Control Unit Numbers + --------
   / Number   Type +        SS IM OS 1--- 2--- 3--- 4--- 5--- 6--- 7--- 8---
   _ 0001     3390A         0  0  1  0001 0002 ____ ____ ____ ____ ____ ____
   _ 0002,8   3390A         0  2     0001 0002 ____ ____ ____ ____ ____ ____
   ******************************* Bottom of data ***************************
   
    F1=Help      F2=Split     F3=Exit      F4=Prompt    F5=Reset     F7=Backward
    F8=Forward   F9=Swap     F10=Actions  F11=Add      F12=Cancel   F13=Instruct
   F20=Right    F22=Command

Most of the entry fields support wildcards, that means that an asterisk (*) can be specified in front and/or after the specified term. The following table illustrates the wildcard processing using the device type field as an example.

Use Field Help on the Filter panel to get information on whether wildcards are supported or not.

To remove the filter, use Clear Filter from the Filter action bar, or enter FILTER CLEAR in the command line.

To count the rows on a filtered list, use Count rows on (filtered) list from the Filter action bar choice, or enter FILTER NUM in the command line. An informational message displays the number of rows in the current list. If this list is filtered, only the rows matching the underlying filter criteria are counted.