HP StorageWorks 2/16V Brocade Fabric OS Command Reference Manual - Supporting - Page 443

perfAddUserMonitor 2 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. 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. 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. ValueList Specify 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 Fabric OS Command Reference Manual 411 53-1000436-01