-- extracted from draft-ietf-snmpconf-bcp-03.txt -- at Tue Dec 5 10:05:26 2000 ACME-HOUSECTL-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-IDENTITY, Counter32, Gauge32, OBJECT-TYPE, TimeTicks, Integer32, NOTIFICATION-TYPE FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF TruthValue, TEXTUAL-CONVENTION, TimeStamp FROM SNMPv2-TC SnmpAdminString FROM SNMP-FRAMEWORK-MIB; acmeHouseCtlMIB MODULE-IDENTITY LAST-UPDATED "200007090000Z" ORGANIZATION "Acme, Inc" CONTACT-INFO "Acme, Inc 1 Main Street Anytown, Anywhere" DESCRIPTION "This mib module defines a sample mib module that contains status/inventory, configuration and diagnostic management objects for items in a single family home." REVISION "200007090000Z" DESCRIPTION "Initial version of ACME-HOUSECTRL-MIB." ::= { XXX 55 } -- -- Textual Conventions -- AcmeCfgVersion ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "A value that starts at 0 and increases monotonically until the Max value is reached at which point the value returns to 0." SYNTAX Gauge32 AcmeDeviceAdminStatus ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The operational state of a device. Setting a device to testing invokes diagnostic routines which may or may not bring a device out of service." SYNTAX INTEGER { up(1), down(2), testing(3) } AcmeDeviceOperStatus ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The current general state of the device. A failed state indicates the device is not responding to management control" SYNTAX INTEGER { up(1), down(2), testing(3), failed(4) } -- -- Top level delegations -- acmeHouseInventory OBJECT-IDENTITY STATUS current DESCRIPTION "Inventory of the controls in the home over which operations can be made." ::= { acmeHouseCtlMIB 1 } acmeHouseGlobals OBJECT-IDENTITY STATUS current DESCRIPTION "Objects of global scope over a given home." ::= { acmeHouseCtlMIB 2 } acmeHouseConfig OBJECT-IDENTITY STATUS current DESCRIPTION "Configuration of devices managed by this MIB or subsidiary MIB modules." ::= { acmeHouseCtlMIB 3 } acmeHouseCtlExceptions OBJECT-IDENTITY STATUS current DESCRIPTION "Exceptions of global scope to this mib defined here." ::= { acmeHouseCtlMIB 9 } acmeHouseCtlConformance OBJECT-IDENTITY STATUS current DESCRIPTION "Conformance details kept here for this MIB." ::= { acmeHouseCtlMIB 10 } -- -- Inventory Group -- acmeHouseInvenLastUpdated OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "Timestamp when inventory report was last updated. A value of zero indicates never." ::= { acmeHouseInventory 1 } acmeHouseInvenNumber OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of rows in acmeHouseInvenTable." ::= { acmeHouseInventory 2 } acmeHouseInvenTable OBJECT-TYPE SYNTAX SEQUENCE OF AcmeHouseInvenEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table presents a list of devices found in a given home. Rows are added and deleted by the agent as discovered." ::= { acmeHouseInventory 3 } acmeHouseInvenEntry OBJECT-TYPE SYNTAX AcmeHouseInvenEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each row represents a particular device managed by this agent." INDEX { acmeHouseInvenId } ::= { acmeHouseInvenTable 1 } AcmeHouseInvenEntry ::= SEQUENCE { acmeHouseInvenId SnmpAdminString, acmeHouseInvenDevice OBJECT IDENTIFIER, acmeHouseInvenKey Integer32, acmeHouseInvenAdminStatus AcmeDeviceAdminStatus, acmeHouseInvenOperStatus AcmeDeviceOperStatus, acmeHouseInvenLastContact TimeStamp } acmeHouseInvenId OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS not-accessible STATUS current DESCRIPTION "A persistent identifier that identifies a device uniquely within a single domain." ::= { acmeHouseInvenEntry 1 } acmeHouseInvenDevice OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-only STATUS current DESCRIPTION "The object identifier that uniquely identifies the type of device. A registration mib maintains the mappings to text. A vaue of 0.0 represents an unknown or unmanageable device." ::= { acmeHouseInvenEntry 2 } acmeHouseInvenKey OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "A unique value within a given set of device with the same acmeHouseInvenDevice object identifier. Can be used for a short-hand indexing to other tables and notifications." ::= { acmeHouseInvenEntry 3 } acmeHouseInvenAdminStatus OBJECT-TYPE SYNTAX AcmeDeviceAdminStatus MAX-ACCESS read-write STATUS current DESCRIPTION "The desired administrative status of this device. Setting the value to down(2) has the effect of changing acmeHouseInvenOperStatus to down(2) as well." ::= { acmeHouseInvenEntry 4 } acmeHouseInvenOperStatus OBJECT-TYPE SYNTAX AcmeDeviceOperStatus MAX-ACCESS read-only STATUS current DESCRIPTION "The curent operational state of the device." ::= { acmeHouseInvenEntry 5 } acmeHouseInvenLastContact OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime when the device last responded to any management request or last poll." ::= { acmeHouseInvenEntry 6 } -- -- Configuration Globals Group -- acmeHouseGlobalSysActive OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "State of house control system. A value of true(1) represents the system is actively monitoring state and will accept valid configuration requests. A value of false(2) indicates this the master system is not maintaining state of systems found in the inventory component." ::= { acmeHouseGlobals 1 } acmeSysActiveLastChanged OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "sysUpTime when acmeHouseGlobalSysActive last changed state." ::= { acmeHouseGlobals 2 } acmeSysActiveConfigId OBJECT-TYPE SYNTAX AcmeCfgVersion MAX-ACCESS read-only STATUS current DESCRIPTION "Current value of configuration information. This value remains persistent across reboots and increases when configuration changes are made to any object in this MIB." ::= { acmeHouseGlobals 3 } acmeSysDevicesActive OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of active devices in the system according to last poll." ::= { acmeHouseGlobals 4 } acmeSysDevicesLastFailed OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "sysUpTime when last device failed poll or admin request." ::= { acmeHouseGlobals 5 } acmeSysDeviceErrors OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of devices that this manager lost contact, timed out with." ::= { acmeHouseGlobals 6 } acmeSysDeviceLastErr OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "A description of the last error that occured in this mib due to configuration errors or status error presentable to user interface." ::= { acmeHouseGlobals 7 } -- -- Notification Section -- acmeHouseCtlGlobalErrs OBJECT IDENTIFIER ::= { acmeHouseCtlExceptions 0 } acmeHouseCtlDeviceLost NOTIFICATION-TYPE OBJECTS { acmeHouseInvenDevice, acmeHouseInvenKey, acmeHouseInvenAdminStatus, acmeHouseInvenOperStatus} STATUS current DESCRIPTION "This notification is generated whenever the invocation of a scheduled action fails. If there is a failure of many devices such that sending single notifications would be resource and time prohibitive, send the acmeHouseCtrlManyDevicesLost notification." ::= { acmeHouseCtlGlobalErrs 1 } acmeHouseCtlManyDevicesLost NOTIFICATION-TYPE OBJECTS { acmeSysDevicesLastFailed, acmeSysDeviceErrors } STATUS current DESCRIPTION "This notification is generated whenever the invocation of a scheduled action fails. If there is a failure of many devices such that sending single notifications would be resource and time prohibitive, send the acmeHouseCtrlManyDevicesLost notification." ::= { acmeHouseCtlGlobalErrs 2 } -- -- Compliance Section -- acmeHouseCtlGroups OBJECT IDENTIFIER ::= { acmeHouseCtlConformance 1 } acmeHouseCtlCompliances OBJECT IDENTIFIER ::= { acmeHouseCtlConformance 2 } acmeHouseInventoryGroup OBJECT-GROUP OBJECTS { acmeHouseInvenLastUpdated, acmeHouseInvenNumber, acmeHouseInvenDevice, acmeHouseInvenKey, acmeHouseInvenAdminStatus, acmeHouseInvenOperStatus, acmeHouseInvenLastContact } STATUS current DESCRIPTION "A collection of objects providing inventory and general status of all home objects controlled by this MIB module." ::= { acmeHouseCtlGroups 1 } acmeHouseGlobalsGroup OBJECT-GROUP OBJECTS { acmeHouseGlobalSysActive, acmeSysActiveLastChanged, acmeSysActiveConfigId, acmeSysDevicesActive, acmeSysDevicesLastFailed, acmeSysDeviceErrors, acmeSysDeviceLastErr } STATUS current DESCRIPTION "A collection of objects providing overall feature configuration state status." ::= { acmeHouseCtlGroups 2 } acmeHouseCtlNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { acmeHouseCtlDeviceLost, acmeHouseCtlManyDevicesLost } STATUS current DESCRIPTION "The notifications used by this MIB module to denote exceptional conditions." ::= { acmeHouseCtlGroups 3 } acmeHouseCtrlMibCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The set of groups that make up the mandatory and optional groups required for MIB module implementation." MODULE MANDATORY-GROUPS { acmeHouseInventoryGroup, acmeHouseGlobalsGroup } ::= { acmeHouseCtlCompliances 1 } END -- -- -- -- Copyright (C) The Internet Society (2000). 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 implementation 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.