Users Guide

Fabric OS Administrator’s Guide 559
53-1002920-02
Frame monitoring
23
Creating frame types to be monitored
In addition to the standard frame types, you can create custom frame types to gather statistics that
fit your needs. To define a custom frame type, you must specify a series of offsets, bitmasks, and
values. For all transmitted frames, the switch performs the following tasks:
• Locates the byte found in the frame at the specified offset.
• Applies the bitmask to the byte found in the frame.
• Compares the new value with the given value.
• Increments the filter counter if a match is found.
You can specify up to four values to compare against each offset. If more than one offset is
required to properly define a filter, the bytes found at each offset must match one of the given
values for the filter to increment its counter. If one or more of the given offsets does not match any
of the given values, the counter does not increment.
The value of the offset must be between 0 and 63, in decimal format. Byte 0 indicates the first byte
of the Start of Frame (SOF), byte 4 is the first byte of the frame header, and byte 28 is the first byte
of the payload. Thus, only the SOF, frame header, and first 36 bytes of payload can be selected as
part of a filter definition. Offset 0 is a special case, which can be used to monitor the first 4 bytes of
the frame (SOF). When the offset is set to 0, the values 0 through 7 that are checked against that
offset are predefined, as shown in Table 89.
Creating a frame monitor
1. Connect to the switch and log in using an account with admin permissions.
2. Enter the fmMonitor
--create command to create a user-defined frame.
Complete details of the fmMonitor command parameters are provided in the Fabric OS Command
Reference. The highth and action options set values and actions for Fabric Watch, but do not apply
to monitoring. To apply the custom values, use the thconfig
--apply command. Refer to the Fabric
Watch Administrator’s Guide for more information about using this command.
Example of creating a user-defined frame type
switch:admin> fmmonitor --create myframemonitor -pat
"17,0xFF,0x07;7,0x4F,0x01;" -action email
TABLE 89 Predefined values at offset 0
Value SOF
0SOFf
1SOFc1
2SOFi1
3SOFn1
4SOFi2
5SOFn2
6SOFi3
7SOFn3