ENTITY-STATE-MIB DEFINITIONS ::= BEGIN

  IMPORTS

      MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, mib-2

          FROM SNMPv2-SMI

      DateAndTime

          FROM SNMPv2-TC

      MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP

           FROM SNMPv2-CONF

      entPhysicalIndex

           FROM ENTITY-MIB

      EntityAdminState, EntityOperState, EntityUsageState,

      EntityAlarmStatus, EntityStandbyStatus

           FROM ENTITY-STATE-TC-MIB;

  entityStateMIB MODULE-IDENTITY

      LAST-UPDATED "200511220000Z"

      ORGANIZATION "IETF Entity MIB Working Group"

      CONTACT-INFO

              " General Discussion: entmib@ietf.org

                To Subscribe:

                http://www.ietf.org/mailman/listinfo/entmib

                http://www.ietf.org/html.charters/entmib-charter.html

                Sharon Chisholm

                Nortel Networks

                PO Box 3511 Station C

                Ottawa, Ont.  K1Y 4H7

                Canada

                schishol@nortel.com

                David T. Perkins

                548 Qualbrook Ct

                San Jose, CA 95110

                USA

                Phone: 408 394-8702

                dperkins@snmpinfo.com

               "

      DESCRIPTION

          "This MIB defines a state extension to the Entity MIB.

           Copyright (C) The Internet Society 2005.  This version

           of this MIB module is part of RFC 4268; see the RFC

           itself for full legal notices."

      REVISION    "200511220000Z"

      DESCRIPTION

          "Initial version, published as RFC 4268."

      ::= { mib-2 131 }

  -- Entity State Objects

  entStateObjects OBJECT IDENTIFIER ::= { entityStateMIB 1 }

  entStateTable OBJECT-TYPE

   SYNTAX      SEQUENCE OF EntStateEntry

   MAX-ACCESS  not-accessible

   STATUS      current

   DESCRIPTION

       "A table of information about state/status of entities.

        This is a sparse augment of the entPhysicalTable.  Entries

        appear in this table for values of

        entPhysicalClass [RFC4133] that in this implementation

        are able to report any of the state or status stored in

        this table.

        "

   ::= { entStateObjects 1 }

    entStateEntry OBJECT-TYPE

       SYNTAX      EntStateEntry

       MAX-ACCESS  not-accessible

       STATUS      current

       DESCRIPTION

           "State information about this physical entity."

       INDEX       { entPhysicalIndex }

       ::= { entStateTable 1 }

    EntStateEntry ::= SEQUENCE {

        entStateLastChanged DateAndTime,

        entStateAdmin       EntityAdminState,

        entStateOper        EntityOperState,

        entStateUsage       EntityUsageState,

        entStateAlarm       EntityAlarmStatus,

        entStateStandby     EntityStandbyStatus

       }

  entStateLastChanged OBJECT-TYPE

   SYNTAX      DateAndTime

   MAX-ACCESS  read-only

   STATUS      current

   DESCRIPTION

     "The value of this object is the date and

      time when the value of any of entStateAdmin,

      entStateOper, entStateUsage, entStateAlarm,

      or entStateStandby changed for this entity.

      If there has been no change since

      the last re-initialization of the local system,

      this object contains the date and time of

      local system initialization.  If there has been

      no change since the entity was added to the

      local system, this object contains the date and

      time of the insertion."

   ::= { entStateEntry 1 }

entStateAdmin OBJECT-TYPE

       SYNTAX      EntityAdminState

       MAX-ACCESS  read-write

       STATUS      current

       DESCRIPTION

            "The administrative state for this entity.

             This object refers to an entities administrative

             permission to service both other entities within

             its containment hierarchy as well other users of

             its services defined by means outside the scope

             of this MIB.

             Setting this object to 'notSupported' will result

             in an 'inconsistentValue' error.  For entities that

             do not support administrative state, all set

             operations will result in an 'inconsistentValue'

             error.

             Some physical entities exhibit only a subset of the

             remaining administrative state values.  Some entities

             cannot be locked, and hence this object exhibits only

             the 'unlocked' state.  Other entities cannot be shutdown

             gracefully, and hence this object does not exhibit the

             'shuttingDown' state.  A value of 'inconsistentValue'

             will be returned if attempts are made to set this

             object to values not supported by its administrative

             model."

       ::= { entStateEntry 2 }

 entStateOper OBJECT-TYPE

       SYNTAX      EntityOperState

       MAX-ACCESS  read-only

       STATUS      current

       DESCRIPTION

           "The operational state for this entity.

            Note that unlike the state model used within the

            Interfaces MIB [RFC2863], this object does not follow

            the administrative state.  An administrative state of

            down does not predict an operational state

            of disabled.

            A value of 'testing' means that entity currently being

            tested and cannot therefore report whether it is

            operational or not.

            A value of 'disabled' means that an entity is totally

            inoperable and unable to provide service both to entities

            within its containment hierarchy, or to other receivers

            of its service as defined in ways outside the scope of

            this MIB.

            A value of 'enabled' means that an entity is fully or

            partially operable and able to provide service both to

            entities within its containment hierarchy, or to other

            receivers of its service as defined in ways outside the

            scope of this MIB.

            Note that some implementations may not be able to

            accurately report entStateOper while the

            entStateAdmin object has a value other than 'unlocked'.

            In these cases, this object MUST have a value

            of 'unknown'."

       ::= { entStateEntry 3 }

 entStateUsage OBJECT-TYPE

       SYNTAX      EntityUsageState

       MAX-ACCESS  read-only

       STATUS      current

       DESCRIPTION

           "The usage state for this entity.

            This object refers to an entity's ability to service more

            physical entities in a containment hierarchy.  A value

            of 'idle' means this entity is able to contain other

            entities but that no other entity is currently

            contained within this entity.

            A value of 'active' means that at least one entity is

            contained within this entity, but that it could handle

            more.  A value of 'busy' means that the entity is unable

            to handle any additional entities being contained in it.

            Some entities will exhibit only a subset of the

            usage state values.  Entities that are unable to ever

            service any entities within a containment hierarchy will

            always have a usage state of 'busy'.  Some entities will

            only ever be able to support one entity within its

            containment hierarchy and will therefore only exhibit

            values of 'idle' and 'busy'."

          ::= { entStateEntry 4 }

 entStateAlarm OBJECT-TYPE

       SYNTAX      EntityAlarmStatus

       MAX-ACCESS  read-only

       STATUS      current

       DESCRIPTION

           "The alarm status for this entity.  It does not include

            the alarms raised on child components within its

            containment hierarchy.

            A value of 'unknown' means that this entity is

            unable to report alarm state.  Note that this differs

            from 'indeterminate', which means that alarm state

            is supported and there are alarms against this entity,

            but the severity of some of the alarms is not known.

            If no bits are set, then this entity supports reporting

            of alarms, but there are currently no active alarms

            against this entity."

       ::= { entStateEntry 5 }

