Navigation Menu

The Navigation menu option enables the user to navigate the application. You can go to the trigger, marker or where any cursor is located. Markers can also be added and removed. Find menu options are available as shown in the screen capture below.

att_0_for_544505883.png
Navigation Menu

The Navigation Toolbar has the same options:

navigation_toolbar.png
Navigation Toolbar
  • Go To: Locates cursors or specific events: Timestamp, X Position, Y Position, Event, Begin, and End. See below.

att_1_for_544505883.png
Navigation > Go to
  • Go to Trigger: Go to the trigger point in the trace.

  • Go to Marker: Go to a specific Marker (see Markers).

  • Find: Examine any data capture file to quickly locate an event or data pattern (see Find).

  • Find Next: Search for the next instance (see Find).

  • Find Previous: Search for the previous instance (see Find).

  • Display Markers: Displays the list of markers (see Markers).

Find

The Find menu and toolbar options enable you to examine any data capture file to quickly locate the event or data pattern.

Select Navigation > Find or click Find att_2_for_544505883.png to open the Quick Find dialog, below. You can also right-click in the Trace and select Quick Search.

Note: Only items captured in the trace file are searchable.

Quick Find

att_3_for_544505883.jpeg
Quick Find Dialog

Click inside the first gray box and a dialog will pop up with Item-Types, Addresses, events, and Fields of interest that occurred in the Trace.

quick_find_options.png
Quick Find Options

The Find function populates Item-Types with addresses and commands that occurred in the Trace.

att_4_for_544505883.jpeg
Addresses of Interest
att_5_for_544505883.jpeg
Commands of Interest

Click the == symbol in the middle of the screen to define a function (equal to, not equal to, greater than, less than, greater than or equal to, less than or equal to).

att_6_for_544505883.jpeg
Function Definition

Click on the third gray window to set the data value to compare against.

Click the red format button to toggle between Decimal, Hexadecimal, Binary, and ASCII input formats; or right-click in the third window to select the input format from the popup menu.

att_7_for_544505883.jpeg
Data Format

Advanced Find

  1. You can access Advanced Find in one of two ways:

    1. Click Find att_8_for_544505883.png in the main toolbar, then click Advanced in the Quick Search dialog.

      quick_advanced.png
      Quick Search > Advanced

OR

b. In the Spreadsheet View window, right click in a column/line of a Trace and select Quick Search from the drop-down menu, then click Advanced.

quick_search_menu.png
Quick Search Menu

Note: If you click in an area containing data, the Quick Search menu will show that data for filters and searches.

  1. Highlight an item in the left pane, then click the left arrow to move it to the search pane.

Tip: Double-click an item in the left pane to move it to the Search pane.

advanced_find.png
Advanced Find Window
  1. Click Find. Results (if any) are displayed in Spreadsheet and Frame Inspector views.

Find Large or Repeating Data Payload Patterns

The Advanced Find feature allows you to define a large or repeating data payload to search for.

search_for_data_pattern.png
Search for Data Pattern
  1. Select the Data Payload Pattern and click the > to move it to the search window. The Data Pattern window appears in which you can define a repeating pattern and/ or a very large pattern.

  2. Use the Up/Down arrows to set the number of Repeats.

  3. Click the radio button for either And or Or.

  4. To set the Payload Length, check the box and enter the length.

  5. Once you are satisfied with your settings, click OK.

The example below shows the Data Pattern set to Repeat 4 times. That is 876543210 is repeated 4 times or a payload length of <99,999. The maximum payload length is 99,999. The maximum number of data patterns you can repeat is 256.

data_pattern_definition.png
Data Pattern Definition

Find Specific Event

You can build up a specific type of event you want to Find and then Save it for later analysis of a Trace by clearing the Show just available item(s) in this trace checkbox.

cleared_checkbox.png
Cleared Checkbox

Filter

Select a type of event you want to search for from the list on the left. Use the >> arrows to move it into the “Search For” window on the right. To choose a different type of event simply select the current event type in the “Search For” window and use the << arrows to remove it. Then select a new event type.

Find

You can find specific events by selecting one and clicking the Find button att_9_for_544505883.jpeg in the Advanced Find dialog.

You can continue to search the output file using Find Next (F3) or Find Previous (F4) for the same pattern, until you redefine the data capture search parameters. You can also click the Find Next att_10_for_544505883.png icon or the Find Previous att_11_for_544505883.png icon. Alternatively, go to Navigation > Find Next or Navigation > Find Previous.

Save

After you have set up a Filter configuration, you can save it as a Filter file by clicking Save.

Load

You can use a previously saved filter by clicking Load in the Filter dialog.

