busTRACE This WEB page comes from the busTRACE 10.0 User's Manual. (Table of Contents)

Previous Topic Next Topic
 

busTRACE has the ability to capture tens of thousands of I/Os (and more). Finding the one you're looking for could be difficult. Fortunately, busTRACE provides a powerful Find capability to help you find the I/O activity you're interested in.

The Find options can be found on the toolbar. Clicking on the arrow to the right of the Find button shows you a drop down list of the type of find you want to perform:

You then enter the term you are looking for in the edit box (to the right of the Find button) and then use the Find Next/Previous buttons to move between I/Os that match your search criteria.

Find Data Transferred - Text Mode

Selecting this option informs busTRACE that you want to find a specific text string in the data transferred to or from the device. You can type any text string into the Find edit box. The drop down arrow, to the right of the edit box, will show you a cache of previously submitted text strings.

Find Data Transferred – Binary/Hex Mode

Selecting this option informs busTRACE that you want to find a specific hex value in the data transferred to or from the device. You type the hex data directly into the Find edit box. The drop down arrow, to the right of the edit box, will show you a cache of previously submitted hex data.

The data should be submitted in byte mode. For example, a value of "2A 00 00 3D" is a valid search string for hex data.

Find Command Sent – Text Mode

Selecting this option informs busTRACE that you want to find a specific command sent to the device using a text string match. This matches the value in the Command 1 column. For example, if you are looking for the Get/Event Status Notification CDB, you could simply type in Get Event and then click on the Find Next/Previous buttons to move to each Get/Event Status Notification CDB.

One particularly powerful feature of busTRACE is its ability to keep track of every command sent to a device. By clicking on the drop down arrow, to the right of the edit box, you will see a list of all commands that have been captured. Select the one you are interested in and choose the Find Next/Previous buttons to move between them. For example:

Find Command Sent – Binary/Hex Mode

Selecting this option informs busTRACE that you want to find a specific command sent to the device using a hex data match. This is only applicable to storage class devices that process Command Descriptor Blocks (CDBs). You type the hex data directly into the Find edit box. The drop down arrow, to the right of the edit box, will show you a cache of previously submitted hex data.

The data should be submitted in byte mode. For example, a value of "2A 00 00 3D" is a valid search string for hex data.

Find I/O Summary Text – Text Mode

Selecting this option informs busTRACE that you want to find a specific error returned from the device, using a text string match. To view a list of all errors seen during the capture sequence, you simply click on the drop down arrow to the right of the edit box. Select the one you are interested in and choose the Find Next/Previous buttons to move between them. For example:

Any Failed I/Os

Selecting this option informs busTRACE that you want to find and move to any failed I/O. Use the Find Next/Previous buttons to move between them.

Find Dialog Box

If you click on the Find button on the toolbar, you will be given a dialog box with the same options available directly from the toolbar. You may prefer this method.

Command Fast Find (Keyboard)

When the keyboard focus is on the I/O Capture List window, you can use the Command Fast Find feature. If you are looking for a certain command, you can simply start typing it in and busTRACE will automatically find and move to the next command match.

For example, if you are looking for a Test Unit Ready command, you simply start typing Test Unit Ready into the keyboard. With the very first letter pressed (i.e. 'T'), busTRACE will move to that next command that starts with 'T'. Typically you only need type in 1-2 letters before you find the command you're looking for.

This is an extremely fast method of finding a specific command. Note that this feature only finds the next I/O match. It does not search previous I/Os. If you are looking for previous I/Os, you would use the toolbar options described earlier.

Find I/O Counter

By press Ctrl+G, you can have a dialog box appear where you can type in an I/O Counter that you are searching for. For example, quickly need to jump to I/O #120? Press Ctrl+G, enter "120" at the prompt, and click on the OK button.

In addition, if you have configured the toolbar to finding commands in text mode (the default), you can also type in the I/O Counter value in the toolbar edit box (see above) and use the Find Next and Find Previous options to find the I/O Counter.

See Also: