Brocade Fabric OS Troubleshooting and Diagnostics Guide v6.2.0 (53-1001187-01, April 2009)

Fabric OS Troubleshooting and Diagnostics Guide 83
53-1001187-01
FTRACE concepts
10
Tracing every FICON event affects performance. To avoid this, the default trace mask is set to
0x80000C7b. The mask is a filter where a bit specifies which frames and events will be captured
and displayed. For troubleshooting, you should set the trace mask to 0-0xFFFFFFFF. The following
table describes the configurable FTRACE parameters.
After information is captured, you can use the portshow command to display FTRACE information
on a GE port for a tunnel. You can save trace events can for future analysis.
Displaying the trace for a tunnel
1. Log on to the switch as admin.
2. Enter the portShow ftrace <slot>/geX tunnelId stats command with the following options:
switch:admin> portshow ftrace ge0 1 stats
This displays the trace stats for the GE port 0 for tunnel 1.
NOTE
The configuration file includes key FCIP FTRACE configuration values. Configurations are stored on
a slot basis and not on blades, such as the FR4-18i. If the FR4-18i is swapped, the configuration
stays the same for the new FR4-18i corresponding to the slot they are plugged in.
When performing a configDownload, the FCIP configuration is applied to the switch only on a slot
power OFF or ON, for example slots containing the FR4-18i. The Brocade 7500, which is not slot
based, requires a reboot. See the Fabric OS Reference for more information on any of these
commands.
FTRACE is a support tool used primarily by your switch support provider. FTRACE includes the ability
to freeze traces on certain events, and to retain the trace information for future examination. The
syntax for the portCfg ftrace command is as follows:
portCfg ftrace [slot/]ge0|ge1 tunnel_Id cfg [-a 1|0] [-b value] [-e 1|0] [-i value] [-p value] [-r value]
[-s value] [-t value] [-z value]
Where:
slot The number of a slot in a 48000 or DCX director chassis that contains an
FC4-18i blade. This parameter does not apply to the stand-alone 7500.
ge0|ge1 The Ethernet port used by the tunnel (ge0 or Ge1).
tunnelid The tunnel number (0 - 7).
TABLE 14 FTRACE configurable parameters
Parameter Default Range Syntax
Auto check Out False T/F Boolean
Buffers 0 0-8 Integer
Display Mask 0xFFFFFFFF 0-0xFFFFFFFF Integer
Enable False T/F Boolean
Post Percentage 5 0-100 Integer
Trace Mask 0x8000 0-0xFFFFFFFF Integer
Trigger Mask 0x80000d7b 0-0xFFFFFFFF Integer