1 EBN-MIB DEFINITIONS ::= BEGIN
4 MODULE-IDENTITY, OBJECT-TYPE, Unsigned32
6 MODULE-COMPLIANCE, OBJECT-GROUP
8 DisplayString, TEXTUAL-CONVENTION
11 -- Because the characters allowed in an SNA control
12 -- point name come from a restricted character set,
13 -- these names are not subject to internationalization.
18 ebnMIB MODULE-IDENTITY
19 LAST-UPDATED "9804281800Z" -- April 28, 1998
20 ORGANIZATION "IETF SNA NAU MIB WG / AIW APPN MIBs SIG"
27 Research Triangle Park, NC 27709, USA
29 E-mail: clouston@cisco.com
35 Research Triangle Park, NC 27709, USA
37 E-mail: remoore@us.ibm.com
41 " The MIB Module for Extended Border Node"
45 -- snanauMIB ::= { mib-2 34 }
47 -- ******************************************************************
48 -- Textual Conventions
49 -- ------------------------------------------------------------------
50 SnaNAUWildcardName ::= TEXTUAL-CONVENTION
53 "Fully-qualified network NAU name. Entries take one of three
55 - Explicit entries do not contain the character '*'.
56 - Partial Wildcard entries have the form 'ccc*', where
57 'ccc' represents one to sixteen characters in a legal
59 - A full wildcard consists of a single character '*'.
61 Because the characters allowed in an SNA NAU name come from
62 a restricted character set, these names are not subject to
63 internationalization."
65 SYNTAX DisplayString(SIZE(1..17))
67 -- ******************************************************************
68 ebnObjects OBJECT IDENTIFIER ::= { ebnMIB 1 }
69 -- ******************************************************************
71 -- ******************************************************************
72 -- EBN Directory Group
73 -- The ebnDirTable is an extension to the appnDirTable. It specifies
74 -- the subnet affiliation for LUs in the EBN's directory.
75 -- ******************************************************************
77 ebnDir OBJECT IDENTIFIER ::= { ebnObjects 1 }
79 ebnDirTable OBJECT-TYPE
80 SYNTAX SEQUENCE OF EbnDirEntry
81 MAX-ACCESS not-accessible
84 "The EBN Directory Table. This table is an extension
85 to the APPN MIB's appnDirTable. Entries in this table
86 are in one-to-one correspondence with entries in the
87 appnDirTable, with corresponding entries having identical
88 values for their respective indexes."
92 ebnDirEntry OBJECT-TYPE
94 MAX-ACCESS not-accessible
97 "Entry in the EBN Directory Table."
99 INDEX { ebnDirLuName }
101 ::= { ebnDirTable 1 }
103 EbnDirEntry ::= SEQUENCE {
104 ebnDirLuName SnaNAUWildcardName,
105 ebnDirSubnetAffiliation INTEGER }
107 ebnDirLuName OBJECT-TYPE
108 SYNTAX SnaNAUWildcardName
109 MAX-ACCESS not-accessible
112 "Fully qualified network LU name in the domain of a serving
113 network node. If this object has the same value as the
114 appnDirLuName object in the APPN MIB, then the two objects
115 are referring to the same LU."
117 ::= { ebnDirEntry 1 }
119 ebnDirSubnetAffiliation OBJECT-TYPE
120 SYNTAX INTEGER { native (1),
126 "Specifies the subnetwork affiliation of the LU:
127 - native(1) : The LU is in the native APPN subnetwork.
128 - nonNative(2) : The LU is in a non-native APPN subnetwork.
129 - subarea(3) : The LU is in a subarea network."
131 ::= { ebnDirEntry 2 }
133 -- ******************************************************************
134 -- EBN Intermediate Session RSCV Group
135 -- This table is a sparse extension to the appnIsInTable. For
136 -- sessions crossing ISTGs adjacent to the EBN, it contains the RSCV
137 -- and COS used in the direction of the BIND destination.
138 -- ******************************************************************
140 ebnIsRscv OBJECT IDENTIFIER ::= { ebnObjects 2 }
142 ebnIsRscvTable OBJECT-TYPE
143 SYNTAX SEQUENCE OF EbnIsRscvEntry
144 MAX-ACCESS not-accessible
147 "The EBN Intermediate Session RSCV table. This table is an
148 extension to the appnIsInTable. It contains the RSCV and COS
149 used in the direction of the BIND destination. There is an
150 entry in this table for each session that traverses an ISTG
151 when it enters or leaves this EBN, with corresponding entries
152 having identical values for their respective indexes."
156 ebnIsRscvEntry OBJECT-TYPE
157 SYNTAX EbnIsRscvEntry
158 MAX-ACCESS not-accessible
161 "Entry in ebnIsRscvTable."
162 INDEX { ebnIsRscvCpName,
165 ::= { ebnIsRscvTable 1 }
167 EbnIsRscvEntry ::= SEQUENCE {
168 ebnIsRscvCpName SnaControlPointName,
169 ebnIsRscvPcid OCTET STRING,
170 ebnIsRscvDestinationRoute OCTET STRING,
171 ebnIsRscvDestinationCos DisplayString }
173 ebnIsRscvCpName OBJECT-TYPE
174 SYNTAX SnaControlPointName
175 MAX-ACCESS not-accessible
178 "The network-qualified control point name of the node at
179 which the session and PCID originated. For APPN and LEN
180 nodes, this is either CP name of the APPN node at which
181 the origin LU is located or the CP name of the NN serving
182 the LEN node at which the origin LU is located. For DLUR
183 resources it is the name of the owning SSCP.
185 If this object has the same value as the appnIsInFqCpName
186 object in the APPN MIB, then the two objects are referring to
187 the same APPN control point."
189 ::= { ebnIsRscvEntry 1 }
191 ebnIsRscvPcid OBJECT-TYPE
192 SYNTAX OCTET STRING (SIZE (8))
193 MAX-ACCESS not-accessible
196 "The procedure correlation identifier (PCID) of a session.
197 It is an 8-octet value.
199 If this object has the same value as the appnIsInPcid object
200 in the APPN MIB, and if the corresponding ebnIsRscvCpName
201 object has the same value as the corresponding
202 appnIsInFqCpName object, then the entries indexed by these
203 objects are referring to the same session."
205 ::= { ebnIsRscvEntry 2 }
207 ebnIsRscvDestinationRoute OBJECT-TYPE
208 SYNTAX OCTET STRING(SIZE (0..255))
213 "The route selection control vector (RSCV x'2B') used in the
214 direction towards the SLU."
216 ::= { ebnIsRscvEntry 3 }
218 ebnIsRscvDestinationCos OBJECT-TYPE
219 SYNTAX DisplayString (SIZE (1..8))
223 "The Class of Service (COS) name used in the direction
226 Because the characters allowed in an SNA COS name come from
227 a restricted character set, these names are not subject to
228 internationalization."
230 ::= { ebnIsRscvEntry 4 }
232 -- ******************************************************************
233 -- EBN Directory Config Group
234 -- The following simple objects provide information about EBN
236 -- ******************************************************************
238 ebnDirConfig OBJECT IDENTIFIER ::= { ebnObjects 3 }
240 ebnSearchCacheTime OBJECT-TYPE
246 "The amount of time in minutes an extended border node will
247 retain information about a multi-subnetwork search, once
248 that that search terminates. A value 0 indicates that the
249 EBN has no defined limit, and the number of entries is
250 bounded only by memory."
252 ::= { ebnDirConfig 1 }
254 ebnMaxSearchCache OBJECT-TYPE
260 "The maximum number of multi-subnet entries to be cached.
261 The value 0 indicates that the local node has no defined
262 limit, and the number of entries is bounded only by
265 ::= { ebnDirConfig 2 }
267 ebnDefaultSubnetVisitCount OBJECT-TYPE
269 UNITS "topology subnetworks"
273 "The default maximum number of subnetworks a LOCATE search
274 procedure may traverse."
276 ::= { ebnDirConfig 3 }
278 -- ******************************************************************
279 -- EBN COS Mapping Group
280 -- The ebnCosMap Table specifies how non-native COS values are mapped
281 -- to COS values defined in the native subnetwork. The COS mappings
282 -- that an EBN performs are determined by multiple factors, one of
283 -- which is a set of user-defined mappings. This table returns the
284 -- COS mappings that the EBN is actually performing, rather than
285 -- the user-defined mappings.
286 -- ******************************************************************
287 ebnCOS OBJECT IDENTIFIER ::= { ebnObjects 4 }
289 ebnCosMapTable OBJECT-TYPE
290 SYNTAX SEQUENCE OF EbnCosMapEntry
291 MAX-ACCESS not-accessible
294 "The EBN COS Mapping Table. This table specifies how non-
295 native COS values are mapped to COS values defined in the
298 Note: The COS mappings that an EBN performs are determined
299 by multiple factors, one of which is a set of user-defined
300 initial mappings. This table returns the COS mappings that
301 the EBN is actually performing at the time it is queried,
302 rather than the user-defined initial ones."
306 ebnCosMapEntry OBJECT-TYPE
307 SYNTAX EbnCosMapEntry
308 MAX-ACCESS not-accessible
311 "An entry in the EBN COS Mapping table."
313 INDEX { ebnCosMapCpName,
314 ebnCosMapNonNativeCos }
316 ::= { ebnCosMapTable 1 }
318 EbnCosMapEntry ::= SEQUENCE {
319 ebnCosMapCpName SnaNAUWildcardName,
320 ebnCosMapNonNativeCos DisplayString,
321 ebnCosMapNativeCos DisplayString }
323 ebnCosMapCpName OBJECT-TYPE
324 SYNTAX SnaNAUWildcardName
325 MAX-ACCESS not-accessible
328 "Fully qualified network CP name for which the COS mapping
331 ::= { ebnCosMapEntry 1 }
333 ebnCosMapNonNativeCos OBJECT-TYPE
334 SYNTAX DisplayString (SIZE(1..8))
335 MAX-ACCESS not-accessible
338 "This object contains one of the following values:
340 - An 8-character COS name used in a non-native subnetwork.
341 - The single character '*', identifying the entry with the
342 default native COS for a non-native CP name. This entry
343 is used when there is no entry in the table for a
344 non-native CP name / non-native COS pair.
346 Because the characters allowed in an SNA COS name come from
347 a restricted character set, these names are not subject to
348 internationalization."
350 ::= { ebnCosMapEntry 2 }
352 ebnCosMapNativeCos OBJECT-TYPE
353 SYNTAX DisplayString (SIZE(1..8))
357 "An 8-byte name for the class-of-service, as known in the
360 Because the characters allowed in an SNA COS name come from
361 a restricted character set, these names are not subject to
362 internationalization."
364 ::= { ebnCosMapEntry 3 }
366 -- ******************************************************************
367 -- EBN Subnet Routing List Group
368 -- The EBN Subnet Routing List indicates to which nodes an EBN
369 -- forwards search request. This group contains information
370 -- pertaining to the CONFIGURED Subnet Routing List at an EBN. How a
371 -- particular search request is routed is determined by a transient
372 -- list that the EBN creates based on the configured list and other
374 -- *******************************************************************
376 ebnSubnetRoutingList OBJECT IDENTIFIER ::= { ebnObjects 5 }
378 ebnSubnetSearchTable OBJECT-TYPE
379 SYNTAX SEQUENCE OF EbnSubnetSearchEntry
380 MAX-ACCESS not-accessible
383 "This table contains one entry for each fully qualified LU
384 name for which an associated subnet routing list has been
385 defined. An entry in this table contains general
386 characteristics of the subnet search routing list for an
387 LU name. The routing list itself is represented by a set
388 of contiguous entries in the ebnSearchTable."
390 ::= { ebnSubnetRoutingList 1 }
392 ebnSubnetSearchEntry OBJECT-TYPE
393 SYNTAX EbnSubnetSearchEntry
394 MAX-ACCESS not-accessible
397 "An entry for the ebnSubnetSearchTable. The entry
398 represents the configured parameters the EBN uses when it
399 is determining how to search for the LU identified by the
400 ebnSubnetSearchLuName object."
402 INDEX { ebnSubnetSearchLuName }
404 ::= { ebnSubnetSearchTable 1 }
406 EbnSubnetSearchEntry ::= SEQUENCE {
407 ebnSubnetSearchLuName SnaNAUWildcardName,
408 ebnSubnetSearchDynamics INTEGER,
409 ebnSubnetSearchOrdering INTEGER }
411 ebnSubnetSearchLuName OBJECT-TYPE
412 SYNTAX SnaNAUWildcardName
413 MAX-ACCESS not-accessible
416 "Fully qualified network LU name."
418 ::= { ebnSubnetSearchEntry 1 }
420 ebnSubnetSearchDynamics OBJECT-TYPE
421 SYNTAX INTEGER { none(1),
427 "Indicates whether an EBN may add dynamic entries to a
428 subnetwork routing list. none(1) means no entries may be
429 added to the subnetwork routing list. limited(2) means
430 only likely entries may be added to the subnetwork routing
431 list. full(3) means all native extended border nodes and
432 adjacent, non-native EBNs and NNs will be added to the
433 subnetwork routing list."
435 ::= { ebnSubnetSearchEntry 2 }
437 ebnSubnetSearchOrdering OBJECT-TYPE
438 SYNTAX INTEGER{ priority(1),
443 "Indicates whether an EBN may reorder a subnetwork routing
444 list so that entries which are more likely to be successful
445 move to the top of the subnetwork routing list and entries
446 which are more likely to be unsuccessful move to the bottom
448 The following values are defined:
450 - priority(1): Entries may be reordered.
451 - defined(2): Entries must not be reordered."
453 ::= { ebnSubnetSearchEntry 3 }
455 -- Border node search table
457 ebnSearchTable OBJECT-TYPE
458 SYNTAX SEQUENCE OF EbnSearchEntry
459 MAX-ACCESS not-accessible
462 "This table indicates the CONFIGURED list of control points
463 to which the EBN sends Locate searches for a given fully
464 qualified LU name. Each entry in the table indicates one
465 control point that should be included in a multi-subnet
466 search for a particular LU name."
468 ::= { ebnSubnetRoutingList 2 }
470 ebnSearchEntry OBJECT-TYPE
471 SYNTAX EbnSearchEntry
472 MAX-ACCESS not-accessible
475 "An entry in the ebnSearchTable. An entry can exist in
476 this table only if an entry exists in the
477 ebnSubnetSearchTable with an ebnSubnetSearchLuName value
478 matching this entry's ebnSearchLuName.
479 For a given ebnSearchLuName value, the ordering of entries
480 provides by the ebnSearchIndex values corresponds to the
481 order in which the control points to be searched appear in
482 the CONFIGURED search list for the ebnSearchLuName."
484 INDEX { ebnSearchLuName,
487 ::= { ebnSearchTable 1 }
489 EbnSearchEntry ::= SEQUENCE {
490 ebnSearchLuName SnaNAUWildcardName,
491 ebnSearchIndex Unsigned32,
492 ebnSearchCpName DisplayString,
493 ebnSearchSNVC Unsigned32 }
495 ebnSearchLuName OBJECT-TYPE
496 SYNTAX SnaNAUWildcardName
497 MAX-ACCESS not-accessible
500 "Fully qualified network LU name. If this object has the
501 same value as the ebnSubnetSearchLuName object, then the
502 two objects are referring to the same LU."
504 ::= { ebnSearchEntry 1 }
506 ebnSearchIndex OBJECT-TYPE
508 MAX-ACCESS not-accessible
511 "Secondary index enumerating the CONFIGURED order in which
512 a search is forwarded to CPs for a particular LU name. The
513 order for an actual search is determined dynamically by the
514 EBN, based on this configured information and on other
515 factors, including whether search dynamics and search
516 ordering are enabled. Information on these last two settings
517 is available in, respectively, the ebnSubnetSearchDynamics
518 and ebnSubnetSearch ordering objects."
520 ::= { ebnSearchEntry 2 }
522 ebnSearchCpName OBJECT-TYPE
523 SYNTAX DisplayString(SIZE(1..17))
527 "This object specifies the CP(s) to which a search should be
528 forwarded. It either follows the SnaNAUWildcardName textual
529 convention or takes one of the following special formats:
531 '*' indicates that all native EBNs and all adjacent non-
532 native EBNs and NNs may be added to the routing list
535 '*SELF' indicates that the EBN should search itself and
536 its native subnetwork at this time during the
539 '*EBNS' indicates all native EBNs.
541 Because the characters allowed in a CP name come from a
542 restricted character set, and because the three formats
543 listed here use no special characters, this object is not
544 subject to internationalization."
546 ::= { ebnSearchEntry 3 }
548 ebnSearchSNVC OBJECT-TYPE
553 "The maximum number of subnets a Locate search procedure may
556 ::= { ebnSearchEntry 4 }
558 -- *******************************************************************
559 -- HPR Extended Border Node Intermediate Session Group
560 -- The hbnIsInTable is a sparse extension to the appnIsInTable.
561 -- For sessions that use back-to-back RTP connections in an HBN,
562 -- this table provides the network connection endpoint identifier
563 -- (NceId) and the transport connection identifier (Tcid) for the
564 -- second RTP connection.
565 -- *******************************************************************
567 hbn OBJECT IDENTIFIER ::= { ebnObjects 6 }
569 hbnIsInTable OBJECT-TYPE
570 SYNTAX SEQUENCE OF HbnIsInEntry
571 MAX-ACCESS not-accessible
574 "The HBN Intermediate Session table."
577 hbnIsInEntry OBJECT-TYPE
579 MAX-ACCESS not-accessible
582 "Entry of the HBN Intermediate Session Table. An entry
583 exists in this table for every intermediate session being
584 routed between back-to-back RTP connections in the HBN.
586 When an entry for a session exists in this table, the
587 NceIds and Tcids for the back-to-back RTP connections are
588 made available in the following four objects:
590 RTP connection in the direction of the PLU:
591 - NceId: appnIsInRtpNceId (in the APPN MIB)
592 - Tcid: appnIsinRtpTcid (in the APPN MIB).
594 RTP connection in the direction of the SLU:
595 - NceId: hbnIsInRtpNceId (in this table)
596 - Tcid: hbnIsInRtpTcid (in this table)."
598 INDEX { hbnIsInFqCpName,
601 ::= { hbnIsInTable 1 }
603 HbnIsInEntry ::= SEQUENCE {
604 hbnIsInFqCpName SnaControlPointName,
605 hbnIsInPcid OCTET STRING,
606 hbnIsInRtpNceId OCTET STRING,
607 hbnIsInRtpTcid OCTET STRING }
609 hbnIsInFqCpName OBJECT-TYPE
610 SYNTAX SnaControlPointName
611 MAX-ACCESS not-accessible
614 "The network-qualified control point name of the node at
615 which the session and PCID originated. For APPN and LEN
616 nodes, this is either the CP name of the APPN node at
617 which the origin LU is located or the CP name of the NN
618 serving the LEN node at which the origin LU is located.
620 If this object has the same value as the appnIsInFqCpName
621 object in the APPN MIB, then the two objects are referring
622 to the same APPN control point."
623 ::= { hbnIsInEntry 1 }
625 hbnIsInPcid OBJECT-TYPE
626 SYNTAX OCTET STRING (SIZE(8))
627 MAX-ACCESS not-accessible
630 "The procedure correlation identifier (PCID) of a session.
631 It is an 8-octet value.
633 If this object has the same value as the appnIsInPcid object
634 in the APPN MIB, and if the corresponding hbnIsInFqCpName
635 object has the same value as the corresponding
636 appnIsInFqCpName object, then the entries indexed by these
637 objects are referring to the same session."
639 ::= { hbnIsInEntry 2 }
641 hbnIsInRtpNceId OBJECT-TYPE
642 SYNTAX OCTET STRING (SIZE(1..8))
646 "The HPR local Network Connection Endpoint of the session in
647 the direction of the SLU."
649 ::= { hbnIsInEntry 3 }
651 hbnIsInRtpTcid OBJECT-TYPE
652 SYNTAX OCTET STRING (SIZE(8))
656 "The RTP connection local TCID of the session in the direction
659 ::= { hbnIsInEntry 4 }
661 -- *******************************************************************
662 -- Conformance Statement
663 -- *******************************************************************
664 ebnConformance OBJECT IDENTIFIER ::= { ebnMIB 2 }
666 ebnCompliances OBJECT IDENTIFIER ::= { ebnConformance 1 }
667 ebnGroups OBJECT IDENTIFIER ::= { ebnConformance 2 }
669 -- Compliance statements
670 ebnCompliance MODULE-COMPLIANCE
673 "The compliance statement for the SNMPv2 entities which
674 implement the ebnMIB."
676 MODULE -- this module
678 -- Unconditionally mandatory groups
682 ebnDirectoryConfigGroup,
684 ebnSubnetRoutingListGroup }
686 -- Conditionally mandatory groups
689 "The hbnIsInGroup is mandatory only for HPR extended border
692 ::= {ebnCompliances 1 }
695 ebnDirectoryGroup OBJECT-GROUP
696 OBJECTS { ebnDirSubnetAffiliation }
699 "The EBN-related directory objects."
704 ebnIsRscvGroup OBJECT-GROUP
705 OBJECTS { ebnIsRscvDestinationRoute,
706 ebnIsRscvDestinationCos }
709 "Two objects representing RSCV and class of service
710 information saved by an EBN."
714 ebnDirectoryConfigGroup OBJECT-GROUP
715 OBJECTS { ebnSearchCacheTime,
717 ebnDefaultSubnetVisitCount }
720 "The EBN Directory Configuration Group."
724 ebnCosMappingGroup OBJECT-GROUP
725 OBJECTS { ebnCosMapNativeCos }
728 "The EBN COS Mapping Group."
732 ebnSubnetRoutingListGroup OBJECT-GROUP
733 OBJECTS { ebnSubnetSearchDynamics,
734 ebnSubnetSearchOrdering,
739 "The Subnet Routing List Group."
743 hbnIsInGroup OBJECT-GROUP
744 OBJECTS { hbnIsInRtpNceId, hbnIsInRtpTcid }
747 "The HBN-related Intermediate Session Objects."