HP StorageWorks Fabric OS 5.0.0 Command Reference Guide (AA-RW1MA-TE, May 2005)

Fabric OS 5.0.0 command reference guide 379
Adds a user-defined filter-based performance monitor.
Synopsis
perfaddusermonitor [slotnumber/]portnumber “grouplist“ [alias]
Availability
admin
NOTE: This command requires a Performance Monitor license.
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.
The maximum number of filters is eight per port including user defined filters, read filters, write filters,
read/write filters, SCSI frame monitor, and IP frame monitor. In addition, there should be no more than six
different offsets for each filter and no more than four different values per offset defined by the user.
Operands
This command has the following operands:
perfAddUserMonitor
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.
This operand is required.
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.