1-- *********************************************************************
2-- CISCO-WIRELESS-P2MP-RF-METRICS-MIB.my:  Cisco Wireless Radio Point to
3--                                         MultiPoint RF Metrics MIB.
4--
5-- November 1999, Allan Figueredo
6--
7-- Copyright (c) 1998-2000 by Cisco Systems, Inc.
8-- All rights reserved.
9--
10-- *********************************************************************
11--
12-- *********************************************************************
13--
14--
15-- 1.0 Glossary
16--
17-- The following terms are used in the MIB definitions below.
18--
19-- Radio Interface:   The interface that provides wireless communication
20--                    features.
21-- Radio Link:   The bi-directional wireless link that exists between
22--               two communicating radios.
23-- Radio PHY:    Represents the transmission characteristics of the
24--               Radio Link.
25-- RF Unit:      The Radio Frequency components and the associated
26--               antennas.
27--
28--
29--
30-- 2.0 Cisco Wireless RF Metrics MIB Organization
31--
32--
33--     This MIB contains information about the radio signal(s) that were
34--     received or attributes of the radio signals computed from
35--     received signals. This group models the real-time data that is
36--     collected.
37--
38--     The key characteristics are:
39--     1. The amount of information captured in these parameters is
40--        large and cannot be modeled as single values.
41--
42--     2. They represent real-time information, which cannot be polled
43--
44--     3. Hardware captures this information.
45--        Radio signal characteristics are modeled in three ways:
46--        1. Histogram
47--        2. Timelines
48--        3. Snapshots
49--
50--
51-- o.  History Group
52--        This group contains information about the radio system
53--        characteristics which are inherently modeled as histograms.
54--        Certain characteristics of the radio system may be captured
55--        as histograms by the hardware.
56--
57--        The user may configure these histograms as needed.
58--
59--        It exists for the following reasons:
60--
61--        1. The amount of information contained in these parameters is
62--           large and cannot be modeled as single values.
63--
64--        2. They represent real-time information, which cannot be
65--           polled for as well.
66--
67--        3. Key signal processing information cannot be captured by
68--           normal SNMP (say 1 sec poll interval) monitoring.
69--
70--        4. Hardware captures this information as histograms.
71--
72--        5. In wireless environments this is key information that needs
73--           to be captured for management.
74--
75-- o.  Timeline Group
76--        This group contains information about how raw radio signal
77--        characteristics that may be captured.  Timelines are normally
78--        associated with a threshold defined in the threshold group.
79--
80-- o.  Threshold Group
81--        This provides provides facilities to define thresholds
82--        on the raw signal attributes that are processed by the
83--        hardware. Normally thresholds are used in conjunction
84--        with Timelines to capture specific radio signal behavior.
85--
86-- o.  Snapshot Group
87--        This group provides facilities that may be used to capture
88--        multiple radio signal attributes keyed to a single user
89--        initiated trigger. Simultaneous capture of multiple real-time
90--        attributes keyed to a single trigger provides indepth
91--        information about the behavior of the system.
92--
93--
94--
95-- 3.0   MIB Definitions
96--
97--
98
99
100CISCO-WIRELESS-P2MP-RF-METRICS-MIB DEFINITIONS ::= BEGIN
101
102	IMPORTS
103	MODULE-IDENTITY, OBJECT-TYPE,
104	Integer32, NOTIFICATION-TYPE
105		FROM SNMPv2-SMI
106	RowStatus, TruthValue,
107	TimeInterval, MacAddress
108		FROM SNMPv2-TC
109	MODULE-COMPLIANCE, OBJECT-GROUP
110		FROM SNMPv2-CONF
111        ifIndex, OwnerString
112		FROM IF-MIB
113	CwrCollectionAction,
114	CwrCollectionStatus, CwrThreshLimitType,
115	P2mpRadioSignalAttribute,
116        CwrFixedPointScale, CwrFixedPointPrecision,
117        CwrFixedPointValue, P2mpSnapshotAttribute,
118        CwrUpdateTime
119		FROM CISCO-WIRELESS-TC-MIB
120	ciscoMgmt
121		FROM CISCO-SMI;
122
123	ciscoWirelessRfMetricsMIB MODULE-IDENTITY
124           LAST-UPDATED "200004191910Z"
125           ORGANIZATION "Cisco Systems Inc."
126           CONTACT-INFO
127	   "	Cisco Systems
128		Customer Service
129
130	   Postal: 170 W Tasman Drive
131		   San Jose, CA  95134
132		   USA
133
134		   Tel: +1 800 553-NETS
135	           E-mail: wireless-nms@cisco.com"
136            DESCRIPTION
137	        "This is the MIB Module for the Cisco Wireless Radio
138                 Point to MultiPoint interface specification."
139       ::= { ciscoMgmt 180}
140
141--
142-- The Cisco Wireless P2MP Radio RF Metrics MIB Tree
143--
144
145p2mpRadioHistoryGroup   OBJECT IDENTIFIER ::=
146                                         { ciscoWirelessRfMetricsMIB 1 }
147p2mpRadioTimelineGroup  OBJECT IDENTIFIER ::=
148                                         { ciscoWirelessRfMetricsMIB 2 }
149p2mpRadioThresholdGroup OBJECT IDENTIFIER ::=
150                                         { ciscoWirelessRfMetricsMIB 3 }
151p2mpRadioSnapshotGroup  OBJECT IDENTIFIER ::=
152                                         { ciscoWirelessRfMetricsMIB 4 }
153
154
155
156--
157-- p2mpRadioHistoryGroup.
158--
159-- The Histogram Table. This table contains information about the set of
160-- histograms that the hardware can be programmed to maintain.
161--
162-- These histograms are generated as follows :
163-- Radio signal data is sampled.
164-- Occurrences of values of the radio signal data is counted.
165-- This count is maintained as discrete sets. Each set represented by
166-- one bin.
167--
168-- Note that the raw radio signal data is not stored in the bins. It is
169-- the count of the occurrence of the radio signal sample that gets
170-- stored.
171--
172
173p2mpHistCtrlTable OBJECT-TYPE
174        SYNTAX SEQUENCE OF P2mpHistCtrlEntry
175        MAX-ACCESS not-accessible
176        STATUS current
177        DESCRIPTION
178        "This table contains information about histograms configured in
179	hardware."
180        ::= { p2mpRadioHistoryGroup 1 }
181
182p2mpHistCtrlEntry OBJECT-TYPE
183        SYNTAX P2mpHistCtrlEntry
184        MAX-ACCESS not-accessible
185        STATUS current
186        DESCRIPTION
187        "This represents one entry in the p2mpHistCtrlTable.  This table
188        is indexed by ifIndex, p2mpHistSuMacAddress, and p2mpHistClass.
189
190        At the head end:
191        Histograms can be created on each upstream channel either on a
192        per channel or per subscriber unit basis.
193
194        When histograms are created on a per subscriber unit basis, the
195        user must specify the subscriber unit's MAC address and the
196        ifIndex of the MAC layer (propDocsWirelessMaclayer) at the
197        head end.
198
199        When histograms are created on a per channel basis, the user
200        must set the MAC address to zero(00 00 00 00 00 00).  The
201        channel ID is specified by the ifIndex of the upstream channel.
202        Hence, when creating histograms on a per channel basis, the
203        ifIndex must be set to the ifIndex of the upstream channel
204        (propDocsWirelessUpstream) on which the histogram is to be
205        created.
206
207        At the subscriber end:
208        Histograms can only be created on the downstream channel.  Since
209        there is only one downstream channel, histograms cannot be
210        created per channel ID.  Hence, when a histogram is created, the
211        user must set the MAC address (p2mpHistSuMacAdress) to
212        zero(00 00 00 00 00 00).  The ifIndex must be set to the ifIndex
213        of the downstream channel (propDocsWirelessDownstream)."
214
215        INDEX { ifIndex, p2mpHistSuMacAddress, p2mpHistClass }
216        ::= { p2mpHistCtrlTable 1 }
217
218P2mpHistCtrlEntry ::= SEQUENCE {
219        p2mpHistSuMacAddress    MacAddress,
220        p2mpHistClass           P2mpRadioSignalAttribute,
221        p2mpHistSize            INTEGER,
222        p2mpHistSumScale        CwrFixedPointScale,
223        p2mpHistSumPrecision    CwrFixedPointPrecision,
224        p2mpStartBinValue       Integer32,
225        p2mpEndBinValue         Integer32,
226        p2mpCollDuration        CwrUpdateTime,
227        p2mpUpdateRate          CwrUpdateTime,
228        p2mpPeriodicSum         TruthValue,
229        p2mpHistOwner           OwnerString,
230        p2mpHistAction          CwrCollectionAction,
231        p2mpHistStatus          CwrCollectionStatus,
232        p2mpHistRowStatus       RowStatus
233        }
234
235p2mpHistSuMacAddress OBJECT-TYPE
236        SYNTAX MacAddress
237        MAX-ACCESS not-accessible
238        STATUS current
239        DESCRIPTION
240        "This object is used to index this table.
241        At the head end:
242           When a histogram is created on a per subscriber unit basis,
243           this object should reflect the MAC address of the subscriber
244           unit.
245           When a histogram is created on a per channel basis, this
246           object must be set to zero(00 00 00 00 00 00).
247        At the subscriber end:
248           When creating a histogram, this object must always be set to
249           zero (00 00 00 00 00 00)."
250        ::= { p2mpHistCtrlEntry 1 }
251
252p2mpHistClass OBJECT-TYPE
253        SYNTAX P2mpRadioSignalAttribute
254        MAX-ACCESS not-accessible
255        STATUS current
256        DESCRIPTION
257        "This objects used to index this table.  It represents the
258         attribute that is being histogrammed."
259        ::= { p2mpHistCtrlEntry 2 }
260
261p2mpHistSize OBJECT-TYPE
262        SYNTAX INTEGER {
263                  fine(1),
264                  coarse(2)
265               }
266        MAX-ACCESS read-create
267        STATUS current
268        DESCRIPTION
269        "This object lets the user select the granularity of the
270        histogram. The number of bins used for the capture in
271        each category is hardware dependent."
272        ::= { p2mpHistCtrlEntry 3 }
273
274p2mpHistSumScale OBJECT-TYPE
275        SYNTAX        CwrFixedPointScale
276        MAX-ACCESS    read-only
277        STATUS        current
278        DESCRIPTION
279        "This variable indicates the exponent to apply to the
280        fixed-point values in the histogram summary table."
281        ::= { p2mpHistCtrlEntry 4 }
282
283p2mpHistSumPrecision OBJECT-TYPE
284        SYNTAX        CwrFixedPointPrecision
285        MAX-ACCESS    read-only
286        STATUS        current
287        DESCRIPTION
288        "This variable indicates the number of decimal places used for
289        precision when interpreting the fixed-point values in the
290        histogram summary table."
291        ::= { p2mpHistCtrlEntry 5 }
292
293p2mpStartBinValue OBJECT-TYPE
294        SYNTAX Integer32 (-2147483647..2147483647)
295        MAX-ACCESS read-create
296        STATUS current
297        DESCRIPTION
298        "This object represents the maximum of the values that will be
299        collected in the first bin of the histogram.
300        All values <= p2mpStartBinValue are kept in the first histogram
301        bin."
302        ::= { p2mpHistCtrlEntry 6 }
303
304p2mpEndBinValue OBJECT-TYPE
305        SYNTAX Integer32 (-2147483647..2147483647)
306        MAX-ACCESS read-create
307        STATUS current
308        DESCRIPTION
309        "This object represents the minimum of the values that will be
310        collected in the last bin of the histogram.
311        All values >= p2mpEndBinValue are kept in the last histogram
312        bin."
313        ::= { p2mpHistCtrlEntry 7 }
314
315p2mpCollDuration OBJECT-TYPE
316        SYNTAX CwrUpdateTime
317        UNITS "seconds"
318        MAX-ACCESS read-create
319        STATUS current
320        DESCRIPTION
321        "This object specifies the duration for which this histogram
322        must be accumulated. After successfully accumulating data for
323        this amount of time the collection stops and the p2mpHistStatus
324        changes to statusCaptured."
325        ::= { p2mpHistCtrlEntry 8 }
326
327p2mpUpdateRate OBJECT-TYPE
328        SYNTAX CwrUpdateTime
329        UNITS "seconds"
330        MAX-ACCESS read-create
331        STATUS current
332        DESCRIPTION
333        "This object represents rate at which snapshots of the histogram
334        will be available."
335        ::= { p2mpHistCtrlEntry 9 }
336
337p2mpPeriodicSum OBJECT-TYPE
338        SYNTAX TruthValue
339        MAX-ACCESS read-create
340        STATUS current
341        DESCRIPTION
342        "The histogram data is updated every p2mpUpdateRate seconds.
343        When set to true(1), the latest histogram data set is summed
344        with the previous histogram data set and the
345        p2mpHistSummaryTable will reflect cumulative values.
346
347        When set to false(2), only the latest data set is made available
348        and the p2mpHistSummarytable will reflect the latest values."
349        ::= { p2mpHistCtrlEntry 10 }
350
351p2mpHistOwner OBJECT-TYPE
352        SYNTAX OwnerString
353        MAX-ACCESS read-create
354        STATUS current
355        DESCRIPTION
356	"This object identifies management station that created this
357	histogram specification."
358        ::= { p2mpHistCtrlEntry 11 }
359
360p2mpHistAction OBJECT-TYPE
361        SYNTAX CwrCollectionAction
362        MAX-ACCESS read-create
363        STATUS current
364        DESCRIPTION
365        "This object represents the action to be carried out on this
366        histogram specification. If a histogram has been successfully
367        captured then it must be cleared before an other capture
368        may be initiated."
369        ::= { p2mpHistCtrlEntry 12 }
370
371p2mpHistStatus OBJECT-TYPE
372        SYNTAX CwrCollectionStatus
373        MAX-ACCESS read-only
374        STATUS current
375        DESCRIPTION
376        "This object represents the current state of this histogram.
377        Once the histogram collection is complete the status changes to
378        statusCaptured and the data is available for use.
379        None of the parameters of a histogram specification may be
380        modified when the specification is in statusInProgress.
381
382        A statusCaptured or statusStopped histogram must be
383        actionClear'ed before it can be restarted.
384
385        The histogram may be read accurately between the p2mpUpdateRate
386        intervals. If the read spans across the update time data from
387        the previous and current updates can be mingled."
388        ::= { p2mpHistCtrlEntry 13 }
389
390p2mpHistRowStatus OBJECT-TYPE
391        SYNTAX RowStatus
392        MAX-ACCESS read-create
393        STATUS current
394        DESCRIPTION
395        "This object may be used to create or delete a histogram control
396        specification."
397        ::= { p2mpHistCtrlEntry 14 }
398
399--
400--      The Histogram Summary Table. This table contains summary Data
401--	about the histograms collected as per the specifications in the
402--	p2mpHistCtrlTable.
403--
404--      This table MUST be supported on the head end and at the
405--      subscriber unit if the p2mpHistCtrlTable is supported.
406
407p2mpHistSummaryTable OBJECT-TYPE
408        SYNTAX SEQUENCE OF P2mpHistSummaryEntry
409        MAX-ACCESS not-accessible
410        STATUS current
411        DESCRIPTION
412        "This table contains histogram Summary collected based on the
413        specifications in the p2mpHistCtrlTable."
414        ::= { p2mpRadioHistoryGroup 2 }
415
416p2mpHistSummaryEntry OBJECT-TYPE
417        SYNTAX P2mpHistSummaryEntry
418        MAX-ACCESS not-accessible
419        STATUS current
420        DESCRIPTION
421        "This represents one entry in the p2mpHistSummaryTable.
422
423        At the head end:
424        When viewing the summary of a histogram that was created for a
425        specific subscriber unit, the user must specify the subscriber
426        unit's MAC address and the ifIndex of the MAC layer at the
427        head end.
428        When viewing the summary of a histogram created for a specific
429        channel, the user must set the MAC address to zero
430        (00 00 00 00 00 00).  The ifIndex is the upstream channel on
431        which the histogram was created.
432
433        At the subscriber end:
434        The user sets the MAC address (p2mpHistSuMacAdress) to
435        zero(00 00 00 00 00 00). The ifIndex is the channel ID of the
436        downstream channel."
437
438        INDEX { ifIndex, p2mpHistSuMacAddress, p2mpHistClass }
439        ::= { p2mpHistSummaryTable 1 }
440
441        P2mpHistSummaryEntry ::= SEQUENCE {
442        p2mpHistUpdateTime   CwrUpdateTime,
443        p2mpHistMin          CwrFixedPointValue,
444        p2mpHistMax          CwrFixedPointValue,
445        p2mpHistMean         CwrFixedPointValue
446        }
447
448p2mpHistUpdateTime OBJECT-TYPE
449        SYNTAX CwrUpdateTime
450        UNITS "seconds"
451        MAX-ACCESS read-only
452        STATUS current
453        DESCRIPTION
454        "This object represents the sysUpTime when this histogram
455        was retrieved from hardware."
456        ::= { p2mpHistSummaryEntry 1 }
457
458p2mpHistMin OBJECT-TYPE
459        SYNTAX CwrFixedPointValue
460        MAX-ACCESS read-only
461        STATUS current
462        DESCRIPTION
463        "This object represents minimum value seen in this histogram."
464        ::= { p2mpHistSummaryEntry 2 }
465
466p2mpHistMax OBJECT-TYPE
467        SYNTAX CwrFixedPointValue
468        MAX-ACCESS read-only
469        STATUS current
470        DESCRIPTION
471        "This object represents maximum value seen in this histogram."
472        ::= { p2mpHistSummaryEntry 3 }
473
474p2mpHistMean OBJECT-TYPE
475        SYNTAX CwrFixedPointValue
476        MAX-ACCESS read-only
477        STATUS current
478        DESCRIPTION
479        "This object represents mean of the values in this histogram."
480        ::= { p2mpHistSummaryEntry 4 }
481
482--
483--      The Histogram Data Table. This table contains the Data
484--	about the histograms collected as per the specifications in the
485--	p2mpHistCtrlTable.
486--
487--      This table MUST be supported on the head end and at the
488--      subscriber unit if the p2mpHistCtrlTable is supported.
489
490p2mpHistDataTable OBJECT-TYPE
491        SYNTAX SEQUENCE OF P2mpHistDataEntry
492        MAX-ACCESS not-accessible
493        STATUS current
494        DESCRIPTION
495        "This table contains histogram values collected based on the
496        specifications in the p2mpHistCtrlTable."
497        ::= { p2mpRadioHistoryGroup 3 }
498
499p2mpHistDataEntry OBJECT-TYPE
500        SYNTAX P2mpHistDataEntry
501        MAX-ACCESS not-accessible
502        STATUS current
503        DESCRIPTION
504        "This represents one entry in the p2mpHistDataTable.
505
506        At the head end:
507        When viewing the data of a histogram that was created for a
508        specific subscriber unit, the user must specify the subscriber
509        unit's MAC address and the ifIndex of the MAC layer at the
510        head end.
511        When viewing the data of a histogram created for a specific
512        channel, the user must set the MAC address to zero
513        (00 00 00 00 00 00).  The ifIndex is the upstream channel on
514        which the histogram was created.
515
516        At the subscriber end:
517        The user sets the MAC address (p2mpHistSuMacAdress) to
518        zero(00 00 00 00 00 00). The ifIndex is the channel ID of the
519        downstream channel."
520
521        INDEX {ifIndex, p2mpHistSuMacAddress, p2mpHistClass,
522               p2mpHistBinIndex }
523        ::= { p2mpHistDataTable 1 }
524
525        P2mpHistDataEntry ::= SEQUENCE {
526        p2mpHistBinIndex     Integer32,
527        p2mpValue            Integer32
528        }
529
530p2mpHistBinIndex OBJECT-TYPE
531        SYNTAX Integer32(1..50)
532        MAX-ACCESS not-accessible
533        STATUS current
534        DESCRIPTION
535        "This object represents the histogram bin number for the value
536        in p2mpValue."
537        ::= { p2mpHistDataEntry 1 }
538
539p2mpValue OBJECT-TYPE
540        SYNTAX Integer32 (0..2147483647)
541        MAX-ACCESS read-only
542        STATUS current
543        DESCRIPTION
544        "This object represents the value in the histogram bin
545        p2mpHistBinIndex."
546        ::= { p2mpHistDataEntry 2 }
547
548--
549-- The Timeline Group.
550--
551-- This group includes the following tables:
552-- p2mpTlCtrlTable, p2mpTlSummaryTable and p2mpTlDataTable.
553--
554-- A radio timeline is raw radio signal data captured based on the
555-- specifications.
556
557p2mpTlCtrlTable OBJECT-TYPE
558        SYNTAX SEQUENCE OF P2mpTlCtrlEntry
559        MAX-ACCESS not-accessible
560        STATUS current
561        DESCRIPTION
562        "This table contains information about timelines configured in
563        hardware. When radio signal data is collected it will be stored
564        in a buffer of size p2mpTlNumDataValues which may be later
565        retrieved."
566        ::= { p2mpRadioTimelineGroup 1 }
567
568p2mpTlCtrlEntry OBJECT-TYPE
569        SYNTAX P2mpTlCtrlEntry
570        MAX-ACCESS not-accessible
571        STATUS current
572        DESCRIPTION
573        "This represents one entry in the p2mpTlCtrlTable.  This table
574        is indexed by ifIndex, p2mpTlSuMacAddress, and p2mpTlClass.
575
576        At the head end:
577        Timelines can be created on each upstream channel either on a
578        per channel or per subscriber unit basis.
579
580        When timelines are created on a per subscriber unit basis, the
581        user must specify the subscriber unit's MAC address and the
582        ifIndex of the MAC layer (propDocsWirelessMaclayer) at the
583        head end.
584
585        When timelines are created on a per channel basis, the user
586        must set the MAC address to zero(00 00 00 00 00 00).  The channel
587        ID is specified by the ifIndex of the upstream channel.  Hence,
588        when creating timelines on a per channel basis, the ifIndex must
589        be set to the ifIndex of the upstream channel on which the
590        timeline is to be created
591
592        At the subscriber end:
593        Timelines can only be created on the downstream channel.  Since
594        there is only one downstream channel, timelines cannot be
595        created per channel ID.  Hence, when a timeline is created, the
596        user must set the MAC address (p2mpTlSuMacAdress) to
597        zero(00 00 00 00 00 00).  The ifIndex must be set to the ifIndex
598        of the downstream channel (propDocsWirelessDownstream)."
599
600        INDEX { ifIndex, p2mpTlSuMacAddress, p2mpTlClass}
601        ::= { p2mpTlCtrlTable 1 }
602
603P2mpTlCtrlEntry ::= SEQUENCE {
604        p2mpTlSuMacAddress       MacAddress,
605        p2mpTlClass              P2mpRadioSignalAttribute,
606        p2mpTlThreshAttribute    P2mpRadioSignalAttribute,
607        p2mpTlThreshType         CwrThreshLimitType,
608        p2mpTlNumDataValues      Integer32,
609        p2mpTlDataScale          CwrFixedPointScale,
610        p2mpTlDataPrecision      CwrFixedPointPrecision,
611        p2mpTlSamplePeriod       Integer32,
612        p2mpTlAction             CwrCollectionAction,
613        p2mpTlPostTrigBufMgmt    INTEGER,
614        p2mpTlOwner              OwnerString,
615        p2mpTlStatus             CwrCollectionStatus,
616        p2mpTlRowStatus          RowStatus
617        }
618
619p2mpTlSuMacAddress OBJECT-TYPE
620        SYNTAX MacAddress
621        MAX-ACCESS not-accessible
622        STATUS current
623        DESCRIPTION
624        "This object is used to index this table.
625        At the head end:
626           When a timeline is created on a per subscriber unit basis,
627           this object should reflect the MAC address of the subscriber
628           unit.
629           When a timeline is created on a per channel basis, this object
630           must be set to zero(00 00 00 00 00 00).
631
632        At the subscriber end:
633           When creating a timeline, this object must always be set to
634           zero (00 00 00 00 00 00)."
635        ::= { p2mpTlCtrlEntry 1 }
636
637p2mpTlClass OBJECT-TYPE
638        SYNTAX P2mpRadioSignalAttribute
639        MAX-ACCESS not-accessible
640        STATUS current
641        DESCRIPTION
642        "This object represents the attribute for which a timline capture
643        is requested.
644        When a timeline is requested p2mpBufSize worth of data will be
645        captured."
646        ::= { p2mpTlCtrlEntry 2 }
647
648p2mpTlThreshAttribute OBJECT-TYPE
649        SYNTAX  P2mpRadioSignalAttribute
650        MAX-ACCESS read-create
651        STATUS current
652        DESCRIPTION
653        "This object, along with p2mpTlThreshType, identifies the
654        threshold in the p2mpThresholdTable responsible for trigerring
655        this timeline. When this object's value is none(0), it implies
656        that there is no threshold associated with this timeline."
657        ::= { p2mpTlCtrlEntry 3 }
658
659p2mpTlThreshType OBJECT-TYPE
660        SYNTAX CwrThreshLimitType
661        MAX-ACCESS read-create
662        STATUS current
663        DESCRIPTION
664        "This object, along with p2mpTlThreshAttribute, identifies the
665        threshold in the p2mpThresholdTable responsible for trigerring
666        this timeline.  When this object's value is none(0), it implies
667        that there is no threshold associated with this timeline."
668        ::= { p2mpTlCtrlEntry 4 }
669
670p2mpTlNumDataValues OBJECT-TYPE
671        SYNTAX Integer32(1..2147483647)
672        UNITS "number of data values"
673        MAX-ACCESS read-create
674        STATUS current
675        DESCRIPTION
676        "This object indicates the number of data values to be captured
677        for this timeline.  The captured data can be viewed by reading
678        the p2mpTlDataTable."
679        ::= { p2mpTlCtrlEntry 5 }
680
681p2mpTlDataScale OBJECT-TYPE
682        SYNTAX        CwrFixedPointScale
683        MAX-ACCESS    read-only
684        STATUS        current
685        DESCRIPTION
686        "This variable indicates the exponent to apply to the
687        fixed-point values in the timeline data table."
688        ::= { p2mpTlCtrlEntry 6 }
689
690p2mpTlDataPrecision OBJECT-TYPE
691        SYNTAX        CwrFixedPointPrecision
692        MAX-ACCESS    read-only
693        STATUS        current
694        DESCRIPTION
695        "This variable indicates the number of decimal places used for
696        precision when interpreting the fixed-point values in the
697        timeline data table."
698        ::= { p2mpTlCtrlEntry 7 }
699
700p2mpTlSamplePeriod OBJECT-TYPE
701        SYNTAX Integer32(0..2147483647)
702	UNITS "milliseconds"
703        MAX-ACCESS read-create
704        STATUS current
705        DESCRIPTION
706        "This lets the user specify the time in milliseconds between
707        consecutive timeline samples.
708        The special value of '0' indicates that the timeline will be
709        sampled on every burst of data.  The number of bursts in one
710        milliseconds depends on the modulation profile."
711        ::= { p2mpTlCtrlEntry 8 }
712
713p2mpTlAction OBJECT-TYPE
714        SYNTAX CwrCollectionAction
715        MAX-ACCESS read-create
716        STATUS current
717        DESCRIPTION
718        "This object represents the action to be carried out on this
719        timeline specification. If a timeline has been successfully
720        captured then it must be cleared before another capture
721        may be initiated."
722        ::= { p2mpTlCtrlEntry 9 }
723
724p2mpTlPostTrigBufMgmt OBJECT-TYPE
725        SYNTAX INTEGER {
726                preTrigger(1),
727                postTrigger(2)
728        }
729        MAX-ACCESS read-create
730        STATUS current
731        DESCRIPTION
732        "Once a trigger fires, this object determines which portion of
733        the collected data to capture for use. If it is:
734        preTrigger(1) : Then most of the data collected prior to trigger
735                        is captured.
736        postTrigger(2): Then most of the data collected after the trigger
737                        is captured."
738        ::= { p2mpTlCtrlEntry 10 }
739
740p2mpTlOwner OBJECT-TYPE
741        SYNTAX OwnerString
742        MAX-ACCESS read-create
743        STATUS current
744        DESCRIPTION
745	"This object identifies the management station that created this
746	timeline specification."
747        ::= { p2mpTlCtrlEntry 11 }
748
749p2mpTlStatus OBJECT-TYPE
750        SYNTAX CwrCollectionStatus
751        MAX-ACCESS read-only
752        STATUS current
753        DESCRIPTION
754        "This object represents the current state of this timeline.
755        Once the timeline collection is complete the status changes to
756        statusCaptured and the data is available for use.
757        None of the parameters of a timeline specification may be
758        modified when the specification is in statusInProgress.
759
760        A statusCaptured or statusStopped timeline must be actionClear'ed
761        before it can be restarted."
762        ::= { p2mpTlCtrlEntry 12 }
763
764p2mpTlRowStatus OBJECT-TYPE
765        SYNTAX RowStatus
766        MAX-ACCESS read-create
767        STATUS current
768        DESCRIPTION
769        "This object may be used to create or delete a timeline control
770        specification.  Once created data sampling starts based on the
771        value of p2mpTlAction."
772        ::= { p2mpTlCtrlEntry 13 }
773
774
775--
776--      The Timeline Summary Table. This table contains summary Data
777--      about the timeline collected as per the specifications in the
778--      p2mpTlCtrlTable.
779--
780
781p2mpTlSummaryTable OBJECT-TYPE
782        SYNTAX SEQUENCE OF P2mpTlSummaryEntry
783        MAX-ACCESS not-accessible
784        STATUS current
785        DESCRIPTION
786        "This table contains Timeline Summary collected based on the
787        specifications in the p2mpTlCtrlTable."
788        ::= { p2mpRadioTimelineGroup 2 }
789
790p2mpTlSummaryEntry OBJECT-TYPE
791        SYNTAX P2mpTlSummaryEntry
792        MAX-ACCESS not-accessible
793        STATUS current
794        DESCRIPTION
795        "This represents one entry in the p2mpTlSummaryTable.
796
797        At the head end:
798        When viewing the summary of a timeline created for a specific
799        subscriber unit, the user must specify the subscriber unit's
800        MAC address and the ifIndex of the MAC layer at the head end.
801        When viewing the summary of a timeline created for a specific
802        channel, the user must set the MAC address to
803        zero(00 00 00 00 00 00).  The ifIndex is the upstream channel on
804        which the timeline was created.
805
806        At the subscriber end:
807        The user sets the MAC address (p2mpTlSuMacAdress) to
808        zero(00 00 00 00 00 00). The ifIndex is the channel ID of the
809        downstream channel."
810
811        INDEX { ifIndex, p2mpTlSuMacAddress, p2mpTlClass}
812        ::= { p2mpTlSummaryTable 1 }
813
814P2mpTlSummaryEntry ::= SEQUENCE {
815        p2mpTlUpdateTime         CwrUpdateTime,
816        p2mpTlNumValues          Integer32,
817        p2mpTlTriggerLoc         Integer32
818        }
819
820p2mpTlUpdateTime OBJECT-TYPE
821        SYNTAX CwrUpdateTime
822        UNITS "seconds"
823        MAX-ACCESS read-only
824        STATUS current
825        DESCRIPTION
826        "This object represents the sysUpTime when this timeline
827        capture was completed."
828        ::= { p2mpTlSummaryEntry 1 }
829
830p2mpTlNumValues OBJECT-TYPE
831        SYNTAX Integer32 (0..2147483647)
832        MAX-ACCESS read-only
833        STATUS current
834        DESCRIPTION
835        "This object represents the number of values available in the
836        timeline"
837        ::= { p2mpTlSummaryEntry 2 }
838
839p2mpTlTriggerLoc OBJECT-TYPE
840        SYNTAX Integer32 (0..2147483647)
841        MAX-ACCESS read-only
842        STATUS current
843        DESCRIPTION
844        "This object contains the value of p2mpTlValueIndex which
845        represents the entry in the p2mpTlDataTable that caused the stop
846        trigger to fire, thereby resulting in this timeline to be
847        collected."
848        ::= { p2mpTlSummaryEntry 3 }
849
850
851--
852--      The Timeline Data Table. This table contains the Data
853--      about the timelines collected as per the specifications in the
854--      p2mpTlCtrlTable.
855--
856
857p2mpTlDataTable OBJECT-TYPE
858        SYNTAX SEQUENCE OF P2mpTlDataEntry
859        MAX-ACCESS not-accessible
860        STATUS current
861        DESCRIPTION
862        "This table contains timeline values collected based on the
863        specifications in the p2mpTlCtrlTable."
864        ::= { p2mpRadioTimelineGroup 3 }
865
866p2mpTlDataEntry OBJECT-TYPE
867        SYNTAX P2mpTlDataEntry
868        MAX-ACCESS not-accessible
869        STATUS current
870        DESCRIPTION
871        "This represents one entry in the p2mpTlDataTable.
872
873        At the head end:
874        When viewing the data of a timeline created for a specific
875        subscriber unit, the user must specify the subscriber unit's
876        MAC address and the ifIndex of the MAC layer at the head end.
877
878        When viewing the data of a timeline created for a specific
879        channel, the user must set the MAC address to
880        zero(00 00 00 00 00 00).  The ifIndex is the upstream channel
881        on which the timeline was created.
882
883        At the subscriber end:
884        The user sets the MAC address (p2mpTlSuMacAdress) to
885        zero(00 00 00 00 00 00). The ifIndex is the channel ID of the
886        downstream channel."
887
888        INDEX { ifIndex, p2mpTlSuMacAddress, p2mpTlClass, p2mpTlValueIndex}
889        ::= { p2mpTlDataTable 1 }
890
891P2mpTlDataEntry ::= SEQUENCE {
892        p2mpTlValueIndex         Integer32,
893        p2mpTlValue              CwrFixedPointValue
894        }
895
896p2mpTlValueIndex OBJECT-TYPE
897        SYNTAX Integer32 (1..2147483647)
898        MAX-ACCESS not-accessible
899        STATUS current
900        DESCRIPTION
901        "This object is the index into the timeline data."
902        ::= { p2mpTlDataEntry 1 }
903
904p2mpTlValue OBJECT-TYPE
905        SYNTAX CwrFixedPointValue
906        MAX-ACCESS read-only
907        STATUS current
908        DESCRIPTION
909        "This object represents the radio signal data sampled."
910        ::= { p2mpTlDataEntry 2 }
911
912
913--
914-- The Threshold table. This table enables the user to define thresholds.
915--
916
917p2mpThresholdTable OBJECT-TYPE
918        SYNTAX SEQUENCE OF P2mpThresholdEntry
919        MAX-ACCESS not-accessible
920        STATUS current
921        DESCRIPTION
922        "This table enables the user to establish thresholds for the
923        radio signals analyzed on the radio interface."
924        ::= { p2mpRadioThresholdGroup 1 }
925
926
927p2mpThresholdEntry OBJECT-TYPE
928        SYNTAX P2mpThresholdEntry
929        MAX-ACCESS not-accessible
930        STATUS current
931        DESCRIPTION
932        "This represents one entry in the p2mpThresholdTable.
933
934        At the head end:
935        Thresholds can be created on each upstream channel either on a
936        per channel or per subscriber unit basis.
937
938        When creating thresholds on a per subscriber unit basis, the
939        user must specify the subscriber unit's MAC address and the
940        ifIndex of the MAC layer (propDocsWirelessMaclayer) at the
941        head end.
942
943        When creating thresholds on a per channel basis, the user
944        must set the MAC address to zero(00 00 00 00 00 00).  The channel
945        ID is specified by the ifIndex of the upstream channel.  Hence,
946        when creating thresholds on a per channel basis, the ifIndex must
947        be set to the ifIndex of the upstream channel
948        (propDocsWirelessUpstream) on which the threshold is created.
949
950        At the subscriber end:
951        Thresholds can only be created on the downstream channel.  Since
952        there is only one downstream channel, thresholds cannot be
953        created per channel ID.  Hence, when a thresholds is created, the
954        users sets the MAC address (p2mpThreshSuMacAdress) to
955        zero(00 00 00 00 00 00).  The ifIndex must be set to the ifIndex
956        of the downstream channel (propDocsWirelessDownstream)."
957
958        INDEX {ifIndex,p2mpThreshSuMacAddr,p2mpThreshAttribute,p2mpThreshType}
959        ::= { p2mpThresholdTable 1 }
960
961P2mpThresholdEntry ::= SEQUENCE {
962	p2mpThreshSuMacAddr          MacAddress,
963        p2mpThreshAttribute          P2mpRadioSignalAttribute,
964        p2mpThreshType               CwrThreshLimitType,
965        p2mpThreshValue              Integer32,
966        p2mpThreshHysteresisTime     TimeInterval,
967        p2mpThreshLimitTime          TimeInterval,
968        p2mpThreshRowStatus          RowStatus
969        }
970
971p2mpThreshSuMacAddr    OBJECT-TYPE
972        SYNTAX MacAddress
973        MAX-ACCESS not-accessible
974        STATUS current
975        DESCRIPTION
976        "This object is used to index this table.
977
978        At the head end:
979           When a threshold is created on a per subscriber unit basis,
980           this object should reflect the MAC address of the subscriber
981           unit.
982           When a threshold is created on a per channel basis, this
983           object must be set to zero(00 00 00 00 00 00).
984        At the subscriber end:
985           When creating a threshold , this object must always be set
986           to zero (00 00 00 00 00 00)."
987        ::= { p2mpThresholdEntry 1 }
988
989p2mpThreshAttribute OBJECT-TYPE
990        SYNTAX  P2mpRadioSignalAttribute
991        MAX-ACCESS not-accessible
992        STATUS current
993        DESCRIPTION
994        "This represents the attribute of a radio link which needs to be
995        thresholded. For each of these attributes, the p2mpThreshType
996        identifies the type of change to monitor. When that threshold is
997        exceeded a Trap with appropriate parameters will be generated."
998        ::= { p2mpThresholdEntry 2 }
999
1000p2mpThreshType OBJECT-TYPE
1001        SYNTAX CwrThreshLimitType
1002        MAX-ACCESS not-accessible
1003        STATUS current
1004        DESCRIPTION
1005        "This object represents the kind of change that needs to be
1006        monitored for the p2mpThreshAttribute. An event is generated
1007        when the specified condition is met."
1008        ::= { p2mpThresholdEntry 3 }
1009
1010p2mpThreshValue OBJECT-TYPE
1011        SYNTAX Integer32 (-2147483647..2147483647)
1012        MAX-ACCESS read-create
1013        STATUS current
1014        DESCRIPTION
1015        "This object represents the value to be compared against. The
1016        p2mpThreshType determines the way in which it is used.
1017        It is used as follows:
1018        if p2mpThreshType is ..
1019        highThresh : Notify if data sample exceeds the p2mpThreshValue.
1020        lowThresh  : Notify if data sample recedes below the
1021                     p2mpThreshValue.
1022        upChange   : Notify if data sample increases by more than
1023                     p2mpThreshValue.
1024        downChange : Notify if data sample decreases by more than
1025                     p2mpThreshValue.
1026        upLimit    : Notify if data sample crosses p2mpThreshValue while
1027                     increasing in value.
1028        lowLimit   : Notify if data sample crosses p2mpThreshValue while
1029                     decreasing in value."
1030        ::= { p2mpThresholdEntry 4 }
1031
1032p2mpThreshHysteresisTime OBJECT-TYPE
1033        SYNTAX TimeInterval
1034        MAX-ACCESS read-create
1035        STATUS current
1036        DESCRIPTION
1037        "When radio signals oscillate around threshold values, they
1038        potentially flood the system with notifications. This object
1039        specifies the amount of time to wait before sending an identical
1040        notification if the oscillations continue."
1041        ::= { p2mpThresholdEntry 5 }
1042
1043p2mpThreshLimitTime OBJECT-TYPE
1044        SYNTAX TimeInterval
1045        MAX-ACCESS read-create
1046        STATUS current
1047        DESCRIPTION
1048        "It is desirable to know when a radio signal has stabilized. This
1049        object specifies the amount of time that the radio signal should
1050        stay below the threshold after crossing it. If it does then a
1051        'clear' notification is sent."
1052        ::= { p2mpThresholdEntry 6 }
1053
1054p2mpThreshRowStatus OBJECT-TYPE
1055        SYNTAX RowStatus
1056        MAX-ACCESS read-create
1057        STATUS current
1058        DESCRIPTION
1059        "This object represents the status of this threshold entry. It
1060        may be used to create a new threshold specification.
1061        For every p2mpThreshAttribute one threshold of p2mpThreshType on
1062        one DSP may be created."
1063        ::= { p2mpThresholdEntry 7 }
1064
1065--
1066--  This table enables the user to capture upto 4 synchronized
1067--  raw radio signal attributes simultaneously.  The user initiates the
1068--  snapshot capture by setting p2mpSnapshotAction to 'actionStart'
1069--
1070--  Some attributes in this group are represented by complex numbers
1071--  Each such attribute is indicated as value(I, q).
1072--
1073
1074p2mpSnapshotCtrlTable OBJECT-TYPE
1075        SYNTAX SEQUENCE OF P2mpSnapshotCtrlEntry
1076        MAX-ACCESS not-accessible
1077        STATUS current
1078        DESCRIPTION
1079        "This table contains information about the snapshots configured
1080        in hardware. When data is collected it will be stored in
1081        p2mpSnapDataTable. Snapshots can only be captured per DSP."
1082        ::= { p2mpRadioSnapshotGroup 1 }
1083
1084p2mpSnapshotCtrlEntry OBJECT-TYPE
1085        SYNTAX P2mpSnapshotCtrlEntry
1086        MAX-ACCESS not-accessible
1087        STATUS current
1088        DESCRIPTION
1089        "This represents one entry in the p2mpSnapshotCntrlTable
1090        It is indexed by the ifIndex of the MAC layer
1091        (propDocsWirelessMaclayer) and p2mpSnapshotDspNum."
1092        INDEX { ifIndex, p2mpSnapshotDspNum}
1093        ::= { p2mpSnapshotCtrlTable 1 }
1094
1095P2mpSnapshotCtrlEntry ::= SEQUENCE {
1096        p2mpSnapshotDspNum           Integer32,
1097        p2mpSnapshotType             P2mpSnapshotAttribute,
1098        p2mpSnapshotDataScale        CwrFixedPointScale,
1099        p2mpSnapshotDataPrecision    CwrFixedPointPrecision,
1100	p2mpSnapshotOwner            OwnerString,
1101        p2mpSnapshotAction           CwrCollectionAction,
1102        p2mpSnapshotStatus           CwrCollectionStatus,
1103        p2mpSnapshotRowStatus        RowStatus
1104        }
1105
1106p2mpSnapshotDspNum OBJECT-TYPE
1107        SYNTAX Integer32(1..8)
1108        MAX-ACCESS not-accessible
1109        STATUS current
1110        DESCRIPTION
1111        "This object represents the DSP on which the snapshot needs to
1112        be collected."
1113        ::= { p2mpSnapshotCtrlEntry 1 }
1114
1115p2mpSnapshotType OBJECT-TYPE
1116        SYNTAX P2mpSnapshotAttribute
1117        MAX-ACCESS read-create
1118        STATUS current
1119        DESCRIPTION
1120        "This identfies the set of radio signal attributes being
1121        monitored in this snapshot."
1122        ::= { p2mpSnapshotCtrlEntry 2 }
1123
1124p2mpSnapshotDataScale OBJECT-TYPE
1125        SYNTAX        CwrFixedPointScale
1126        MAX-ACCESS    read-only
1127        STATUS        current
1128        DESCRIPTION
1129        "This variable indicates the exponent to apply to the
1130        fixed-point values in the snapshot data table."
1131        ::= { p2mpSnapshotCtrlEntry 3 }
1132
1133p2mpSnapshotDataPrecision OBJECT-TYPE
1134        SYNTAX        CwrFixedPointPrecision
1135        MAX-ACCESS    read-only
1136        STATUS        current
1137        DESCRIPTION
1138        "This variable indicates the number of decimal places used for
1139        precision when interpreting the fixed-point values in the
1140        snapshot data table."
1141        ::= { p2mpSnapshotCtrlEntry 4 }
1142
1143p2mpSnapshotOwner OBJECT-TYPE
1144        SYNTAX OwnerString
1145        MAX-ACCESS read-create
1146        STATUS current
1147        DESCRIPTION
1148	"This object identifies management station that created this
1149	snapshot specification."
1150        ::= { p2mpSnapshotCtrlEntry 5 }
1151
1152p2mpSnapshotAction OBJECT-TYPE
1153        SYNTAX CwrCollectionAction
1154        MAX-ACCESS read-create
1155        STATUS current
1156        DESCRIPTION
1157        "This object represents the action to be carried out on this
1158        snapshot specification. If a snapshot has been successfully
1159        captured then it must be cleared before another capture
1160        may be initiated."
1161        ::= { p2mpSnapshotCtrlEntry 6 }
1162
1163p2mpSnapshotStatus OBJECT-TYPE
1164        SYNTAX CwrCollectionStatus
1165        MAX-ACCESS read-only
1166        STATUS current
1167        DESCRIPTION
1168        "This object represents the current status of this snapshot
1169        specification. When the status in statusInProgress none of the
1170        snapshot parameters can be configured. When the status is
1171        statusCaptured then data is available for use."
1172        ::= { p2mpSnapshotCtrlEntry 7 }
1173
1174p2mpSnapshotRowStatus OBJECT-TYPE
1175        SYNTAX RowStatus
1176        MAX-ACCESS read-create
1177        STATUS current
1178        DESCRIPTION
1179        "This object may be used to create or delete this snapshot
1180        specification."
1181        ::= { p2mpSnapshotCtrlEntry 8 }
1182
1183--
1184--      The Snapshot Summary Table. This table contains summary
1185--      information for the data captured by a snapshot specification
1186--
1187--  This table is supported on the head end and at the subscriber unit.
1188
1189p2mpSnapSummaryTable OBJECT-TYPE
1190        SYNTAX SEQUENCE OF P2mpSnapSummaryEntry
1191        MAX-ACCESS not-accessible
1192        STATUS current
1193        DESCRIPTION
1194        "This table contains summary information for captured snapshots
1195        defined in p2mpSnapshotCtrlTable."
1196        ::= { p2mpRadioSnapshotGroup 2 }
1197
1198p2mpSnapSummaryEntry OBJECT-TYPE
1199        SYNTAX P2mpSnapSummaryEntry
1200        MAX-ACCESS not-accessible
1201        STATUS current
1202        DESCRIPTION
1203        "This represents one entry in the p2mpSnapSummaryTable. It is
1204        indexed by the ifIndex of the MAC layer
1205        (propDocsWirelessMaclayer) and p2mpSnapshotDspNum."
1206        INDEX { ifIndex, p2mpSnapshotDspNum}
1207        ::= { p2mpSnapSummaryTable 1 }
1208
1209P2mpSnapSummaryEntry ::= SEQUENCE {
1210        p2mpSnapAttr1Id          Integer32,
1211        p2mpSnapAttr1Size        Integer32,
1212        p2mpSnapAttr2Id          Integer32,
1213        p2mpSnapAttr2Size        Integer32,
1214        p2mpSnapAttr3Id          Integer32,
1215        p2mpSnapAttr3Size        Integer32,
1216        p2mpSnapAttr4Id          Integer32,
1217        p2mpSnapAttr4Size        Integer32
1218        }
1219
1220p2mpSnapAttr1Id OBJECT-TYPE
1221        SYNTAX Integer32 (1..2147483647)
1222        MAX-ACCESS read-only
1223        STATUS current
1224        DESCRIPTION
1225        "This object represents the bit in the P2mpSnapshotAttribute
1226        bitmask that identifies the first attribute value."
1227        ::= { p2mpSnapSummaryEntry 2 }
1228
1229p2mpSnapAttr1Size OBJECT-TYPE
1230        SYNTAX Integer32 (0..4096)
1231        MAX-ACCESS read-only
1232        STATUS current
1233        DESCRIPTION
1234        "This object represents the number of values captured for the
1235        snapshot p2mpSnapAttr1Id."
1236        ::= { p2mpSnapSummaryEntry 3 }
1237
1238p2mpSnapAttr2Id OBJECT-TYPE
1239        SYNTAX Integer32 (1..2147483647)
1240        MAX-ACCESS read-only
1241        STATUS current
1242        DESCRIPTION
1243        "This object represents the bit in the P2mpSnapshotAttribute
1244        bitmask that identifies the second attribute value."
1245        ::= { p2mpSnapSummaryEntry 4 }
1246
1247p2mpSnapAttr2Size OBJECT-TYPE
1248        SYNTAX Integer32 (0..4096)
1249        MAX-ACCESS read-only
1250        STATUS current
1251        DESCRIPTION
1252        "This object represents the number of values captured for the
1253        snapshot p2mpSnapAttr2Id."
1254        ::= { p2mpSnapSummaryEntry 5 }
1255
1256p2mpSnapAttr3Id OBJECT-TYPE
1257        SYNTAX Integer32 (1..2147483647)
1258        MAX-ACCESS read-only
1259        STATUS current
1260        DESCRIPTION
1261        "This object represents the bit in the P2mpSnapshotAttribute
1262        bitmask that identifies the third attribute value."
1263        ::= { p2mpSnapSummaryEntry 6 }
1264
1265p2mpSnapAttr3Size OBJECT-TYPE
1266        SYNTAX Integer32 (0..4096)
1267        MAX-ACCESS read-only
1268        STATUS current
1269        DESCRIPTION
1270        "This object represents the number of values captured for the
1271        snapshot p2mpSnapAttr3Id."
1272        ::= { p2mpSnapSummaryEntry 7 }
1273
1274p2mpSnapAttr4Id OBJECT-TYPE
1275        SYNTAX Integer32 (1..2147483647)
1276        MAX-ACCESS read-only
1277        STATUS current
1278        DESCRIPTION
1279        "This object represents the bit in the P2mpSnapshotAttribute
1280        bitmask that identifies the fourth attribute value."
1281        ::= { p2mpSnapSummaryEntry 8 }
1282
1283p2mpSnapAttr4Size OBJECT-TYPE
1284        SYNTAX Integer32 (0..4096)
1285        MAX-ACCESS read-only
1286        STATUS current
1287        DESCRIPTION
1288        "This object represents the number of values captured for the
1289        snapshot p2mpSnapAttr4Id."
1290        ::= { p2mpSnapSummaryEntry 9 }
1291
1292
1293--
1294--      The Snapshot Data Table. This table contains the Data
1295--      about the snapshots collected as per the specifications in the
1296--      p2mpSnapshotCtrlTable.
1297--
1298--  This table is supported on the head end and at the subscriber unit.
1299
1300p2mpSnapDataTable OBJECT-TYPE
1301        SYNTAX SEQUENCE OF P2mpSnapDataEntry
1302        MAX-ACCESS not-accessible
1303        STATUS current
1304        DESCRIPTION
1305        "This table contains snapshot values collected based on the
1306        specifications in the p2mpSnapshotCtrlTable."
1307        ::= { p2mpRadioSnapshotGroup 3 }
1308
1309p2mpSnapDataEntry OBJECT-TYPE
1310        SYNTAX P2mpSnapDataEntry
1311        MAX-ACCESS not-accessible
1312        STATUS current
1313        DESCRIPTION
1314        "This represents one entry in the P2mpSnapDataTable. It is
1315        indexed by ifIndex of the MAC layer (propDocsWirelessMaclayer),
1316        p2mpSnapshotIndex, and p2mpSnapValueIndex.
1317
1318        The values in this table represent real and complex numbers.
1319        If they are real numbers then p2mpRealPart contains the data and
1320        p2mpImaginaryPart is undefined."
1321        INDEX { ifIndex, p2mpSnapshotDspNum, p2mpSnapValueIndex }
1322        ::= { p2mpSnapDataTable 1 }
1323
1324P2mpSnapDataEntry ::= SEQUENCE {
1325        p2mpSnapValueIndex        Integer32,
1326        p2mpRealPart              CwrFixedPointValue,
1327        p2mpImaginaryPart         CwrFixedPointValue
1328        }
1329
1330p2mpSnapValueIndex OBJECT-TYPE
1331        SYNTAX Integer32(1..4096)
1332        MAX-ACCESS not-accessible
1333        STATUS current
1334        DESCRIPTION
1335        "This object represents the snapshot entry value number.  The
1336        hardware provides a maximum of 1024 data points for any snapshot
1337        attribute.  Since we can capture a maximum of 4 attributes in a
1338        single snapshot, this object can have a maximum value of
1339        4096 (1024 * 4)."
1340        ::= { p2mpSnapDataEntry 1 }
1341
1342p2mpRealPart OBJECT-TYPE
1343        SYNTAX CwrFixedPointValue
1344        MAX-ACCESS read-only
1345        STATUS current
1346        DESCRIPTION
1347        "The data sample value. Real part."
1348        ::= { p2mpSnapDataEntry 2 }
1349
1350
1351p2mpImaginaryPart OBJECT-TYPE
1352        SYNTAX CwrFixedPointValue
1353        MAX-ACCESS read-only
1354        STATUS current
1355        DESCRIPTION
1356        "The data sample value. Imaginary part of the attribute is
1357        represented by a complex number."
1358        ::= { p2mpSnapDataEntry 3 }
1359
1360
1361-- The following two OBJECT IDENTIFIERS are used to define SNMPv2
1362-- Notifications that are backward compatible with SNMPv1 Traps.
1363
1364p2mpRfMetricsMIBNotificationPrefix
1365                OBJECT IDENTIFIER ::= { p2mpRadioThresholdGroup 2 }
1366p2mpRfMetricsMIBNotification
1367            OBJECT IDENTIFIER ::= {p2mpRfMetricsMIBNotificationPrefix 0}
1368
1369--
1370-- The following trap is generated in response to a threshold defined
1371-- in p2mpThreshTable.
1372
1373p2mpTrapThresh NOTIFICATION-TYPE
1374	OBJECTS {p2mpThreshValue,
1375                 p2mpThreshHysteresisTime,
1376                 p2mpThreshLimitTime }
1377        STATUS current
1378        DESCRIPTION
1379        "The radio subsystem generates this trap when a threshold crosses
1380        its specified limit. The parameters identify the following:
1381        p2mpThreshValue          - The value that was crossed.
1382        p2mpThreshHysteresisTime - The specified hysteresis time
1383        p2mpThreshLimitTime      - The specified limit time "
1384        ::= { p2mpRfMetricsMIBNotification 1 }
1385
1386
1387
1388-- ============================================================================
1389--
1390-- Compliance Statements
1391--
1392
1393p2mpRadioRfConformance
1394                    OBJECT IDENTIFIER ::= {ciscoWirelessRfMetricsMIB 5}
1395p2mpRadioRfCompliances OBJECT IDENTIFIER ::= { p2mpRadioRfConformance 1 }
1396p2mpRadioRfGroups      OBJECT IDENTIFIER ::= { p2mpRadioRfConformance 2 }
1397
1398p2mpRadioRfCompliance MODULE-COMPLIANCE
1399        STATUS      current
1400        DESCRIPTION
1401            "The compliance statement for devices that are Point to
1402            MultiPoint wireless interfaces."
1403
1404        MODULE  -- ciscoWirelessRfMetricsMIB
1405
1406        MANDATORY-GROUPS {
1407              p2mpComplianceHistogramGroup
1408              }
1409
1410        GROUP p2mpComplianceThresholdGroup
1411                DESCRIPTION
1412                "This group is mandatory for a system that supports the
1413                radio head end feature. It is optional at the
1414                Subscriber Unit."
1415
1416        GROUP p2mpComplianceTimelineGroup
1417                DESCRIPTION
1418                "This group is optional at the head end and the
1419                Subscriber Unit."
1420
1421        GROUP p2mpComplianceSnapshotGroup
1422                DESCRIPTION
1423                "This group is optional at the head end and the
1424                Subscriber Unit."
1425
1426        ::= { p2mpRadioRfCompliances 1 }
1427
1428--
1429--
1430p2mpComplianceHistogramGroup OBJECT-GROUP
1431        OBJECTS {
1432	        p2mpHistSize,
1433                p2mpHistSumScale,
1434                p2mpHistSumPrecision,
1435                p2mpStartBinValue,
1436                p2mpEndBinValue,
1437                p2mpUpdateRate,
1438                p2mpCollDuration,
1439	        p2mpPeriodicSum,
1440                p2mpHistOwner,
1441                p2mpHistAction,
1442                p2mpHistStatus,
1443                p2mpHistRowStatus,
1444                p2mpHistUpdateTime,
1445                p2mpHistMin,
1446                p2mpHistMax,
1447                p2mpHistMean,
1448                p2mpValue
1449                }
1450        STATUS      current
1451        DESCRIPTION
1452        "Group of objects implemented in the point to multipoint wireless
1453         system for capturing histograms and snapshots of radio signal
1454         parameters on the radio interface."
1455        ::= { p2mpRadioRfGroups 1 }
1456
1457--
1458--
1459p2mpComplianceThresholdGroup OBJECT-GROUP
1460        OBJECTS {
1461                p2mpThreshValue,
1462                p2mpThreshHysteresisTime,
1463                p2mpThreshLimitTime,
1464                p2mpThreshRowStatus
1465                }
1466        STATUS      current
1467        DESCRIPTION
1468        "Group of objects implemented in the point to multipoint
1469         wireless system to set thresholds on the radio interface."
1470        ::= { p2mpRadioRfGroups 2 }
1471
1472--
1473-- Optional Timeline Group
1474--
1475p2mpComplianceTimelineGroup OBJECT-GROUP
1476        OBJECTS {
1477                p2mpTlThreshAttribute,
1478                p2mpTlThreshType,
1479                p2mpTlNumDataValues,
1480                p2mpTlDataScale,
1481                p2mpTlDataPrecision,
1482                p2mpTlSamplePeriod,
1483                p2mpTlAction,
1484                p2mpTlPostTrigBufMgmt,
1485                p2mpTlOwner,
1486                p2mpTlStatus,
1487                p2mpTlRowStatus,
1488                p2mpTlUpdateTime,
1489                p2mpTlNumValues,
1490                p2mpTlTriggerLoc,
1491                p2mpTlValue
1492                }
1493        STATUS      current
1494        DESCRIPTION
1495        "Group of objects implemented in the point to point wireless
1496        system for establishing thresholds and capturing timeline data."
1497        ::= { p2mpRadioRfGroups 3 }
1498
1499--
1500-- Optional Snapshot Group
1501--
1502p2mpComplianceSnapshotGroup OBJECT-GROUP
1503        OBJECTS {
1504                p2mpSnapshotType,
1505                p2mpSnapshotDataScale,
1506                p2mpSnapshotDataPrecision,
1507                p2mpSnapshotOwner,
1508                p2mpSnapshotAction,
1509                p2mpSnapshotStatus,
1510                p2mpSnapshotRowStatus,
1511                p2mpSnapAttr1Id,
1512                p2mpSnapAttr1Size,
1513                p2mpSnapAttr2Id,
1514                p2mpSnapAttr2Size,
1515                p2mpSnapAttr3Id,
1516                p2mpSnapAttr3Size,
1517                p2mpSnapAttr4Id,
1518                p2mpSnapAttr4Size,
1519                p2mpRealPart,
1520                p2mpImaginaryPart
1521                }
1522        STATUS      current
1523        DESCRIPTION
1524        "Group of objects implemented in the point to multi point
1525         wireless system for capturing snapshots of various parameters
1526         on the radio interface."
1527        ::= { p2mpRadioRfGroups 4 }
1528
1529END
1530