-- extracted from draft-irtf-nmrg-get-subtree-mib-00.txt -- at Mon Nov 15 17:11:28 1999 GET-SUBTREE-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Unsigned32, Counter32 FROM SNMPv2-SMI RowStatus, TruthValue FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF SnmpAdminString FROM SNMP-FRAMEWORK-MIB; getSubtreeMIB MODULE-IDENTITY LAST-UPDATED "9907161200Z" ORGANIZATION "IRTF Network Management Research Group" CONTACT-INFO " Dave Thaler Microsoft Corporation One Microsoft Way Redmond, WA 98052-6399 EMail: dthaler@dthaler.microsoft.com" DESCRIPTION "This MIB module provides the ability to retrieve an arbitary subtree of OIDs by receiving traps." ::= { XXX } getSubtreeMIBObjects OBJECT IDENTIFIER ::= { getSubtreeMIB 1 } getSubtree OBJECT IDENTIFIER ::= { getSubtreeMIBObjects 1 } getSubtreeTraps OBJECT IDENTIFIER ::= { getSubtreeMIBObjects 2 } getSubtreeTable OBJECT-TYPE SYNTAX SEQUENCE OF GetSubtreeEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table containing information on GET-SUBTREE operations in progress." ::= { getSubtree 1 } getSubtreeEntry OBJECT-TYPE SYNTAX GetSubtreeEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) containing the information on a particular GET-SUBTREE operation in progress." INDEX { getSubtreeIndex } ::= { getSubtreeTable 1 } GetSubtreeEntry ::= SEQUENCE { getSubtreeIndex Unsigned32, getSubtreeTargetAddrName SnmpAdminString, getSubtreeRootOid OBJECT IDENTIFIER, getSubtreeSequenceNumber Counter32, getSubtreeDone TruthValue, getSubtreeStatus RowStatus } getSubtreeIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS not-accessible STATUS current DESCRIPTION "An integer uniquely identifying the GET-SUBTREE operation in progress. This value should be randomly generated by a manager before attempting to create the row." ::= { getSubtreeEntry 1 } getSubtreeTargetAddrName OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "This object selects a management target defined in the snmpTargetAddrTable (in the SNMP-TARGET-MIB). The selected target is defined by an entry in the snmpTargetAddrTable whose index value (snmpTargetAddrName) is equal to this object." ::= { getSubtreeEntry 2 } getSubtreeRootOid OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "The OID of the subtree to be sent." ::= { getSubtreeEntry 3 } getSubtreeSequenceNumber OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of trap responses previously sent for this request." ::= { getSubtreeEntry 4 } getSubtreeDone OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "This is set to true in the last trap sent, and is set to false otherwise." ::= { getSubtreeEntry 5 } getSubtreeStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row, by which new entries may be created, or old entries deleted from this table. Once created, the row may be deleted, but other objects in the row may not be modified. A row will be deleted automatically by the agent once the operation has completed. Creating a row will cause the subtree retrieval operation to commence. If the agent allows aborting operations in progress, deleting a row will cause the operation to halt." ::= { getSubtreeEntry 6 } -- traps getSubtreeTrapPrefix OBJECT IDENTIFIER ::= { getSubtreeTraps 0 } getSubtreeResponse NOTIFICATION-TYPE OBJECTS { getSubtreeSequenceNumber, getSubtreeDone } STATUS current DESCRIPTION "In addition to the two objects above, this trap also contains a series of varbinds containing the next chunk of the subtree. The generating entity will append, in order, as many variables to the variable-bindings field as it can without exceeding the maximum message size, and without going beyond the subtree of OIDs requested. A series of such traps will be generated until the end of the subtree is reached." ::= { getSubtreeTrapPrefix 1 } -- conformance information getSubtreeMIBConformance OBJECT IDENTIFIER ::= { getSubtreeMIB 2 } getSubtreeMIBCompliances OBJECT IDENTIFIER ::= { getSubtreeMIBConformance 1 } getSubtreeMIBGroups OBJECT IDENTIFIER ::= { getSubtreeMIBConformance 2 } -- compliance statements getSubtreeMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for the GetSubtree MIB." MODULE -- this module MANDATORY-GROUPS { getSubtreeObjectGroup, getSubtreeNotificationGroup } ::= { getSubtreeMIBCompliances 1 } -- units of conformance getSubtreeObjectGroup OBJECT-GROUP OBJECTS { getSubtreeTargetAddrName, getSubtreeRootOid, getSubtreeSequenceNumber, getSubtreeDone, getSubtreeStatus } STATUS current DESCRIPTION "A collection of objects to support requests for subtree retrieval operations." ::= { getSubtreeMIBGroups 1 } getSubtreeNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { getSubtreeResponse } STATUS current DESCRIPTION "The notification which an entity is required to implement." ::= { getSubtreeMIBGroups 2 } END -- -- Copyright (C) The Internet Society (1999). All Rights Reserved. -- -- This document and translations of it may be copied and furnished -- to others, and derivative works that comment on or otherwise -- explain it or assist in its implmentation may be prepared, copied, -- published and distributed, in whole or in part, without -- restriction of any kind, provided that the above copyright notice -- and this paragraph are included on all such copies and derivative -- works. However, this document itself may not be modified in any -- way, such as by removing the copyright notice or references to the -- Internet Society or other Internet organizations, except as needed -- for the purpose of developing Internet standards in which case the -- procedures for copyrights defined in the Internet Standards -- process must be followed, or as required to translate it into -- languages other than English. -- -- The limited permissions granted above are perpetual and will not -- be revoked by the Internet Society or its successors or assigns. -- -- This document and the information contained herein is provided on -- an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET -- ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR -- IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF -- THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED -- WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.