Perfaddusermonitor - HP StorageWorks 8B - FC Entry Switch Reference Manual

1
Telnet Commands

perfAddUserMonitor

Add a user-defined filter-based monitor.
Synopsis
perfAddUserMonitor port, "grouplist" [, "alias"]
Availability
admin
Description
Use this command to define a special mechanism to qualify frames for statistics gathering to fit
your own special need.
Each group of elements with same offset will have their comparison result (OR-ed) together before
the combined result of each group get (AND-ed) together for final comparison result. If the final
result is logic 1, then the monitor counter will be increased by one.
After a successful execution of this command, a monitor number is displayed. The monitor number
is provided for easy 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 8 per port including user defined filters, read filters, write filters,
and read/write filters. In addition there should be no more than 6 different Offsets for each port and
no more than 4 different values per Offset defined by user.
Operands
This command has the following operands:
port
grouplist
1-148
Specify the port number where you want to add a user defined monitor. This
operand is required.
Specify up to 6 sets of Offset, Mask, and ValueList separated by a semicolon (;).
The entire grouplist operand must be enclosed in quotation marks. This operand
is required.
The grouplist operand must be specified in the following format:
"offset, Mask, ValueList; offset, Mask, ValueList"
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
which can be used to monitor the first 4 bytes SOFx frames. EOF can not be
monitored.
Mask - Specify the mask value to be applied (ANDed) 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.
Fabric OS Reference