entStateStandby OBJECT-TYPE

       SYNTAX EntityStandbyStatus

       MAX-ACCESS read-only

       STATUS current

       DESCRIPTION

            "The standby status for this entity.

            Some entities will exhibit only a subset of the

            remaining standby state values.  If this entity

            cannot operate in a standby role, the value of this

            object will always be 'providingService'."

  ::= { entStateEntry 6 }

-- Notifications

 entStateNotifications OBJECT IDENTIFIER ::= { entityStateMIB 0 }

entStateOperEnabled NOTIFICATION-TYPE

   OBJECTS { entStateAdmin,

             entStateAlarm

           }

   STATUS             current

   DESCRIPTION

           "An entStateOperEnabled notification signifies that the

            SNMP entity, acting in an agent role, has detected that

            the entStateOper object for one of its entities has

            transitioned into the 'enabled' state.

            The entity this notification refers can be identified by

            extracting the entPhysicalIndex from one of the

            variable bindings.  The entStateAdmin and entStateAlarm

            varbinds may be examined to find out additional

            information on the administrative state at the time of

            the operation state change as well as to find out whether

            there were any known alarms against the entity at that

            time that may explain why the physical entity has become

            operationally disabled."

  ::= { entStateNotifications 1 }

entStateOperDisabled NOTIFICATION-TYPE

   OBJECTS { entStateAdmin,

             entStateAlarm }

   STATUS             current

   DESCRIPTION

           "An entStateOperDisabled notification signifies that the

            SNMP entity, acting in an agent role, has detected that

            the entStateOper object for one of its entities has

            transitioned into the 'disabled' state.

            The entity this notification refers can be identified by

            extracting the entPhysicalIndex from one of the

            variable bindings.  The entStateAdmin and entStateAlarm

            varbinds may be examined to find out additional

            information on the administrative state at the time of

            the operation state change as well as to find out whether

            there were any known alarms against the entity at that

            time that may affect the physical entity's

            ability to stay operationally enabled."

  ::= { entStateNotifications 2 }

-- Conformance and Compliance

entStateConformance OBJECT IDENTIFIER ::= { entityStateMIB 2 }

entStateCompliances OBJECT IDENTIFIER

                  ::= { entStateConformance 1 }

entStateCompliance MODULE-COMPLIANCE

      STATUS  current

      DESCRIPTION

          "The compliance statement for systems supporting

          the Entity State MIB."

      MODULE -- this module

          MANDATORY-GROUPS {

           entStateGroup

          }

      GROUP       entStateNotificationsGroup

         DESCRIPTION

             "This group is optional."

      OBJECT entStateAdmin

       MIN-ACCESS  read-only

       DESCRIPTION

           "Write access is not required."

   ::= { entStateCompliances 1 }

entStateGroups OBJECT IDENTIFIER ::= { entStateConformance 2 }

entStateGroup OBJECT-GROUP

   OBJECTS {

           entStateLastChanged,

           entStateAdmin,

           entStateOper,

           entStateUsage,

           entStateAlarm,

           entStateStandby

           }

    STATUS   current

    DESCRIPTION

         "Standard Entity State group."

    ::= { entStateGroups 1}

entStateNotificationsGroup NOTIFICATION-GROUP

   NOTIFICATIONS {

           entStateOperEnabled,

           entStateOperDisabled

           }

    STATUS   current

    DESCRIPTION

         "Standard Entity State Notification group."

    ::= { entStateGroups 2}

END