Save Find Setup

After you have set up a Find configuration, you can save it as a Search configuration file by clicking Save. You can then use it on a different capture by clicking Load in the Find dialog.

Search From

Choose a starting point to begin or continue a search:

  • Selection (you select a event to be the starting point for the search)

  • Start of the trace file

  • Trigger Pointer

  • X Pointer

  • Y Pointer

  • Last Found

Find Direction

Choose either Forward or Backward direction in which to perform the find.

Find Logic

The default setting is Or. With this setting, clicking Find Next locates all selected items in turn. If you choose And, you can set a logical AND combination of items to find. Both options allow setting Advanced find features.

Finding LUNs and LBAs

Perform the following steps to find LUNs and LBAs:

  1. Click the Find icon att_12_for_544505883.png to display the Quick Find dialog.

  2. Click Advanced to display the Find dialog.

  3. Select FCP_CMD in the left pane and drag it in to the right pane or click the right arrow.

find_luns.png
Find LUNs and LBAs
  1. Select the command, double-click or right-click, and select Match Fields. The following dialog displays.

  2. Enter the values in the fields.

  3. Click OK twice.

find_lbas.png
Find LUNs and LBAs

You can search for a specific kind of NVMe command. This example demonstrates a search for an NVMe Discover Command.

find_nvme.png
Search for NVMe

Click on the Find button and the event with the NVMe Discover Command will pop up to the top of the Spreadsheet View.

From the Advanced Find/Filter dialog, there is a Data Pattern item available.

att_13_for_544505883.jpeg
Data Pattern Search Menu

You can use this feature to set criteria based on Data Patterns in the frame payloads.

att_14_for_544505883.png
Data Pattern Search Filter
  1. From the tree list on the left, select the types of payloads you want to search/filter against.

  2. Check the boxes next to Data Pattern and Data Length to set whether you check based on those criteria or not.

  3. If you check both the Data Pattern and Data Length boxes, also select the And/Or radio button to set whether you want to combine the criteria with AND or OR logic.

  4. If Data Pattern is checked, enter the pattern you wish to match against. You may specify any size of pattern in this field. Click the red format button to toggle between different input format modes:

    • Hex

    • Binary

    • ASCII

    • Decimal

  5. If Data Length is checked, enter the length in bytes you wish to match against, and set the desired comparison operator:

    • == (equal)

    • != (not equal)

    • > (greater than)

    • < (less than)

    • >= (greater than or equal)

    • <= (less than or equal)

Decode MAD Headers

Another example of using the Find function would be to locate a specific type of decoded header. In this example we’re looking for an MAD header.

Open the File function from the Main toolbar, click on Advanced and type in MAD in the filter window. If the trace has any MAD headers they will be shown in the Spreadsheet View.

mad_header_decode.png
MAD Header Decoded

Decode iSER Headers

In this example, a search for an ISER header is performed:

  1. Click the Find button on the Main Toolbar.

  2. Select Advanced and enter iSER in the filter field at the top of the left pane.

    find_iser.png
    Advanced Find – iSER

If the trace has any iSER headers they will be shown in the Spreadsheet View.

iser_decode.png
iSER Header Decoded

Go To Event

Select the large white down arrow/Go to icon att_15_for_544505883.jpeg to open the Go to Event dialog.

att_16_for_544505883.jpeg
Go To Event Options

Select a particular Event you are interested in and click OK. The Spreadsheet View moves to that event.

Select the small arrow next to the Go To Icon to open menu below:

go_to_tab.png
Navigation – Go To Tab
  • Go to X: Takes you to the X-Cursor

  • Go to Y: Takes you to the Y-Cursor

  • Go to Timestamp: Takes you to the specified time

  • Go to Event: Choose which type of Event and Number to go to

  • Go to Begin: Takes you to the first Event in the Trace

  • Go to End: Takes you to the last Event in the Trace

att_17_for_544505883.png
Navigation – Go to Time Stamp

Enter a specific time you are interested in and click OK. The Spreadsheet View will move to that time.

Go to Trigger

Select the Go to Trigger icon att_18_for_544505883.jpeg and the Spreadsheet View will move the trigger to the top of the Spreadsheet View display.

go_to_trigger.png
Navigation: Go to Trigger

Go to Marker

Select the large white down arrow/Go to Marker icon att_19_for_544505883.jpeg to open the Go to Marker dialog box.

marker_list.png
Marker List Dialog

Select a Marker and click Go To to move the Spreadsheet View to that point. Select the small white triangle to the right of the icon to open the list of markers.

list_of_markers.png
List of Markers

Selecting a marker from the list moves that event to the top of the Spreadsheet View.