Brocade Fabric OS Administrator's Guide Supporting Fabric OS v6.3.0 (53-1001336-02, November 2009)

392 Fabric OS Administrator’s Guide
53-1001336-02
Filter-based performance monitoring
17
To define a custom filter, you must specify a series of offsets, masks, and values. For all
transmitted frames, the switch performs these tasks:
• Locates the byte found in the frame at the specified offset.
• Applies the mask to the byte found in the frame.
• Compares the value with the given values in the perfAddUserMonitor command.
• Increments the filter counter if a match is found.
To illustrate, if you were to enter:
perfaddusermonitor 30 "4, 0xff, 0x06; 6, 0xff, 0x02; 7, 0xff, 0xd4"
the operation would be successful because offset 4 is a canned monitor and has a resource
already reserved for it. Offsets 6 and 7 would exhaust all unique filter monitor resources on port
30. Therefore, any additional filter monitors created on port 30 would have to be canned filter
monitors.
The number of different offsets per port depends on the switch platform, as follows:
• Brocade 4100, 4900, 5000, 5100, 5300, 7500, 7500E, 7600, 7800, 8000, 48000, Brocade
Encryption Switch, Brocade DCX, and DCX-4S platforms.
Up to 15 different offsets per port (14 offsets when FICON Management Server mode, or
fmsmode, is enabled).
• Brocade 300 platforms.
Up to 7 different offsets per port (6 offsets when fmsmode is enabled).
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 81.
If the switch does not have enough resources to create a given filter, then other filters might have to
be deleted to free resources.
Adding custom filter-based monitors
1. Connect to the switch and log in as admin.
2. Enter the perfAddUserMonitor command:
perfaddusermonitor [slotnumber/]portnumber "grouplist" [ alias ]
TABLE 81 Predefined values at offset 0
Value SOF Value SOF
0SOFf4SOFi2
1SOFc15SOFn2
2SOFi16SOFi3
3SOFn17SOFn3