Owner's manual

Advanced Performance Monitoring User’s Guide 3-5
Using Advanced Performance Monitoring
3
Use the perfSetPortEEMask to set a mask for end-to-end monitors. The command sets the mask
for all end-to-end monitors of a port, so that you can selectively choose the Fibre Channel frames in
which the number of words are to be counted.
The perfSetPortEEMask command sets a mask for the Domain ID, Area ID, and AL_PA of the
SIDs and DIDs for frames transmitted from and received by the port. Figure 3-3 shows the mask
positions in the command.
Figure 3-3 Mask Positions for End-to-end Monitors
In Figure 3-3, a mask (“ff”) is set on port 2 to compare the AL_PA fields on the SID and DID in all
frames (transmitted and received) on port 2. The Domain ID and Area ID fields in all frames are
ignored, as no mask is set on these fields.
For example, if you set the following monitor on a port:
perfAddEEMonitor 2, “0x051200”, “0x111eef”
then the frame SID must be “0x051200” and the frame DID must be “0x111eef” to trigger the
monitor.
If you set the mask shown in Figure 3-3, then the frame SID and DID must match only the AL_PA
portion of the specified SID-DID pair. That is, frames with SID of “0xnnnn00” and DID of
“0xnnnnef” trigger the monitor, where nnnn is any number.
Each port can have only one EE mask. The mask is applied to all end-to-end monitors on the port.
You cannot specify individual masks for each monitor on the port. If you define a new end-to-end
monitor on a port after you have created a mask for that port, the mask is automatically applied to
the new monitor.
The default EE mask value upon power-on is “ff:ff:ff” for everything—SID and DID on all
transmitted and received frames.
Example. The following commands add an end-to-end monitor to port 2, and then set a mask on
the SID and DID Domain ID of frames transmitted from port 2. After the mask is set, monitor 0
counts the number of words in incoming Fibre Channel frames that have an SID of 0x05nnnn and
DID of 0x11nnnn, where nnnn is any number.
perfSetPortEEMask 2, “00:00:ff”, “00:00:ff”, “00:00:ff”, “00:00:ff”
SID mask
DID mask
Transmitted from port Received by port
AL_PA mask
Area ID mask
Domain ID mask
SID mask DID mask
sw1:admin> perfAddEEMonitor 2, “0x051200”, “0x111eef”
End-to-End monitor number 0 added.
sw1:admin> perfSetPortEEMask 2, “00:00:00”, “00:00:00”,
“ff:00:00”, “ff:00:00”
The EE mask on port 2 is set and EE counters are reset.