Filtering the VTAM SAW data collection


Use filtering to limit the volume of VTAM session awareness (SAW) data that is collected and determine which VTAM sessions will be globally traced.

MainView for IP checks the SAW filters in the order they are listed on the SAW Filter (SAWFILTR) panel.

To filter the VTAM SAW data collection

  1. From the EZIP menu, select Product Administration (EZADMIN) in the Utilities section, and press Enter.
  2. From the EZADMIN menu, select VTAM SAW Settings (MVIPSAWD) and press Enter.
  3. From the MVIPSAWD panel, select SAW Filters and press Enter.
  4. The SAWFILTR view is displayed. The first time you enter the SAWFILTR view, no filters are defined and only a DummyPLU entry is shown in the following figure.

      W1 =SAWFILTR==========TCPIP====*========ddmmmyyyy==11:02:16====MVIP=====D====1
     CMD                       Keep Log                                             
     --- Primary    Secondary  PIU  PIU   SAW   Order                               
         DummyPLU   DummySLU      7 No    Yes       1
  5. In the Command field, type ADD next to the DummyPLU entry, and then press Enter.

    Warning

    Note

    When entries are already present, you can use the following commands to update or delete an entry:

    • U to update the entry
    • DEL to delete the entry

    The SAW filter data entry screen is displayed, as shown in the following figure.

     05JUN2013  04:10:45 ------ MAINVIEW WINDOW INTERFACE (V6.1.00) ----------------
     Essssssssssssssssssssssssssssss Add SAW Filter sssssssssssssssssssssssssssssssN
     e COMMAND ===>                                              SCROLL ===> PAGE  e
     e                                                                             e
     e  Primary LU:   DummyPLU                                                     e
     e  Secondary LU: DummySLU                                                     e
     e                                                                             e
     e  SAW:          Yes       (Yes/No)                                           e
     e  Keep PIU:     7         (0-999)                                            e
     e  Log PIU:      No        (Yes/No)                                           e
     e  Order:        1                                                            e
     e                                                                             e
     e                                                                             e
     e END to Add SAW Filter                                                       e
     e CANCEL to NOT Add SAW Filter                                                e
     e HELP to view related help                                                   e
     e                                                                             e
     e                                                                             e
     e                                                                             e
     e                                                                             e
     e                                                                             e
     e                                                                             e
     e                                                                             e
     e                                                                             e
     DsssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssM
  6. Add a filter in the data entry screen by typing the required information as described in the following table.

    Field

    User entry

    Primary LU

    Defines the primary logical unit (PLU) criteria to match against the VTAM SAW data.

    You can use masking when defining the Primary LU. The following characters are valid for masking:

    • An asterisk (*) - matches the rest of the PLU name
    • A question mark (?) - matches any single character

    Secondary LU

    Defines the secondary logical unit (SLU) criteria to match against the VTAM SAW data.

    You can use masking when defining the Secondary LU. The following characters are valid for masking:

    • An asterisk (*) - matches the rest of the SLU name
    • A question mark (?) - matches any single character

    SAW

    Specifies whether VTAM session data will be collected for this session. Valid values are:

    • YES (default)
    • NO

    Keep PIU

    Specifies how many trace PIUs are kept for each VTAM session.

    Valid values are in the range 0 through 999 and the default value is 7.

    Log PIU

    Specifies whether traced PIUs are logged to MainView history when the VTAM session ends. Valid values are:

    • YES
    • NO (default)

    Order

    Defines the order in which the SAW filter entries are checked.



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

MainView for IP 3.6