Dell POWEREDGE M1000E User Manual

Page 600

568

Fabric OS Command Reference

53-1001764-02

perfAddUserMonitor

"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"

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:

SOFf

SOFc1

SOFi1

SOFn1

SOFi2

SOFn2

SOFi3

SOFn3

alias

Specifies a name for the monitor. Strings exceeding 10 characters are
truncated. To accommodate spaces, the string must be surrounded by
quotation marks. Spaces count toward the character limit but are removed.
This operand is optional. By default, the alias is an empty string.

Examples

To add a filter-based monitor for all Extended Link Service requests (R_CTL=0x22 and TYPE=0x01)
to a port:

switch:admin>

perfaddusermonitor 1/4 "4, 0xff, 0x22; 12, 0xff, 0x01"

User monitor #0 added

As a special case, to add a filter-based monitor for SOFi3 to a port:

switch:admin>

perfaddusermonitor 1/4 "0, 0xff, 6"

User monitor #1 added