HP 8/80 Fabric OS Administrator's Guide v6.4.0 (53-1001763-01, June 2010) - Page 430

17 Frame monitoring For the perfMonitorShow and perfMonitorClear commands, the management of filter monitors is provided through the fmConfig interface.While the legacy commands are still operational in the Fabric OS v6.4.0 release, their use is incompatible with the new fmConfig command. Once you use the fmConfig interface to configure and manage filter-based monitors, you can no longer use the old commands. 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 these 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-7 that are checked against that offset are predefined as shown in Table 84. TABLE 84 Predefined values at offset 0 Value SOF Value SOF 0 SOFf 1 SOFc1 2 SOFi1 3 SOFn1 4 SOFi2 5 SOFn2 6 SOFi3 7 SOFn3 1. Connect to the switch and log in as admin. 2. Enter the fmConfig --create command to create a user-defined frame. Complete details of the fmConfig 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 monitoring. To apply the custom values, use the thconfig --apply command. See the Fabric Watch Administrator's Guide for more information about using this command. Example of creating a user-defined frame type switch:admin> fmconfig --create MyFrameMonitor -pat "17,0xFF,0x07;7,0x4F,0x01;" -action email Create Success :0 Example of creating a user-defined frame type and applying frame monitors to ports 3, 4, and 5 switch:admin> fmconfig --create MyFrameMonitor -pat "17,0xFF,0x007;7,0x4F,0x01;" -port 3-5 Starting port :3 End port :5 Create Success :0 390 Fabric OS Administrator's Guide 53-1001763-01