Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)

2-396 Fabric OS Command Reference Manual
Publication Number: 53-1000240-01
perfAddUserMonitor
2
Note: Enter commands in lowercase only; mixed case is for readability.
perfAddUserMonitor
Adds a user-defined filter-based performance monitor.
Synopsis perfaddusermonitor [slotnumber/]portnumber "grouplist" [alias]
Description Use this command to define a custom filter for frame offsets and values.
For every offset, each group of comparison values is OR-ed together to determine a match. If there are
multiple offsets, each resulting OR function is AND-ed to determine if the entire statement is true, thus
incrementing the counter.
After a successful execution of this command, a monitor number is displayed. The monitor number is
provided for manipulation of these filter-based performance monitors. The optional user-defined alias is
also displayed, if one was specified. All valid monitor numbers and user-defined aliases can be retrieved
with the perfShowFilterMonitor command.
N
ote
This command requires a Brocade Advanced Performance Monitoring license.
This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE
ports.
Bloom-based platforms provide two unique unused offsets per port for user-defined filter monitors, other
than the six offsets already reserved for predefined filter monitors. Condor-based platforms provide 15
unused offsets per port.
N
ote
The execution of this command is subject to Admin Domain restrictions that may be in place.
Operands This command has the following operands:
slotnumber For bladed systems only, this operand specifies the slot number of the port on
which the monitor is to be added, followed by a slash (/).
portnumber Specifies the number of the port on which the monitor is to be added, relative to
its slot for bladed systems. Use switchShow for a list of valid ports.
"grouplist" Specify up to six sets of offset, mask, and ValueList, separated by semicolons (;).
The entire grouplist operand must be enclosed in quotation marks. For example:
"4, 0xff, 0x22; 12, 0xff, 0x01"
The grouplist component values are as follows:
Offset Specify the offset within the frame. Offset 0 is the first byte of the SOF,
and offset 4 is the first byte of the frame header. The offset must be in
decimal format. Valid values for offset are 0, [4-63]. Offset 0 is a special
case that can be used to monitor the first four bytes SOFx frames. EOF
cannot be monitored.
Mask Specify the mask value to be applied (AND-ed) to frame contents.