HP StorageWorks 1606 Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 568

2 perfAddUserMonitor perfAddUserMonitor Synopsis Adds a user-defined filter-based performance monitor. 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 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" 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" Offset Mask ValueList The grouplist component values are as follows: 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. Specifies the mask value to be applied (with the AND operator) to frame contents. 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 538 Fabric OS Command Reference 53-1001337-01