390 Fabric OS Administrator’s Guide
53-1001763-02
Frame monitoring
17
For the perfMonitorShow and perfMonitorClear commands, the management of filter monitors is
provided through the fmConfig interface.While the legacy commands are still operational in the
Fabric OS v6.4.0 release, their use is incompatible with the new fmConfig command. Once you use
the fmConfig interface to configure and manage filter-based monitors, you can no longer use the
old commands.

Creating frame types to be monitored

In addition to the standard frame types, you can create custom frame types to gather statistics that
fit your needs. To define a custom frame type, you must specify a series of offsets, bitmasks, and
values. For all transmitted frames, the switch performs these tasks:
•Locates the byte found in the frame at the specified offset.
•Applies the bitmask to the byte found in the frame.
•Compares the new value with the given value.
•Increments the filter counter if a match is found.
You can specify up to four values to compare against each offset. If more than one offset is
required to properly define a filter, the bytes found at each offset must match one of the given
values for the filter to increment its counter. If one or more of the given offsets does not match any
of the given values, the counter does not increment. The value of the offset must be between 0 and
63, in decimal format. Byte 0 indicates the first byte of the Start of Frame (SOF), byte 4 is the first
byte of the frame header, and byte 28 is the first byte of the payload. Thus only the SOF, frame
header, and first 36 bytes of payload can be selected as part of a filter definition. Offset 0 is a
special case, which can be used to monitor the first 4 bytes of the frame (SOF). When the offset is
set to 0, the values 0–7 that are checked against that offset are predefined as shown in Table 84.
1. Connect to the switch and log in as admin.
2. Enter the fmConfig --create command to create a user-defined frame.
Complete details of the fmConfig command parameters are provided in the Fabric OS Command
Reference. The highth and action options set values and actions for Fabric Watch, but do not apply
monitoring. To apply the custom values, use the thconfig --apply command. See the Fabric Watch
Administrator’s Guide for more information about using this command.
Example of creating a user-defined frame type
switch:admin> fmconfig --create MyFrameMonitor -pat
"17,0xFF,0x07;7,0x4F,0x01;" -action email
Create Success :0
Example of creating a user-defined frame type and applying frame monitors to ports 3, 4, and 5
switch:admin> fmconfig --create MyFrameMonitor -pat
"17,0xFF,0x007;7,0x4F,0x01;" -port 3-5
Starting port :3 End port :5
Create Success :0
TABLE 84 Predefined values at offset 0
Value SOF Value SOF
0SOFf 4 SOFi2
1 SOFc1 5 SOFn2
2 SOFi1 6 SOFi3
3 SOFn1 7 SOFn3