1-- *****************************************************************
2-- CISCO VSI Master MIB
3-- Virtual Switch Interface Master MIB
4--
5-- September 1999, Steve Elias & Mike Lague
6--
7-- Copyright (c) 1999, 2000 by cisco Systems, Inc.
8-- All rights reserved.
9-- *****************************************************************
10
11CISCO-VSIMASTER-MIB DEFINITIONS ::= BEGIN
12
13IMPORTS
14     MODULE-IDENTITY, OBJECT-TYPE,
15     NOTIFICATION-TYPE,
16     Integer32, Gauge32, Counter32,
17     IpAddress                        FROM SNMPv2-SMI
18     SnmpAdminString                  FROM SNMP-FRAMEWORK-MIB
19     MODULE-COMPLIANCE, OBJECT-GROUP,
20     NOTIFICATION-GROUP               FROM SNMPv2-CONF
21     TEXTUAL-CONVENTION,
22     TruthValue                       FROM SNMPv2-TC
23     InterfaceIndex                   FROM IF-MIB
24     ciscoMgmt                        FROM CISCO-SMI;
25
26ciscoVsiMasterMIB     MODULE-IDENTITY
27     LAST-UPDATED     "200010170000Z"
28     ORGANIZATION     "Cisco Systems, Inc."
29     CONTACT-INFO
30          "           Cisco Systems
31                      Customer Service
32
33           Postal:    170 W Tasman Drive
34                      San Jose, CA  95134
35                      USA
36           Tel:       +1 800 553-NETS
37
38           e-mail:    cs-snmp@cisco.com
39          "
40
41    DESCRIPTION
42        "This MIB module contains objects related to the master side of
43           the Virtual Switch Interface protocol used for control of ATM
44           switches."
45
46    REVISION         "200010170000Z"
47    DESCRIPTION
48        "This version introduces NOTIFICATIONS capability."
49
50    REVISION         "200006010000Z"
51    DESCRIPTION
52        "Initial version of this MIB module."
53
54     ::=  { ciscoMgmt 162 }
55
56-- *****************************************************************
57-- VSI Master Textual Conventions
58-- *****************************************************************
59
60VsiControllerIndex ::= TEXTUAL-CONVENTION
61     STATUS          current
62     DESCRIPTION
63        "This textual convention defines the controller index for each
64         Virtual Switch Interface (VSI) controller in the domain of the
65         VSI Master.  The value is an internally generated unique number
66         with local significance only.  It must remain constant after
67         the VSI Master sub-system is initialized."
68     SYNTAX          Integer32 (1..2147483647)
69
70VsiSessionIndex ::= TEXTUAL-CONVENTION
71     STATUS          current
72     DESCRIPTION
73        "This textual convention defines a unique value, greater
74         than zero, for each VSI session in the managed system.
75         The value should remain constant after a VSI session
76         is reinitialized."
77     SYNTAX          Integer32 (1..2147483647)
78
79VsiLogicalIfIndex ::= TEXTUAL-CONVENTION
80     STATUS          current
81     DESCRIPTION
82        "This textual convention defines a unique value, greater than
83         zero, for each VSI logical interface controlled by the managed
84         system.  A logical interface index is an abstract number that
85         is generated  and provided by a Slave, and represents a virtual
86         interface.  It is used by the Master, when communicating
87         with the Slave, to gain access to interface data, including
88         ifIndex.  This is not a selector index for ifType, ifName,
89         ifOperState, and ifAdminState, etc."
90     SYNTAX          Integer32 (1..2147483647)
91
92VsiXCIndex ::= TEXTUAL-CONVENTION
93     STATUS          current
94     DESCRIPTION
95        "This textual convention defines a unique value, greater
96         than zero, for each cross-connect on a managed system
97         controlled by VSI.  The value should remain constant
98         after a cross-connect is initialized, for the duration
99         of the life of the cross-connect."
100     SYNTAX          Integer32 (1..2147483647)
101
102
103-- *****************************************************************
104--   Top-level structure of the MIB
105-- *****************************************************************
106
107ciscoVsiMasterObjects
108                        OBJECT IDENTIFIER ::= { ciscoVsiMasterMIB 1 }
109ciscoVsiMasterNotifications
110                        OBJECT IDENTIFIER ::= { ciscoVsiMasterMIB 2 }
111ciscoVsiMasterConformance
112                        OBJECT IDENTIFIER ::= { ciscoVsiMasterMIB 3 }
113
114
115-- *****************************************************************
116--   VSI Master Controller Objects
117-- *****************************************************************
118
119
120vsiMasterControllerTable     OBJECT-TYPE
121     SYNTAX          SEQUENCE OF VsiMasterControllerEntry
122     MAX-ACCESS      not-accessible
123     STATUS          current
124     DESCRIPTION
125        "A table containing a set of VSI controllers.  Each controller
126         represents an instance of the VSI Master control protocol.
127         A controller communicates with a set of VSI Slaves across
128         a control interface.  Running the VSI protocol, the controller
129         supports a network control application.
130         Through VSI, such an application can control the Virtual
131         Circuit cross-connect table inside the ATM switch,
132         perform monitoring and statistics collection of interfaces and
133         virtual circuits on the switch, and discover configuration
134         information from within the switch."
135     ::= { ciscoVsiMasterObjects 1 }
136
137vsiMasterControllerEntry OBJECT-TYPE
138     SYNTAX          VsiMasterControllerEntry
139     MAX-ACCESS      not-accessible
140     STATUS          current
141     DESCRIPTION
142        "An entry containing management information applicable to a
143         controller which uses the VSI protocol.  Controller entries
144         represent internally generated control structures.  Therefore
145         each row is created by the agent in response to the learning of
146         a controller's instantiation.   Instantiation of a controller
147         is performed by the VSI Master protocol implementation under
148         management via this MIB.  These structures, once instantiated,
149         are never deleted.  Each controller manages a set of VSI
150         slaves, via a protocol instance called a Session."
151
152     INDEX { vsiControllerIndex }
153     ::= { vsiMasterControllerTable 1 }
154
155VsiMasterControllerEntry ::=
156   SEQUENCE {
157     vsiControllerIndex            VsiControllerIndex,
158     vsiControllerId               Integer32,
159     vsiCrossConnects              Integer32,
160     vsiControllerType             INTEGER,
161     vsiBaseVersionSupported       Integer32,
162     vsiTopVersionSupported        Integer32,
163     vsiVersionInUse               Integer32,
164     vsiSpecifiedVersion           Integer32,
165     vsiControlInterface           InterfaceIndex,
166     vsiLogicalControlInterface    VsiLogicalIfIndex,
167     vsiControlIfIpAddress         IpAddress,
168     vsiAvailableChnlWarnThreshold Integer32,
169     vsiAvailableChnlAlarmThreshold  Integer32,
170     vsiAvailableChnlThresholdStatus INTEGER
171     }
172
173vsiControllerIndex   OBJECT-TYPE
174     SYNTAX          VsiControllerIndex
175     MAX-ACCESS      read-only
176     STATUS          current
177     DESCRIPTION
178        "A unique value per VSI controller, greater than 0.  This
179         object gets its value from the vsiControllerId, and is used
180         for row selection within the vsiMasterControllerTable."
181     ::= { vsiMasterControllerEntry 1 }
182
183
184vsiControllerId      OBJECT-TYPE
185     SYNTAX          Integer32 (0..255)
186     MAX-ACCESS      read-only
187     STATUS          current
188     DESCRIPTION
189        "The controller identifier for the VSI controller.  Values are
190         arbitrarily assigned by the VSI protocol implementation being
191         managed via this MIB, with local significance only.  These
192         values appear in the header of all VSI protocol messages."
193     ::= { vsiMasterControllerEntry 2 }
194
195vsiCrossConnects     OBJECT-TYPE
196     SYNTAX          Integer32 (0..2147483647)
197     MAX-ACCESS      read-only
198     STATUS          current
199     DESCRIPTION
200        "This object contains a value equal to the number of
201         cross-connects being controlled via VSI protocol via
202         this controller."
203     ::= { vsiMasterControllerEntry 3 }
204
205vsiControllerType     OBJECT-TYPE
206     SYNTAX           INTEGER {
207          other(1),
208          mpls(2),   -- Multi Protocol Label Switching
209          pnni(3),   -- Private Network to Network Interface
210          par(4) }   -- Portable Autoroute
211     MAX-ACCESS  read-only
212     STATUS     current
213     DESCRIPTION
214        "A VSI controller represents an instance of a service layer
215         accessible to a network control application.  This object
216         serves to identify the type of the network control
217         application currently being supported by this controller.
218         other(1): the type is unspecified.
219         mpls(2): indicates that the client is a Label Switch
220                  Controller performing Multi Protocol Label Switching.
221         pnni(3): indicates that the client is an instance of the
222                  ATM Private Network to Network Interface.
223         par(4): indicates that the client is an instance of ATM
224                  Portable Autoroute."
225     ::= { vsiMasterControllerEntry 4 }
226
227vsiBaseVersionSupported OBJECT-TYPE
228     SYNTAX          Integer32 (1..255)
229     MAX-ACCESS      read-only
230     STATUS          current
231     DESCRIPTION
232        "A VSI Master protocol instance defines internally a set of
233         versions of the protocol that it will support.  These versions
234         are numbered, by default, starting from 1.  This object
235         makes available the lowest numbered version that the VSI
236         Master protocol supports.  This object is related to the other
237         vsiMasterControllerEntry objects, vsiTopVersionSupported and
238         vsiVersionInUse."
239      ::= { vsiMasterControllerEntry 5 }
240
241vsiTopVersionSupported     OBJECT-TYPE
242     SYNTAX          Integer32 (1..255)
243     MAX-ACCESS      read-only
244     STATUS          current
245     DESCRIPTION
246        "A VSI Master protocol instance defines internally a set of
247         versions of the protocol that it will support.  These versions
248         are numbered, by default, starting from 1.  This object
249         makes available the highest numbered version that the VSI
250         Master protocol supports.  This object is related to the other
251         vsiMasterControllerEntry objects, vsiBaseVersionSupported and
252         vsiVersionInUse."
253     ::= { vsiMasterControllerEntry 6 }
254
255vsiVersionInUse      OBJECT-TYPE
256     SYNTAX          Integer32 (1..255)
257     MAX-ACCESS      read-only
258     STATUS          current
259     DESCRIPTION
260        "The number of the VSI version currently being used by this
261         controller.  Protocol selection procedures dictate that this
262         should be the highest value of protocol version, between
263         vsiBaseVersionSupported and vsiTopVersionSupported, that is
264         supported by all slaves.  An exception to this rule will
265         occur when the version is constrained to a specific value
266         indicated by the vsiSpecifiedVersion object."
267      ::= { vsiMasterControllerEntry 7 }
268
269vsiSpecifiedVersion  OBJECT-TYPE
270     SYNTAX          Integer32 (0..255)
271     MAX-ACCESS      read-write
272     STATUS          current
273     DESCRIPTION
274        "When this object is written with a non-zero value,
275	re-synchronization procedures will be initiated, if necessary,
276	in order to constrain the master and slaves to use the
277         indicated protocol version. When written with zero (0), the
278         master and slaves should use the version dictated by the
279         usual protocol version selection procedures; resynchronization
280         procedures will be invoked, if necessary, to achieve this
281         result."
282      ::= { vsiMasterControllerEntry 8 }
283
284vsiControlInterface  OBJECT-TYPE
285     SYNTAX          InterfaceIndex
286     MAX-ACCESS      read-only
287     STATUS          current
288     DESCRIPTION
289        "A VSI controller communicates with a set of VSI Slaves
290         across a control interface.  The controller is connected to
291         the ATM switch via an ATM link called the Slave Control Link.
292         The interface at the Master end of the link is the Master
293         Control Port, and is described by this object; it is the
294         ifIndex of this Master Control Port."
295      ::= { vsiMasterControllerEntry 9 }
296
297vsiLogicalControlInterface     OBJECT-TYPE
298     SYNTAX          VsiLogicalIfIndex
299     MAX-ACCESS      read-only
300     STATUS          current
301     DESCRIPTION
302        "This object describes the instance of a logical interface index
303         bound to the slave end of the Slave Control Link, which is
304         referred to in the description of vsiControlInterface."
305     ::= { vsiMasterControllerEntry 10 }
306
307vsiControlIfIpAddress  OBJECT-TYPE
308     SYNTAX          IpAddress
309     MAX-ACCESS      read-only
310     STATUS          current
311     DESCRIPTION
312        "The IP address of the interface identified by
313         the associated vsiControlInterface object."
314      ::= { vsiMasterControllerEntry 11 }
315
316vsiAvailableChnlWarnThreshold  OBJECT-TYPE
317     SYNTAX          Integer32 (0..100)
318     MAX-ACCESS      read-write
319     STATUS          current
320     DESCRIPTION
321        "A controller has in its domain multiple instances of the
322         vsiLogicalIfAvailIngressChnls and
323         vsiLogicalIfAvailEgressChnls counters.  This set of values,
324         associated with all the logical interfaces in the
325         vsiLogicalIfTable, is monitored so as to note the minimum
326         value.
327
328         The minimum observed value is compared against this threshold
329         object.  If the minimum observed value is less than this
330         threshold, and the value at the last comparison was greater
331         than or equal to this threshold, a single event will be
332         generated, to indicate a warning that available channels are
333         being depleted.  After a warning event is generated, another
334         such event will not be generated unless the
335         vsiAvailableChnlAlarmThreshold is reached.  If the
336         vsiAvailableChnlAlarmThreshold is reached and then the minimum
337         observed value is greater than or equal to this threshold, a
338         single event is generated, to indicate that a recovery
339         of resources has occurred.
340
341         If this object contains the value zero, then the thresholding
342         operation will be disabled.  Otherwise, the value of this
343         object must be greater than or equal to the value of the
344         associated vsiAvailableChnlAlarmThreshold object.
345         Notification emissions are also gated by the
346         vsiXCTrapEnable object."
347
348      DEFVAL        { 0 }
349      ::= { vsiMasterControllerEntry 12 }
350
351vsiAvailableChnlAlarmThreshold  OBJECT-TYPE
352     SYNTAX          Integer32 (0..100)
353     MAX-ACCESS      read-write
354     STATUS          current
355     DESCRIPTION
356        "A controller has in its domain multiple instances of the
357         vsiLogicalIfAvailIngressChnls and
358         vsiLogicalIfAvailEgressChnls counters.  This set of values,
359         associated with all the logical interfaces in the
360         vsiLogicalIfTable, is monitored so as to note the minimum
361         value.
362
363         The minimum observed value is compared against this threshold
364         object.  If the minimum observed value is less than this
365         threshold, and the value at the last comparison was greater
366         than or equal to this threshold, a single event will be
367         generated, to indicate an alarm that available channels are
368         being depleted.  After an alarm event is generated, another
369         such event will not be generated unless the
370         vsiAvailableChnlWarnThreshold is reached.
371
372         If this object contains the value zero, then the thresholding
373         operation will be disabled.  Otherwise, the value of this
374         object must be less than or equal to the value of the
375         associated vsiAvailableChnlWarnThreshold object.
376         Notification emissions are also gated by the
377         vsiXCTrapEnable object."
378
379      DEFVAL        { 0 }
380      ::= { vsiMasterControllerEntry 13 }
381
382vsiAvailableChnlThresholdStatus OBJECT-TYPE
383     SYNTAX         INTEGER {
384                     warning(1),
385                     alarm(2),
386                     recovery(3),
387                     normal(4) }
388     MAX-ACCESS      read-only
389     STATUS          current
390     DESCRIPTION
391        "As described for the vsiAvailableChnlWarnThreshold and
392         vsiAvailableChnlAlarmThreshold objects, events are generated
393         when these thresholds are crossed.  This object defines a
394         set of unique values that are used with the
395         vsiLcnExhaustionNotice to convey information about the
396         context of a threshold crossing.
397
398         warning(1): the event qualifier for indicating
399                     vsiAvailableChnlWarnThreshold violations.
400         alarm(2): the event qualifier for indicating
401                   vsiAvailableChnlAlarmThreshold violations.
402         recovery(3): the event qualifier for indicating
403                      vsiAvailableChnlWarnThreshold recovery.
404         normal(4): the initial value that indicates that no
405                    thresholds have been crossed."
406      ::= { vsiMasterControllerEntry 14 }
407
408
409-- *****************************************************************
410--   VSI Master Session Objects
411-- *****************************************************************
412
413vsiSessionTable      OBJECT-TYPE
414     SYNTAX          SEQUENCE OF VsiSessionEntry
415     MAX-ACCESS      not-accessible
416     STATUS          current
417     DESCRIPTION
418        "A table containing VSI master-slave session status information.
419         Each VSI controller manages a set of VSI slaves, via a protocol
420         instance called a Session.  VSI slaves are entities that reside
421         on the controlled ATM switch.  Their number and characteristics
422         are discovered by the VSI controller via the VSI protocol.
423         This table has an entry for each slave so discovered."
424     ::= { ciscoVsiMasterObjects 2 }
425
426vsiSessionEntry      OBJECT-TYPE
427     SYNTAX          VsiSessionEntry
428     MAX-ACCESS      not-accessible
429     STATUS          current
430     DESCRIPTION
431        "A vsiSessionEntry is a set of objects that together represent
432         the status of each instance of VSI protocol and the slave in
433         an ATM switch to which that instance corresponds.  There is
434         one vsiSession for each slave.  The number of slaves is
435         discovered via the VSI protocol.  Each slave is responsible
436         for a subset of the total number of external interfaces on
437         the ATM switch.   Session entries refer back to their
438         respective controllers via vsiSessionControllerIndex, and
439         are in turn referred to by vsiLogicalIfSessionIndex in the
440         VsiLogicalIfEntry.  These entries are never deleted."
441     INDEX          { vsiSessionControllerIndex, vsiSessionIndex }
442     ::= { vsiSessionTable 1 }
443
444VsiSessionEntry ::=
445     SEQUENCE {
446      vsiSessionControllerIndex VsiControllerIndex,
447      vsiSessionIndex          VsiSessionIndex,
448      vsiSessionVpi            Integer32,
449      vsiSessionVci            Integer32,
450      vsiSessionSwitchId       Integer32,
451      vsiSessionSwitchName     SnmpAdminString,
452      vsiSessionSlaveId        Integer32,
453      vsiSessionState          INTEGER,
454      vsiSessionWindowSize     Integer32,
455      vsiSessionCmdsPending    Gauge32,
456      vsiSessionActiveId       Integer32,
457      vsiSessionPowerupId      Integer32
458      }
459
460vsiSessionControllerIndex     OBJECT-TYPE
461     SYNTAX          VsiControllerIndex
462     MAX-ACCESS      not-accessible
463     STATUS          current
464     DESCRIPTION
465        "The ID of the controller which controls this master-slave
466         session.  This identifies which vsiMasterControllerEntry
467         represents the controller communicating with a slave through
468         this Session."
469     ::= { vsiSessionEntry 1 }
470
471vsiSessionIndex      OBJECT-TYPE
472     SYNTAX          VsiSessionIndex
473     MAX-ACCESS      not-accessible
474     STATUS          current
475     DESCRIPTION
476        "A VSI controller discovers a set of slaves through VSI
477         protocol.  Each of the discovered slaves is bound to a
478         protocol Session and each of these Sessions occupies a
479         row in the vsiSessionTable.  This object is the row selector.
480         The value should remain constant after a VSI session is
481         reinitialized."
482      ::= { vsiSessionEntry 2 }
483
484vsiSessionVpi        OBJECT-TYPE
485     SYNTAX          Integer32 (0..4095)
486     MAX-ACCESS      read-only
487     STATUS          current
488     DESCRIPTION
489        "The virtual path identifier for this VSI master-slave session.
490         The Slave Control Link, referred to in the description of
491         vsiLogicalControlInterface, supports an ATM control VC.  This
492         is the vpi for that link."
493     ::= { vsiSessionEntry 3 }
494
495vsiSessionVci        OBJECT-TYPE
496     SYNTAX          Integer32 (0..65535)
497     MAX-ACCESS      read-only
498     STATUS          current
499     DESCRIPTION
500        "The virtual channel identifier for this VSI master-slave
501         session.  The Slave Control Link, referred to in the
502         description of vsiLogicalControlInterface, supports an
503         ATM control VC.  This is the vci for that link."
504     ::= { vsiSessionEntry 4 }
505
506vsiSessionSwitchId   OBJECT-TYPE
507     SYNTAX          Integer32 (0..255)
508     MAX-ACCESS      read-only
509     STATUS          current
510     DESCRIPTION
511        "The identifier of the switch which participates in this VSI
512         master-slave session.  The switch terminates the virtual
513         circuit identified by the vpi/vci pair referred to by
514         vsiSessionVpi and vsiSessionVci."
515     ::= { vsiSessionEntry 5 }
516
517vsiSessionSwitchName OBJECT-TYPE
518     SYNTAX          SnmpAdminString
519     MAX-ACCESS      read-only
520     STATUS          current
521     DESCRIPTION
522        "The IP hostname for the slave switch which is controlled by
523         this session.  This is an ascii string of maximum
524         length 64 characters, learned from the ATM switch."
525     ::= { vsiSessionEntry 6 }
526
527vsiSessionSlaveId    OBJECT-TYPE
528     SYNTAX          Integer32 (0..255)
529     MAX-ACCESS      read-only
530     STATUS          current
531     DESCRIPTION
532        "The identifier of the slave for this VSI master-slave session.
533         This value is learned from the slave on the switch."
534      ::= { vsiSessionEntry 7 }
535
536vsiSessionState      OBJECT-TYPE
537     SYNTAX          INTEGER {
538                       inactive(1),
539                       unknown(2),
540                       configuring(3),
541                       resyncStarting(4),
542                       resyncUnderway(5),
543                       resyncEnding(6),
544                       discovery(7),
545                       established(8),
546                       shutdownStarting(9)
547                      }
548     MAX-ACCESS      read-only
549     STATUS          current
550     DESCRIPTION
551        "The state of the VSI session.
552         inactive(1): communications data structures for communicating
553         with the slave have been created, but the VSI protocol has
554         not been started.
555         unknown(2): slave has been queried, but its configuration data
556         has not yet been received.
557         configuring(3): configuration data has been sent to the slave,
558         but a response has not yet been received.
559         resyncStarting(4): a re-sync command has been sent to the
560         slave but a response has not yet been received.
561         resyncUnderway(5): a re-sync command response has been
562         received from the slave, but the network applications have
563         not yet completed reasserting connections.
564         resyncEnding(6): a command has been sent to end re-sync, but
565         a response has not yet been received.
566         discovery(7): a query has been sent to the slave for
567         interface information, but a response has not yet
568         been received.
569         established(8): discovery has completed.
570         shutdownStarting(9): the master has started an orderly
571         shutdown of the slave."
572     ::= { vsiSessionEntry 8 }
573
574vsiSessionWindowSize     OBJECT-TYPE
575     SYNTAX          Integer32 (0..65535)
576     MAX-ACCESS      read-only
577     STATUS          current
578     DESCRIPTION
579        "The maximum number of command messages the VSI master will
580         send before requiring a response from slave.  If the value
581         is 0, then flow control is not enabled."
582     ::= { vsiSessionEntry 9 }
583
584vsiSessionCmdsPending    OBJECT-TYPE
585     SYNTAX          Gauge32 (0..65535)
586     MAX-ACCESS      read-only
587     STATUS          current
588     DESCRIPTION
589        "The number of unacknowledged command messages.  The VSI master
590         sends commands to the slave, without receiving acknowledgement,
591         until the window size threshold has been reached.  This
592         object is a count of the number of commands that have been
593         sent and that are awaiting acknowledgment."
594     ::= { vsiSessionEntry 10 }
595
596vsiSessionActiveId   OBJECT-TYPE
597     SYNTAX          Integer32 (0..2147483647)
598     MAX-ACCESS      read-only
599     STATUS          current
600     DESCRIPTION
601        "ID supplied by the slave to identify the session.  This value
602         is interpreted by the master, when a change occurs, to
603         indicate that a resync should be inititated."
604     ::= { vsiSessionEntry 11 }
605
606vsiSessionPowerupId  OBJECT-TYPE
607     SYNTAX          Integer32 (0..2147483647)
608     MAX-ACCESS      read-only
609     STATUS          current
610     DESCRIPTION
611        "ID supplied by the slave to identify the session at powerup.
612         This is the initial value for vsiSessionActiveId, and its
613         default is zero.  Changes in vsiSessionActiveId signal a
614         resync."
615     ::= { vsiSessionEntry 12 }
616
617-- *****************************************************************
618--   VSI Master Logical Interface Objects
619-- *****************************************************************
620
621vsiLogicalIfTable    OBJECT-TYPE
622     SYNTAX          SEQUENCE OF VsiLogicalIfEntry
623     MAX-ACCESS      not-accessible
624     STATUS          current
625     DESCRIPTION
626        "A table containing information about logical interfaces
627         on the slave switch controlled via VSI.  Logical interfaces
628         are an abstraction of exposed, external ATM interfaces that
629         are available for connections.  When two external interfaces,
630         represented by two logical interfaces, are paired, they
631         provide physical paths through the switch.  These physical
632         pathways support cross-connects."
633     ::= { ciscoVsiMasterObjects 3 }
634
635vsiLogicalIfEntry    OBJECT-TYPE
636     SYNTAX          VsiLogicalIfEntry
637     MAX-ACCESS      not-accessible
638     STATUS          current
639     DESCRIPTION
640        "An entry containing information about a single VSI
641         logical interface.  Entries are instantiated and removed
642         as signalled by the slave which controls the external
643         interface.  Each entry contains information about the
644         capacity of cross-connects the interface can bear, cell
645         rate, merge capability, vpi/vci ranges, and statistics.
646         Pairs of logical interfaces support potential cross-connects
647         that, when actualized, are represented by the vsiXCEntrys
648         in the vsiXCTable.
649         Logical interfaces are controlled by a designated slave,
650         as determined by the switch.  The slave is in the
651         domain of the controller whose identity is given
652         by vsiLogicalIfControllerIndex.  This object is an opaque
653         identifier, provided by the slave, and used as a key to
654         identify the entry."
655     INDEX { vsiLogicalIfControllerIndex, vsiLogicalIfIndex }
656     ::= { vsiLogicalIfTable 1 }
657
658VsiLogicalIfEntry ::=
659     SEQUENCE {
660      vsiLogicalIfControllerIndex      VsiControllerIndex,
661      vsiLogicalIfIndex                VsiLogicalIfIndex,
662      vsiLogicalIfName                 SnmpAdminString,
663      vsiLogicalIfOperState            INTEGER,
664      vsiLogicalIfAdminState           INTEGER,
665      vsiLogicalIfRxCells              Counter32,
666      vsiLogicalIfTxCells              Counter32,
667      vsiLogicalIfRxCellsDiscarded     Counter32,
668      vsiLogicalIfTxCellsDiscarded     Counter32,
669      vsiLogicalIfRxHeaderErrors       Counter32,
670      vsiLogicalIfRxInvalidAddrs       Counter32,
671      vsiLogicalIfEndPointsInUse       Gauge32,
672      vsiLogicalIfAvailIngressChnls    Gauge32,
673      vsiLogicalIfAvailEgressChnls     Gauge32,
674      vsiLogicalIfAvailIngressCellRate Gauge32,
675      vsiLogicalIfAvailEgressCellRate  Gauge32,
676      vsiLogicalIfMaxIngressCellRate   Integer32,
677      vsiLogicalIfMaxEgressCellRate    Integer32,
678      vsiLogicalIfVcMergeSupported     TruthValue,
679      vsiLogicalIfMulticastSupported   TruthValue,
680      vsiLogicalIfVpiTranslated        TruthValue,
681      vsiLogicalIfStrictSigRange       TruthValue,
682      vsiLogicalIfMinVpi               INTEGER,
683      vsiLogicalIfMaxVpi               INTEGER,
684      vsiLogicalIfMinVci               INTEGER,
685      vsiLogicalIfMaxVci               INTEGER,
686      vsiLogicalControlIfIndex         InterfaceIndex,
687      vsiLogicalIfSessionIndex         VsiSessionIndex
688      }
689
690vsiLogicalIfControllerIndex    OBJECT-TYPE
691     SYNTAX          VsiControllerIndex
692     MAX-ACCESS      read-only
693     STATUS          current
694     DESCRIPTION
695        "The VSI controller index of the controller through which
696         this logical interface was learned."
697        ::= { vsiLogicalIfEntry 1 }
698
699vsiLogicalIfIndex    OBJECT-TYPE
700     SYNTAX          VsiLogicalIfIndex
701     MAX-ACCESS      read-only
702     STATUS          current
703     DESCRIPTION
704        "A unique value, greater than zero, for each VSI logical
705         interface.  Logical interface numbers are selected by the
706         switch to be unique and persistent.  The same number is
707         preserved through power failures.  This index is not the same
708         as an ifIndex.  It is an abstract number provided by the slave,
709         representing a virtual interface, which is an identifier to be
710         used when communicating with the slave about an interface."
711      ::= { vsiLogicalIfEntry 2 }
712
713vsiLogicalIfName     OBJECT-TYPE
714     SYNTAX          SnmpAdminString
715     MAX-ACCESS      read-only
716     STATUS          current
717     DESCRIPTION
718        "The physical descriptor of the logical interface, as
719         reported by the VSI slave.  It is distinct from ifName."
720     ::= { vsiLogicalIfEntry 3 }
721
722vsiLogicalIfOperState    OBJECT-TYPE
723     SYNTAX          INTEGER {
724                       removed(1),
725                       active(2),
726                       failedExternal(3),
727                       failedInternal(4)
728                     }
729     MAX-ACCESS      read-only
730     STATUS          current
731     DESCRIPTION
732        "The VSI operational state of the logical interface as
733         reported to the VSI master by the VSI slave.
734         removed(1): the interface is not a valid interface on this
735                     controller, is not part of the controller's
736                     partition, or is not available.
737         active(2): the interface is active and ready for use.
738         failedExternal(3): external failure, such as a line alarm,
739                            detected.
740         failedInternal(4): local hardware has detected a failure,
741                            making the interface unusable."
742     ::= { vsiLogicalIfEntry 4 }
743
744vsiLogicalIfAdminState     OBJECT-TYPE
745     SYNTAX          INTEGER {
746                       down(1),
747                       up(2),
748                       pendingDown(3) }
749     MAX-ACCESS      read-only
750     STATUS          current
751     DESCRIPTION
752        "The current administrative (configured) state of the
753         interface, as reported to the VSI master by the VSI slave.
754         down(1): the interface is not a valid interface for the
755         controller.
756         up(2): the interface is configured for use by the controller.
757         pendingDown(3): the interface is being removed from service,
758         and the controller is requested to remove all connections."
759      ::= { vsiLogicalIfEntry 5 }
760
761vsiLogicalIfRxCells  OBJECT-TYPE
762     SYNTAX          Counter32
763     MAX-ACCESS      read-only
764     STATUS          current
765     DESCRIPTION
766        "The number of cells received via this logical interface
767         as reported to the VSI master by the VSI slave."
768     ::= { vsiLogicalIfEntry 6 }
769
770vsiLogicalIfTxCells  OBJECT-TYPE
771     SYNTAX          Counter32
772     MAX-ACCESS      read-only
773     STATUS          current
774     DESCRIPTION
775        "The number of cells transmitted via this logical
776         interface as reported to the VSI master by the VSI slave."
777     ::= { vsiLogicalIfEntry 7 }
778
779vsiLogicalIfRxCellsDiscarded     OBJECT-TYPE
780     SYNTAX          Counter32
781     MAX-ACCESS      read-only
782     STATUS          current
783     DESCRIPTION
784        "The number of received cells discarded by this logical
785         interface as reported to the VSI master by the VSI slave."
786     ::= { vsiLogicalIfEntry 8 }
787
788vsiLogicalIfTxCellsDiscarded     OBJECT-TYPE
789     SYNTAX          Counter32
790     MAX-ACCESS      read-only
791     STATUS          current
792     DESCRIPTION
793        "The number of transmitted cells discarded by this logical
794         interface as reported to the VSI master by the VSI slave."
795     ::= { vsiLogicalIfEntry 9 }
796
797vsiLogicalIfRxHeaderErrors     OBJECT-TYPE
798     SYNTAX          Counter32
799     MAX-ACCESS      read-only
800     STATUS          current
801     DESCRIPTION
802        "The number of cells received via this logical
803         interface which had header errors, as reported to
804         the VSI master by the VSI slave."
805     ::= { vsiLogicalIfEntry 10 }
806
807vsiLogicalIfRxInvalidAddrs     OBJECT-TYPE
808     SYNTAX          Counter32
809     MAX-ACCESS      read-only
810     STATUS          current
811     DESCRIPTION
812         "The number of cells received by this logical
813          interface which had invalid addresses, as
814          reported to the VSI master by the VSI slave.
815          An unknown vpi/vci value set is an example of
816          of an invalid address."
817      ::= { vsiLogicalIfEntry 11 }
818
819vsiLogicalIfEndPointsInUse     OBJECT-TYPE
820     SYNTAX          Gauge32
821     MAX-ACCESS      read-only
822     STATUS          current
823     DESCRIPTION
824        "The number of end points in use on this logical
825         interface, as reported to the VSI master by the
826         VSI slave.  This reflects an aggregate count of
827         input, output and bi-directional end points.
828         If the logical interface has not been
829         removed, but does not currently support any cross
830         connects, this object will be reported as zero (0)."
831     ::= { vsiLogicalIfEntry 12 }
832
833vsiLogicalIfAvailIngressChnls     OBJECT-TYPE
834     SYNTAX          Gauge32
835     MAX-ACCESS      read-only
836     STATUS          current
837     DESCRIPTION
838        "The number of ingress channels available for this
839         logical interface, as reported to the VSI master
840         by the VSI slave."
841     ::= { vsiLogicalIfEntry 13 }
842
843vsiLogicalIfAvailEgressChnls     OBJECT-TYPE
844     SYNTAX          Gauge32
845     MAX-ACCESS      read-only
846     STATUS          current
847     DESCRIPTION
848        "The number of egress channels available for this
849         logical interface, as reported to the VSI master
850         by the VSI slave."
851     ::= { vsiLogicalIfEntry 14 }
852
853vsiLogicalIfAvailIngressCellRate OBJECT-TYPE
854     SYNTAX          Gauge32
855     MAX-ACCESS      read-only
856     STATUS          current
857     DESCRIPTION
858        "The available ingress cell rate in cells/second
859         for the logical interface, as reported to the VSI
860         master by the VSI slave."
861     ::= { vsiLogicalIfEntry 15 }
862
863vsiLogicalIfAvailEgressCellRate     OBJECT-TYPE
864     SYNTAX          Gauge32
865     MAX-ACCESS      read-only
866     STATUS          current
867     DESCRIPTION
868        "The available egress cell rate in cells/second
869         for the logical interface, as reported to the VSI
870         master by the VSI slave."
871     ::= { vsiLogicalIfEntry 16 }
872
873vsiLogicalIfVcMergeSupported     OBJECT-TYPE
874     SYNTAX          TruthValue
875     MAX-ACCESS      read-only
876     STATUS          current
877     DESCRIPTION
878        "If this object has the value true(1) then VC merge
879         capability is supported for this logical interface.
880         Otherwise VC merge capability is not supported on
881         this logical interface."
882     ::= { vsiLogicalIfEntry 17 }
883
884vsiLogicalIfMulticastSupported   OBJECT-TYPE
885     SYNTAX          TruthValue
886     MAX-ACCESS      read-only
887     STATUS          current
888     DESCRIPTION
889        "If this object has the value true(1) then multicast
890         capability is supported for this logical interface.
891         Otherwise multicast capability is not supported on
892         this logical interface."
893     ::= { vsiLogicalIfEntry 18 }
894
895vsiLogicalIfVpiTranslated        OBJECT-TYPE
896     SYNTAX          TruthValue
897     MAX-ACCESS      read-only
898     STATUS          current
899     DESCRIPTION
900        "If this object has the value true(1) then vpi values
901         entering on this logical interface are translated at
902         the other end of the link.  This translation may be
903         an indication that the link is supporting a tunnel.
904         Otherwise, vpi values are not translated for traversal
905         of the link."
906      ::= { vsiLogicalIfEntry 19 }
907
908vsiLogicalIfStrictSigRange       OBJECT-TYPE
909     SYNTAX          TruthValue
910     MAX-ACCESS      read-only
911     STATUS          current
912     DESCRIPTION
913        "If this object has the value true(1) then signalling
914         addresses must be in the strict advertised range for
915         the high-address (vpi).  Otherwise, signalling addresses
916         are not so constrained."
917     ::= { vsiLogicalIfEntry 20 }
918
919vsiLogicalIfMaxIngressCellRate   OBJECT-TYPE
920     SYNTAX          Integer32 (0..2147483647)
921     MAX-ACCESS      read-only
922     STATUS          current
923     DESCRIPTION
924        "The maximum ingress cell rate in cells/second for the
925         logical interface, as reported to the VSI.  This value is
926         the limiting value for vsiLogicalIfAvailIngressCellRate."
927     ::= { vsiLogicalIfEntry 21 }
928
929vsiLogicalIfMaxEgressCellRate     OBJECT-TYPE
930     SYNTAX          Integer32 (0..2147483647)
931     MAX-ACCESS      read-only
932     STATUS          current
933     DESCRIPTION
934        "The maximum egress cell rate in cells/second
935         for the logical interface, as reported to the VSI
936         master by the VSI slave."
937     ::= { vsiLogicalIfEntry 22 }
938
939vsiLogicalIfMinVpi   OBJECT-TYPE
940     SYNTAX          INTEGER (0..4095)
941     MAX-ACCESS      read-only
942     STATUS          current
943     DESCRIPTION
944        "Minimum allowed vpi value for this interface
945         as reported by VSI slave switch."
946     ::= { vsiLogicalIfEntry 23 }
947
948vsiLogicalIfMaxVpi   OBJECT-TYPE
949     SYNTAX          INTEGER(0..4095)
950     MAX-ACCESS      read-only
951     STATUS          current
952     DESCRIPTION
953        "Maximum allowed vpi value for this interface
954         as reported by VSI slave switch."
955     ::= { vsiLogicalIfEntry 24 }
956
957vsiLogicalIfMinVci   OBJECT-TYPE
958     SYNTAX          INTEGER(0..65535)
959     MAX-ACCESS      read-only
960     STATUS          current
961     DESCRIPTION
962        "Minimum allowed vci value for this interface
963         as reported by VSI slave switch."
964      ::= { vsiLogicalIfEntry 25 }
965
966vsiLogicalIfMaxVci   OBJECT-TYPE
967     SYNTAX          INTEGER(0..65535)
968     MAX-ACCESS      read-only
969     STATUS          current
970     DESCRIPTION
971        "Maximum allowed vci value for this interface
972         as reported by VSI slave switch."
973     ::= { vsiLogicalIfEntry 26 }
974
975vsiLogicalControlIfIndex  OBJECT-TYPE
976     SYNTAX          InterfaceIndex
977     MAX-ACCESS      read-only
978     STATUS          current
979     DESCRIPTION
980        "The interface index for the interface which
981         controls this logical interface.  This is the ifIndex
982         of the controlling network layer interface, and
983         is a direct manifestation of the mapping between
984         a logical interface and the real ifIndex."
985      ::= { vsiLogicalIfEntry 27 }
986
987vsiLogicalIfSessionIndex OBJECT-TYPE
988     SYNTAX          VsiSessionIndex
989     MAX-ACCESS      read-only
990     STATUS          current
991     DESCRIPTION
992        "All logical interfaces are in the domain of a VSI slave,
993         which communicates with the VSI master through a Session.
994         This object is a selector for an entry in the table
995         vsiSessionTable.  It is the VSI session index for the VSI
996         session which controls this logical interface."
997     ::= { vsiLogicalIfEntry 28 }
998
999 -- *****************************************************************
1000 --   VSI Master Cross-connect Objects
1001 -- *****************************************************************
1002
1003vsiXCTable           OBJECT-TYPE
1004     SYNTAX          SEQUENCE OF VsiXCEntry
1005     MAX-ACCESS      not-accessible
1006     STATUS          current
1007     DESCRIPTION
1008        "A table containing information about cross-connects
1009         on the slave switch controlled via VSI.  cross-connects
1010         represent virtual links across two interfaces.  The
1011         participating interfaces that support these links are
1012         represented in this MIB by the vsiLogicalIfTable entries."
1013     ::= { ciscoVsiMasterObjects 4 }
1014
1015vsiXCEntry           OBJECT-TYPE
1016     SYNTAX          VsiXCEntry
1017     MAX-ACCESS      not-accessible
1018     STATUS          current
1019     DESCRIPTION
1020        "An entry containing information about one unidirectional
1021         or bidirectional cross-connect on the slave switch
1022         controlled via VSI.  A VSI controller represents an instance
1023         of a service layer accessible to a network control application.
1024         The application creates virtual links via service requests to
1025         the controller, which in turn sends commands to the VSI slave,
1026         indicating the participating logical interfaces.  Conversely,
1027         links are taken down by a reverse process.  Virtual link
1028         creation and deletion come about as a result of routing
1029         decisions."
1030     INDEX { vsiXCControllerIndex,
1031          vsiXCLogicalIfLow,
1032          vsiXCLogicalIfHi,
1033          vsiXCIndex }
1034     ::= { vsiXCTable 1 }
1035
1036VsiXCEntry     ::=
1037     SEQUENCE {
1038          vsiXCControllerIndex    VsiControllerIndex,
1039          vsiXCLogicalIfLow       VsiLogicalIfIndex,
1040          vsiXCLogicalIfHi        VsiLogicalIfIndex,
1041          vsiXCIndex              VsiXCIndex,
1042          vsiXCState              INTEGER,
1043          vsiXCVpiLow             Integer32,
1044          vsiXCVciLow             Integer32,
1045          vsiXCVpiHi              Integer32,
1046          vsiXCVciHi              Integer32
1047          }
1048
1049vsiXCControllerIndex    OBJECT-TYPE
1050     SYNTAX          VsiControllerIndex
1051     MAX-ACCESS      read-only
1052     STATUS          current
1053     DESCRIPTION
1054        "The  index of the VSI controller through which this
1055         cross-connect was instantiated.  This object is the index for
1056         a vsiControllerTable entry;  the controller indexed is
1057         the VSI protocol partner to the slave that is controlling
1058         the logical interfaces on which this cross-connect is
1059         supported."
1060      ::= { vsiXCEntry 1 }
1061
1062vsiXCLogicalIfLow    OBJECT-TYPE
1063     SYNTAX          VsiLogicalIfIndex
1064     MAX-ACCESS      read-only
1065     STATUS          current
1066     DESCRIPTION
1067        "The VSI logical interface index for the first endpoint
1068         of the cross-connect.  This object is the selector index
1069         for one of the two vsiLogicalIfTable entries that support this
1070         cross-connect.  Further, this index value is constrained
1071         to be 'numerically lower than' the index value of the other
1072         vsiLogicalIfTable entry, indexed by vsiXCLogicalIfHi,
1073         supporting this cross-connect."
1074     ::= { vsiXCEntry 2 }
1075
1076vsiXCLogicalIfHi     OBJECT-TYPE
1077     SYNTAX          VsiLogicalIfIndex
1078     MAX-ACCESS      read-only
1079     STATUS          current
1080     DESCRIPTION
1081        "The VSI logical interface index for the second endpoint
1082         of the cross-connect.  This object is the selector index
1083         for one of the two vsiLogicalIfTable entries that support this
1084         cross-connect.  Further, this index value is constrained
1085         to be 'numerically higher than' the index value of the other
1086         vsiLogicalIfTable entry, indexed by vsiXCLogicalIfLow,
1087         supporting this cross-connect."
1088     ::= { vsiXCEntry 3 }
1089
1090vsiXCIndex           OBJECT-TYPE
1091     SYNTAX          VsiXCIndex
1092     MAX-ACCESS      read-only
1093     STATUS          current
1094     DESCRIPTION
1095        "A unique value greater than zero, for each cross-connect
1096         within the set of VsiXCTable entries indexed by
1097         vsiXCLogicalIfLow and vsiXCLogicalIfHi.
1098         The value should remain constant after a cross-connect
1099         is initialized.  These values are assigned in sequence
1100         by the management agent, starting from one (1)."
1101     ::= { vsiXCEntry 4 }
1102
1103vsiXCState          OBJECT-TYPE
1104     SYNTAX         INTEGER {
1105                       deleted(1),
1106                       reserved(2),
1107                       committed(3),
1108                       reservedFail(4)
1109                    }
1110     MAX-ACCESS      read-only
1111     STATUS          current
1112     DESCRIPTION
1113        "The operational state of the cross-connect, as reported
1114         to the VSI master by the VSI slave.
1115         deleted(1): the connection does not exist.
1116         reserved(2): connection is in the reserved state.
1117         committed(3): connection is in the committed state.
1118         reservedFail(4): connection is reserved but has an internal
1119                          failure."
1120      ::= { vsiXCEntry 5 }
1121
1122vsiXCVpiLow          OBJECT-TYPE
1123     SYNTAX          Integer32 (0..4095)
1124     MAX-ACCESS      read-only
1125     STATUS          current
1126     DESCRIPTION
1127        "The vpi of that endpoint of the cross-connect which
1128         terminates on the logical interface whose index is
1129         given by vsiXCLogicalIfLow."
1130     ::= { vsiXCEntry 6 }
1131
1132vsiXCVciLow          OBJECT-TYPE
1133     SYNTAX          Integer32(0..65535)
1134     MAX-ACCESS      read-only
1135     STATUS          current
1136     DESCRIPTION
1137        "The vci of that endpoint of the cross-connect which
1138         terminates on the logical interface whose index is
1139         given by vsiXCLogicalIfLow."
1140     ::= { vsiXCEntry 7 }
1141
1142vsiXCVpiHi           OBJECT-TYPE
1143     SYNTAX          Integer32(0..4095)
1144     MAX-ACCESS      read-only
1145     STATUS          current
1146     DESCRIPTION
1147        "The vpi of that endpoint of the cross-connect which
1148         terminates on the logical interface whose index is
1149         given by vsiXCLogicalIfHi."
1150     ::= { vsiXCEntry 8 }
1151
1152vsiXCVciHi           OBJECT-TYPE
1153     SYNTAX          Integer32(0..65535)
1154     MAX-ACCESS      read-only
1155     STATUS          current
1156     DESCRIPTION
1157        "The vci of that endpoint of the cross-connect which
1158         terminates on the logical interface whose index is
1159         given by vsiXCLogicalIfHi."
1160     ::= { vsiXCEntry 9 }
1161
1162
1163
1164-- Notification Configuration
1165
1166vsiControllerTrapEnable OBJECT-TYPE
1167     SYNTAX        TruthValue
1168     MAX-ACCESS    read-write
1169     STATUS        current
1170     DESCRIPTION
1171        "If this object is true, both vsiControllerAdded and
1172         vsiControllerDeleted notifications are enabled."
1173     DEFVAL { false }
1174     ::= { ciscoVsiMasterObjects 5 }
1175
1176vsiSessionTrapEnable OBJECT-TYPE
1177     SYNTAX        TruthValue
1178     MAX-ACCESS    read-write
1179     STATUS        current
1180     DESCRIPTION
1181        "If this object is true, both vsiSessionUp
1182         and vsiSessionDown notifications are enabled."
1183     DEFVAL { false }
1184     ::= { ciscoVsiMasterObjects 6 }
1185
1186vsiLogicalIfTrapEnable OBJECT-TYPE
1187     SYNTAX        TruthValue
1188     MAX-ACCESS    read-write
1189     STATUS        current
1190     DESCRIPTION
1191        "If this object is true, both vsiLogicalIfUp
1192         and vsiLogicalIfDown notifications are enabled."
1193     DEFVAL { false }
1194     ::= { ciscoVsiMasterObjects 7 }
1195
1196vsiXCTrapEnable OBJECT-TYPE
1197     SYNTAX        TruthValue
1198     MAX-ACCESS    read-write
1199     STATUS        current
1200     DESCRIPTION
1201        "If this object is true, both vsiXCFailed and
1202         vsiLcnExhaustionNotice notifications are enabled."
1203     DEFVAL { false }
1204     ::= { ciscoVsiMasterObjects 8 }
1205
1206vsiVSITrapEnable OBJECT-TYPE
1207     SYNTAX        TruthValue
1208     MAX-ACCESS    read-write
1209     STATUS        current
1210     DESCRIPTION
1211        "If this object is true, all of
1212         vsiControllerTrapEnable, vsiSessionTrapEnable,
1213         vsiLogicalIfTrapEnable, and vsiXCTrapEnable
1214         are also set to true.  This allows for enabling
1215         and disabling all notifications as a group."
1216     DEFVAL { false }
1217     ::= { ciscoVsiMasterObjects 9 }
1218
1219--
1220--   Notifications
1221--
1222
1223vsiControllerAdded NOTIFICATION-TYPE
1224     OBJECTS     { vsiControllerType }
1225     STATUS      current
1226     DESCRIPTION
1227        "This notification is generated when a vsiMasterControllerEntry
1228         is added to the vsiMasterControllerTable.
1229
1230         The vsiControllerType object identifies the type and instance
1231         of the entry that was added.
1232
1233         The agent will not generate this notification if the
1234         vsiControllerTrapEnable object is equal to 'false'."
1235     ::= { ciscoVsiMasterNotifications 1 }
1236
1237vsiControllerDeleted NOTIFICATION-TYPE
1238     OBJECTS     { vsiControllerType }
1239     STATUS      current
1240     DESCRIPTION
1241        "This notification is generated when a vsiMasterControllerEntry
1242         is deleted from the vsiMasterControllerTable.
1243
1244         The vsiControllerType object identifies the type and instance
1245         of the entry that was deleted.
1246
1247         The agent will not generate this notification if the
1248         vsiControllerTrapEnable object is equal to 'false'."
1249     ::= { ciscoVsiMasterNotifications 2 }
1250
1251vsiSessionUp NOTIFICATION-TYPE
1252     OBJECTS     { vsiSessionState}
1253     STATUS      current
1254     DESCRIPTION
1255        "This notification is generated when the vsiSessionState
1256         object transitions to the established(8) state.
1257
1258         The vsiSessionState object identifies the state and instance
1259         of the session, after the session has made the transition that
1260         caused the notification to be generated.
1261
1262         The agent will not generate this notification if the
1263         vsiSessionTrapEnable object is equal to 'false'."
1264
1265     ::= { ciscoVsiMasterNotifications 3 }
1266
1267vsiSessionDown NOTIFICATION-TYPE
1268     OBJECTS     { vsiSessionState }
1269     STATUS      current
1270     DESCRIPTION
1271        "This notification is generated when the vsiSessionState
1272         object transitions from any of unknown(1), configuring(2), or
1273         established(8) state to shutdownStarting(9) states.
1274         This notification is also generated when the vsiSessionState
1275         transitions from configuring(2) or established(8) state to
1276         the unknown(1) state.
1277
1278         The vsiSessionState object identifies the state and instance
1279         of the session, after the session has made the transition that
1280         caused the notification to be generated.
1281
1282         The agent will not generate this notification if the
1283         vsiSessionTrapEnable object is equal to 'false'."
1284     ::= { ciscoVsiMasterNotifications 4 }
1285
1286vsiLogicalIfUp NOTIFICATION-TYPE
1287     OBJECTS     { vsiLogicalIfOperState }
1288     STATUS      current
1289     DESCRIPTION
1290        "This notification is generated when the vsiLogicalIfOperState
1291         object transitions to the active(2) state.
1292
1293         The vsiLogicalIfOperState object identifies the state and
1294         instance of the logical interface, after the logical interface
1295         has made the transition that caused the notification to be
1296         generated.
1297
1298         The agent will not generate this notification if the
1299         vsiLogicalIfTrapEnable object is equal to 'false'."
1300     ::= { ciscoVsiMasterNotifications 5 }
1301
1302vsiLogicalIfDown NOTIFICATION-TYPE
1303     OBJECTS     { vsiLogicalIfOperState }
1304     STATUS      current
1305     DESCRIPTION
1306        "This notification is generated when the vsiLogicalIfOperState
1307         object transitions from the active(2) state to either the
1308         failedExternal(3) or failedInternal(4) state.
1309
1310         The vsiLogicalIfOperState object identifies the state and
1311         instance of the logical interface, after the logical interface
1312         has made the transition that caused the notification to be
1313         generated.
1314
1315         The agent will not generate this notification if the
1316         vsiLogicalIfTrapEnable object is equal to 'false'."
1317     ::= { ciscoVsiMasterNotifications 6 }
1318
1319vsiXCFailed NOTIFICATION-TYPE
1320     OBJECTS     { vsiXCControllerIndex,
1321                   vsiXCLogicalIfLow,
1322                   vsiXCLogicalIfHi }
1323     STATUS      current
1324     DESCRIPTION
1325        "This notification is generated when an attempt to create a
1326         cross-connect fails.  Failure means the slave has answered
1327         a connect command with a nak, reject, or error response.
1328
1329         The vsiXCControllerIndex object identifies the
1330         VsiControllerIndex of the VSI controller through which the
1331         cross-connect was attempted.
1332         The vsiXCLogicalIfLow object provides the lower valued
1333         VsiLogicalIfIndex of the logical interface on which the
1334         cross-connect was attempted.
1335         The vsiXCLogicalIfHi object provides the higher valued
1336         VsiLogicalIfIndex of the logical interface on which the
1337         cross-connect was attempted.
1338
1339         The agent will not generate this notification if the
1340         vsiXCTrapEnable object is equal to 'false'."
1341     ::= { ciscoVsiMasterNotifications 7 }
1342
1343vsiLcnExhaustionNotice NOTIFICATION-TYPE
1344     OBJECTS     { vsiControllerIndex,
1345                   vsiAvailableChnlThresholdStatus }
1346     STATUS      current
1347     DESCRIPTION
1348        "As cross-connects on logical interfaces are instantiated or
1349         released, and available channel counts are respectively
1350         diminished or augmented, there is a potential for the
1351         available channel counts to cross a threshold.  The threshold
1352         value may be crossed in the positive direction as the
1353         available channel count is rising, or in a negative direction
1354         as the available channel count is falling.  The threshold
1355         values are described as the vsiAvailableChnlWarnThreshold and
1356         the vsiAvailableChnlAlarmThreshold objects.
1357
1358         The vsiControllerIndex identifies the controller domain in
1359         which the threshold event took place.
1360         The vsiAvailableChnlThresholdStatus indicates the particular
1361         kind of threshold crossing that occurred.
1362
1363         When comparison with vsiAvailableChnlWarnThreshold indicates a
1364         negative crossing, this notification, with
1365         vsiAvailableChnlThresholdStatus:warning(1) is emitted.
1366         When comparison with vsiAvailableChnlAlarmThreshold indicates
1367         a negative threshold violation, this notification, with
1368         vsiAvailableChnlThresholdStatus:alarm(2) is emitted.
1369         When comparison with vsiAvailableChnlWarnThreshold indicates a
1370         positive threshold crossing, and if the preceeding
1371         vsiLcnExhaustionNotice had been sent with the
1372         vsiAvailableChnlThresholdStatus:alarm(2) parameter, this
1373         notification, with vsiAvailableChnlThresholdStatus:recovery(3)
1374         is emitted.
1375
1376         The agent will not generate this notification if the
1377         vsiXCTrapEnable is equal to 'false'."
1378     ::= { ciscoVsiMasterNotifications 8 }
1379
1380
1381-- End of notifications.
1382
1383
1384--********************************************************************
1385-- Module Conformance Statement
1386--********************************************************************
1387
1388ciscoVsiMasterGroups
1389                  OBJECT IDENTIFIER ::= { ciscoVsiMasterConformance 1 }
1390ciscoVsiMasterCompliances
1391                  OBJECT IDENTIFIER ::= { ciscoVsiMasterConformance 2 }
1392
1393--
1394-- Compliance Statements
1395--
1396
1397    ciscoVsiMasterModuleCompliance MODULE-COMPLIANCE
1398          STATUS deprecated
1399          DESCRIPTION
1400             "The basic implentation requirements for agents that
1401              support this VSI Master MIB."
1402          MODULE -- this module
1403              MANDATORY-GROUPS    { ciscoVsiMasterGeneralGroup }
1404          ::= { ciscoVsiMasterCompliances 1 }
1405
1406    ciscoVsi2MasterModuleCompliance MODULE-COMPLIANCE
1407          STATUS current
1408          DESCRIPTION
1409             "The implentation requirements for agents that
1410              support the VSI Master MIB with Notifications."
1411          MODULE -- this module
1412              MANDATORY-GROUPS  { ciscoVsiMasterGeneralGroup,
1413                                  ciscoVsi2MasterGroup,
1414                                  ciscoVsi2AlarmControlGroup,
1415                                  ciscoVsi2MasterNotificationGroup   }
1416          OBJECT     vsiSpecifiedVersion
1417          MIN-ACCESS read-only
1418          DESCRIPTION
1419             "Write access is not required."
1420          ::= { ciscoVsiMasterCompliances 2 }
1421
1422      -- units of conformance
1423
1424      ciscoVsiMasterGeneralGroup OBJECT-GROUP
1425          OBJECTS {
1426              vsiControllerIndex,
1427              vsiControllerId,
1428              vsiCrossConnects,
1429              vsiControllerType,
1430              vsiBaseVersionSupported,
1431              vsiTopVersionSupported,
1432              vsiVersionInUse,
1433              vsiSpecifiedVersion,
1434              vsiControlInterface,
1435              vsiLogicalControlInterface,
1436              vsiSessionVpi,
1437              vsiSessionVci,
1438              vsiSessionSwitchId,
1439              vsiSessionSwitchName,
1440              vsiSessionSlaveId,
1441              vsiSessionState,
1442              vsiSessionWindowSize,
1443              vsiSessionCmdsPending,
1444              vsiSessionActiveId,
1445              vsiSessionPowerupId,
1446              vsiLogicalIfControllerIndex,
1447              vsiLogicalIfIndex,
1448              vsiLogicalIfName,
1449              vsiLogicalIfOperState,
1450              vsiLogicalIfAdminState,
1451              vsiLogicalIfRxCells,
1452              vsiLogicalIfTxCells,
1453              vsiLogicalIfRxCellsDiscarded,
1454              vsiLogicalIfTxCellsDiscarded,
1455              vsiLogicalIfRxHeaderErrors,
1456              vsiLogicalIfRxInvalidAddrs,
1457              vsiLogicalIfEndPointsInUse,
1458              vsiLogicalIfAvailIngressChnls,
1459              vsiLogicalIfAvailEgressChnls,
1460              vsiLogicalIfAvailIngressCellRate,
1461              vsiLogicalIfAvailEgressCellRate,
1462              vsiLogicalIfMaxIngressCellRate,
1463              vsiLogicalIfMaxEgressCellRate,
1464              vsiLogicalIfVcMergeSupported,
1465              vsiLogicalIfMulticastSupported,
1466              vsiLogicalIfVpiTranslated,
1467              vsiLogicalIfStrictSigRange,
1468              vsiLogicalIfMinVpi,
1469              vsiLogicalIfMaxVpi,
1470              vsiLogicalIfMinVci,
1471              vsiLogicalIfMaxVci,
1472              vsiLogicalControlIfIndex,
1473              vsiLogicalIfSessionIndex,
1474              vsiXCControllerIndex,
1475              vsiXCLogicalIfLow,
1476              vsiXCLogicalIfHi,
1477              vsiXCIndex,
1478              vsiXCState,
1479              vsiXCVpiLow,
1480              vsiXCVciLow,
1481              vsiXCVpiHi,
1482              vsiXCVciHi
1483          }
1484          STATUS    current
1485          DESCRIPTION
1486              "Objects that apply to all VSI Master implementations."
1487          ::= { ciscoVsiMasterGroups 1 }
1488
1489      ciscoVsi2MasterGroup OBJECT-GROUP
1490          OBJECTS {
1491              vsiControlIfIpAddress,
1492              vsiAvailableChnlWarnThreshold,
1493              vsiAvailableChnlAlarmThreshold,
1494              vsiAvailableChnlThresholdStatus
1495          }
1496          STATUS    current
1497          DESCRIPTION
1498              "Objects that apply to all VSI Master implementations."
1499          ::= { ciscoVsiMasterGroups 2 }
1500
1501      ciscoVsi2AlarmControlGroup  OBJECT-GROUP
1502          OBJECTS {
1503              vsiControllerTrapEnable,
1504              vsiSessionTrapEnable,
1505              vsiLogicalIfTrapEnable,
1506              vsiXCTrapEnable,
1507              vsiVSITrapEnable
1508          }
1509          STATUS  current
1510          DESCRIPTION
1511              "Collection of objects needed to control
1512               (enable and disable)
1513               the generation of associated Notifications."
1514          ::= { ciscoVsiMasterGroups 3 }
1515
1516      ciscoVsi2MasterNotificationGroup NOTIFICATION-GROUP
1517          NOTIFICATIONS { vsiControllerAdded,
1518                          vsiControllerDeleted,
1519                          vsiSessionUp,
1520                          vsiSessionDown,
1521                          vsiLogicalIfUp,
1522                          vsiLogicalIfDown,
1523                          vsiXCFailed,
1524                          vsiLcnExhaustionNotice }
1525          STATUS  current
1526          DESCRIPTION
1527               "Set of notifications implemented in this module."
1528          ::= { ciscoVsiMasterGroups 4 }
1529
1530
1531
1532END
1533
1534
1535
1536