Perfaddusermonitor - Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base Command Reference Manual

2

perfAddUserMonitor

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 evaluated using the Boolean OR operator to
determine a match. If there are multiple offsets, each resulting OR function is evaluated using the
AND operator to determine if the entire statement is true, thereby incrementing the counter.
Execution of this command displays a numeric key that uniquely identifies the monitor. Use the
perfMonitorShow command for a listing of valid keys and user-defined aliases.
Notes This command requires an Advanced Performance Monitoring license.
This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and
GbE ports.
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command
Availability" for details.
Operands This command has the following operands:
slotnumber
portnumber
"grouplist"
500
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 (/).
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.
Specifies 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 Specifies 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 Specifies the mask value to be applied (with the AND operator) to frame
contents.
ValueList Specifies up to four values that need to be captured from frame contents. The
ValueList can be either hexadecimal or decimal format.
SOFx frames are considered a special case. The Offset is specified as 0x0;
valueList values are specified with:
0 SOFf
1 SOFc1
2 SOFi1
3 SOFn1
Fabric OS Command Reference
53-1001186-01