1-- *****************************************************************
2-- CISCO-SDLLC-MIB.my Cisco SDLLC MIB
3--
4-- April 1995, Bob Clouston
5--
6-- Copyright (c) 1995-1998 by cisco Systems, Inc.
7-- All rights reserved.
8-- *****************************************************************
9--
10
11CISCO-SDLLC-MIB DEFINITIONS ::= BEGIN
12
13--
14-- Definitions
15
16IMPORTS
17	MODULE-IDENTITY, OBJECT-TYPE, Integer32, NOTIFICATION-TYPE
18		FROM SNMPv2-SMI
19	MODULE-COMPLIANCE, OBJECT-GROUP
20		FROM SNMPv2-CONF
21	TruthValue, MacAddress
22		FROM SNMPv2-TC
23	ciscoMgmt
24		FROM CISCO-SMI
25	ifIndex
26		FROM IF-MIB;
27
28ciscoSnaSdllcMIB  MODULE-IDENTITY
29	LAST-UPDATED	"9812170000Z"
30	ORGANIZATION	"Cisco Systems, Inc."
31	CONTACT-INFO
32		"	Cisco Systems
33			Customer Service
34
35		Postal:	170 W. Tasman Drive
36			San Jose, CA  95134
37			USA
38
39		   Tel: +1 800 553-NETS
40
41		E-mail: cs-snmp@cisco.com"
42	DESCRIPTION
43		"This is the MIB module for objects used to manage SDLLC.
44
45   Overview of SDLLC conversion MIB
46
47
48   MIB description
49   The SDLLC MIB includes read-only configuration and operational
50   information on Cisco's implementation of SDLC to LLC2 media
51   translation.  The following example shows the entities managed
52   by the SDLLC MIB.
53
54
55    FEP/ ==  Token == CISCO A == WAN/RSRB == CISCO B == Serial == SDLC
56    Host     Ring                                       line      station
57
58     |=============== LLC2 session ============|=== SDLC session ====|
59
60     In this example configuration, CISCO B is performing the SDLLC
61     conversion, and so we query CISCO B for this MIB.
62     The SDLC device believes it is talking to the host via a direct
63     SDLC session.  The host believes it is talking to the SDLC station on
64     the same token ring.  CISCO A is also unaware of the SDLLC conversion
65     going on at CISCO B; it just believes it has an RSRB session with
66     its peer CISCO B to bridge two token ring separated by a WAN.
67     So CISCO B is the only agent that can provide the SDLLC conversion
68     details.  We can combine this MIB with the CISCO-RSRB-MIB from
69     either CISCO A or CISCO B to get a better picture of the network.
70
71     This MIB has two tables:
72
73     convSdllcPortTable has an entry for each serial interface for
74     general SDLLC information on an interface, such as administered
75     virtual MAC addresses and virtual ring and bridge numbers.
76     This table is indexed by ifIndex.
77
78     convSdllcAddrTable has an entry for each serial interface and
79     SDLC address pair.  It contains information specific to an SDLC
80     address on an interface, such as the partner MAC address,
81     XID value, and address state.  This table is indexed by ifIndex
82     and convSdllcAddrSdlcAddr (the address of the SDLC station).
83
84     The above configuration would have a single entry in each table.
85     If CISCO B had two serial lines configured for sdllc conversion,
86     there would be two entries per table.  If there
87     were only one serial line, but it was multipoint and
88     supported two sdlc addresses on the other end of the
89     line, there would be a single entry in convSdllcPortTable, and
90     two entries in convSdllcAddrTable.
91
92     The MIB provides the following information for convSdllcPortTable:
93
94     convSdllcPortVirtMacAddr - The locally administered MAC addressed
95       assigned to the serial interface.  Note that this address must
96       always end in '00'.  CISCO B replaces the 00 with the sdlc
97       address of the serial device.  For a multipoint configuration
98       with two SDLC stations the llc2 side will 'see' two token ring
99       stations with unique MAC addresses on the sdlc side.
100     convSdllcPortVirtRing - The locally administered token ring number
101       assigned to the serial interface.  This gives the serial interface
102       a token ring appearance to the llc2 side of the conversion, so
103       that it appears that it is a token ring on the other side of
104       a bridge.
105     convSdllcPortBridge - The bridge number assigned to CISCO B
106     convSdllcPortLlc2Ring - The token ring number on the LLC2 session
107       side.  In this case it is the RSRB virtual ring group number
108       between CISCO A and CISCO B.
109     convSdllcPortLocalAck - indicates whether local acknowledgement
110       of SDLLC sessions is active.
111     convSdllcPortLocalAckState - indicates the state of
112      the local acknowledgement session.
113     convSdllcPortMaxLlc2FrameSize - the largest I-frame size that
114       can be sent or received on the LLC2 session.
115
116     The MIB provides the following information for convSdllcAddrTable:
117     convSdllcAddrSdlcAddr - The address of the SDLC station.
118     convSdllcAddrPartnerMacAddr - The MAC address of the FEP, as
119       specified with the sdllc partner command.
120     convSdllcAddrXID - The IDBLK and IDNUM of the SDLC station;
121       these must match the VTAM configured values
122     convSdllcAddrState - indicates the state of the SDLLC conversion
123     convSdllcAddrMaxSdlcFrameSize - the largest I-frame size that
124       can be sent or received on the SDLC session.
125                            "
126	REVISION        "9508210000Z"
127	DESCRIPTION
128		"Minor cleanups to pacify mib compiler."
129        REVISION        "9812170000Z"
130        DESCRIPTION
131                "Removed the old description, rewrite to match the MIB
132                structure."
133	::= { ciscoMgmt 28 }
134
135convSdllcObjects    OBJECT IDENTIFIER ::= { ciscoSnaSdllcMIB 1 }
136convSdllcPorts OBJECT IDENTIFIER ::= { convSdllcObjects 1 }
137convSdllcAddrs OBJECT IDENTIFIER ::= { convSdllcObjects 2 }
138
139-- *************************************************************************
140-- * Serial Interface table
141-- *************************************************************************
142
143convSdllcPortTable OBJECT-TYPE
144    SYNTAX     SEQUENCE OF ConvSdllcPortEntry
145    MAX-ACCESS not-accessible
146    STATUS     current
147    DESCRIPTION
148        "Table of interfaces and SDLC addresses configured for SDLLC
149         conversion"
150    ::= { convSdllcPorts 1 }
151
152convSdllcPortEntry OBJECT-TYPE
153    SYNTAX     ConvSdllcPortEntry
154    MAX-ACCESS not-accessible
155    STATUS     current
156    DESCRIPTION
157        "Status and configuration values for a specific SDLLC conversion
158         interface and SDLC address. "
159    INDEX { ifIndex }
160    ::= { convSdllcPortTable 1 }
161
162ConvSdllcPortEntry ::=
163    SEQUENCE {
164        convSdllcPortVirtMacAddr      MacAddress,
165        convSdllcPortVirtRing         Integer32,
166        convSdllcPortBridge           Integer32,
167        convSdllcPortLlc2Ring         Integer32,
168        convSdllcPortLocalAck         TruthValue,
169        convSdllcPortLocalAckState    INTEGER,
170        convSdllcPortMaxLlc2FrameSize Integer32
171     }
172
173convSdllcPortVirtMacAddr  OBJECT-TYPE
174    SYNTAX     MacAddress
175    MAX-ACCESS read-only
176    STATUS     current
177    DESCRIPTION
178     "The local administered virtual MAC address for the device on
179      the serial interface."
180    ::= { convSdllcPortEntry 1 }
181
182convSdllcPortVirtRing  OBJECT-TYPE
183    SYNTAX     Integer32
184    MAX-ACCESS read-only
185    STATUS     current
186    DESCRIPTION
187      "The virtual ring number assigned to the serial interface."
188    ::= { convSdllcPortEntry 2 }
189
190convSdllcPortBridge OBJECT-TYPE
191    SYNTAX     Integer32
192    MAX-ACCESS read-only
193    STATUS     current
194    DESCRIPTION
195      "The bridge number assigned to SDLLC conversion."
196    ::= { convSdllcPortEntry 3 }
197
198convSdllcPortLlc2Ring OBJECT-TYPE
199    SYNTAX     Integer32
200    MAX-ACCESS read-only
201    STATUS     current
202    DESCRIPTION
203      "The ring number assigned to the LLC2 side of the SDLLC conversion."
204    ::= { convSdllcPortEntry 4 }
205
206
207convSdllcPortLocalAck OBJECT-TYPE
208    SYNTAX     TruthValue
209    MAX-ACCESS read-only
210    STATUS     current
211    DESCRIPTION
212      "Indicates if all SDLLC sessions are locally acknowledged.
213
214       TRUE-> SDLLC sessions are locally acknowledged
215       FALSE-> SDLLC sessions are not locally acknowledged
216      "
217    ::= { convSdllcPortEntry 5 }
218
219convSdllcPortLocalAckState OBJECT-TYPE
220    SYNTAX      INTEGER
221     {
222      disconnected   (1),     -- LAK not connected, but peers may be
223      localDiscWait  (2),     -- Waiting for local peer to disconnect
224      remDiscWait    (3),     -- Waiting for remote peer to disconnect
225      remWait        (4),     -- Waiting for peer to open
226      localWait	     (5),     -- Waiting for local LLC2 to open
227      connectPending (6),     -- Synchronize us before final connect
228      connected      (7),     -- Full data transfer possible
229      remQOnWait     (8),     -- Waiting for Quench on acknowledgement
230      remQOffWait    (9),     -- Waiting for Quench off acknowledgement
231      quenched       (10),    -- We're quenched, expect no data
232      unknown        (255)    -- Unknown or not-applicable state
233      }
234    MAX-ACCESS  read-only
235    STATUS      current
236    DESCRIPTION
237      "State of the local acknowledgment session between two stations."
238    ::= { convSdllcPortEntry 6 }
239
240convSdllcPortMaxLlc2FrameSize OBJECT-TYPE
241    SYNTAX     Integer32
242    MAX-ACCESS read-only
243    STATUS     current
244    DESCRIPTION
245      "The largest information frame (I-frame) size that can be sent or
246       received on the LLC2 session."
247    ::= { convSdllcPortEntry 7 }
248
249-- *************************************************************************
250-- * Address table
251-- *************************************************************************
252
253convSdllcAddrTable OBJECT-TYPE
254    SYNTAX     SEQUENCE OF ConvSdllcAddrEntry
255    MAX-ACCESS not-accessible
256    STATUS     current
257    DESCRIPTION
258        "Table of SDLC addresses configured for SDLLC
259         conversion on a particular interface."
260    ::= { convSdllcAddrs 1 }
261
262convSdllcAddrEntry OBJECT-TYPE
263    SYNTAX     ConvSdllcAddrEntry
264    MAX-ACCESS not-accessible
265    STATUS     current
266    DESCRIPTION
267        "Status and configuration values for a specific SDLLC conversion
268         SDLC address. "
269    INDEX { ifIndex, convSdllcAddrSdlcAddr }
270    ::= { convSdllcAddrTable 1 }
271
272ConvSdllcAddrEntry ::=
273    SEQUENCE {
274        convSdllcAddrSdlcAddr         INTEGER,
275        convSdllcAddrPartnerMacAddr   MacAddress,
276        convSdllcAddrXID              OCTET STRING,
277        convSdllcAddrState            INTEGER,
278        convSdllcAddrMaxSdlcFrameSize Integer32
279    }
280
281convSdllcAddrSdlcAddr OBJECT-TYPE
282    SYNTAX     INTEGER(0..255)
283    MAX-ACCESS not-accessible
284    STATUS     current
285    DESCRIPTION
286      "The address of the SDLC station."
287    ::= { convSdllcAddrEntry 1 }
288
289
290convSdllcAddrPartnerMacAddr OBJECT-TYPE
291    SYNTAX     MacAddress
292    MAX-ACCESS read-only
293    STATUS     current
294    DESCRIPTION
295      "The  MAC address of the LLC2 station, for device-initiated SDLLC
296       connections."
297    ::= { convSdllcAddrEntry 2 }
298
299convSdllcAddrXID OBJECT-TYPE
300    SYNTAX     OCTET STRING (SIZE (4))
301    MAX-ACCESS read-only
302    STATUS     current
303    DESCRIPTION
304      "The XID value that is associated with the SDLC station.
305       This value must match the host configured value."
306    ::= { convSdllcAddrEntry 3 }
307
308convSdllcAddrState    OBJECT-TYPE
309    SYNTAX     INTEGER
310    {
311      disconnected       (1),  -- session disconnected
312      sdlcDisconnecting  (2),  -- disconnect pending SDLC side
313      sdlcPriConnecting  (3),  -- connect pending SDLC primary side
314      netDisconnecting   (4),  -- disconnect pending network side
315      netConnecting      (5),  -- connect pending network side
316      sdlcSecConnecting  (6),  -- connect pending SDLC secondary side
317      connected          (7)   -- session connected
318    }
319    MAX-ACCESS read-only
320    STATUS     current
321    DESCRIPTION
322      "Current state of the SDLLC connection."
323    ::= { convSdllcAddrEntry 4 }
324
325convSdllcAddrMaxSdlcFrameSize OBJECT-TYPE
326    SYNTAX     Integer32
327    MAX-ACCESS read-only
328    STATUS     current
329    DESCRIPTION
330      "The largest information frame (I-frame) size that can be sent or
331       received on the SDLC session."
332    ::= { convSdllcAddrEntry 5 }
333
334-- *************************************************************************
335-- * SDLLC Notifications
336-- *************************************************************************
337
338convSdllcNotificationPrefix OBJECT IDENTIFIER ::= { ciscoSnaSdllcMIB 2 }
339convSdllcNotifications OBJECT IDENTIFIER ::= { convSdllcNotificationPrefix 0 }
340
341convSdllcPeerStateChangeNotification NOTIFICATION-TYPE
342     OBJECTS {convSdllcAddrState }
343     STATUS      current
344     DESCRIPTION
345        "This Notification indicates that the state of an SDLLC connection
346         has transitioned to connected or disconnected."
347    ::= { convSdllcNotifications 1 }
348
349-- *************************************************************************
350-- * Conformance Information
351-- *************************************************************************
352--
353
354sdllcMibConformance   OBJECT IDENTIFIER ::= { ciscoSnaSdllcMIB 3 }
355sdllcMibCompliances   OBJECT IDENTIFIER ::= { sdllcMibConformance 1 }
356sdllcMibGroups        OBJECT IDENTIFIER ::= { sdllcMibConformance 2 }
357--
358-- *************************************************************************
359-- * Compliance Statements
360-- *************************************************************************
361
362sdllcMibCompliance    MODULE-COMPLIANCE
363        STATUS current
364        DESCRIPTION
365                "The compliance statement for sdllc."
366        MODULE  -- this module
367                MANDATORY-GROUPS {
368			convSdllcPortGroup,
369			convSdllcAddrGroup
370		}
371         ::= { sdllcMibCompliances 1 }
372
373convSdllcPortGroup OBJECT-GROUP
374        OBJECTS {
375                convSdllcPortVirtMacAddr,
376                convSdllcPortVirtRing,
377                convSdllcPortBridge,
378                convSdllcPortLlc2Ring,
379                convSdllcPortLocalAck,
380                convSdllcPortLocalAckState,
381                convSdllcPortMaxLlc2FrameSize
382        }
383        STATUS current
384        DESCRIPTION
385                "A collection of objects providing configuration and
386                 operational information about an SDLLC port."
387        ::= { sdllcMibGroups 1}
388
389convSdllcAddrGroup OBJECT-GROUP
390        OBJECTS {
391                convSdllcAddrPartnerMacAddr,
392                convSdllcAddrXID,
393                convSdllcAddrState,
394                convSdllcAddrMaxSdlcFrameSize
395        }
396        STATUS current
397        DESCRIPTION
398                "A collection of objects providing configuration and
399                 operational information about an SDLC address."
400        ::= { sdllcMibGroups 2}
401
402END
403