Imported Upstream version 0.4.8
[platform/upstream/libsmi.git] / mibs / ietf / APPN-DLUR-MIB
1 APPN-DLUR-MIB DEFINITIONS ::= BEGIN
2
3 IMPORTS
4         DisplayString, TruthValue
5                 FROM SNMPv2-TC
6
7         OBJECT-TYPE, MODULE-IDENTITY, Unsigned32
8                 FROM SNMPv2-SMI
9
10         MODULE-COMPLIANCE, OBJECT-GROUP
11                 FROM SNMPv2-CONF
12
13         snanauMIB
14                 FROM SNA-NAU-MIB
15
16         SnaControlPointName
17                 FROM APPN-MIB;
18
19 dlurMIB MODULE-IDENTITY
20         LAST-UPDATED  "9705101500Z"
21         ORGANIZATION  "IETF SNA NAU MIB WG / AIW APPN/HPR MIBs SIG"
22         CONTACT-INFO
23
24                 "
25                         Bob Clouston
26                         Cisco Systems
27                         7025 Kit Creek Road
28                         P.O. Box 14987
29                         Research Triangle Park, NC 27709, USA
30                         Tel:    1 919 472 2333
31                         E-mail: clouston@cisco.com
32
33                         Bob Moore
34                         IBM Corporation
35                         800 Park Offices Drive
36                         RHJA/664
37                         P.O. Box 12195
38                         Research Triangle Park, NC 27709, USA
39                         Tel:    1 919 254 4436
40                         E-mail: remoore@ralvm6.vnet.ibm.com
41                 "
42       DESCRIPTION
43                 "This is the MIB module for objects used to manage
44                 network devices with DLUR capabilities.  This MIB
45                 contains information that is useful for managing an APPN
46                 product that implements a DLUR (Dependent Logical Unit
47                 Requester).  The DLUR product has a client/server
48                 relationship with an APPN product that implements a DLUS
49                 (Dependent Logical Unit Server)."
50
51 ::= { snanauMIB 5 }
52 -- snanauMIB ::= { mib-2 34 }
53
54 -- *********************************************************************
55 -- Textual Convention
56 -- *********************************************************************
57 -- SnaControlPointName is imported from the APPN MIB
58
59 -- *********************************************************************
60   dlurObjects OBJECT IDENTIFIER ::= { dlurMIB 1 }
61 -- *********************************************************************
62
63
64 dlurNodeInfo OBJECT IDENTIFIER ::= { dlurObjects 1 }
65 -- *********************************************************************
66 -- DLUR Capabilities of the node
67 --
68 --  This group represents the capabilities and options of the DLUR
69 --  implementation.
70 -- *********************************************************************
71 dlurNodeCapabilities OBJECT IDENTIFIER ::= { dlurNodeInfo 1 }
72
73 dlurNodeCpName OBJECT-TYPE
74       SYNTAX SnaControlPointName
75       MAX-ACCESS read-only
76       STATUS current
77       DESCRIPTION
78           "Administratively assigned network name for the APPN node where
79           this DLUR implementation resides.  If this object has the same
80           value as the appnNodeCpName object in the APPN MIB, then the
81           two objects are referring to the same APPN node."
82
83       ::= { dlurNodeCapabilities 1 }
84
85 dlurReleaseLevel OBJECT-TYPE
86       SYNTAX DisplayString (SIZE (2))
87       MAX-ACCESS read-only
88       STATUS current
89       DESCRIPTION
90           "The DLUR release level of this implementation.  This is the
91           value that is encoded in the DLUR/DLUS Capabilites (CV 51).
92           To insure consistent display, this one-byte value is encoded
93           here as two displayable characters that are equivalent to a
94           hexadecimal display.  For example, if the one-byte value as
95           encoded in CV51 is X'01', this object will contain the
96           displayable string '01'."
97
98       ::= { dlurNodeCapabilities 2 }
99
100 dlurAnsSupport OBJECT-TYPE
101       SYNTAX INTEGER {
102                      continueOrStop(1),
103                      stopOnly(2)
104                      }
105       MAX-ACCESS read-only
106       STATUS current
107       DESCRIPTION
108           "Automatic Network Shutdown (ANS) capability of this node.
109
110               -  'continueOrStop' indicates that the DLUR implementation
111                  supports either ANS value (continue or stop) as
112                  specified by the DLUS on ACTPU for each PU.
113
114               -  'stopOnly' indicates that the DLUR implementation only
115                  supports the ANS value of stop.
116
117            ANS = continue means that the DLUR node will keep LU-LU
118            sessions active even if SSCP-PU and SSCP-LU control sessions
119            are interrupted.
120
121            ANS = stop means that LU-LU sessions will be interrupted when
122            the SSCP-PU and SSCP-LU sessions are interrupted."
123
124       ::= { dlurNodeCapabilities 3 }
125
126 dlurMultiSubnetSupport OBJECT-TYPE
127       SYNTAX TruthValue
128       MAX-ACCESS read-only
129       STATUS current
130       DESCRIPTION
131           "Indication of whether this DLUR implementation can support
132           CPSVRMGR sessions that cross NetId boundaries."
133
134       ::= { dlurNodeCapabilities 4 }
135
136 dlurDefaultDefPrimDlusName OBJECT-TYPE
137       SYNTAX SnaControlPointName
138       MAX-ACCESS read-only
139       STATUS current
140       DESCRIPTION
141           "The SNA name of the defined default primary DLUS for all of
142           the PUs served by this DLUR.  This can be overridden for a
143           particular PU by a defined primary DLUS for that PU,
144           represented by the dlurPuDefPrimDlusName object."
145
146       ::= { dlurNodeCapabilities 5 }
147
148 dlurNetworkNameForwardingSupport OBJECT-TYPE
149       SYNTAX TruthValue
150       MAX-ACCESS read-only
151       STATUS current
152       DESCRIPTION
153           "Indication of whether this DLUR implementation supports
154           forwarding of Network Name control vectors on ACTPUs and
155           ACTLUs to DLUR-served PUs and their associated LUs.
156
157           This object corresponds to byte 9. bit 3 of cv51."
158
159       ::= { dlurNodeCapabilities 6 }
160
161 dlurNondisDlusDlurSessDeactSup OBJECT-TYPE
162       SYNTAX TruthValue
163       MAX-ACCESS read-only
164       STATUS current
165       DESCRIPTION
166           "Indication of whether this DLUR implementation supports
167           nondisruptive deactivation of its DLUR-DLUS sessions.
168           Upon receiving from a DLUS an UNBIND for the CPSVRMGR pipe
169           with sense data X'08A0 000B', a DLUR that supports this
170           option immediately begins attempting to activate a CPSVRMGR
171           pipe with a DLUS other than the one that sent the UNBIND.
172
173           This object corresponds to byte 9. bit 4 of cv51."
174
175       ::= { dlurNodeCapabilities 7 }
176
177 -- *********************************************************************
178 -- DLUR default defined backup DLUS table
179 -- *********************************************************************
180
181 dlurDefaultDefBackupDlusTable OBJECT-TYPE
182       SYNTAX SEQUENCE OF DlurDefaultDefBackupDlusEntry
183       MAX-ACCESS not-accessible
184       STATUS current
185       DESCRIPTION
186           "This table contains an ordered list of defined backup DLUSs
187           for all of the PUs served by this DLUR.  These can be
188           overridden for a particular PU by a list of defined backup
189           DLUSs for that PU, represented by the
190           dlurPuDefBackupDlusNameTable.  Entries in this table are
191           ordered from most preferred default backup DLUS to least
192           preferred."
193
194       ::= { dlurNodeInfo 2 }
195
196 dlurDefaultDefBackupDlusEntry OBJECT-TYPE
197       SYNTAX DlurDefaultDefBackupDlusEntry
198       MAX-ACCESS not-accessible
199       STATUS current
200       DESCRIPTION
201           "This table is indexed by an integer-valued index, which
202           orders the entries from most preferred default backup DLUS
203           to least preferred."
204
205       INDEX { dlurDefaultDefBackupDlusIndex }
206
207       ::= { dlurDefaultDefBackupDlusTable 1 }
208
209 DlurDefaultDefBackupDlusEntry ::= SEQUENCE {
210       dlurDefaultDefBackupDlusIndex      Unsigned32,
211       dlurDefaultDefBackupDlusName       SnaControlPointName
212                      }
213
214 dlurDefaultDefBackupDlusIndex OBJECT-TYPE
215       SYNTAX Unsigned32 (1..4294967295)
216       MAX-ACCESS not-accessible
217       STATUS current
218       DESCRIPTION
219           "Index for this table.  The index values start at 1,
220           which identifies the most preferred default backup DLUS."
221
222       ::= { dlurDefaultDefBackupDlusEntry 1 }
223
224 dlurDefaultDefBackupDlusName OBJECT-TYPE
225       SYNTAX SnaControlPointName
226       MAX-ACCESS read-only
227       STATUS current
228       DESCRIPTION
229           "Fully qualified name of a default backup DLUS for PUs served
230           by this DLUR."
231
232       ::= { dlurDefaultDefBackupDlusEntry 2 }
233
234 -- *********************************************************************
235 -- PU Information
236 --
237 --  The following table carries information about the PUs that this APPN
238 --  node is supporting via DLUR.
239
240 -- *********************************************************************
241 dlurPuInfo OBJECT IDENTIFIER ::= { dlurObjects 2 }
242
243 dlurPuTable OBJECT-TYPE
244       SYNTAX SEQUENCE OF DlurPuEntry
245       MAX-ACCESS not-accessible
246       STATUS current
247       DESCRIPTION
248           "Information about the PUs supported by this DLUR."
249
250       ::= { dlurPuInfo 1 }
251
252 dlurPuEntry OBJECT-TYPE
253       SYNTAX DlurPuEntry
254       MAX-ACCESS not-accessible
255       STATUS current
256       DESCRIPTION
257           "Entry in a table of PU information, indexed by PU name."
258
259       INDEX { dlurPuName  }
260
261       ::= { dlurPuTable 1 }
262
263 DlurPuEntry ::= SEQUENCE {
264       dlurPuName                  DisplayString,
265       dlurPuSscpSuppliedName      DisplayString,
266       dlurPuStatus                INTEGER,
267       dlurPuAnsSupport            INTEGER,
268       dlurPuLocation              INTEGER,
269       dlurPuLsName                DisplayString,
270       dlurPuDlusSessnStatus       INTEGER,
271       dlurPuActiveDlusName        DisplayString,
272       dlurPuDefPrimDlusName       DisplayString
273                      }
274
275 dlurPuName OBJECT-TYPE
276       SYNTAX DisplayString (SIZE (1..17))
277       MAX-ACCESS not-accessible
278       STATUS current
279       DESCRIPTION
280           "Locally administered name of the PU."
281
282       ::= { dlurPuEntry 1 }
283
284
285 dlurPuSscpSuppliedName OBJECT-TYPE
286       SYNTAX DisplayString (SIZE (0..17))
287       MAX-ACCESS read-only
288       STATUS current
289       DESCRIPTION
290           "The SNA name of the PU.  This value is supplied to a PU by the
291           SSCP that activated it.  If a value has not been supplied, a
292           zero-length string is returned."
293
294       ::= { dlurPuEntry 2 }
295
296 dlurPuStatus OBJECT-TYPE
297       SYNTAX INTEGER {
298                       reset(1),
299                       pendReqActpuRsp(2),
300                       pendActpu(3),
301                       pendActpuRsp(4),
302                       active(5),
303                       pendLinkact(6),
304                       pendDactpuRsp(7),
305                       pendInop(8),
306                       pendInopActpu(9)
307                      }
308       MAX-ACCESS read-only
309       STATUS current
310       DESCRIPTION
311           "Status of the DLUR-supported PU.  The following values are
312           defined:
313
314              reset(1)           -  reset
315              pendReqActpuRsp(2) -  pending a response from the DLUS
316                                    to a Request ACTPU
317              pendActpu(3)       -  pending an ACTPU from the DLUS
318              pendActpuRsp(4)    -  pending an ACTPU response from the PU
319              active(5)          -  active
320              pendLinkact(6)     -  pending activation of the link to a
321                                    downstream PU
322              pendDactpuRsp(7)   -  pending a DACTPU response from the PU
323              pendInop(8)        -  the CPSVRMGR pipe became inoperative
324                                    while the DLUR was pending an ACTPU
325                                    response from the PU
326              pendInopActpu(9)   -  when the DLUR was in the pendInop
327                                    state, a CPSVRMGR pipe became active
328                                    and a new ACTPU was received over it,
329                                    before a response to the previous
330                                    ACTPU was received from the PU."
331
332       ::= { dlurPuEntry 3 }
333
334 dlurPuAnsSupport OBJECT-TYPE
335       SYNTAX INTEGER {
336                      continue(1),
337                      stop(2)
338                      }
339       MAX-ACCESS read-only
340       STATUS current
341       DESCRIPTION
342           "The Automatic Network Shutdown (ANS) support configured for
343           this PU.  This value (as configured by the network
344           administrator) is sent by DLUS with ACTPU for each PU.
345
346               -  'continue' means that the DLUR node will attempt to keep
347                  LU-LU sessions active even if SSCP-PU and SSCP-LU
348                  control sessions are interrupted.
349
350               -  'stop' means that LU-LU sessions will be interrupted
351                  when the SSCP-PU and SSCP-LU sessions are interrupted."
352
353       ::= { dlurPuEntry 4 }
354
355 dlurPuLocation OBJECT-TYPE
356       SYNTAX INTEGER {
357                       internal(1),
358                       downstream(2) }
359       MAX-ACCESS read-only
360       STATUS current
361       DESCRIPTION
362           "Location of the DLUR-support PU:
363               internal(1)   - internal to the APPN node itself (no link)
364               downstream(2) - downstream of the APPN node (connected via
365                               a link)."
366
367       ::= { dlurPuEntry 5 }
368
369 dlurPuLsName OBJECT-TYPE
370       SYNTAX DisplayString (SIZE (0..10))
371       MAX-ACCESS read-only
372       STATUS current
373       DESCRIPTION
374           "Administratively assigned name of the link station through
375           which a downstream PU is connected to this DLUR.  A zero-length
376           string is returned for internal PUs.  If this object has the
377           same value as the appnLsName object in the APPN MIB, then the
378           two are identifying the same link station."
379
380       ::= { dlurPuEntry 6 }
381
382 dlurPuDlusSessnStatus OBJECT-TYPE
383       SYNTAX INTEGER {
384                       reset(1),
385                       pendingActive(2),
386                       active(3),
387                       pendingInactive(4)
388                      }
389       MAX-ACCESS read-only
390       STATUS current
391       DESCRIPTION
392           "Status of the control session to the DLUS identified in
393           dlurPuActiveDlusName.  This is a combination of the separate
394           states for the contention-winner and contention-loser sessions:
395
396           reset(1)           - none of the cases below
397           pendingActive(2)   - either contention-winner session or
398                                contention-loser session is pending active
399           active(3)          - contention-winner and contention-loser
400                                sessions are both active
401           pendingInactive(4) - either contention-winner session or
402                                contention-loser session is pending
403                                inactive - this test is made AFTER the
404                                'pendingActive' test.
405
406           The following matrix provides a different representation of
407           how the values of this object are related to the individual
408           states of the contention-winner and contention-loser sessions:
409
410                Conwinner
411                | pA | pI | A | X = !(pA | pI | A)
412           C ++++++++++++++++++++++++++++++++++
413           o pA | 2  |  2 | 2 | 2
414           n ++++++++++++++++++++++++++++++++++
415           l pI | 2  |  4 | 4 | 4
416           o ++++++++++++++++++++++++++++++++++
417           s A  | 2  |  4 | 3 | 1
418           e ++++++++++++++++++++++++++++++++++
419           r X  | 2  |  4 | 1 | 1
420             ++++++++++++++++++++++++++++++++++
421           "
422
423       ::= { dlurPuEntry 7 }
424
425 dlurPuActiveDlusName OBJECT-TYPE
426       SYNTAX DisplayString (SIZE (0..17))
427       MAX-ACCESS read-only
428       STATUS current
429       DESCRIPTION
430           "The SNA name of the active DLUS for this PU.  If its length
431           is not zero, this name follows the SnaControlPointName textual
432           convention.  A zero-length string indicates that the PU does
433           not currently have an active DLUS."
434
435       ::= { dlurPuEntry 8 }
436
437 dlurPuDefPrimDlusName OBJECT-TYPE
438       SYNTAX DisplayString (SIZE (0..17))
439       MAX-ACCESS read-only
440       STATUS current
441       DESCRIPTION
442           "The SNA name of the defined primary DLUS for this PU, if one
443           has been defined.  If present, this name follows the
444           SnaControlPointName textual convention.  A zero-length string
445           indicates that no primary DLUS has been defined for this PU, in
446           which case the global default represented by the
447           dlurDefaultDefPrimDlusName object is used."
448
449       ::= { dlurPuEntry 9 }
450
451 -- *****************************************
452 -- Defined backup DLUS table for a PU
453 -- *****************************************
454
455 dlurPuDefBackupDlusTable OBJECT-TYPE
456       SYNTAX SEQUENCE OF DlurPuDefBackupDlusEntry
457       MAX-ACCESS not-accessible
458       STATUS current
459       DESCRIPTION
460           "This table contains an ordered list of defined backup DLUSs
461           for those PUs served by this DLUR that have their own defined
462           backup DLUSs.  PUs that have no entries in this table use the
463           global default backup DLUSs for the DLUR, represented by the
464           dlurDefaultDefBackupDlusNameTable.  Entries in this table are
465           ordered from most preferred backup DLUS to least preferred for
466           each PU."
467
468       ::= { dlurPuInfo 2 }
469
470 dlurPuDefBackupDlusEntry OBJECT-TYPE
471       SYNTAX DlurPuDefBackupDlusEntry
472       MAX-ACCESS not-accessible
473       STATUS current
474       DESCRIPTION
475           "This table is indexed by PU name and by an integer-valued
476           index, which orders the entries from most preferred backup DLUS
477           for the PU to least preferred."
478
479       INDEX { dlurPuDefBackupDlusPuName,
480               dlurPuDefBackupDlusIndex }
481
482       ::= { dlurPuDefBackupDlusTable 1 }
483
484 DlurPuDefBackupDlusEntry ::= SEQUENCE {
485       dlurPuDefBackupDlusPuName          DisplayString,
486       dlurPuDefBackupDlusIndex           Unsigned32,
487       dlurPuDefBackupDlusName            SnaControlPointName
488                      }
489
490 dlurPuDefBackupDlusPuName OBJECT-TYPE
491       SYNTAX DisplayString (SIZE (1..17))
492       MAX-ACCESS not-accessible
493       STATUS current
494       DESCRIPTION
495           "Locally administered name of the PU.  If this object has the
496           same value as the dlurPuName object, then the two are
497           identifying the same PU."
498
499       ::= { dlurPuDefBackupDlusEntry 1 }
500
501 dlurPuDefBackupDlusIndex OBJECT-TYPE
502       SYNTAX Unsigned32 (1..4294967295)
503       MAX-ACCESS not-accessible
504       STATUS current
505       DESCRIPTION
506           "Secondary index for this table.  The index values start at 1,
507           which identifies the most preferred backup DLUS for the PU."
508
509       ::= { dlurPuDefBackupDlusEntry 2 }
510
511 dlurPuDefBackupDlusName OBJECT-TYPE
512       SYNTAX SnaControlPointName
513       MAX-ACCESS read-only
514       STATUS current
515       DESCRIPTION
516           "Fully qualified name of a backup DLUS for this PU."
517
518       ::= { dlurPuDefBackupDlusEntry 3 }
519
520 -- *********************************************************************
521 --               DLUS Control Sessions (CPSVRMGR Pipes)
522 --
523 --  This table contains information about DLUS control sessions, also
524 --  known as CPSVRMGR pipes.  Although DLUR uses a pair of CPSVRMGR
525 --  sessions for communication, for the purpose of status, information
526 --  about these two sessions is combined to yield a single status for the
527 --  requester/server connection.
528
529 -- *********************************************************************
530
531 dlurDlusInfo OBJECT IDENTIFIER ::= { dlurObjects 3 }
532
533 dlurDlusTable OBJECT-TYPE
534       SYNTAX SEQUENCE OF DlurDlusEntry
535       MAX-ACCESS not-accessible
536       STATUS current
537       DESCRIPTION
538            "Information about DLUS control sessions."
539
540       ::= { dlurDlusInfo 1}
541
542 dlurDlusEntry OBJECT-TYPE
543       SYNTAX DlurDlusEntry
544       MAX-ACCESS not-accessible
545       STATUS current
546       DESCRIPTION
547            "This entry is indexed by the name of the DLUS."
548
549       INDEX { dlurDlusName }
550
551       ::= { dlurDlusTable 1 }
552
553 DlurDlusEntry ::= SEQUENCE {
554       dlurDlusName          SnaControlPointName,
555       dlurDlusSessnStatus   INTEGER
556                      }
557
558 dlurDlusName OBJECT-TYPE
559       SYNTAX SnaControlPointName
560       MAX-ACCESS not-accessible
561       STATUS current
562       DESCRIPTION
563           "The SNA name of a DLUS with which this DLUR currently has a
564           CPSVRMGR pipe established."
565
566       ::= { dlurDlusEntry 1 }
567
568 dlurDlusSessnStatus OBJECT-TYPE
569       SYNTAX INTEGER {
570                       reset(1),
571                       pendingActive(2),
572                       active(3),
573                       pendingInactive(4)
574                      }
575       MAX-ACCESS read-only
576       STATUS current
577       DESCRIPTION
578           "Status of the CPSVRMGR pipe between the DLUR and this DLUS.
579           This is a combination of the separate states for the
580           contention-winner and contention-loser sessions:
581
582           reset(1)           - none of the cases below
583           pendingActive(2)   - either contention-winner session or
584                                contention-loser session is pending active
585           active(3)          - contention-winner and contention-loser
586                                sessions are both active
587           pendingInactive(4) - either contention-winner session or
588                                contention-loser session is pending
589                                inactive - this test is made AFTER the
590                                'pendingActive' test.
591
592           The following matrix provides a different representation of
593           how the values of this object are related to the individual
594           states of the contention-winner and contention-loser sessions:
595
596                Conwinner
597                | pA | pI | A | X = !(pA | pI | A)
598           C ++++++++++++++++++++++++++++++++++
599           o pA | 2  |  2 | 2 | 2
600           n ++++++++++++++++++++++++++++++++++
601           l pI | 2  |  4 | 4 | 4
602           o ++++++++++++++++++++++++++++++++++
603           s A  | 2  |  4 | 3 | 1
604           e ++++++++++++++++++++++++++++++++++
605           r X  | 2  |  4 | 1 | 1
606             ++++++++++++++++++++++++++++++++++
607           "
608
609       ::= { dlurDlusEntry 2 }
610
611 -- ***************************************************************
612 -- Conformance information
613 -- ***************************************************************
614
615 dlurConformance       OBJECT IDENTIFIER ::= { dlurMIB 2 }
616
617 dlurCompliances       OBJECT IDENTIFIER ::= { dlurConformance 1 }
618 dlurGroups            OBJECT IDENTIFIER ::= { dlurConformance 2 }
619
620 -- Compliance statements
621
622 dlurCompliance MODULE-COMPLIANCE
623       STATUS current
624       DESCRIPTION
625           "The compliance statement for the SNMPv2 entities which
626           implement the DLUR MIB."
627
628       MODULE -- this module
629
630 --    Unconditionally mandatory groups
631       MANDATORY-GROUPS  { dlurConfGroup }
632
633       ::= { dlurCompliances 1 }
634
635 -- Units of conformance
636 dlurConfGroup OBJECT-GROUP
637       OBJECTS {
638                dlurNodeCpName,
639                dlurReleaseLevel,
640                dlurAnsSupport,
641                dlurMultiSubnetSupport,
642                dlurNetworkNameForwardingSupport,
643                dlurNondisDlusDlurSessDeactSup,
644                dlurDefaultDefPrimDlusName,
645                dlurDefaultDefBackupDlusName,
646                dlurPuSscpSuppliedName,
647                dlurPuStatus,
648                dlurPuAnsSupport,
649                dlurPuLocation,
650                dlurPuLsName,
651                dlurPuDlusSessnStatus,
652                dlurPuActiveDlusName,
653                dlurPuDefPrimDlusName,
654                dlurPuDefBackupDlusName,
655                dlurDlusSessnStatus
656               }
657       STATUS current
658       DESCRIPTION
659           "A collection of objects providing information on an
660           implementation of APPN DLUR."
661
662       ::= { dlurGroups 1 }
663
664 -- end of conformance statement
665
666 END