Network Working Group J. Saperia Request for Comments: 1559 Digital Equipment Corporation Obsoletes: 1289 December 1993 Category: Standards Track DECnet Phase IV MIB Extensions Status of this Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited. Table of Contents 1. Introduction ................................................ 1 2. The Network Management Framework ............................ 2 2.1 Object Definitions ......................................... 2 3. Selected Objects ............................................ 3 4. Textual Conventions ......................................... 4 5. Definitions ................................................. 4 6. Changes from RFC 1289 ....................................... 67 7. Acknowledgements ........................................... 68 8. References ................................................. 68 9. Security Considerations .................................... 69 10. Author's Address .......................................... 69 1. Introduction This memo defines a set of DECnet Phase IV extensions that have been created for the Internet MIB. It reflects changes which are the result of operational experience based on RFC 1289. When used in conjunction with the structure of management information (STD 16, RFC 1155), the management information base for network management of TCP/IP-based internets (STD 17, RFC 1213) and the Simple Network Management Protocol (STD 15, RFC 1157), it will be possible to provide integrated network management of combined TCP/IP and DECnet Phase IV based internets. This document was produced by the DECnet Phase IV MIB working group of the Internet Engineering Task Force (IETF). With the adoption of The Simple Network Management Protocol (STD 15, RFC 1157), the management information base for network management of TCP/IP-based internets (STD 17, RFC 1213), and the structure of DECnet Phase IV MIB Working Group [Page 1] RFC 1559 DECnet Phase IV MIB December 1993 management information (STD 16, RFC 1155), by the Internet, and a large number of vendor implementations of these standards in commercially available products, it became possible to provide a higher level of effective network management in TCP/IP-based internets than previously available. With the growth in the use of these standards, network managers desired to use this environment as a base for providing integrated network management of multi-protocol networks. DECnet Phase IV is one widely used protocol which often coexists in IP-based internets. This memo provides the mechanisms by which IP- based management stations can effectively manage DECnet Phase IV based systems (especially router products) in an integrated fashion through the use of the standard Internet SMI, MIB and Simple Network Management Protocol. DECnet Phase IV objects have been defined to be used in conjunction with the Internet MIB to allow access and control of these new objects by the Internet community. Additional support for other DECnet-based protocols such as RBMS (Remote Bridge Management Software) or other Digital Equipment Corporation specific hardware platforms is not included in this document. 2. The Network Management Framework The Internet-standard Network Management Framework consists of three components. They are: o STD 16, RFC 1155 which defines the SMI, the mechanisms used for describing and naming objects for the purpose of management. STD 16, RFC 1212 defines a more concise description mechanism, which is wholly consistent with the SMI. o STD 17, RFC 1213 defines MIB-II, the core set of managed objects for the Internet suite of protocols. o STD 15, RFC 1157 which defines the SNMP, the protocol used for network access to managed objects. The Framework permits new objects to be defined for the purpose of experimentation and evaluation. 2.1 Object Definitions Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI. In particular, each object type is named by an DECnet Phase IV MIB Working Group [Page 2] RFC 1559 DECnet Phase IV MIB December 1993 OBJECT IDENTIFIER, an administratively assigned name. The object type together with an object instance serves to uniquely identify a specific instantiation of the object. For human convenience, we often use a textual string, termed the descriptor, to refer to the object type. 3. Selected Objects The objects included in this memo have been created from the DIGITAL Network Architecture Network Management Functional Specification Version 4.0.0, dated July 1983. An attempt has been made to provide a reasonable ordering of these variables into groups. These groups are: System Group Network Management Group Session Group End Group Routing Group Circuit Group DDCMP Group DDCMP Multipoint Control Group Ethernet Group Counters Group Adjacency Group Line Group Non Broadcast Line Group Area Group An effort has also been made to preserve the original syntax of each object wherever possible, for example, a DECnet Phase IV object is Executor State. This was originally coded as a NICE (Network Information and Control Exchange) data type which is a coded single field object of 1 byte in length. When converted for inclusion into the Internet MIB using the Internet SMI, it became an enumerated integer. All objects in this memo are described using the standard Internet SMI and BER of STD 16, RFC 1155. A complete description of an object will include the name, syntax and encoding. Just as with objects supported in the MIB (STD 17, RFC 1213), an object name is identified with an object identifier which has been administratively assigned. This identifies an Object Type. When an object type is combined with a specific instance, the particular object is uniquely identified. The use of Object Descriptors in this memo is consistent with that of STD 17, RFC 1213 - they are text strings meant to be read by humans. The descriptors have been taken from the original DIGITAL Network Architecture Network Management Functional Specification Version 4.0.0 Dated July 1983 which defined DECnet Phase IV objects. These DECnet Phase IV MIB Working Group [Page 3] RFC 1559 DECnet Phase IV MIB December 1993 names were then massaged to put them in a form as consistent as possible with object type names listed in the standard Internet MIB. Object defintion information is also taken directly from the Network Architecture Network Managment Functional Specification cited above wherever possible. In this document, EXECUTOR is intended to reference only the DECnet software and is not intended to effect any other protocols which may be running on the system. 4. Textual Conventions New datatypes have been introduced as a textual conventions in this DECnet Phase IV MIB document. The purpose of these additions is to facilitate understanding of new objects in this MIB. No changes to the SMI or the SNMP are necessary to support these conventions which are described in 5 (Definitions). 5. Definitions DECNET-PHIV-MIB DEFINITIONS ::= BEGIN IMPORTS Gauge FROM RFC1155-SMI OBJECT-TYPE FROM RFC-1212 mib-2, DisplayString FROM RFC1213-MIB; -- DECNet Phase-IV MIB phiv OBJECT IDENTIFIER ::= { mib-2 18 } -- textual conventions PhivAddr ::= OCTET STRING (SIZE (2)) -- This data type is intended as a short word representation of -- standard DECnet Phase IV addresses. DECnet addresses are -- hierarchically structured numbers assigned to a particular -- DECnet node. The address is structured so that the area -- number is contained in the most significant 6 bits of the -- first octet. The next 2 bits of the first octet contain -- the first two bits of the host address. The remainder of -- the host address is contained in the second octet. PhivCounter ::= INTEGER -- This data type has been created for DECnet counters. These -- counters latch at their maximum specified value until either -- the system is restarted, or they are reset to zero by the user DECnet Phase IV MIB Working Group [Page 4] RFC 1559 DECnet Phase IV MIB December 1993 -- or management software. InterfaceIndex ::= INTEGER -- The range of ifIndex, i.e., (1..2147483647) -- groups in the decnetiv mib phivSystem OBJECT IDENTIFIER ::= { phiv 1 } phivManagement OBJECT IDENTIFIER ::= { phiv 2 } session OBJECT IDENTIFIER ::= { phiv 3 } end OBJECT IDENTIFIER ::= { phiv 4 } routing OBJECT IDENTIFIER ::= { phiv 5 } circuit OBJECT IDENTIFIER ::= { phiv 6 } ddcmp OBJECT IDENTIFIER ::= { phiv 7 } control OBJECT IDENTIFIER ::= { phiv 8 } ethernet OBJECT IDENTIFIER ::= { phiv 9 } counters OBJECT IDENTIFIER ::= { phiv 10 } adjacency OBJECT IDENTIFIER ::= { phiv 11 } line OBJECT IDENTIFIER ::= { phiv 12 } nonBroadcastLine OBJECT IDENTIFIER ::= { phiv 14 } area OBJECT IDENTIFIER ::= { phiv 15 } -- System Group -- The implementation of the System Group is mandatory for -- all systems. phivSystemState OBJECT-TYPE SYNTAX INTEGER { on (1), off (2), shut (3), restricted (4) } ACCESS read-write STATUS mandatory DESCRIPTION "This represents the operational state of the executor node. The possible states are: ON Allows logical links. OFF Allows no new links, terminates existing links, and stops routing traffic through. SHUT Allows no new logical links, does not destroy existing logical links, and goes to the OFF state when all logical links are gone. DECnet Phase IV MIB Working Group [Page 5] RFC 1559 DECnet Phase IV MIB December 1993 RESTRICTED Allows no new incoming logical links from other nodes. NOTE: These values are incremented by one compared to the standard DECnet values in order to maintain compliance with RFC 1155)." ::= { phivSystem 1 } phivExecIdent OBJECT-TYPE SYNTAX DisplayString (SIZE (0..32)) ACCESS read-write STATUS mandatory DESCRIPTION "This is a text string that describes the executor node (for example, 'Research Lab'). The string is up to 32 characters of any type." ::= { phivSystem 2 } -- Network Management Group -- The implementation of the Network Management Group is -- mandatory for all systems which contain a DECnet-style -- management version. phivMgmtMgmtVers OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "This is the read-only Network Management Version, consisting of the version number, the Engineering Change Order (ECO) number, and the user ECO number (for example, 3.0.0). This parameter applies to the executor node only." ::= { phivManagement 1 } -- Session Layer Group -- The implementation of the Session Layer Group is optional. -- A system can be said to implement this group if and only if -- all objects in this group are implemented. phivSessionSystemName OBJECT-TYPE SYNTAX DisplayString (SIZE (0..6)) ACCESS read-only STATUS mandatory DESCRIPTION DECnet Phase IV MIB Working Group [Page 6] RFC 1559 DECnet Phase IV MIB December 1993 "Name to be associated with the node identification. Only one name can be assigned to a node address or a circuit identification. No name should be used more than once in a DECnet network. Node-name is one to six upper case alphanumeric characters with at least one alpha character. A length of 0 indicates no name." ::= { session 1 } phivSessionInTimer OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum duration between the time a connect is received for a process at the executor node and the time that process accepts or rejects it. If the connect is not accepted or rejected by the user within the number of seconds specified, Session Control rejects it for the user. A value of 0 indicates no timer is running." ::= { session 2 } phivSessionOutTimer OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the duration between the time the executor requests a connect and the time that connect is acknowledged by the destination node. If the connect is not acknowledged within the number of seconds specified, Session Control returns an error. A value of 0 indicates no timer is running." ::= { session 3 } -- End Communication Layer Group -- The implementation of the End Communication Layer Group is optional. -- A system can be said to implement this group if and only if -- all objects in this group are implemented. -- Remote State Table phivEndRemoteTable OBJECT-TYPE SYNTAX SEQUENCE OF PhivEndRemoteEntry ACCESS not-accessible STATUS mandatory DESCRIPTION DECnet Phase IV MIB Working Group [Page 7] RFC 1559 DECnet Phase IV MIB December 1993 "Information about the state of sessions between the node under study and the nodes found in the table." ::= { end 1 } phivEndRemoteEntry OBJECT-TYPE SYNTAX PhivEndRemoteEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Information about a particular remote node as seen from the end communication layer." INDEX { phivEndRemoteHostNodeID } ::= { phivEndRemoteTable 1 } PhivEndRemoteEntry ::= SEQUENCE { phivEndRemoteHostNodeID PhivAddr, phivEndRemoteState INTEGER, phivEndCircuitIndex INTEGER, phivEndActiveLinks INTEGER, phivEndDelay INTEGER } phivEndRemoteHostNodeID OBJECT-TYPE SYNTAX PhivAddr -- OCTET STRING (SIZE (2)) ACCESS read-only STATUS mandatory DESCRIPTION "This value is the address of the remote node to be evaluated." ::= { phivEndRemoteEntry 1 } phivEndRemoteState OBJECT-TYPE SYNTAX INTEGER { on (1), off (2), shut (3), restricted (4) } ACCESS read-write STATUS mandatory DESCRIPTION "This represents the operational state of the remote node DECnet Phase IV MIB Working Group [Page 8] RFC 1559 DECnet Phase IV MIB December 1993 being evaluated. The possible states are: ON Allows logical links. OFF Allows no new links, terminates existing links, and stops routing traffic through. SHUT Allows no new logical links, does not destroy existing logical links, and goes to the OFF state when all logical links are gone. RESTRICTED Allows no new incoming logical links from other nodes. NOTE: These values are incremented by one compared to the standard DECnet values in order to maintain compliance with RFC 1155." ::= { phivEndRemoteEntry 2 } phivEndCircuitIndex OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-only STATUS mandatory DESCRIPTION "A unique index value for each known circuit used to communicate with the remote node. This is the same value as phivCircuitIndex." ::= { phivEndRemoteEntry 3 } phivEndActiveLinks OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "This read-only parameter represents the number of active logical links from the executor to the destination node." ::= { phivEndRemoteEntry 4 } phivEndDelay OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "This read-only parameter is the average round trip delay in seconds to the destination node. This parameter is kept on a remote node basis." ::= { phivEndRemoteEntry 5 } -- End System Counter Table DECnet Phase IV MIB Working Group [Page 9] RFC 1559 DECnet Phase IV MIB December 1993 phivEndCountTable OBJECT-TYPE SYNTAX SEQUENCE OF PhivEndCountEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Information about the counters associated with each end system that is known to the entity. These counters reflect totals from the perspective of the executor node." ::= { end 2 } phivEndCountEntry OBJECT-TYPE SYNTAX PhivEndCountEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Information about a particular session between two end systems." INDEX { phivEndCountHostNodeID } ::= { phivEndCountTable 1 } PhivEndCountEntry ::= SEQUENCE { phivEndCountHostNodeID PhivAddr, phivEndCountSecsLastZeroed PhivCounter, phivEndCountUsrBytesRec PhivCounter, phivEndCountUsrBytesSent PhivCounter, phivEndUCountUsrMessRec PhivCounter, phivEndCountUsrMessSent PhivCounter, phivEndCountTotalBytesRec PhivCounter, phivEndCountTotalBytesSent PhivCounter, phivEndCountTotalMessRec PhivCounter, phivEndCountTotalMessSent PhivCounter, phivEndCountConnectsRecd PhivCounter, phivEndCountConnectsSent PhivCounter, DECnet Phase IV MIB Working Group [Page 10] RFC 1559 DECnet Phase IV MIB December 1993 phivEndCountReponseTimeouts PhivCounter, phivEndCountRecdConnectResErrs PhivCounter } phivEndCountHostNodeID OBJECT-TYPE SYNTAX PhivAddr -- OCTET STRING (SIZE (2)) ACCESS read-only STATUS mandatory DESCRIPTION "This value is the address of the remote node to be evaluated." ::= { phivEndCountEntry 1 } phivEndCountSecsLastZeroed OBJECT-TYPE SYNTAX PhivCounter (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "This value is the number of seconds that have elapsed since the counters for the node in this table row were last set to zero. This counter is located in the network management layer, but is returned with the end system information which follows." ::= { phivEndCountEntry 2 } phivEndCountUsrBytesRec OBJECT-TYPE SYNTAX PhivCounter (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "Number of user bytes received from the target host." ::= { phivEndCountEntry 3 } phivEndCountUsrBytesSent OBJECT-TYPE SYNTAX PhivCounter (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "Number of user bytes sent to the target host." ::= { phivEndCountEntry 4 } phivEndUCountUsrMessRec OBJECT-TYPE SYNTAX PhivCounter (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION DECnet Phase IV MIB Working Group [Page 11] RFC 1559 DECnet Phase IV MIB December 1993 "Number of user messages received from the target host." ::= { phivEndCountEntry 5 } phivEndCountUsrMessSent OBJECT-TYPE SYNTAX PhivCounter (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "Number of user messages sent to the target host." ::= { phivEndCountEntry 6 } phivEndCountTotalBytesRec OBJECT-TYPE SYNTAX PhivCounter (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "Number of bytes received from the target host." ::= { phivEndCountEntry 7 } phivEndCountTotalBytesSent OBJECT-TYPE SYNTAX PhivCounter (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "Number of bytes sent to the target host." ::= { phivEndCountEntry 8 } phivEndCountTotalMessRec OBJECT-TYPE SYNTAX PhivCounter (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "Number of messages received from the target host." ::= { phivEndCountEntry 9 } phivEndCountTotalMessSent OBJECT-TYPE SYNTAX PhivCounter (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "Number of messages sent to the target host." ::= { phivEndCountEntry 10 } phivEndCountConnectsRecd OBJECT-TYPE SYNTAX PhivCounter (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION DECnet Phase IV MIB Working Group [Page 12] RFC 1559 DECnet Phase IV MIB December 1993 "Number of connects received from the target host." ::= { phivEndCountEntry 11 } phivEndCountConnectsSent OBJECT-TYPE SYNTAX PhivCounter (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "Number of connects sent to the target host." ::= {phivEndCountEntry 12 } phivEndCountReponseTimeouts OBJECT-TYPE SYNTAX PhivCounter (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "Number of response timeouts." ::= { phivEndCountEntry 13 } phivEndCountRecdConnectResErrs OBJECT-TYPE SYNTAX PhivCounter (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "Number of received connect resource errors." ::= {phivEndCountEntry 14 } -- additional End System objects phivEndMaxLinks OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum active logical link count allowed for the executor." ::= { end 3 } phivEndNSPVers OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "This read-only parameter represents the version number of the node End Communication S/W. The format is version number, ECO, and user ECO, e.g., 4.1.0" ::= { end 4 } DECnet Phase IV MIB Working Group [Page 13] RFC 1559 DECnet Phase IV MIB December 1993 phivEndRetransmitFactor OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum number of times the source End Communication at the executor node will restart the retransmission timer when it expires. If the number is exceeded, Session Control disconnects the logical link for the user." ::= { end 5 } phivEndDelayFact OBJECT-TYPE SYNTAX INTEGER (1..255) ACCESS read-write STATUS mandatory DESCRIPTION "This is the number by which to multiply one sixteenth of the estimated round trip delay to a node to set the retransmission timer to that node." ::= { end 6 } phivEndDelayWeight OBJECT-TYPE SYNTAX INTEGER (1..255) ACCESS read-write STATUS mandatory DESCRIPTION "This number represents the weight to apply to a current round trip delay estimate to a remote node when updating the estimated round trip delay to a node. On some systems the number must be 1 less than a power of 2 for computational efficiency." ::= { end 7 } phivEndInactivityTimer OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum duration of inactivity (no data in either direction) on a logical link before the node checks to see if the logical link still works. If no activity occurs within the minimum number of seconds, End Communication generates artificial traffic to test the link (End Communication specification)." ::= { end 8 } DECnet Phase IV MIB Working Group [Page 14] RFC 1559 DECnet Phase IV MIB December 1993 phivEndCountZeroCount OBJECT-TYPE SYNTAX INTEGER { other (1), reset (2) } ACCESS read-write STATUS mandatory DESCRIPTION "When this value is set to 2, all of the counters in the End System Counter Table are set to zero." ::= { end 9 } phivEndMaxLinksActive OBJECT-TYPE SYNTAX PhivCounter (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the high water mark for the number of links that were active at any one time." ::= { end 10 } -- Routing Layer Group -- The implementation of the Routing Layer Group is mandatory for -- all systems that implement level 1 routing layer -- communications. phivRouteBroadcastRouteTimer OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value determines the maximum time in seconds allowed between Routing updates on Ethernet circuits. When this timer expired before a routing update occurs, a routing update is forced. With a standard calculation, Routing also uses this timer to enforce a minimum delay between routing updates." ::= { routing 1 } phivRouteBuffSize OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This parameter value determines the maximum size of a Routing message. It therefore determines the maximum size message that can be forwarded. This size includes DECnet Phase IV MIB Working Group [Page 15] RFC 1559 DECnet Phase IV MIB December 1993 protocol overhead down to and including the End Communication layer, plus a constant value of 6. (This value of 6 is included to provide compatibility with the parameter definition in Phase III, which included the Routing overhead.) It does not include Routing or Data link overhead (except for the constant value of 6). There is one buffer size for all circuits. NOTE: The BUFFER SIZE defines the maximum size messages that the Routing layer can forward. The SEGMENT BUFFER SIZE (defined below) defines the maximum size messages that the End Communication layer can transmit or receive. The SEGMENT BUFFER SIZE is always less than or equal to the BUFFER SIZE. Normally the two parameters will be equal. They may be different to allow the network manager to alter buffer sizes on all nodes without interruption of service. They both include an extra 6 bytes for compatibility with Phase III." ::= { routing 2 } phivRouteRoutingVers OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "This read-only parameter identifies the executor node's Routing version number. The format is version number, ECO, and user ECO, e.g., 4.1.0" ::= { routing 3 } phivRouteMaxAddr OBJECT-TYPE SYNTAX INTEGER (1..1023) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the largest node number and, therefore, number of nodes that can be known about by the executor node's home area." ::= { routing 4 } phivRouteMaxBdcastNonRouters OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum total number of nonrouters the executor node can have on its Ethernet DECnet Phase IV MIB Working Group [Page 16] RFC 1559 DECnet Phase IV MIB December 1993 circuits." ::= { routing 5 } phivRouteMaxBdcastRouters OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum total number of routers the executor node can have on its Ethernet circuits." ::= { routing 6 } phivRouteMaxBuffs OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum number of transmit buffers that Routing may use for all circuits." ::= { routing 7 } phivRouteMaxCircuits OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum number of Routing circuits that the executor node can know about." ::= { routing 8 } phivRouteMaxCost OBJECT-TYPE SYNTAX INTEGER (1..1022) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum total path cost allowed from the executor to any node within an area. The path cost is the sum of the circuit costs along a path between two nodes. This parameter defines the point where the executor node's Routing routing decision algorithm declares another node unreachable because the cost of the least costly path to the other node is excessive. For correct operation, this parameter must not be less than the maximum path cost of the network." ::= { routing 9 } DECnet Phase IV MIB Working Group [Page 17] RFC 1559 DECnet Phase IV MIB December 1993 phivRouteMaxHops OBJECT-TYPE SYNTAX INTEGER (1..30) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum number of routing hops allowable from the executor to any other reachable node within an area. (A hop is the logical distance over a circuit between two adjacent nodes.) This parameter defines the point where the executor node's Routing routing decision algorithm declares another node unreachable because the length of the shortest path between the two nodes is too long. For correct operation, this parameter must not be less than the network diameter. (The network diameter is the reachability distance between the two nodes of the network having the greatest reachability distance, where reachability distance is the length the shortest path between a given pair of nodes.)" ::= { routing 10 } phivRouteMaxVisits OBJECT-TYPE SYNTAX INTEGER (1..63) ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the maximum number of nodes a message coming into the executor node can have visited. If the message is not for this node and the MAXIMUM VISITS number is exceeded, the message is discarded. The MAXIMUM VISITS parameter defines the point where the packet lifetime control algorithm discards a packet that has traversed too many nodes. For correct operation, this parameter must not be less than the maximum path length of the network. (The maximum path length is the routing distance between the two nodes of the network having the greatest routing distance, where routing distance is the length of the least costly path between a given pair of nodes.)" ::= { routing 11 } phivRouteRoutingTimer OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This value determines the maximum time in seconds allowed between Routing updates on non-Ethernet DECnet Phase IV MIB Working Group [Page 18] RFC 1559 DECnet Phase IV MIB December 1993 circuits. When this timer expires before a routing update occurs, a routing update is forced." ::= { routing 12 } phivRouteSegBuffSize OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This parameter value determines the maximum size of an end-to-end segment. The size is a decimal integer in the range 1-65535. This size is in bytes. This size includes protocol overhead down to and including the End Communication layer, plus a constant value of 6. (This value of 6 is included to provide compatibility with the BUFFER SIZE parameter definition.) It does not include Routing or Data link overhead (except for the constant value of 6)." ::= { routing 13 } phivRouteType OBJECT-TYPE SYNTAX INTEGER { routing-III (1), nonrouting-III (2), area (3), routing-IV (4), nonrouting-IV (5) } ACCESS read-only STATUS obsolete DESCRIPTION "This parameter indicates the type of the executor node. The node-type is one of the following: routing-III nonrouting-III routing-IV ronrouting-IV area A routing node has full routing capability. A nonrouting node contains a subset of the Routing routing modules. The III and IV indicate the DNA phase of the node. Nonrouting nodes can deliver and receive packets to and from any node, but cannot route packets from other nodes through to other nodes. An area node routes between areas. Refer to the Routing specification for details. DECnet Phase IV MIB Working Group [Page 19] RFC 1559 DECnet Phase IV MIB December 1993 For adjacent nodes, this is a read-only parameter that indicates the type of the reachable adjacent node. NOTE: The ROUTING-III and NONROUTING-III values are incremented by one compared to the standard DECnet values in order to maintain compliance with RFC 1155)" ::= { routing 14 } phivRouteCountAgedPktLoss OBJECT-TYPE SYNTAX PhivCounter (0..127) ACCESS read-only STATUS mandatory DESCRIPTION "Number of aged packet losses." ::= { routing 15 } phivRouteCountNodeUnrPktLoss OBJECT-TYPE SYNTAX PhivCounter (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "Number of node unreachable packet losses." ::= { routing 16 } phivRouteCountOutRngePktLoss OBJECT-TYPE SYNTAX PhivCounter (0..127) ACCESS read-only STATUS mandatory DESCRIPTION "Number of node out-of-range packet losses." ::= { routing 17 } phivRouteCountOverSzePktLoss OBJECT-TYPE SYNTAX PhivCounter (0..127) ACCESS read-only STATUS mandatory DESCRIPTION "Number of Oversized packet losses." ::= { routing 18 } phivRouteCountPacketFmtErr OBJECT-TYPE SYNTAX PhivCounter (0..127) ACCESS read-only STATUS mandatory DESCRIPTION "Number of packet format errors." ::= { routing 19 } DECnet Phase IV MIB Working Group [Page 20] RFC 1559 DECnet Phase IV MIB December 1993 phivRouteCountPtlRteUpdtLoss OBJECT-TYPE SYNTAX PhivCounter (0..127) ACCESS read-only STATUS mandatory DESCRIPTION "Number of partial routing update losses." ::= { routing 20 } phivRouteCountVerifReject OBJECT-TYPE SYNTAX PhivCounter (0..127) ACCESS read-only STATUS mandatory DESCRIPTION "Number of verification rejects." ::= { routing 21 } -- Level 1 Routing Table phivLevel1RouteTable OBJECT-TYPE SYNTAX SEQUENCE OF PhivLevel1RouteEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Information about the currently known DECnet Phase IV Routes." ::= { routing 22 } phivLevel1RouteEntry OBJECT-TYPE SYNTAX PhivLevel1RouteEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Information about the currently known DECnet Phase IV Routes." INDEX { phivLevel1RouteNodeAddr } ::= { phivLevel1RouteTable 1 } PhivLevel1RouteEntry ::= SEQUENCE { phivLevel1RouteNodeAddr PhivAddr, phivLevel1RouteCircuitIndex INTEGER, phivLevel1RouteCost INTEGER, phivLevel1RouteHops INTEGER, phivLevel1RouteNextNode DECnet Phase IV MIB Working Group [Page 21] RFC 1559 DECnet Phase IV MIB December 1993 PhivAddr } phivLevel1RouteNodeAddr OBJECT-TYPE SYNTAX PhivAddr -- OCTET STRING (SIZE (2)) ACCESS read-only STATUS mandatory DESCRIPTION "This value is the address of the node about which routing information is contained in this level 1 routing table." ::= { phivLevel1RouteEntry 1 } phivLevel1RouteCircuitIndex OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-only STATUS mandatory DESCRIPTION "A unique index value for each known circuit. This is the index to the circuit state table and is the same value as phivCircuitIndex." ::= { phivLevel1RouteEntry 2 } phivLevel1RouteCost OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "This read-only parameter represents the total cost over the current path to the destination node. Cost is a positive integer value associated with using a circuit. Routing routes messages (data) along the path between two nodes with the smallest cost. COST is kept on a remote node basis." ::= { phivLevel1RouteEntry 3 } phivLevel1RouteHops OBJECT-TYPE SYNTAX INTEGER (0..127) ACCESS read-only STATUS mandatory DESCRIPTION "This read-only parameter represents the number of hops over to a destination node. A hop is Routing value representing the logical distance between two nodes in a network. HOPS is kept on a remote node basis." ::= { phivLevel1RouteEntry 4 } phivLevel1RouteNextNode OBJECT-TYPE DECnet Phase IV MIB Working Group [Page 22] RFC 1559 DECnet Phase IV MIB December 1993 SYNTAX PhivAddr -- OCTET STRING (SIZE (2)) ACCESS read-only STATUS mandatory DESCRIPTION "This read-only value indicates the next node on the circuit used to get to the node under scrutiny (next hop)." ::= { phivLevel1RouteEntry 5 } -- Additional routing parameters phivRouteCountZeroCount OBJECT-TYPE SYNTAX INTEGER { other (1), reset (2) } ACCESS read-write STATUS mandatory DESCRIPTION "When this value is set to 2, the following objects are set to Zero: phivRouteCountAgedPktLoss, phivRouteCountNodeUnrPktLoss, phivRouteCountOutRngePktLoss, phivRouteCountOverSzePktLoss, phivRouteCountPacketFmtErr, phivRouteCountPtlRteUpdtLoss, and phivRouteCountVerifReject." ::= { routing 23 } phivRouteSystemAddr OBJECT-TYPE SYNTAX PhivAddr -- OCTET STRING (SIZE (2)) ACCESS read-only STATUS obsolete DESCRIPTION "DECnet Phase IV node address." ::= { routing 24 } phivRouteRoutingType OBJECT-TYPE SYNTAX INTEGER { routing-III (1), nonrouting-III (2), area (3), routing-IV (4), nonrouting-IV (5) } ACCESS read-write STATUS mandatory DESCRIPTION DECnet Phase IV MIB Working Group [Page 23] RFC 1559 DECnet Phase IV MIB December 1993 "This read-write parameter indicates the type of the executor node. The node-type is one of the following: routing-III nonrouting-III routing-IV ronrouting-IV area A routing node has full routing capability. A nonrouting node contains a subset of the Routing routing modules. The III and IV indicate the DNA phase of the node. Nonrouting nodes can deliver and receive packets to and from any node, but cannot route packets from other nodes through to other nodes. An area node routes between areas. Refer to the Routing specification for details. For adjacent nodes, this is a read-only parameter that indicates the type of the reachable adjacent node. NOTE: The ROUTING-III and NONROUTING-III values are incremented by one compared to the standard DECnet values in order to maintain compliance with RFC 1155)" ::= { routing 25 } phivRouteSystemAddress OBJECT-TYPE SYNTAX PhivAddr -- OCTET STRING (SIZE (2)) ACCESS read-write STATUS mandatory DESCRIPTION "DECnet Phase IV node address." ::= { routing 26 } -- Circuit Group -- The implementation of the Circuit Group is mandatory for -- all systems. -- Circuit Parameters Table phivCircuitParametersTable OBJECT-TYPE SYNTAX SEQUENCE OF PhivCircuitParametersEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Information about the parameters associated with all circuits currently known." ::= {circuit 1 } DECnet Phase IV MIB Working Group [Page 24] RFC 1559 DECnet Phase IV MIB December 1993 phivCircuitParametersEntry OBJECT-TYPE SYNTAX PhivCircuitParametersEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Parameters information about all circuits currently known." INDEX { phivCircuitIndex } ::= { phivCircuitParametersTable 1 } PhivCircuitParametersEntry ::= SEQUENCE { phivCircuitIndex INTEGER, phivCircuitLineIndex INTEGER, phivCircuitCommonState INTEGER, phivCircuitCommonSubState INTEGER, phivCircuitCommonName DisplayString, phivCircuitExecRecallTimer INTEGER, phivCircuitCommonType INTEGER, phivCircuitService INTEGER, phivCircuitExecCost INTEGER, phivCircuitExecHelloTimer INTEGER } phivCircuitIndex OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-only STATUS mandatory DESCRIPTION "A unique index value for each known circuit." ::= { phivCircuitParametersEntry 1 } phivCircuitLineIndex OBJECT-TYPE SYNTAX InterfaceIndex ACCESS read-only STATUS mandatory DESCRIPTION "The line on which this circuit is active. This is DECnet Phase IV MIB Working Group [Page 25] RFC 1559 DECnet Phase IV MIB December 1993 the same as the ifIndex." ::= { phivCircuitParametersEntry 2 } phivCircuitCommonState OBJECT-TYPE SYNTAX INTEGER { on (1), off (2), service (3), cleared (4) } ACCESS read-write STATUS mandatory DESCRIPTION "This value represents the circuit's Network Management operational state. NOTE: These values are incremented by one compared to the standard DECnet values in order to maintain compliance with RFC 1155." ::= { phivCircuitParametersEntry 3 } phivCircuitCommonSubState OBJECT-TYPE SYNTAX INTEGER { starting (1),