Table Of Contents
Mapping Statistics to the Data Tables
IGX, BPX, MGX 8220, MGX 8230, MGX 8250, and MGX 8850 PXM1-Based Files
AXSM, AXSM-E, AXSM-XG, FRSM12, PXM1E, and SRM-E Files
AXSM, AXSM-E, FRSM-12, PXM1E, and SRM-E Formats
AXSM, AXSM-E, and FRSM-12 Key Formats
AUSM, CESM, FRSM Statistics Formats
BPX-SES Statistics File Formats
Bulk Statistics File Format
This appendix describes the formats of the statistics files collected from the nodes. These formats are necessary for users who parse the statistics files using an Operational Support System (OSS). The following topics are included:
•
Mapping Statistics to the Data Tables
•
IGX, BPX, MGX 8220, MGX 8230, MGX 8250, and MGX 8850 PXM1-Based Files
•
AXSM, AXSM-E, AXSM-XG, FRSM12, PXM1E, and SRM-E Files
•
AUSM, CESM, FRSM Statistics Formats
Mapping Statistics to the Data Tables
You can parse the statistics using the statsdb or stratacom database. Table F-1 provides the tables in the stratacom and statsdb databases for each statistic object type and subobject type.
Collection Process
Cisco WAN Manager (CWM) uses Trivial File Transfer Protocol (TFTP) to collect the statistics files from the following nodes:
•
Cisco IGX
•
Cisco BPX
•
Cisco MGX 8220
•
Cisco MGX 8230
•
Cisco MGX 8250
•
Cisco MGX 8850 PXM1-based
For the following nodes, the collection server uses File Transfer Protocol (FTP) to obtain the statistics files:
•
Cisco MGX 8830
•
Cisco MGX 8850 PXM1E and PXM45-based
•
Cisco MGX 8950
CWM issues a get request, and the node responds by transmitting the statistics via FTP or TFTP, in bulk, to a statistics collection file into the /usr/users/svplus/spool directory.
Once the transfer is complete, the file is moved to the /svplus/incoming/<coll svr> directory. From the incoming /<coll svr> directory, the file is read by a parser. After being parsed to the database, the file is transferred to the purge directory. This directory is selected through the Stats DB Host Configuration Dialog in SCM GUI.
In the /svplus/spool and /svplus/incoming/<coll svr> directories, the file has a transient existence from 1-5 minutes. The file is stored in the /svplus/purge directory (or any other directory selected for the purged files) for a period of time that the user selects from the Stats DB Configuration Dialog in SCMGUI (typically three days).
![]()
Note
For more information about SCM GUI, refer to the Cisco WAN Manager User's Guide Release 12.
IGX, BPX, MGX 8220, MGX 8230, MGX 8250, and MGX 8850 PXM1-Based Files
This section provides the file name convention and structure for the statistics files collected from the following nodes:
•
Cisco IGX
•
Cisco BPX
•
Cisco MGX 8220
•
Cisco MGX 8230
•
Cisco MGX 8250
•
Cisco MGX 8850 PXM1-based
File Name
Each statistics collection file received from a node is uniquely identified in CWM using the following file name format:
<node>.<timestamp in GMT[mmddyyyyHHMM]>-<parsermethod[0]>
![]()
Note
The file formats in CWM differ from those on the nodes. CWM appends the <node> and <parsermethod> to each of the files received from the nodes.
File Format
The format of the statistics collection file is shown in Table F-2. This file consists of a fixed-length header and a sequential string of statistics identified by their object type, subtype, and statistic type.
Table F-2 IGX, BPX, MGX 8220, MGX 8230, MGX 8250, and MGX 8850 PXM1-Based File Formats
Field Description Field Size Fixed Header SectionDomain number of node
1 byte
Node number
1 byte
Release number (for example, 725a for Release 7.2.5.a)
4 bytes
Node Type
1 byte
Status byte (for example, used for switch over)
2 bytes
Peak flag (1 = enabled, 0 = disabled)
1 byte
Bucket interval
1 byte
Number of object types
1 byte
Data Dependent SectionObject type identifier
1 byte
Number of object subtypes
1 byte
Object subtype identifier
1 byte
Number of instances of Key
2 bytes
Key instance
variable length1
Stat type count
1 byte
Stat type
1 byte
Number of buckets
1 byte
Stat value (reverse chronological order)
4 bytes
Peak value (1st bucket = file time stamp)
4 bytes
Repeat Stat type, Stat value, and Peak value for number of buckets
n bytes
Repeat Stat type count
n bytes
Repeat number of instances of Key
n bytes
Repeat Object Sub-type identifier section
n bytes
Repeat Object type section
n bytes
1 Key instance field size is based on the object subtype. For the keying information, see Table F-16.
The keying information for the statistics in this sections is listed in Table F-16.
Example F-1 shows a read-binary statistics file from a BPX (parsing method 0).
Example F-1 BPX Statistics File
Reading Binary Statistics File: tballbpx.042520020900-0Domain Number: 1Node Number: 2Release Number: 934NNode Type: 1Status Byte: 4Peak Flag: 0Bucket Interval: 15Number of Objects: 3----------------------------------------------------------------------------------------------------ObjectID: 0Number of SubObjects: 1--------------------------------------------------SubObjectID: 7 NumKeys: 15Key 1 = 1 Key 2 = 2 Key 3 = 15 Key 4 = 1117StatCount: 6StatType: 29NumBuckets: 1StatValue: 0.000000 StatType: 30NumBuckets: 1StatValue: 0.000000 StatType: 31NumBuckets: 1
NumBuckets: 1
StatValue: 0.000000 StatType: 32NumBuckets: 1StatValue: 0.000000 StatType: 38NumBuckets: 1StatValue: 0.000000 StatType: 41NumBuckets: 1StatValue: 0.000000 Key 1 = 1 Key 2 = 2 Key 3 =15 Key 4 = 384StatCount: 6StatType: 29NumBuckets: 1StatValue: 0.000000 StatType: 30NumBuckets: 1StatValue: 0.000000 StatType: 31NumBuckets: 1StatValue: 0.000000 StatType: 32NumBuckets: 1StatValue: 0.000000 StatType: 38NumBuckets: 1StatValue: 0.000000 StatType: 41NumBuckets: 1StatValue: 0.000000 Key 1 = 1 Key 2 = 6 Key 3 =51 Key 4 = 342StatCount: 6StatType: 29NumBuckets: 1StatValue: 0.000000 StatType: 30NumBuckets: 1StatValue: 0.000000 StatType: 31NumBuckets: 1StatValue: 0.000000 StatType: 32NumBuckets: 1StatValue: 0.000000 StatType: 38NumBuckets: 1StatValue: 0.000000 StatType: 41NumBuckets: 1StatValue: 0.000000 Key 1 = 1 Key 2 = 2 Key 3 =15 Key 4 = 399AXSM, AXSM-E, AXSM-XG, FRSM12, PXM1E, and SRM-E Files
This section contains the file formats for the following service modules:
•
AXSM, AXSM-E, AXSM-XG
•
FRSM12
•
PXM1E
•
SRM-E
File Types
The following types of statistics files are applicable to the service modules in this section:
•
General Statistics (GEN)—This file contains the following types of statistics:
–
Line
–
Trunk
–
Port
–
Card
–
IMA group and IMA link
•
Connection Statistics (CON)—This file contains statistics for SPVC and PVC connections.
•
PNNI Statistics (PNS)—This file contains PNNI network statistics.
For PXM1E cards, if connection, line, and PNNI connection statistics are selected, then all three files are collected. Different collection periods can occur for PNS files and old PXM1E statistics files.
Also, the PXM1E uses two statistics parsers. One parser is used for collecting statistics that are specific to the PXM1E card. The other parser is used to collect statistics that are specific to the node.
For PXM45 cards collecting PNNI statistics, only the PNNI file is collected.
File Names
Each statistic file type uses the following file naming conventions:
•
General statistics: <ShelfNum>-<SlotNum>-<GEN>-<DayMonthYearHrMin>
•
Connection statistics: <ShelfNum>-<SlotNum>-<CON>-<DayMonthYearHrMin>
•
PNNI network statistics: <ShelfNum>-<SlotNum>-<PNS>-<DayMonthYearHrMin>
Table F-3 describes each field in the file names.
File Formats
This section contains the file formats for each of the service modules.
AXSM, AXSM-E, FRSM-12, PXM1E, and SRM-E Formats
The file name format for the statistics files of the AXSM, AXSM-E, FRSM12, and PXM1E cards is
<node>-<shelf>-<slot>-Gen/Con-<timestamp in GMT>-<parsermethod>
The statistics file format for the SRM-E card is
<node>-<shelf>-<PXM slot(1/7)>-S07/S15/S31-<timestamp in GMT>-<parsermethod[5]>
Table F-4 provides the format of the AXSM, AXSM-E, FRSM-12, PXM1E, and SRM-E statistics files.
The keying information for these statistics in this sections is listed in Table F-16.
Example F-2 shows an AXSM general statistics read-binary file (parsing method 2).
Example F-2 AXSM General Statistics File
Reading Binary Statistics File: mgx885012-1-05-Gen-042620022215Parsing begins here .........FileVersion : 1BucketInterval : 15PeakInterval : 1****************************************************Stats Data Record Header 1Object : 3 , SubObject : 0StatCount : 22Key List Values :Shelf = 1 Slot = 5 Iftype = 1 Bay = 1 Line = 1***************************************************Stat Type : 0 Stat Value = 0 Peak Value = 0Stat Type : 1 Stat Value = 0 Peak Value = 0Stat Type : 2 Stat Value = 0 Peak Value = 0Stat Type : 3 Stat Value = 0 Peak Value = 0Stat Type : 4 Stat Value = 0 Peak Value = 0Stat Type : 6 Stat Value = 0 Peak Value = 0Stat Type : 7 Stat Value = 0 Peak Value = 0Stat Type : 8 Stat Value = 0 Peak Value = 0Stat Type : 9 Stat Value = 0 Peak Value = 0Stat Type : 10 Stat Value = 0 Peak Value = 0Stat Type : 11 Stat Value = 0 Peak Value = 0Stat Type : 12 Stat Value = 0 Peak Value = 0Stat Type : 13 Stat Value = 0 Peak Value = 0Stat Type : 14 Stat Value = 0 Peak Value = 0Stat Type : 15 Stat Value = 1100 Peak Value = 75****************************************************Stats Data Record Header 2Object : 3 , SubObject : 0StatCount : 22Key List Values :Shelf = 1 Slot = 5 Iftype = 1 Bay = 1 Line = 2***************************************************Stat Type : 0 Stat Value = 0 Peak Value = 0Stat Type : 1 Stat Value = 0 Peak Value = 0Stat Type : 2 Stat Value = 0 Peak Value = 0Stat Type : 3 Stat Value = 0 Peak Value = 0Stat Type : 4 Stat Value = 0 Peak Value = 0AXSM-XG and PNNI
The file name format for the AXSM-XG files is
<node>-<shelf>-<slot>-Gen/Atm-<timestamp in GMT>-<parsermethod [6]>
The file name format for the PNNI statistics files is
<node>-<shelf>-<slot>-PNS-<timestamp in GMT>-<parsermethod [6]>
Table F-5 describes the fields.
AXSM, AXSM-E, and FRSM-12 Key Formats
This section contains the Key formats for AXSM, AXSM-E, and FRSM-12 cards.
The Key field is 8 bytes with two bit arrays of 32 bits each. This format is used for each instance of a subobject.
Key field 0 contains an unsigned 32 bit integer interface index. Table F-6 describes the bits associated with Key field 0 on the AXSM, AXSM-E, and FRSM-12 cards.
Key field 1 contains an unsigned 32 bit integer VPI/VCI.
Table F-7 describes the bits associated with Key field 1 on the AXSM, AXSM-E and FRSM-12 cards.
Table F-7 AXSM, AXSM-E, and FRSM-12 Key Field 1
Bit Position DescriptionBit 31-16
VPI number
Bit 15-0
VCI number
Key field 1 values depend on the following type of statistics listed in Table F-8.
PXM1E Key Formats
This section contains the Key formats that are applicable to the PXM1E card on the Cisco MGX 8830 and Cisco MGX 8850 nodes.
Key field 0 contains an unsigned 32 bit integer interface index. Table F-9 describes the bits associated with Key field 0 for PXM1E cards.
Key field 1 contains an unsigned 32 bit integer VPI/VCI. Table F-10 describes the bits associated with Key field 1 for PXM1E cards.
SRM-E Key Formats
This section describes the Key formats that are applicable to the SRM-E card on the Cisco MGX 8830 and Cisco MGX 8850 (PXM1E).
Key field 0 contains an unsigned 32 bit integer interface index. Table F-11 describes the bits associated with Key field 0 on the SRM-E card.
![]()
Note
The SRM-E card does not use Key field 1.
![]()
Note
For SRM-E cards, the bay number is 1.
AUSM, CESM, FRSM Statistics Formats
The Cisco MGX 8830, Cisco MGX 8850 PXM1E and PXM45-based platforms contain the following service modules:
•
AUSM
•
CESM
•
FRSM
![]()
Note
Although the AUSM, CESM, and FRSM cards are also supported on PXM1-based nodes, the formats are different.
The following format applies to statistics files from the AUSM, CESM, and FRSM service modules.
<node>.<timestamp in GMT[mmddyyyyHHMM]>-<parsermethod[3]>
Table F-12 provides the format of the AUSM, CESM, and FRSM service module statistics files.
Table F-12 AUSM, CESM, and FRSM Statistics File Format
Field Description Field Size Fixed Header SectionDomain number of node
1 byte
Node number
1 byte
Release number (for example, 725a for Release 7.2.5.a)
4 bytes
Node type (for example, 23 is the node type for Cisco MGX 8830)
1 byte
Status byte (for example, used for switch over)
2 bytes
Peak flag (1 = enabled, 0 = disabled)
1 byte
Bucket interval
1 byte
Data Dependent SectionLength of data block
4 bytes
Number of object types
1 byte
Object type identifier
1 byte
Number of subobject types
1 byte
Object subtype identifier
1 byte
Number of instances of key
2 bytes
Key instance
variable length1
Stat type count
1 byte
Stat type
1 byte
Number of buckets
1 byte
Stat value (reverse chronological order)
4 bytes
Peak value (1st bucket = file time stamp)
4 bytes
Repeat Stat value and Peak value for number of buckets
n bytes
Repeat Object subtype identifier section
n bytes
Repeat Object type section
n bytes
Status of previous slot (0 = OK, 1 = Error)2
1 byte
Checksum
4 bytes
1 Key instance file size is based on the object subtype. For the keying information, see Table F-16.
2 The Status of previous slot field validates the structure of the data block. For example, a missing field indicates an error. This field does not validate the data.
2 The keying information for these statistics in this sections is listed in Table F-16.
2 Example F-3 shows read-binary statistics file from a PXM1E with an AUSM, FRSM, or CESM card (parsing method 3).
Example F-3 AUSM, CESM, FRSM Statistics
NbsmReadbinary Reading Binary Statistics File: tball-pxm1e-3.042520021545-3Domain Number: 1Node Number: 1Release Number: 0000Node Type: 23Status Byte: 0Peak Flag: 0Bucket Interval: 15----------------------------------------------------------------------------------------------------Length of Data Block: 22Number of Objects: 1*************************ObjectID: 0Number of SubObjects: 1--------------------------------------------------SubObjectID: 10 NumKeys: 1Key 1 = 1 Key 2 = 35StatCount: 2StatType: 71NumBuckets: 1StatValue: 0.000000 StatType: 72NumBuckets: 1StatValue: 614404.000000Status of previous slot data = 0 (GOOD)----------------------------------------------------------------------------------------------------Length of Data Block: 320Number of Objects: 3*************************BPX-SES Statistics File Formats
The file name format for the BPX-SES statistics files is
<node>-<shelf>-<slot>-SP<resourcepartition#>-<timestamp in GMT>-<parsermethod[1]>
Table F-13 provides the format of the BPX-SES statistics files.
Example F-4 shows a BPX-SES read-binary statistics file (parsing method 1).
Example F-4 BPX-SES Statistics File
BxmSpvcReadbinary is Reading Binary Statistics File: BPX-C3-0-02-SP1-042420022345-1Parsing begins here .........FileVersion : 2BucketInterval : 15PeakInterval : 5Object : 0SubObject : 7StatCount : 4StatId : 29StatId : 30StatId : 31StatId : 32****************************************************Stats Data Record Header 1Key List Values :Shelf = 0 Slot = 2 Logical Interface = 3 Vpi = 0 Vci = 6747***************************************************Stat Type : 29 Stat Value = 0 Peak Value = 0Stat Type : 30 Stat Value = 0 Peak Value = 0Stat Type : 31 Stat Value = 0 Peak Value = 0Stat Type : 32 Stat Value = 0 Peak Value = 0****************************************************Stats Data Record Header 2Key List Values :Shelf = 0 Slot = 2 Logical Interface = 3 Vpi = 0 Vci = 6745***************************************************Stat Type : 29 Stat Value = 0 Peak Value = 0Stat Type : 30 Stat Value = 0 Peak Value = 0Stat Type : 31 Stat Value = 0 Peak Value = 0Stat Type : 32 Stat Value = 0 Peak Value = 0****************************************************Key 0 is the interface index of the BXM. Table F-14 describes the bits associated with Key field 0 on the BXM card.
Table F-14 BXM Key Field 0
Bit Position DescriptionBit 31-24
Shelf number. This value is equal to 1.
Bit 23-16
Slot number.
Bit 15-9
Reserved.
Bit 8-0
Logical interface number.
Key field 1 is the connection ID. Table F-15 describes the bits associated with Key field 1 on the BXM card.
Object Subtype to Key List
Table F-16 depicts the keying information based upon object subtype.
![]()
Note
Unless noted, the key field size in Table F-16 is one byte.