1 APPN-DLUR-MIB DEFINITIONS ::= BEGIN
4 DisplayString, TruthValue
7 OBJECT-TYPE, MODULE-IDENTITY, Unsigned32
10 MODULE-COMPLIANCE, OBJECT-GROUP
19 dlurMIB MODULE-IDENTITY
20 LAST-UPDATED "9705101500Z"
21 ORGANIZATION "IETF SNA NAU MIB WG / AIW APPN/HPR MIBs SIG"
29 Research Triangle Park, NC 27709, USA
31 E-mail: clouston@cisco.com
35 800 Park Offices Drive
38 Research Triangle Park, NC 27709, USA
40 E-mail: remoore@ralvm6.vnet.ibm.com
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)."
52 -- snanauMIB ::= { mib-2 34 }
54 -- *********************************************************************
56 -- *********************************************************************
57 -- SnaControlPointName is imported from the APPN MIB
59 -- *********************************************************************
60 dlurObjects OBJECT IDENTIFIER ::= { dlurMIB 1 }
61 -- *********************************************************************
64 dlurNodeInfo OBJECT IDENTIFIER ::= { dlurObjects 1 }
65 -- *********************************************************************
66 -- DLUR Capabilities of the node
68 -- This group represents the capabilities and options of the DLUR
70 -- *********************************************************************
71 dlurNodeCapabilities OBJECT IDENTIFIER ::= { dlurNodeInfo 1 }
73 dlurNodeCpName OBJECT-TYPE
74 SYNTAX SnaControlPointName
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."
83 ::= { dlurNodeCapabilities 1 }
85 dlurReleaseLevel OBJECT-TYPE
86 SYNTAX DisplayString (SIZE (2))
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'."
98 ::= { dlurNodeCapabilities 2 }
100 dlurAnsSupport OBJECT-TYPE
108 "Automatic Network Shutdown (ANS) capability of this node.
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.
114 - 'stopOnly' indicates that the DLUR implementation only
115 supports the ANS value of stop.
117 ANS = continue means that the DLUR node will keep LU-LU
118 sessions active even if SSCP-PU and SSCP-LU control sessions
121 ANS = stop means that LU-LU sessions will be interrupted when
122 the SSCP-PU and SSCP-LU sessions are interrupted."
124 ::= { dlurNodeCapabilities 3 }
126 dlurMultiSubnetSupport OBJECT-TYPE
131 "Indication of whether this DLUR implementation can support
132 CPSVRMGR sessions that cross NetId boundaries."
134 ::= { dlurNodeCapabilities 4 }
136 dlurDefaultDefPrimDlusName OBJECT-TYPE
137 SYNTAX SnaControlPointName
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."
146 ::= { dlurNodeCapabilities 5 }
148 dlurNetworkNameForwardingSupport OBJECT-TYPE
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.
157 This object corresponds to byte 9. bit 3 of cv51."
159 ::= { dlurNodeCapabilities 6 }
161 dlurNondisDlusDlurSessDeactSup OBJECT-TYPE
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.
173 This object corresponds to byte 9. bit 4 of cv51."
175 ::= { dlurNodeCapabilities 7 }
177 -- *********************************************************************
178 -- DLUR default defined backup DLUS table
179 -- *********************************************************************
181 dlurDefaultDefBackupDlusTable OBJECT-TYPE
182 SYNTAX SEQUENCE OF DlurDefaultDefBackupDlusEntry
183 MAX-ACCESS not-accessible
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
194 ::= { dlurNodeInfo 2 }
196 dlurDefaultDefBackupDlusEntry OBJECT-TYPE
197 SYNTAX DlurDefaultDefBackupDlusEntry
198 MAX-ACCESS not-accessible
201 "This table is indexed by an integer-valued index, which
202 orders the entries from most preferred default backup DLUS
205 INDEX { dlurDefaultDefBackupDlusIndex }
207 ::= { dlurDefaultDefBackupDlusTable 1 }
209 DlurDefaultDefBackupDlusEntry ::= SEQUENCE {
210 dlurDefaultDefBackupDlusIndex Unsigned32,
211 dlurDefaultDefBackupDlusName SnaControlPointName
214 dlurDefaultDefBackupDlusIndex OBJECT-TYPE
215 SYNTAX Unsigned32 (1..4294967295)
216 MAX-ACCESS not-accessible
219 "Index for this table. The index values start at 1,
220 which identifies the most preferred default backup DLUS."
222 ::= { dlurDefaultDefBackupDlusEntry 1 }
224 dlurDefaultDefBackupDlusName OBJECT-TYPE
225 SYNTAX SnaControlPointName
229 "Fully qualified name of a default backup DLUS for PUs served
232 ::= { dlurDefaultDefBackupDlusEntry 2 }
234 -- *********************************************************************
237 -- The following table carries information about the PUs that this APPN
238 -- node is supporting via DLUR.
240 -- *********************************************************************
241 dlurPuInfo OBJECT IDENTIFIER ::= { dlurObjects 2 }
243 dlurPuTable OBJECT-TYPE
244 SYNTAX SEQUENCE OF DlurPuEntry
245 MAX-ACCESS not-accessible
248 "Information about the PUs supported by this DLUR."
252 dlurPuEntry OBJECT-TYPE
254 MAX-ACCESS not-accessible
257 "Entry in a table of PU information, indexed by PU name."
261 ::= { dlurPuTable 1 }
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
275 dlurPuName OBJECT-TYPE
276 SYNTAX DisplayString (SIZE (1..17))
277 MAX-ACCESS not-accessible
280 "Locally administered name of the PU."
282 ::= { dlurPuEntry 1 }
285 dlurPuSscpSuppliedName OBJECT-TYPE
286 SYNTAX DisplayString (SIZE (0..17))
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."
294 ::= { dlurPuEntry 2 }
296 dlurPuStatus OBJECT-TYPE
311 "Status of the DLUR-supported PU. The following values are
315 pendReqActpuRsp(2) - pending a response from the DLUS
317 pendActpu(3) - pending an ACTPU from the DLUS
318 pendActpuRsp(4) - pending an ACTPU response from the PU
320 pendLinkact(6) - pending activation of the link to a
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
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."
332 ::= { dlurPuEntry 3 }
334 dlurPuAnsSupport OBJECT-TYPE
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.
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.
350 - 'stop' means that LU-LU sessions will be interrupted
351 when the SSCP-PU and SSCP-LU sessions are interrupted."
353 ::= { dlurPuEntry 4 }
355 dlurPuLocation OBJECT-TYPE
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
367 ::= { dlurPuEntry 5 }
369 dlurPuLsName OBJECT-TYPE
370 SYNTAX DisplayString (SIZE (0..10))
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."
380 ::= { dlurPuEntry 6 }
382 dlurPuDlusSessnStatus OBJECT-TYPE
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:
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.
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:
411 | pA | pI | A | X = !(pA | pI | A)
412 C ++++++++++++++++++++++++++++++++++
414 n ++++++++++++++++++++++++++++++++++
416 o ++++++++++++++++++++++++++++++++++
418 e ++++++++++++++++++++++++++++++++++
420 ++++++++++++++++++++++++++++++++++
423 ::= { dlurPuEntry 7 }
425 dlurPuActiveDlusName OBJECT-TYPE
426 SYNTAX DisplayString (SIZE (0..17))
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."
435 ::= { dlurPuEntry 8 }
437 dlurPuDefPrimDlusName OBJECT-TYPE
438 SYNTAX DisplayString (SIZE (0..17))
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."
449 ::= { dlurPuEntry 9 }
451 -- *****************************************
452 -- Defined backup DLUS table for a PU
453 -- *****************************************
455 dlurPuDefBackupDlusTable OBJECT-TYPE
456 SYNTAX SEQUENCE OF DlurPuDefBackupDlusEntry
457 MAX-ACCESS not-accessible
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
470 dlurPuDefBackupDlusEntry OBJECT-TYPE
471 SYNTAX DlurPuDefBackupDlusEntry
472 MAX-ACCESS not-accessible
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."
479 INDEX { dlurPuDefBackupDlusPuName,
480 dlurPuDefBackupDlusIndex }
482 ::= { dlurPuDefBackupDlusTable 1 }
484 DlurPuDefBackupDlusEntry ::= SEQUENCE {
485 dlurPuDefBackupDlusPuName DisplayString,
486 dlurPuDefBackupDlusIndex Unsigned32,
487 dlurPuDefBackupDlusName SnaControlPointName
490 dlurPuDefBackupDlusPuName OBJECT-TYPE
491 SYNTAX DisplayString (SIZE (1..17))
492 MAX-ACCESS not-accessible
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."
499 ::= { dlurPuDefBackupDlusEntry 1 }
501 dlurPuDefBackupDlusIndex OBJECT-TYPE
502 SYNTAX Unsigned32 (1..4294967295)
503 MAX-ACCESS not-accessible
506 "Secondary index for this table. The index values start at 1,
507 which identifies the most preferred backup DLUS for the PU."
509 ::= { dlurPuDefBackupDlusEntry 2 }
511 dlurPuDefBackupDlusName OBJECT-TYPE
512 SYNTAX SnaControlPointName
516 "Fully qualified name of a backup DLUS for this PU."
518 ::= { dlurPuDefBackupDlusEntry 3 }
520 -- *********************************************************************
521 -- DLUS Control Sessions (CPSVRMGR Pipes)
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.
529 -- *********************************************************************
531 dlurDlusInfo OBJECT IDENTIFIER ::= { dlurObjects 3 }
533 dlurDlusTable OBJECT-TYPE
534 SYNTAX SEQUENCE OF DlurDlusEntry
535 MAX-ACCESS not-accessible
538 "Information about DLUS control sessions."
540 ::= { dlurDlusInfo 1}
542 dlurDlusEntry OBJECT-TYPE
544 MAX-ACCESS not-accessible
547 "This entry is indexed by the name of the DLUS."
549 INDEX { dlurDlusName }
551 ::= { dlurDlusTable 1 }
553 DlurDlusEntry ::= SEQUENCE {
554 dlurDlusName SnaControlPointName,
555 dlurDlusSessnStatus INTEGER
558 dlurDlusName OBJECT-TYPE
559 SYNTAX SnaControlPointName
560 MAX-ACCESS not-accessible
563 "The SNA name of a DLUS with which this DLUR currently has a
564 CPSVRMGR pipe established."
566 ::= { dlurDlusEntry 1 }
568 dlurDlusSessnStatus OBJECT-TYPE
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:
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.
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:
597 | pA | pI | A | X = !(pA | pI | A)
598 C ++++++++++++++++++++++++++++++++++
600 n ++++++++++++++++++++++++++++++++++
602 o ++++++++++++++++++++++++++++++++++
604 e ++++++++++++++++++++++++++++++++++
606 ++++++++++++++++++++++++++++++++++
609 ::= { dlurDlusEntry 2 }
611 -- ***************************************************************
612 -- Conformance information
613 -- ***************************************************************
615 dlurConformance OBJECT IDENTIFIER ::= { dlurMIB 2 }
617 dlurCompliances OBJECT IDENTIFIER ::= { dlurConformance 1 }
618 dlurGroups OBJECT IDENTIFIER ::= { dlurConformance 2 }
620 -- Compliance statements
622 dlurCompliance MODULE-COMPLIANCE
625 "The compliance statement for the SNMPv2 entities which
626 implement the DLUR MIB."
628 MODULE -- this module
630 -- Unconditionally mandatory groups
631 MANDATORY-GROUPS { dlurConfGroup }
633 ::= { dlurCompliances 1 }
635 -- Units of conformance
636 dlurConfGroup OBJECT-GROUP
641 dlurMultiSubnetSupport,
642 dlurNetworkNameForwardingSupport,
643 dlurNondisDlusDlurSessDeactSup,
644 dlurDefaultDefPrimDlusName,
645 dlurDefaultDefBackupDlusName,
646 dlurPuSscpSuppliedName,
651 dlurPuDlusSessnStatus,
652 dlurPuActiveDlusName,
653 dlurPuDefPrimDlusName,
654 dlurPuDefBackupDlusName,
659 "A collection of objects providing information on an
660 implementation of APPN DLUR."
664 -- end of conformance statement