1-- *****************************************************************
2-- CISCO-NETSYNC-MIB.my: Cisco SyncE MIB
3--
4-- October 2010, Danny Lee
5--
6-- Copyright (c) 2010 by cisco Systems Inc.
7-- All rights reserved.
8--
9-- *****************************************************************
10
11CISCO-NETSYNC-MIB DEFINITIONS ::= BEGIN
12
13IMPORTS
14    MODULE-IDENTITY,
15    OBJECT-TYPE,
16    NOTIFICATION-TYPE,
17    Gauge32,
18    Unsigned32
19        FROM SNMPv2-SMI
20    MODULE-COMPLIANCE,
21    NOTIFICATION-GROUP,
22    OBJECT-GROUP
23        FROM SNMPv2-CONF
24    TruthValue,
25    TEXTUAL-CONVENTION,
26    TimeStamp
27        FROM SNMPv2-TC
28    SnmpAdminString
29        FROM SNMP-FRAMEWORK-MIB
30    ciscoMgmt
31        FROM CISCO-SMI;
32
33
34ciscoNetsyncMIB MODULE-IDENTITY
35    LAST-UPDATED    "201010150000Z"
36    ORGANIZATION    "Cisco Systems, Inc."
37    CONTACT-INFO
38            "Cisco Systems
39            Customer Service
40
41
42            Postal: 170 W Tasman Drive
43
44            San Jose, CA  95134
45
46            USA
47
48
49            Tel: +1 800 553-NETS
50
51
52            E-mail: cs-sync-e@cisco.com"
53    DESCRIPTION
54        "The Synchronous Ethernet (SyncE) MIB is defined
55        for monitoring network synchronization based on
56        ITU-T G.781 clock selection.
57
58        Synchronous Ethernet (SyncE) is a standard defined
59        for delivering timing to the remote NEs through a
60        Packet Network.   SyncE is well defined by ITU-T
61        which included G.8261, G.8262, G.8264 and G.781.
62        It leverages the PHY layer of Ethernet to transmit
63        frequency to the remote sites.  Its functionality
64        and accuracy mimics that of the SONET/SDH network
65        because of its physical layer characteristic.
66        In order to allow best clock source traceabiliy,
67        correctly define the timing source and helps
68        preventing timing loop, Synchronization Status
69        Message is required for SyncE.  This is similar
70        to SONET/SDH.  However, since SONET/SDH use 4 bits
71        from the two S bytes in the SONET/SDH overhead
72        frame for such message, Ethernet relies on a
73        different channel called ESMC (Ethernet
74        Synchronization Messaging Channel) which is based
75        on IEEE 802.3 Organization Specific Slow Protocol.
76
77        Glossary:
78        AIS: Alarm Indication Signal
79        ATM: Asynchronous Transfer Mode
80        EEC: Ethernet Equipment Clock
81        ESMC: Ethernet Synchronization Messaging Channel
82        QL: Quality Level
83        SASE: Stand Alone Synchronization Equipment
84        SSM: Synchronization Status Messaging"
85    REVISION        "201010150000Z"
86    DESCRIPTION
87        "Initial version of the SyncE MIB module."
88    ::= { ciscoMgmt 761 }
89
90
91
92-- Textual Conventions
93
94CiscoNetsyncIfType ::= TEXTUAL-CONVENTION
95    STATUS          current
96    DESCRIPTION
97        "Network synchronization clock source Interface type.
98
99        Netsync interface         Interface type
100        ========================  ==============
101        netsyncIfTypeUnknown      Unknown
102        netsyncIfTypeInternal     Internal
103        netsyncIfTypeEthernet     Ethernet
104        netsyncIfTypeSonet        SONET
105        netsyncIfTypeTop          Timing Over Packet
106        netsyncIfTypeExt          External interface
107        netsyncIfTypeController   T1/E1 Controller
108        netsyncIfTypeGps          GPS
109        netsyncIfTypeAtm          ATM
110
111        For external and GPS interface types, the following
112        syntax is used for specifying an interface:
113            <slot>/<card>/<port> <signal type> where
114        slot : slot number of the device where card is present.
115        card : bay number in which card is inserted.
116        port : port number on the card.
117        signal type: hardware signal of the specified
118                     <slot>/<card>/<port>. Examples of signal
119                     type are T1 SF and T1 ESF.
120        "
121    SYNTAX          INTEGER  {
122                        netsyncIfTypeUnknown(1),
123                        netsyncIfTypeInternal(2),
124                        netsyncIfTypeEthernet(3),
125                        netsyncIfTypeSonet(4),
126                        netsyncIfTypeTop(5),
127                        netsyncIfTypeExt(6),
128                        netsyncIfTypeController(7),
129                        netsyncIfTypeGps(8),
130                        netsyncIfTypeAtm(9)
131                    }
132
133CiscoNetsyncNetworkOption ::= TEXTUAL-CONVENTION
134    STATUS          current
135    DESCRIPTION
136        "Network synchronization networking options.
137
138        Network option                Network option type
139        ===========================   ===================
140        netsyncNetworkOptionUnknown   Unknown network option
141        netsyncNetworkOption1         Option I
142        netsyncNetworkOption2Gen1     Option II Generation 1
143        netsyncNetworkOption2Gen2     Option II Generation 2
144        netsyncNetworkOption3         Option III
145        netsyncNetworkOptionInvalid   Invalid network option
146
147        Option I refers to ITU-T Option I synchronization networks.
148
149        Option II refers to ITU-T Option II synchronization networks
150        designed for North America.
151
152        Option III refers to ITU-T Option III synchronization networks
153        designed for Japan.
154        "
155    REFERENCE       "ITU-T standard G.781"
156    SYNTAX          INTEGER  {
157                        netsyncNetworkOptionUnknown(1),
158                        netsyncNetworkOption1(2),
159                        netsyncNetworkOption2Gen1(3),
160                        netsyncNetworkOption2Gen2(4),
161                        netsyncNetworkOption3(5),
162                        netsyncNetworkOptionInvalid(6)
163                    }
164
165CiscoNetsyncEECOption ::= TEXTUAL-CONVENTION
166    STATUS          current
167    DESCRIPTION
168        "Network synchronization EEC (Ethernet Equipment Clock)
169        options.
170
171        The EEC options are for Synchronous Ethernet devices and define
172        the requirements for clocks, e.g. bandwidth, frequency accuracy,
173        holdover and noise generation.
174
175        Two options are defined:
176        EEC-Option 1: Designed to interwork with network optimized for
177        the 2048 kbit/s hierarchy.
178
179        EEC-Option 2: Designed to interwork with network optimized for
180        the 1544 kbit/s hierarchy.
181
182        netsyncEECOptionUnknown   Unknown
183        netsyncEECOption1         EEC option 1
184        netsyncEECOption2         EEC option 2
185        netsyncEECOptionInvalid   Invalid EEC option
186        "
187
188    REFERENCE       "ITU-T standard G.781"
189    SYNTAX          INTEGER  {
190                        netsyncEECOptionUnknown(1),
191                        netsyncEECOption1(2),
192                        netsyncEECOption2(3),
193                        netsyncEECOptionInvalid(4)
194                    }
195
196CiscoNetsyncQLMode ::= TEXTUAL-CONVENTION
197    STATUS          current
198    DESCRIPTION
199        "The clock mode of the network synchronization clock selection
200        process as described in ITU-T standard G.781 section 5.12.
201
202        G.781 clock selection runs in one of two clock modes:
203        QL (Quality Level) enabled mode and QL disabled mode.
204
205        netsyncQLModeUnknown    - QL mode unknown
206        netsyncQLModeQlDisabled - QL-disabled mode;
207                                  clock selection is running
208                                  in QL disabled mode,
209                                  which primarily considers
210                                  the source's priority as the
211                                  clock selection criteria.
212        netsyncQLModeQlEnabled  - QL-enabled mode
213                                  clock selection is running
214                                  in QL enabled mode,
215                                  which primarily considers
216                                  the source's clock quality
217                                  level and priority as the
218                                  clock selection criteria.
219        "
220    REFERENCE       "ITU-T standard G.781 section 5.12"
221    SYNTAX          INTEGER  {
222                        netsyncQLModeUnknown(1),
223                        netsyncQLModeQlDisabled(2),
224                        netsyncQLModeQlEnabled(3)
225                    }
226
227CiscoNetsyncClockMode ::= TEXTUAL-CONVENTION
228    STATUS          current
229    DESCRIPTION
230        "Clock operating mode:
231
232        netsyncClockModeUnknown  - system is unable to
233                                   determine the operating mode.
234        netsyncClockModeFreerun  - free-running mode.
235        netsyncClockModeHoldover - holdover mode.
236        netsyncClockModeLocked   - a valid clock source is locked.
237        "
238    SYNTAX          INTEGER  {
239                        netsyncClockModeUnknown(1),
240                        netsyncClockModeFreerun(2),
241                        netsyncClockModeHoldover(3),
242                        netsyncClockModeLocked(4)
243                    }
244
245CiscoNetsyncQualityLevel ::= TEXTUAL-CONVENTION
246    STATUS          current
247    DESCRIPTION
248        "Clock source QL (quality level) is defined in ITU-T G.781
249        section 5.4 to reflect the synchronization quality within a
250        network Option, i.e. I, II, and III.
251
252        The following clock source quality levels are defined for the
253        synchronization process of Option I:
254
255        QL-PRC     Primary reference clock
256        QL-SSU-A   Type I or V slave clock defined in ITU-T G.811
257        QL-SSU-B   Type VI slave clock defined in ITU-T G.812
258        QL-SEC     Synchronous equipment clock
259        QL-DNU     Do not use for synchronization
260        QL-INVx    Unallocated SSM value,
261                   where x represent the value of SSM received
262        QL-FAILED  Signal failure state
263        QL-UNC     Unconnected to an input
264        QL-NSUPP   Not supporting the SSM processing
265
266        The following clock source quality levels are defined for the
267        synchronization process of Option II:
268
269        QL-PRS     PRS traceable
270        QL-STU     Synchronized; traceability unknown
271        QL-ST2     Stratum 2
272        QL-TNC     Transit node clock
273        QL-ST3E    Stratum 3E
274        QL-ST3     Stratum 3
275        QL-SMC     SONET clock self timed
276        QL-ST4     Stratum 4 freerun
277        QL-PROV    Provisionable by the network operator
278        QL-DUS     Do not use for synchronization
279        QL-INVx    Unallocated SSM value,
280                   where x represent the value of SSM received
281        QL-FAILED  Signal failure state
282        QL-UNC     Unconnected to an input
283        QL-NSUPP   Not supporting the SSM processing
284
285        The following clock source quality levels are defined for the
286        synchronization process of Option III:
287
288        QL-UNK     Unknown clock source
289        QL-SEC     Synchronous equipment clock
290
291        QL-INVx    Unallocated SSM value,
292                   where x represent the value of SSM received
293        QL-FAILED  Signal failure state
294        QL-UNC     Unconnected to an input
295        QL-NSUPP   Not supporting the SSM processing
296        "
297    REFERENCE       "ITU-T standard G.781 section 5.4"
298    SYNTAX          INTEGER  {
299                        netsyncQualityLevelNULL(1),
300                        netsyncQualityLevelDNU(2),
301                        netsyncQualityLevelDUS(3),
302                        netsyncQualityLevelFAILED(4),
303                        netsyncQualityLevelINV0(5),
304                        netsyncQualityLevelINV1(6),
305                        netsyncQualityLevelINV2(7),
306                        netsyncQualityLevelINV3(8),
307                        netsyncQualityLevelINV4(9),
308                        netsyncQualityLevelINV5(10),
309                        netsyncQualityLevelINV6(11),
310                        netsyncQualityLevelINV7(12),
311                        netsyncQualityLevelINV8(13),
312                        netsyncQualityLevelINV9(14),
313                        netsyncQualityLevelINV10(15),
314                        netsyncQualityLevelINV11(16),
315                        netsyncQualityLevelINV12(17),
316                        netsyncQualityLevelINV13(18),
317                        netsyncQualityLevelINV14(19),
318                        netsyncQualityLevelINV15(20),
319                        netsyncQualityLevelNSUPP(21),
320                        netsyncQualityLevelPRC(22),
321                        netsyncQualityLevelPROV(23),
322                        netsyncQualityLevelPRS(24),
323                        netsyncQualityLevelSEC(25),
324                        netsyncQualityLevelSMC(26),
325                        netsyncQualityLevelSSUA(27),
326                        netsyncQualityLevelSSUB(28),
327                        netsyncQualityLevelST2(29),
328                        netsyncQualityLevelST3(30),
329                        netsyncQualityLevelST3E(31),
330                        netsyncQualityLevelST4(32),
331                        netsyncQualityLevelSTU(33),
332                        netsyncQualityLevelTNC(34),
333                        netsyncQualityLevelUNC(35),
334                        netsyncQualityLevelUNK(36)
335                    }
336
337CiscoNetsyncSSMCap ::= TEXTUAL-CONVENTION
338    STATUS          current
339    DESCRIPTION
340        "Network synchronization clock source interface SSM
341        (Synchronization Status Message) capability.
342
343        SSM Capability         Capability information
344        =====================  ======================
345        netsyncSSMCapNone      No SSM capability
346        netsyncSSMCapTxRx      To transmit and receive SSM
347        netsyncSSMCapTx        To transmit SSM only
348        netsyncSSMCapRx        To receive SSM only
349        netsyncSSMCapInvalid   Capability invalid or unsupported
350        "
351    SYNTAX          INTEGER  {
352                        netsyncSSMCapNone(1),
353                        netsyncSSMCapTxRx(2),
354                        netsyncSSMCapTx(3),
355                        netsyncSSMCapRx(4),
356                        netsyncSSMCapInvalid(5)
357                    }
358
359CiscoNetsyncESMCCap ::= TEXTUAL-CONVENTION
360    STATUS          current
361    DESCRIPTION
362        "Network synchronization clock source interface ESMC
363        (Ethernet Synchronization Messaging Channel)
364        capability.
365
366        ESMC Capability         Capability information
367        ======================  ======================
368        netsyncESMCCapNone      No ESMC capability
369        netsyncESMCCapTxRx      To transmit and receive ESMC
370        netsyncESMCCapTx        To transmit SSM only
371        netsyncESMCCapRx        To receive SSM only
372        netsyncESMCCapInvalid   Capability invalid or unsupported
373        "
374    SYNTAX          INTEGER  {
375                        netsyncESMCCapNone(1),
376                        netsyncESMCCapTxRx(2),
377                        netsyncESMCCapTx(3),
378                        netsyncESMCCapRx(4),
379                        netsyncESMCCapInvalid(5)
380                    }
381
382CiscoNetsyncAlarmInfo ::= TEXTUAL-CONVENTION
383    STATUS          current
384    DESCRIPTION
385        "Input clock source's alarm reasons:
386
387        netsyncSrcAlarmReasonAIS      - Alarm Indication Signal
388        netsyncSrcAlarmReasonOOR      - Out of range
389        netsyncSrcAlarmReasonOIR      - Online Insertion Removal
390        netsyncSrcAlarmReasonInternal - Internal"
391    SYNTAX          BITS {
392                        netsyncSrcAlarmReasonAIS(0),
393                        netsyncSrcAlarmReasonOOR(1),
394                        netsyncSrcAlarmReasonOIR(2),
395                        netsyncSrcAlarmReasonInternal(3)
396                    }
397-- Textual Conventions definition will be defined before this line
398
399ciscoNetsyncMIBNotifs  OBJECT IDENTIFIER
400    ::= { ciscoNetsyncMIB 0 }
401
402ciscoNetsyncMIBObjects  OBJECT IDENTIFIER
403    ::= { ciscoNetsyncMIB 1 }
404
405ciscoNetsyncMIBConform  OBJECT IDENTIFIER
406    ::= { ciscoNetsyncMIB 2 }
407
408ciscoNetsyncMIBTables  OBJECT IDENTIFIER
409    ::= { ciscoNetsyncMIBObjects 1 }
410
411cnsClkSelGlobalTable OBJECT-TYPE
412    SYNTAX          SEQUENCE OF CnsClkSelGlobalEntry
413    MAX-ACCESS      not-accessible
414    STATUS          current
415    DESCRIPTION
416        "G.781 clock selection process table.
417        This table contains the global parameters for the G.781 clock
418        selection process."
419    ::= { ciscoNetsyncMIBTables 1 }
420
421cnsClkSelGlobalEntry OBJECT-TYPE
422    SYNTAX          CnsClkSelGlobalEntry
423    MAX-ACCESS      not-accessible
424    STATUS          current
425    DESCRIPTION
426        "An entry is added to cnsClkSelGlobalTable when G.781 clock
427        selection is enabled in the device configuration.  The entry
428        is removed when G.781 clock selection is removed from the
429        configuration."
430    INDEX           { cnsClkSelGloProcIndex }
431    ::= { cnsClkSelGlobalTable 1 }
432
433CnsClkSelGlobalEntry ::= SEQUENCE {
434        cnsClkSelGloProcIndex            Unsigned32,
435        cnsClkSelGlobProcessMode         CiscoNetsyncQLMode,
436        cnsClkSelGlobClockMode           CiscoNetsyncClockMode,
437        cnsClkSelGlobNetsyncEnable       TruthValue,
438        cnsClkSelGlobRevertiveMode       TruthValue,
439        cnsClkSelGlobESMCMode            TruthValue,
440        cnsClkSelGlobEECOption           CiscoNetsyncEECOption,
441        cnsClkSelGlobNetworkOption       CiscoNetsyncNetworkOption,
442        cnsClkSelGlobHoldoffTime         Unsigned32,
443        cnsClkSelGlobWtrTime             Unsigned32,
444        cnsClkSelGlobNofSources          Unsigned32,
445        cnsClkSelGlobLastHoldoverSeconds Gauge32,
446        cnsClkSelGlobCurrHoldoverSeconds Gauge32
447}
448
449cnsClkSelGloProcIndex OBJECT-TYPE
450    SYNTAX          Unsigned32 (0..4294967295)
451    MAX-ACCESS      not-accessible
452    STATUS          current
453    DESCRIPTION
454        "An index that uniquely represents a clock selection process.
455
456        This index is assigned arbitrarily by the system
457        and may not be persistent across reboots."
458    ::= { cnsClkSelGlobalEntry 1 }
459
460cnsClkSelGlobProcessMode OBJECT-TYPE
461    SYNTAX          CiscoNetsyncQLMode
462    MAX-ACCESS      read-only
463    STATUS          current
464    DESCRIPTION
465        "This object indicates the QL mode of
466        the network synchronization clock selection
467        process as described in ITU-T standard G.781
468        section 5.12.
469        "
470    ::= { cnsClkSelGlobalEntry 2 }
471
472cnsClkSelGlobClockMode OBJECT-TYPE
473    SYNTAX          CiscoNetsyncClockMode
474    MAX-ACCESS      read-only
475    STATUS          current
476    DESCRIPTION
477        "This object indicates the operating mode
478        of the system clock."
479    ::= { cnsClkSelGlobalEntry 3 }
480
481cnsClkSelGlobNetsyncEnable OBJECT-TYPE
482    SYNTAX          TruthValue
483    MAX-ACCESS      read-only
484    STATUS          current
485    DESCRIPTION
486        "This object indicates whether the G.781
487        clock selection is enabled or not.
488
489        'true'  - G.781 clock selection is enabled
490        'false' - G.781 clock selection is disabled"
491    DEFVAL          { false }
492    ::= { cnsClkSelGlobalEntry 4 }
493
494cnsClkSelGlobRevertiveMode OBJECT-TYPE
495    SYNTAX          TruthValue
496    MAX-ACCESS      read-only
497    STATUS          current
498    DESCRIPTION
499        "This object indicates the revertive mode
500        setting in the G.781 clock selection process.
501
502        The switching of clock sources can be made revertive or
503        non-revertive. In non-revertive mode, an alternate
504        clock source is maintained even after the original clock
505        source has recovered from the failure that caused the switch.
506        In revertive mode, the clock selection process switches back
507        to the original clock source after recovering from the
508        failure."
509    DEFVAL          { false }
510    ::= { cnsClkSelGlobalEntry 5 }
511
512cnsClkSelGlobESMCMode OBJECT-TYPE
513    SYNTAX          TruthValue
514    MAX-ACCESS      read-only
515    STATUS          current
516    DESCRIPTION
517        "This object indicates if global ESMC is enabled.
518        With ESMC enabled globally, the system is capable
519        of handling ESMC messages."
520    DEFVAL          { false }
521    ::= { cnsClkSelGlobalEntry 6 }
522
523cnsClkSelGlobEECOption OBJECT-TYPE
524    SYNTAX          CiscoNetsyncEECOption
525    MAX-ACCESS      read-only
526    STATUS          current
527    DESCRIPTION
528        "This object indicates the network synchronization
529        EEC (Ethernet Equipment Clock) option."
530    REFERENCE       "ITU-T standard G.781"
531    DEFVAL          { netsyncEECOptionUnknown }
532    ::= { cnsClkSelGlobalEntry 7 }
533
534cnsClkSelGlobNetworkOption OBJECT-TYPE
535    SYNTAX          CiscoNetsyncNetworkOption
536    MAX-ACCESS      read-only
537    STATUS          current
538    DESCRIPTION
539        "This object indicates the synchronization
540        network option."
541    REFERENCE       "ITU-T standard G.781"
542    DEFVAL          { netsyncNetworkOptionUnknown }
543    ::= { cnsClkSelGlobalEntry 8 }
544
545cnsClkSelGlobHoldoffTime OBJECT-TYPE
546    SYNTAX          Unsigned32 (0..4294967295)
547    UNITS           "milliseconds"
548    MAX-ACCESS      read-only
549    STATUS          current
550    DESCRIPTION
551        "This object indicates the global
552        holdoff time in the G.781 clock
553        selection process."
554    REFERENCE       "ITU-T standard G.781 section 5.8"
555    DEFVAL          { 300 }
556    ::= { cnsClkSelGlobalEntry 9 }
557
558cnsClkSelGlobWtrTime OBJECT-TYPE
559    SYNTAX          Unsigned32 (0..4294967295)
560    UNITS           "seconds"
561    MAX-ACCESS      read-only
562    STATUS          current
563    DESCRIPTION
564        "This object indicates the global
565        wait-to-restore time in the G.781
566        clock selection process."
567    REFERENCE       "ITU-T standard G.781 section 5.9"
568    DEFVAL          { 300 }
569    ::= { cnsClkSelGlobalEntry 10 }
570
571cnsClkSelGlobNofSources OBJECT-TYPE
572    SYNTAX          Unsigned32 (1..255)
573    UNITS           "clock sources"
574    MAX-ACCESS      read-only
575    STATUS          current
576    DESCRIPTION
577        "This object indicates the number of
578        synchronization sources currently
579        configured for the G.781
580        clock selection process."
581    ::= { cnsClkSelGlobalEntry 11 }
582
583cnsClkSelGlobLastHoldoverSeconds OBJECT-TYPE
584    SYNTAX          Gauge32
585    UNITS           "seconds"
586    MAX-ACCESS      read-only
587    STATUS          current
588    DESCRIPTION
589        "This object indicates the duration of
590        the last holdover period in seconds.
591        If the holdover duration is less than a second,
592        the object will carry the value zero."
593    ::= { cnsClkSelGlobalEntry 12 }
594
595cnsClkSelGlobCurrHoldoverSeconds OBJECT-TYPE
596    SYNTAX          Gauge32
597    UNITS           "seconds"
598    MAX-ACCESS      read-only
599    STATUS          current
600    DESCRIPTION
601        "This object indicates the duration of
602        the current holdover period.
603        If a system clock is in holdover mode,
604        the object carries the current holdover
605        duration in seconds. If the system clock
606        is not in holdover, the object carries
607        the value 0."
608    ::= { cnsClkSelGlobalEntry 13 }
609
610
611
612cnsSelectedInputSourceTable OBJECT-TYPE
613    SYNTAX          SEQUENCE OF CnsSelectedInputSourceEntry
614    MAX-ACCESS      not-accessible
615    STATUS          current
616    DESCRIPTION
617        "T0 selected clock source table.
618        This table contains the selected clock source for the input T0
619        clock."
620    ::= { ciscoNetsyncMIBTables 2 }
621
622cnsSelectedInputSourceEntry OBJECT-TYPE
623    SYNTAX          CnsSelectedInputSourceEntry
624    MAX-ACCESS      not-accessible
625    STATUS          current
626    DESCRIPTION
627        "An entry is created in the table when the G.781 clock
628        selection process has successfully selected a T0 clock
629        source.  The entry shall remain during the time
630        the G.781 clock selection process remains enabled."
631    INDEX           { cnsSelInpSrcNetsyncIndex }
632    ::= { cnsSelectedInputSourceTable 1 }
633
634CnsSelectedInputSourceEntry ::= SEQUENCE {
635        cnsSelInpSrcNetsyncIndex Unsigned32,
636        cnsSelInpSrcName         SnmpAdminString,
637        cnsSelInpSrcIntfType     CiscoNetsyncIfType,
638        cnsSelInpSrcQualityLevel CiscoNetsyncQualityLevel,
639        cnsSelInpSrcPriority     Unsigned32,
640        cnsSelInpSrcTimestamp    TimeStamp,
641        cnsSelInpSrcFSW          TruthValue,
642        cnsSelInpSrcMSW          TruthValue
643}
644
645cnsSelInpSrcNetsyncIndex OBJECT-TYPE
646    SYNTAX          Unsigned32 (1..4294967295)
647    MAX-ACCESS      not-accessible
648    STATUS          current
649    DESCRIPTION
650        "An index that uniquely represents an entry in
651        this table. This index is assigned arbitrarily
652        by the clock selection process and may not be persistent
653        across reboots."
654    ::= { cnsSelectedInputSourceEntry 1 }
655
656cnsSelInpSrcName OBJECT-TYPE
657    SYNTAX          SnmpAdminString (SIZE (1..255))
658    MAX-ACCESS      read-only
659    STATUS          current
660    DESCRIPTION
661        "This object indicates the name of the
662        selected T0 clock."
663    ::= { cnsSelectedInputSourceEntry 2 }
664
665cnsSelInpSrcIntfType OBJECT-TYPE
666    SYNTAX          CiscoNetsyncIfType
667    MAX-ACCESS      read-only
668    STATUS          current
669    DESCRIPTION
670        "This object indicates the type of the
671        selected T0 clock."
672    ::= { cnsSelectedInputSourceEntry 3 }
673
674cnsSelInpSrcQualityLevel OBJECT-TYPE
675    SYNTAX          CiscoNetsyncQualityLevel
676    MAX-ACCESS      read-only
677    STATUS          current
678    DESCRIPTION
679        "This object indicates the selected T0 clock
680        source's effective quality level, which
681        is the derived clock quality based on the three factors:
682        (a) Received quality level.
683        (b) Configured Rx quality level.  This factor supersedes (a).
684        (c) System overridden quality level as a result of exceptional
685        events such as signal failure or ESMC failure.  This factor
686        supersedes (a) and (b)."
687    ::= { cnsSelectedInputSourceEntry 4 }
688
689cnsSelInpSrcPriority OBJECT-TYPE
690    SYNTAX          Unsigned32 (1..1024)
691    MAX-ACCESS      read-only
692    STATUS          current
693    DESCRIPTION
694        "This object indicates the configured
695        priority of the selected T0 clock.
696        A smaller value represents a higher priority."
697    REFERENCE       "ITU-T standard G.781 section 5.10"
698    ::= { cnsSelectedInputSourceEntry 5 }
699
700cnsSelInpSrcTimestamp OBJECT-TYPE
701    SYNTAX          TimeStamp
702    MAX-ACCESS      read-only
703    STATUS          current
704    DESCRIPTION
705        "This object indicates the timestamp of
706        the T0 clock source being selected by
707        the G.781 clock selection process."
708    ::= { cnsSelectedInputSourceEntry 6 }
709
710cnsSelInpSrcFSW OBJECT-TYPE
711    SYNTAX          TruthValue
712    MAX-ACCESS      read-only
713    STATUS          current
714    DESCRIPTION
715        "This object indicates the forced switching flag. Forced
716        switching, as described in G.781, is used to override the
717        currently selected synchronization source.
718
719        The 'true' value indicates the currently selected clock
720        source is a result of the forced switching. The 'false'
721        value indicates the currently selected clock source is
722        not a result of forced switching."
723    REFERENCE       "ITU-T standard G.781 section 5.11.2.2"
724    ::= { cnsSelectedInputSourceEntry 7 }
725
726cnsSelInpSrcMSW OBJECT-TYPE
727    SYNTAX          TruthValue
728    MAX-ACCESS      read-only
729    STATUS          current
730    DESCRIPTION
731        "This object indicates the manual switching flag.
732        The 'true' value indicates the currently selected clock source
733        is a result of the manual switch command. The command allows
734        a user to select a synchronization source assuming it is
735        enabled, not locked out, not in signal fail condition,
736        and has a QL better than DNU in QL-enabled mode. Furthermore,
737        in QL-enabled mode, a manual switch can be performed only to
738        a source which has the highest available QL."
739    REFERENCE       "ITU-T standard G.781 section 5.11.2.3"
740    ::= { cnsSelectedInputSourceEntry 8 }
741
742
743
744cnsInputSourceTable OBJECT-TYPE
745    SYNTAX          SEQUENCE OF CnsInputSourceEntry
746    MAX-ACCESS      not-accessible
747    STATUS          current
748    DESCRIPTION
749        "T0 clock source table.
750        This table contains a list of input sources for input T0 clock
751        selection."
752    ::= { ciscoNetsyncMIBTables 3 }
753
754cnsInputSourceEntry OBJECT-TYPE
755    SYNTAX          CnsInputSourceEntry
756    MAX-ACCESS      not-accessible
757    STATUS          current
758    DESCRIPTION
759        "An entry is created in the table when a user adds a T0
760        clock source in the configuration. An entry is removed
761        in the table when a user removes a T0 clock source from
762        the configuration."
763    INDEX           { cnsInpSrcNetsyncIndex }
764    ::= { cnsInputSourceTable 1 }
765
766CnsInputSourceEntry ::= SEQUENCE {
767        cnsInpSrcNetsyncIndex       Unsigned32,
768        cnsInpSrcName               SnmpAdminString,
769        cnsInpSrcIntfType           CiscoNetsyncIfType,
770        cnsInpSrcPriority           Unsigned32,
771        cnsInpSrcESMCCap            CiscoNetsyncESMCCap,
772        cnsInpSrcSSMCap             CiscoNetsyncSSMCap,
773        cnsInpSrcQualityLevelTxCfg  CiscoNetsyncQualityLevel,
774        cnsInpSrcQualityLevelRxCfg  CiscoNetsyncQualityLevel,
775        cnsInpSrcQualityLevelTx     CiscoNetsyncQualityLevel,
776        cnsInpSrcQualityLevelRx     CiscoNetsyncQualityLevel,
777        cnsInpSrcQualityLevel       CiscoNetsyncQualityLevel,
778        cnsInpSrcHoldoffTime        Unsigned32,
779        cnsInpSrcWtrTime            Unsigned32,
780        cnsInpSrcLockout            TruthValue,
781        cnsInpSrcSignalFailure      TruthValue,
782        cnsInpSrcAlarm              TruthValue,
783        cnsInpSrcAlarmInfo          CiscoNetsyncAlarmInfo,
784        cnsInpSrcFSW                TruthValue,
785        cnsInpSrcMSW                TruthValue
786}
787
788cnsInpSrcNetsyncIndex OBJECT-TYPE
789    SYNTAX          Unsigned32 (1..4294967295)
790    MAX-ACCESS      not-accessible
791    STATUS          current
792    DESCRIPTION
793        "An index that uniquely represents an entry in
794        this table. This index is assigned arbitrarily
795        by the clock selection process and may not be persistent
796        across reboots."
797    ::= { cnsInputSourceEntry 1 }
798
799cnsInpSrcName OBJECT-TYPE
800    SYNTAX          SnmpAdminString (SIZE (1..255))
801    MAX-ACCESS      read-only
802    STATUS          current
803    DESCRIPTION
804        "This object indicates the name of an input
805        clock source configured for the T0 clock
806        selection."
807    ::= { cnsInputSourceEntry 2 }
808
809cnsInpSrcIntfType OBJECT-TYPE
810    SYNTAX          CiscoNetsyncIfType
811    MAX-ACCESS      read-only
812    STATUS          current
813    DESCRIPTION
814        "This object indicates the type of an input
815        clock source configured for the T0 clock
816        selection."
817    ::= { cnsInputSourceEntry 3 }
818
819cnsInpSrcPriority OBJECT-TYPE
820    SYNTAX          Unsigned32 (1..1024)
821    MAX-ACCESS      read-only
822    STATUS          current
823    DESCRIPTION
824        "This object indicates the priority of an input
825        clock source configured for the T0 clock
826        selection.
827
828        A smaller value represents a higher priority."
829    REFERENCE       "ITU-T standard G.781 section 5.10"
830    ::= { cnsInputSourceEntry 4 }
831
832cnsInpSrcESMCCap OBJECT-TYPE
833    SYNTAX          CiscoNetsyncESMCCap
834    MAX-ACCESS      read-only
835    STATUS          current
836    DESCRIPTION
837        "This object indicates the ESMC capability
838        of an input clock source configured for the
839        T0 clock selection.  This is applicable only to Synchronous
840        Ethernet input clock source identified by cnsInpSrcIntfType
841        'netsyncIfTypeEthernet'."
842    ::= { cnsInputSourceEntry 5 }
843
844cnsInpSrcSSMCap OBJECT-TYPE
845    SYNTAX          CiscoNetsyncSSMCap
846    MAX-ACCESS      read-only
847    STATUS          current
848    DESCRIPTION
849        "This object indicates the SSM capability
850        of an input clock source configured for the
851        T0 clock selection. This is applicable only to
852        any synchronous interface clock source except
853        SyncE interface, which is identified by cnsInpSrcIntfType
854        'netsyncIfTypeEthernet'."
855    ::= { cnsInputSourceEntry 6 }
856
857cnsInpSrcQualityLevelTxCfg OBJECT-TYPE
858    SYNTAX          CiscoNetsyncQualityLevel
859    MAX-ACCESS      read-only
860    STATUS          current
861    DESCRIPTION
862        "This object indicates the configured transmit
863        clock quality level of an input clock source."
864    ::= { cnsInputSourceEntry 7 }
865
866cnsInpSrcQualityLevelRxCfg OBJECT-TYPE
867    SYNTAX          CiscoNetsyncQualityLevel
868    MAX-ACCESS      read-only
869    STATUS          current
870    DESCRIPTION
871        "This object indicates the configured receive
872        clock quality level of an input clock source."
873    ::= { cnsInputSourceEntry 8 }
874
875cnsInpSrcQualityLevelTx OBJECT-TYPE
876    SYNTAX          CiscoNetsyncQualityLevel
877    MAX-ACCESS      read-only
878    STATUS          current
879    DESCRIPTION
880        "This object indicates the most recent clock
881        quality level transmitted on the input clock
882        source."
883    ::= { cnsInputSourceEntry 9 }
884
885cnsInpSrcQualityLevelRx OBJECT-TYPE
886    SYNTAX          CiscoNetsyncQualityLevel
887    MAX-ACCESS      read-only
888    STATUS          current
889    DESCRIPTION
890        "This object indicates the last clock quality
891        level received on the input clock source."
892    ::= { cnsInputSourceEntry 10 }
893
894cnsInpSrcQualityLevel OBJECT-TYPE
895    SYNTAX          CiscoNetsyncQualityLevel
896    MAX-ACCESS      read-only
897    STATUS          current
898    DESCRIPTION
899        "This object indicates the current clock quality
900        level of the input clock source.  This is the
901        effective quality which is derived from three values:
902
903        1) most recent clock quality level received,
904        2) forced clock quality level (entered via configuration)
905        3) overridden clock quality level as a result of line protocol
906        down, signal failure, or alarms."
907    ::= { cnsInputSourceEntry 11 }
908
909cnsInpSrcHoldoffTime OBJECT-TYPE
910    SYNTAX          Unsigned32 (0..4294967295)
911    UNITS           "milliseconds"
912    MAX-ACCESS      read-only
913    STATUS          current
914    DESCRIPTION
915        "This object indicates the hold-off time value of
916        an input clock source.
917
918        The hold-off time prevents short activation of signal failure
919        is passed to the selection process.  When a signal failure
920        event is reported on a clock source, it waits the duration of
921        the hold-off time before declaring signal failure on the clock
922        source."
923    REFERENCE       "ITU-T standard G.781 section 5.8"
924    ::= { cnsInputSourceEntry 12 }
925
926cnsInpSrcWtrTime OBJECT-TYPE
927    SYNTAX          Unsigned32 (0..4294967295)
928    UNITS           "Seconds"
929    MAX-ACCESS      read-only
930    STATUS          current
931    DESCRIPTION
932        "This object indicates the wait-to-restore time value
933        of an input clock source.
934
935        The wait-to-restore time ensures that a previous failed
936        synchronization source is only again considered as available
937        by the selection process if it is fault-free for a certain time.
938        When a signal failure condition is cleared on a clock source,
939        it waits the duration of the wait-to-restore time before
940        clearing the signal failure status on the clock source."
941    REFERENCE       "ITU-T standard G.781 section 5.9"
942    ::= { cnsInputSourceEntry 13 }
943
944cnsInpSrcLockout OBJECT-TYPE
945    SYNTAX          TruthValue
946    MAX-ACCESS      read-only
947    STATUS          current
948    DESCRIPTION
949        "This object indicates whether or not the lockout
950        command has been applied to a clock source.
951
952        The 'true' value means the clock source is not
953        considered by the selection process."
954    REFERENCE       "ITU-T standard G.781 section 5.11.1"
955    ::= { cnsInputSourceEntry 14 }
956
957cnsInpSrcSignalFailure OBJECT-TYPE
958    SYNTAX          TruthValue
959    MAX-ACCESS      read-only
960    STATUS          current
961    DESCRIPTION
962        "This object indicates whether or not a
963        signal failure event is currently being
964        reported on the input clock source."
965    REFERENCE       "ITU-T standard G.781 section 5.7"
966    ::= { cnsInputSourceEntry 15 }
967
968cnsInpSrcAlarm OBJECT-TYPE
969    SYNTAX          TruthValue
970    MAX-ACCESS      read-only
971    STATUS          current
972    DESCRIPTION
973        "This object indicates whether or not an
974        alarm event is currently being reported
975        on the input clock source."
976    ::= { cnsInputSourceEntry 16 }
977
978cnsInpSrcAlarmInfo OBJECT-TYPE
979    SYNTAX          CiscoNetsyncAlarmInfo
980    MAX-ACCESS      read-only
981    STATUS          current
982    DESCRIPTION
983        "This object indicates the alarm reasons of
984        an input clock source if an alarm event
985        is being reported on it."
986    ::= { cnsInputSourceEntry 17 }
987
988cnsInpSrcFSW OBJECT-TYPE
989    SYNTAX          TruthValue
990    MAX-ACCESS      read-only
991    STATUS          current
992    DESCRIPTION
993        "This object indicates the forced switching flag.
994        Forced switching, as described in G.781, is used to
995        override the currently selected synchronization source.
996
997        The 'true' value indicates the currently selected clock source
998        is a result of the forced switching. The 'false' value
999        indicates the currently selected clock source is not a result
1000        of forced switching."
1001    REFERENCE       "ITU-T standard G.781 section 5.11.2.2"
1002    ::= { cnsInputSourceEntry 18 }
1003
1004cnsInpSrcMSW OBJECT-TYPE
1005    SYNTAX          TruthValue
1006    MAX-ACCESS      read-only
1007    STATUS          current
1008    DESCRIPTION
1009        "This object indicates the manual switching flag.
1010
1011        The 'true' value indicates the currently selected clock source
1012        is a result of the manual switching. The switch allows
1013        a user to select a synchronization source assuming it is
1014        enabled, not locked out, not in signal fail condition,
1015        and has a QL better than DNU in QL-enabled mode.
1016
1017        A clock source is enabled when it occupies a row in
1018        cnsInputSourceTable.  A clock source is not locked out
1019        when cnsInpSrcLockout contains the value 'false'.
1020        A clock source is not in signal failure condition when
1021        cnsInpSrcSignalFailure contains the value 'false'.
1022        The QL is identified in cnsInpSrcQualityLevel.
1023
1024        In QL-enabled mode, a manual switch can be performed only to
1025        a source which has the highest available QL."
1026    REFERENCE       "ITU-T standard G.781 section 5.11.2.3"
1027    ::= { cnsInputSourceEntry 19 }
1028
1029
1030
1031cnsExtOutputTable OBJECT-TYPE
1032    SYNTAX          SEQUENCE OF CnsExtOutputEntry
1033    MAX-ACCESS      not-accessible
1034    STATUS          current
1035    DESCRIPTION
1036        "T4 external output table.
1037        This table contains a list of T4 external outputs.
1038
1039        Each T4 external output is associated with clock
1040        source(s) to be found in cnsT4ClockSourceTable.
1041        The clock selection process considers all the
1042        available clock sources and select the T4 clock
1043        source based on the G.781 clock selection algorithm."
1044    ::= { ciscoNetsyncMIBTables 4 }
1045
1046cnsExtOutputEntry OBJECT-TYPE
1047    SYNTAX          CnsExtOutputEntry
1048    MAX-ACCESS      not-accessible
1049    STATUS          current
1050    DESCRIPTION
1051        "An entry is created in the table when a user adds
1052        a T4 external output in the configuration.  A T4 external
1053        output configured input clock sources are defined in
1054        cnsT4ClockSourceTable.
1055
1056        An entry is removed from the table when a user removes
1057        a T4 external output from the configuration."
1058    INDEX           { cnsExtOutListIndex }
1059    ::= { cnsExtOutputTable 1 }
1060
1061CnsExtOutputEntry ::= SEQUENCE {
1062        cnsExtOutListIndex       Unsigned32,
1063        cnsExtOutSelNetsyncIndex Unsigned32,
1064        cnsExtOutName            SnmpAdminString,
1065        cnsExtOutIntfType        CiscoNetsyncIfType,
1066        cnsExtOutQualityLevel    CiscoNetsyncQualityLevel,
1067        cnsExtOutPriority        Unsigned32,
1068        cnsExtOutFSW             TruthValue,
1069        cnsExtOutMSW             TruthValue,
1070        cnsExtOutSquelch         TruthValue
1071}
1072
1073cnsExtOutListIndex OBJECT-TYPE
1074    SYNTAX          Unsigned32 (1..4294967295)
1075    MAX-ACCESS      not-accessible
1076    STATUS          current
1077    DESCRIPTION
1078        "An index that uniquely represents an entry in
1079        this table.  This index is assigned arbitrarily by the
1080        clock selection process and may not be persistent
1081        across reboots."
1082    ::= { cnsExtOutputEntry 1 }
1083
1084cnsExtOutSelNetsyncIndex OBJECT-TYPE
1085    SYNTAX          Unsigned32 (1..4294967295)
1086    MAX-ACCESS      read-only
1087    STATUS          current
1088    DESCRIPTION
1089        "An index that uniquely represents the selected input clock
1090        source whose information is reported by a row in
1091        cnsT4ClockSourceTable. The index lists the value of
1092        cnsT4ClkSrcNetsyncIndex, which is the input clock source
1093        of the T4 external output selected by the G.781 clock
1094        selection process."
1095    ::= { cnsExtOutputEntry 2 }
1096
1097cnsExtOutName OBJECT-TYPE
1098    SYNTAX          SnmpAdminString (SIZE (1..255))
1099    MAX-ACCESS      read-only
1100    STATUS          current
1101    DESCRIPTION
1102        "This object indicates the name of a
1103        T4 external output."
1104    ::= { cnsExtOutputEntry 3 }
1105
1106cnsExtOutIntfType OBJECT-TYPE
1107    SYNTAX          CiscoNetsyncIfType
1108    MAX-ACCESS      read-only
1109    STATUS          current
1110    DESCRIPTION
1111        "This object indicates the interface type
1112        of the T4 external output."
1113    ::= { cnsExtOutputEntry 4 }
1114
1115cnsExtOutQualityLevel OBJECT-TYPE
1116    SYNTAX          CiscoNetsyncQualityLevel
1117    MAX-ACCESS      read-only
1118    STATUS          current
1119    DESCRIPTION
1120        "This object indicates the clock quality
1121        of the T4 external output."
1122    ::= { cnsExtOutputEntry 5 }
1123
1124cnsExtOutPriority OBJECT-TYPE
1125    SYNTAX          Unsigned32 (1..1024)
1126    MAX-ACCESS      read-only
1127    STATUS          current
1128    DESCRIPTION
1129        "This object indicates the priority of the
1130        selected clock source for a T4 external
1131        output.
1132
1133        A smaller value represents a higher priority."
1134    REFERENCE       "ITU-T standard G.781 section 5.10"
1135    ::= { cnsExtOutputEntry 6 }
1136
1137cnsExtOutFSW OBJECT-TYPE
1138    SYNTAX          TruthValue
1139    MAX-ACCESS      read-only
1140    STATUS          current
1141    DESCRIPTION
1142        "This object indicates the forced switching flag.
1143        Forced switching, as described in G.781, is used to
1144        override the currently selected synchronization source,
1145        The T4 selected synchronization source is identified by
1146        cnsExtOutSelNetsyncIndex, which contains the index to
1147        the clock source in cnsT4ClockSourceTable.
1148
1149        The 'true' value indicates the currently selected
1150        T4 clock source is a result of the forced switching.
1151        The 'false' value indicates the currently selected T4
1152        clock source is not a result of forced switching."
1153    REFERENCE       "ITU-T standard G.781 section 5.11.2.2"
1154    ::= { cnsExtOutputEntry 7 }
1155
1156cnsExtOutMSW OBJECT-TYPE
1157    SYNTAX          TruthValue
1158    MAX-ACCESS      read-only
1159    STATUS          current
1160    DESCRIPTION
1161        "This object indicates the manual switching flag.
1162
1163        The 'true' value indicates the currently selected
1164        T4 clock source is a result of the manual switch command.
1165        The command allows a user to select a synchronization source
1166        assuming it is enabled, not locked out, not in signal fail
1167        condition, and has a QL better than DNU in QL-enabled mode.
1168
1169        A clock source is enabled when it occupies in row in
1170        cnsT4ClockSourceTable.  A clock source is not locked out
1171        when cnsT4ClkSrcLockout contains the value 'false'.
1172        A clock source is not in signal failure condition when
1173        cnsT4ClkSrcSignalFailure contains the value 'false'.
1174        The QL is identified in cnsT4ClkSrcQualityLevel.
1175
1176        In QL-enabled mode, a manual switch can be
1177        performed only to a source which has the highest
1178        available QL."
1179    REFERENCE       "ITU-T standard G.781 section 5.11.2.3"
1180    ::= { cnsExtOutputEntry 8 }
1181
1182cnsExtOutSquelch OBJECT-TYPE
1183    SYNTAX          TruthValue
1184    MAX-ACCESS      read-only
1185    STATUS          current
1186    DESCRIPTION
1187        "This object indicates whether or not a
1188        T4 external output is squelched.
1189
1190        Squelching is a sychronization function defined to prevent
1191        transmission of a timing signal with a quality that is lower
1192        than the quality of the clock in the receiving networks
1193        element or SASE. It is also used for the prevention of
1194        timing loops."
1195    REFERENCE       "ITU-T standard G.781 section 5.4.1.4"
1196    ::= { cnsExtOutputEntry 9 }
1197
1198
1199
1200cnsT4ClockSourceTable OBJECT-TYPE
1201    SYNTAX          SEQUENCE OF CnsT4ClockSourceEntry
1202    MAX-ACCESS      not-accessible
1203    STATUS          current
1204    DESCRIPTION
1205        "T4 clock source table.
1206        This table contains a list of input sources for a specific
1207        T4 external output. An entry shall be added to
1208        cnsExtOutputTable first. Then clock sources shall be
1209        added in this table for the selection process to select
1210        the appropriate T4 clock source."
1211    ::= { ciscoNetsyncMIBTables 5 }
1212
1213cnsT4ClockSourceEntry OBJECT-TYPE
1214    SYNTAX          CnsT4ClockSourceEntry
1215    MAX-ACCESS      not-accessible
1216    STATUS          current
1217    DESCRIPTION
1218        "An entry is created in the table when a user adds a
1219        clock source to a T4 external output in the configuration.
1220        The T4 external output is defined in the T4 external
1221        output table. An entry is removed in the table when a user
1222        removes a T4 clock source from the configuration."
1223    INDEX           {
1224                        cnsExtOutListIndex,
1225                        cnsT4ClkSrcNetsyncIndex
1226                    }
1227    ::= { cnsT4ClockSourceTable 1 }
1228
1229CnsT4ClockSourceEntry ::= SEQUENCE {
1230        cnsT4ClkSrcNetsyncIndex       Unsigned32,
1231        cnsT4ClkSrcName               SnmpAdminString,
1232        cnsT4ClkSrcIntfType           CiscoNetsyncIfType,
1233        cnsT4ClkSrcPriority           Unsigned32,
1234        cnsT4ClkSrcESMCCap            CiscoNetsyncESMCCap,
1235        cnsT4ClkSrcSSMCap             CiscoNetsyncSSMCap,
1236        cnsT4ClkSrcQualityLevelTxCfg  CiscoNetsyncQualityLevel,
1237        cnsT4ClkSrcQualityLevelRxCfg  CiscoNetsyncQualityLevel,
1238        cnsT4ClkSrcQualityLevelTx     CiscoNetsyncQualityLevel,
1239        cnsT4ClkSrcQualityLevelRx     CiscoNetsyncQualityLevel,
1240        cnsT4ClkSrcQualityLevel       CiscoNetsyncQualityLevel,
1241        cnsT4ClkSrcHoldoffTime        Unsigned32,
1242        cnsT4ClkSrcWtrTime            Unsigned32,
1243        cnsT4ClkSrcLockout            TruthValue,
1244        cnsT4ClkSrcSignalFailure      TruthValue,
1245        cnsT4ClkSrcAlarm              TruthValue,
1246        cnsT4ClkSrcAlarmInfo          CiscoNetsyncAlarmInfo,
1247        cnsT4ClkSrcFSW                TruthValue,
1248        cnsT4ClkSrcMSW                TruthValue
1249}
1250
1251cnsT4ClkSrcNetsyncIndex OBJECT-TYPE
1252    SYNTAX          Unsigned32 (1..4294967295)
1253    MAX-ACCESS      not-accessible
1254    STATUS          current
1255    DESCRIPTION
1256        "An index that uniquely represents an entry in
1257        this table.  This index is assigned arbitrarily by the
1258        clock selection process and may not be persistent
1259        across reboots."
1260    ::= { cnsT4ClockSourceEntry 1 }
1261
1262cnsT4ClkSrcName OBJECT-TYPE
1263    SYNTAX          SnmpAdminString (SIZE (1..255))
1264    MAX-ACCESS      read-only
1265    STATUS          current
1266    DESCRIPTION
1267        "This object indicates the name of a input
1268        clock source configured for the T4 clock
1269        selection."
1270    ::= { cnsT4ClockSourceEntry 2 }
1271
1272cnsT4ClkSrcIntfType OBJECT-TYPE
1273    SYNTAX          CiscoNetsyncIfType
1274    MAX-ACCESS      read-only
1275    STATUS          current
1276    DESCRIPTION
1277        "This object indicates the type of an input
1278        clock source configured for the T4 clock
1279        selection."
1280    ::= { cnsT4ClockSourceEntry 3 }
1281
1282cnsT4ClkSrcPriority OBJECT-TYPE
1283    SYNTAX          Unsigned32 (1..1024)
1284    MAX-ACCESS      read-only
1285    STATUS          current
1286    DESCRIPTION
1287        "This object indicates the priority of an input
1288        clock source configured for the T4 clock
1289        selection.
1290
1291        A smaller value represents a higher priority."
1292    REFERENCE       "ITU-T standard G.781 section 5.10"
1293    ::= { cnsT4ClockSourceEntry 4 }
1294
1295cnsT4ClkSrcESMCCap OBJECT-TYPE
1296    SYNTAX          CiscoNetsyncESMCCap
1297    MAX-ACCESS      read-only
1298    STATUS          current
1299    DESCRIPTION
1300        "This object indicates the ESMC capability
1301        of an input clock source configured for the
1302        T4 clock selection.  This is applicable
1303        only to Synchronous Ethernet input clock source
1304        identified by cnsT4ClkSrcIntfType 'netsyncIfTypeEthernet'."
1305    ::= { cnsT4ClockSourceEntry 5 }
1306
1307cnsT4ClkSrcSSMCap OBJECT-TYPE
1308    SYNTAX          CiscoNetsyncSSMCap
1309    MAX-ACCESS      read-only
1310    STATUS          current
1311    DESCRIPTION
1312        "This object indicates the SSM capability
1313        of an input clock source configured for the
1314        T4 clock selection. This is applicable only to any
1315        synchronous interface clock source except SyncE interface,
1316        which is identified by cnsT4ClkSrcIntfType
1317        'netsyncIfTypeEthernet'."
1318    ::= { cnsT4ClockSourceEntry 6 }
1319
1320cnsT4ClkSrcQualityLevelTxCfg OBJECT-TYPE
1321    SYNTAX          CiscoNetsyncQualityLevel
1322    MAX-ACCESS      read-only
1323    STATUS          current
1324    DESCRIPTION
1325        "This object indicates the configured transmit
1326        clock quality level of a T4 input clock source."
1327    ::= { cnsT4ClockSourceEntry 7 }
1328
1329cnsT4ClkSrcQualityLevelRxCfg OBJECT-TYPE
1330    SYNTAX          CiscoNetsyncQualityLevel
1331    MAX-ACCESS      read-only
1332    STATUS          current
1333    DESCRIPTION
1334        "This object indicates the configured receive
1335        clock quality level of a T4 input clock source."
1336    ::= { cnsT4ClockSourceEntry 8 }
1337
1338cnsT4ClkSrcQualityLevelTx OBJECT-TYPE
1339    SYNTAX          CiscoNetsyncQualityLevel
1340    MAX-ACCESS      read-only
1341    STATUS          current
1342    DESCRIPTION
1343        "This object indicates the most recent clock
1344        quality level transmitted on the T4 input
1345        clock source."
1346    ::= { cnsT4ClockSourceEntry 9 }
1347
1348cnsT4ClkSrcQualityLevelRx OBJECT-TYPE
1349    SYNTAX          CiscoNetsyncQualityLevel
1350    MAX-ACCESS      read-only
1351    STATUS          current
1352    DESCRIPTION
1353        "This object indicates the last clock quality
1354        level received on the T4 input clock
1355        source."
1356    ::= { cnsT4ClockSourceEntry 10 }
1357
1358cnsT4ClkSrcQualityLevel OBJECT-TYPE
1359    SYNTAX          CiscoNetsyncQualityLevel
1360    MAX-ACCESS      read-only
1361    STATUS          current
1362    DESCRIPTION
1363        "This object indicates the current clock quality
1364        level of the T4 input clock source.  This is the
1365        effective quality which is derived from three values:
1366
1367        1) most recent clock quality level received,
1368        2) forced clock quality level (entered via configuration)
1369        3) overridden clock quality level as a result of line protocol
1370        down, signal failure, or alarms."
1371    ::= { cnsT4ClockSourceEntry 11 }
1372
1373cnsT4ClkSrcHoldoffTime OBJECT-TYPE
1374    SYNTAX          Unsigned32 (0..4294967295)
1375    UNITS           "milliseconds"
1376    MAX-ACCESS      read-only
1377    STATUS          current
1378    DESCRIPTION
1379        "This object indicates the hold-off time value of
1380        a T4 input clock source.
1381
1382        The hold-off time prevents short activation of signal failure
1383        is passed to the selection process.  When a signal failure
1384        event is reported on a clock source, it waits the duration of
1385        the hold-off time before declaring signal failure on the clock
1386        source."
1387    REFERENCE       "ITU-T standard G.781 section 5.8"
1388    ::= { cnsT4ClockSourceEntry 12 }
1389
1390cnsT4ClkSrcWtrTime OBJECT-TYPE
1391    SYNTAX          Unsigned32 (0..4294967295)
1392    UNITS           "seconds"
1393    MAX-ACCESS      read-only
1394    STATUS          current
1395    DESCRIPTION
1396        "This object indicates the wait-to-restore time value
1397        of a T4 input clock source.
1398
1399        The wait-to-restore time ensures that a previous failed
1400        synchronization source is only again considered as available
1401        by the selection process if it is fault-free for a certain time.
1402        When a signal failure condition is cleared on a clock source,
1403        it waits the duration of the wait-to-restore time before
1404        clearing the signal failure status on the clock source."
1405    REFERENCE       "ITU-T standard G.781 section 5.9"
1406    ::= { cnsT4ClockSourceEntry 13 }
1407
1408cnsT4ClkSrcLockout OBJECT-TYPE
1409    SYNTAX          TruthValue
1410    MAX-ACCESS      read-only
1411    STATUS          current
1412    DESCRIPTION
1413        "This object indicates whether or not the lockout
1414        command has been applied on a T4 clock source.
1415
1416        The 'true' value means the clock source is not
1417        considered by the selection process."
1418    REFERENCE       "ITU-T standard G.781 section 5.11.1"
1419    ::= { cnsT4ClockSourceEntry 14 }
1420
1421cnsT4ClkSrcSignalFailure OBJECT-TYPE
1422    SYNTAX          TruthValue
1423    MAX-ACCESS      read-only
1424    STATUS          current
1425    DESCRIPTION
1426        "This object indicates whether or not a
1427        signal failure event is currently being
1428        reported on the T4 input clock source."
1429    REFERENCE       "ITU-T standard G.781 section 5.7"
1430    ::= { cnsT4ClockSourceEntry 15 }
1431
1432cnsT4ClkSrcAlarm OBJECT-TYPE
1433    SYNTAX          TruthValue
1434    MAX-ACCESS      read-only
1435    STATUS          current
1436    DESCRIPTION
1437        "This object indicates whether or not an
1438        alarm event is currently being reported
1439        on the T4 input clock source."
1440    ::= { cnsT4ClockSourceEntry 16 }
1441
1442cnsT4ClkSrcAlarmInfo OBJECT-TYPE
1443    SYNTAX          CiscoNetsyncAlarmInfo
1444    MAX-ACCESS      read-only
1445    STATUS          current
1446    DESCRIPTION
1447        "This object indicates the alarm reasons of
1448        a T4 input clock source if an alarm event
1449        is being reported on the clock source."
1450    ::= { cnsT4ClockSourceEntry 17 }
1451
1452cnsT4ClkSrcFSW OBJECT-TYPE
1453    SYNTAX          TruthValue
1454    MAX-ACCESS      read-only
1455    STATUS          current
1456    DESCRIPTION
1457        "This object indicates the forced switching flag.
1458        Forced switching, as described in G.781, is used to
1459        override the currently selected synchronization source.
1460
1461        The 'true' value indicates the currently selected
1462        T4 clock source is a result of the forced switching.
1463        The 'false' value indicates the currently selected
1464        T4 clock source is not a result of forced switching."
1465    REFERENCE       "ITU-T standard G.781 section 5.11.2.2"
1466    ::= { cnsT4ClockSourceEntry 18 }
1467
1468cnsT4ClkSrcMSW OBJECT-TYPE
1469    SYNTAX          TruthValue
1470    MAX-ACCESS      read-only
1471    STATUS          current
1472    DESCRIPTION
1473        "This object indicates the manual switching flag.
1474
1475        The 'true' value indicates the currently selected
1476        T4 clock source is a result of the manual switching.
1477        The switch allows a user to select a
1478        synchronization source assuming it is enabled,
1479        not locked out, not in signal fail condition,
1480        and has a QL better than DNU in QL-enabled mode.
1481
1482        A clock source is enabled when it occupies a row in
1483        cnsT4ClockSourceTable.  A clock source is not locked
1484        out when cnsT4ClkSrcLockout contains the value 'false'.
1485        A clock source is not in signal failure condition when
1486        cnsT4ClkSrcSignalFailure contains the value 'false'.
1487        The QL is identified in cnsT4ClkSrcQualityLevel.
1488
1489        In QL-enabled mode, a manual switch
1490        can be performed only to a source which has the
1491        highest available QL."
1492    REFERENCE       "ITU-T standard G.781 section 5.11.2.3"
1493    ::= { cnsT4ClockSourceEntry 19 }
1494
1495cnsNotifObjects  OBJECT IDENTIFIER
1496    ::= { ciscoNetsyncMIBObjects 2 }
1497
1498
1499cnsInpSrcFailClear OBJECT-TYPE
1500    SYNTAX          TruthValue
1501    MAX-ACCESS      accessible-for-notify
1502    STATUS          current
1503    DESCRIPTION
1504        "This object indicates the clear status of a signal failure
1505        event. A value of 'true' means a signal failure event reported
1506        on a clock source has been cleared.  A value of 'false' means
1507        a signal event has been reported on a clock source."
1508    ::= { cnsNotifObjects 1 }
1509
1510cnsInpSrcAlarmClear OBJECT-TYPE
1511    SYNTAX          TruthValue
1512    MAX-ACCESS      accessible-for-notify
1513    STATUS          current
1514    DESCRIPTION
1515        "This object indicates the clear status of an alarm event.
1516        A value of 'true' means an alarm event reported on a clock
1517        source has been cleared.  A value of 'false' means an alarm
1518        event has been reported on a clock source."
1519    ::= { cnsNotifObjects 2 }
1520
1521ciscoNetsyncMIBNotifControl  OBJECT IDENTIFIER
1522    ::= { ciscoNetsyncMIBObjects 3 }
1523
1524cnsMIBEnableStatusNotification OBJECT-TYPE
1525    SYNTAX      TruthValue
1526    MAX-ACCESS  read-write
1527    STATUS      current
1528    DESCRIPTION
1529        "A control object to enable/disable
1530        ciscoNetsyncSelectedT0Clock, ciscoNetsyncSelectedT4Clock,
1531        ciscoNetsyncInputSignalFailureStatus,
1532        ciscoNetsyncInputAlarmStatus notifications at the system
1533        level.
1534        This object should hold any of the below values.
1535            true - The notif is enabled globally for the system
1536            false- The notif is disabled globally for the system"
1537        DEFVAL { false }
1538        ::= { ciscoNetsyncMIBNotifControl 1 }
1539
1540
1541-- Default Notification Type
1542
1543ciscoNetsyncSelectedT0Clock NOTIFICATION-TYPE
1544    OBJECTS         {
1545                        cnsSelInpSrcName,
1546                        cnsSelInpSrcIntfType,
1547                        cnsSelInpSrcQualityLevel,
1548                        cnsSelInpSrcPriority
1549                    }
1550    STATUS          current
1551    DESCRIPTION
1552        "T0 clock selection notification.
1553
1554        This notification is generated when one
1555        of the following conditions is met:
1556
1557        - A new clock source is selected by the
1558          T0 clock selection.
1559        - The clock quality of a T0 selected clock
1560          source is changed.
1561        - The configured priority of a T0 selected
1562          clock source is changed.
1563        "
1564   ::= { ciscoNetsyncMIBNotifs 1 }
1565
1566ciscoNetsyncSelectedT4Clock NOTIFICATION-TYPE
1567    OBJECTS         {
1568                        cnsExtOutName,
1569                        cnsT4ClkSrcName,
1570                        cnsT4ClkSrcIntfType,
1571                        cnsT4ClkSrcQualityLevel,
1572                        cnsT4ClkSrcPriority
1573                    }
1574    STATUS          current
1575    DESCRIPTION
1576        "T4 clock selection notification.
1577
1578        This notification is generated when one
1579        of the following conditions is met:
1580
1581        - A new clock source is selected by the
1582          T4 clock selection.
1583        - The clock quality of a T4 selected clock
1584          source is changed.
1585        - The configured priority of a T4 selected
1586          clock source is changed.
1587        "
1588   ::= { ciscoNetsyncMIBNotifs 2 }
1589
1590ciscoNetsyncInputSignalFailureStatus NOTIFICATION-TYPE
1591    OBJECTS         {
1592                        cnsInpSrcName,
1593                        cnsInpSrcIntfType,
1594                        cnsInpSrcFailClear
1595                    }
1596    STATUS          current
1597    DESCRIPTION
1598        "Input clock source signal failure notification.
1599
1600        This notification is generated when a signal
1601        failure event is reported on an input clock source.
1602        One of the conditions a signal failure event
1603        could be due to interface shutdown."
1604   ::= { ciscoNetsyncMIBNotifs 3 }
1605
1606ciscoNetsyncInputAlarmStatus NOTIFICATION-TYPE
1607    OBJECTS         {
1608                        cnsInpSrcName,
1609                        cnsInpSrcIntfType,
1610                        cnsInpSrcAlarmInfo,
1611                        cnsInpSrcAlarmClear
1612                    }
1613    STATUS          current
1614    DESCRIPTION
1615        "Input clock source alarm notification.
1616
1617        This notification is generated when an alarm
1618        event is reported on an input clock source."
1619   ::= { ciscoNetsyncMIBNotifs 4 }
1620
1621
1622ciscoNetsyncMIBCompliances  OBJECT IDENTIFIER
1623    ::= { ciscoNetsyncMIBConform 1 }
1624
1625ciscoNetsyncMIBGroups  OBJECT IDENTIFIER
1626    ::= { ciscoNetsyncMIBConform 2 }
1627
1628
1629ciscoNetsyncMIBCompliance MODULE-COMPLIANCE
1630    STATUS          current
1631    DESCRIPTION
1632        "This is a default module-compliance
1633        containing default object groups."
1634    MODULE          -- this module
1635    MANDATORY-GROUPS {
1636                        cnsClkSelGlobalObjectGroup,
1637                        cnsSelectedInputSourceObjectGroup,
1638                        cnsInputSourceObjectGroup,
1639                        cnsExtOutputObjectGroup,
1640                        cnsT4ClkSrcObjectGroup,
1641                        ciscoNetsyncMIBNotificationGroup,
1642                        cnsMIBNotifEnablesGroup
1643                    }
1644    ::= { ciscoNetsyncMIBCompliances 1 }
1645
1646-- Units of Conformance
1647
1648cnsClkSelGlobalObjectGroup OBJECT-GROUP
1649    OBJECTS         {
1650                        cnsClkSelGlobProcessMode,
1651                        cnsClkSelGlobClockMode,
1652                        cnsClkSelGlobNetsyncEnable,
1653                        cnsClkSelGlobRevertiveMode,
1654                        cnsClkSelGlobESMCMode,
1655                        cnsClkSelGlobEECOption,
1656                        cnsClkSelGlobNetworkOption,
1657                        cnsClkSelGlobHoldoffTime,
1658                        cnsClkSelGlobWtrTime,
1659                        cnsClkSelGlobNofSources,
1660                        cnsClkSelGlobLastHoldoverSeconds,
1661                        cnsClkSelGlobCurrHoldoverSeconds
1662                    }
1663    STATUS          current
1664    DESCRIPTION
1665        "This group contains all objects referenced by
1666        the G.781 clock selection process table."
1667    ::= { ciscoNetsyncMIBGroups 1 }
1668
1669cnsSelectedInputSourceObjectGroup OBJECT-GROUP
1670    OBJECTS         {
1671                        cnsSelInpSrcName,
1672                        cnsSelInpSrcQualityLevel,
1673                        cnsSelInpSrcTimestamp,
1674                        cnsSelInpSrcFSW,
1675                        cnsSelInpSrcMSW,
1676                        cnsSelInpSrcIntfType,
1677                        cnsSelInpSrcPriority
1678                    }
1679    STATUS          current
1680    DESCRIPTION
1681        "This group contains all objects referenced by
1682        cnsSelectedInputSourceTable."
1683    ::= { ciscoNetsyncMIBGroups 2 }
1684
1685cnsInputSourceObjectGroup OBJECT-GROUP
1686    OBJECTS         {
1687                        cnsInpSrcName,
1688                        cnsInpSrcIntfType,
1689                        cnsInpSrcPriority,
1690                        cnsInpSrcESMCCap,
1691                        cnsInpSrcSSMCap,
1692                        cnsInpSrcQualityLevelTxCfg,
1693                        cnsInpSrcQualityLevelRxCfg,
1694                        cnsInpSrcQualityLevelTx,
1695                        cnsInpSrcQualityLevelRx,
1696                        cnsInpSrcQualityLevel,
1697                        cnsInpSrcHoldoffTime,
1698                        cnsInpSrcWtrTime,
1699                        cnsInpSrcLockout,
1700                        cnsInpSrcSignalFailure,
1701                        cnsInpSrcAlarm,
1702                        cnsInpSrcAlarmInfo,
1703                        cnsInpSrcFSW,
1704                        cnsInpSrcMSW,
1705                        cnsInpSrcAlarmClear,
1706                        cnsInpSrcFailClear
1707                    }
1708    STATUS          current
1709    DESCRIPTION
1710        "This group contains all objects referenced by
1711        cnsInputSourceTable."
1712    ::= { ciscoNetsyncMIBGroups 3 }
1713
1714cnsExtOutputObjectGroup OBJECT-GROUP
1715    OBJECTS         {
1716                        cnsExtOutName,
1717                        cnsExtOutSelNetsyncIndex,
1718                        cnsExtOutIntfType,
1719                        cnsExtOutQualityLevel,
1720                        cnsExtOutPriority,
1721                        cnsExtOutFSW,
1722                        cnsExtOutMSW,
1723                        cnsExtOutSquelch
1724                    }
1725    STATUS          current
1726    DESCRIPTION
1727        "This group contains all objects referenced by
1728        cnsExtOutputTable."
1729    ::= { ciscoNetsyncMIBGroups 4 }
1730
1731cnsT4ClkSrcObjectGroup OBJECT-GROUP
1732    OBJECTS         {
1733                        cnsT4ClkSrcName,
1734                        cnsT4ClkSrcIntfType,
1735                        cnsT4ClkSrcPriority,
1736                        cnsT4ClkSrcESMCCap,
1737                        cnsT4ClkSrcSSMCap,
1738                        cnsT4ClkSrcQualityLevelTxCfg,
1739                        cnsT4ClkSrcQualityLevelRxCfg,
1740                        cnsT4ClkSrcQualityLevelTx,
1741                        cnsT4ClkSrcQualityLevelRx,
1742                        cnsT4ClkSrcQualityLevel,
1743                        cnsT4ClkSrcHoldoffTime,
1744                        cnsT4ClkSrcWtrTime,
1745                        cnsT4ClkSrcLockout,
1746                        cnsT4ClkSrcSignalFailure,
1747                        cnsT4ClkSrcAlarm,
1748                        cnsT4ClkSrcAlarmInfo,
1749                        cnsT4ClkSrcFSW,
1750                        cnsT4ClkSrcMSW
1751                    }
1752    STATUS          current
1753    DESCRIPTION
1754        "This group contains all objects referenced by
1755        cnsT4ClockSourceTable."
1756    ::= { ciscoNetsyncMIBGroups 5 }
1757
1758cnsMIBNotifEnablesGroup OBJECT-GROUP
1759    OBJECTS {
1760        cnsMIBEnableStatusNotification
1761    }
1762    STATUS  current
1763    DESCRIPTION
1764        "The collection of objects which are used to
1765        enable notification.
1766        "
1767    ::= { ciscoNetsyncMIBGroups 6 }
1768
1769ciscoNetsyncMIBNotificationGroup NOTIFICATION-GROUP
1770   NOTIFICATIONS    {
1771                        ciscoNetsyncSelectedT0Clock,
1772                        ciscoNetsyncSelectedT4Clock,
1773                        ciscoNetsyncInputSignalFailureStatus,
1774                        ciscoNetsyncInputAlarmStatus
1775                    }
1776    STATUS          current
1777    DESCRIPTION
1778        "The is the netsync notification group."
1779    ::= { ciscoNetsyncMIBGroups 7 }
1780
1781
1782END
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875