Chassis MIB Proposal

[{3COM/PDD/PeteW}@pdd.3mail.3com.com]

FROM: Wilson, Peter

TO:  {[e-mail]}:ugate:3com                       DATE:  01-04-94
                                                              TIME:  09:39
CC:
SUBJECT:  Chassis MIB Proposal
PRIORITY:
ATTACHMENTS:

------------------------------------------------------------------------------
chasEntityViewTable  OBJECT-TYPE
    SYNTAX      SEQUENCE OF ChasEntityViewEntry
    ACCESS      not-accessible
    STATUS      mandatory
    DESCRIPTION
        "A table of all MIB views orgainized by entity.
         Each entity may have a number of MIB views
         associated with it."
    ::= { chasEntity 2 }

chasEntityViewEntry  OBJECT-TYPE
    SYNTAX      ChasEntityViewEntry
    ACCESS      not-accessible
    STATUS      mandatory
    DESCRIPTION
            "Defines a specific MIB view."
    INDEX { chasEntityViewEntityId, chasEntityViewIndex }

ChasEntityViewEntry  ::= SEQUENCE {
    chasEntityViewEntityId        INTEGER,
    chasEntityViewIndex           INTEGER,
    chasEntityTDomain             OBJECT IDENTIFIER,
    chasEntityTAddress            OCTET STRING,
    chasEntityCommunity           DisplayString,
    chasEntityContext             Context
}

chasEntityViewEntityId  OBJECT-TYPE
    SYNTAX  INTEGER (1..65535)
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "The unique entity for which this MIB view is
         defined.  This is an instance of chasEntityIndex
         within the chasEntityTable."
    ::= { chasEntityViewEntry 1 }

chasEntityViewIndex  OBJECT-TYPE
    SYNTAX  INTEGER (1..127)
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "Distinguishes this view of the entity from other
         possible views."
    ::= { chasEntityViewEntry 2 }

chasEntityTDomain OBJECT-TYPE
    SYNTAX  OBJECT-IDENTIFIER
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "This object identifies the protocol by which the view of the
         entity identified by this row in the table may be accessed. Note
         that different views of the same entity may be visible via different
         transport protocols. That is some bilingual stacks could include
         views visible via SNMPv1 over IP and also by SNMPv1 over IPX."
    ::= { chasEntityViewEntry 3}

chasEntityTAddress OBJECT-TYPE
    SYNTAX  TAddress
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "The transport service address by which the entity identified by
         this row of in the table may be accessed. The format of the
         address is determined by the value of chasEntityTAddress."
    ::= { chasEntityViewEntry 4}

chasEntityCommunity  OBJECT-TYPE
    SYNTAX  OCTET STRING (SIZE (0..255))
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "The SNMPv1 Community which is used to access, via the
         transport domain identified by chasEntityTDomain and
         chasEntityTAddress, the view of the entity identified
         by this row in the this table.

         If the view of the entity identified by this table row
         is not accessed by SNMPv1 then the value of this object for this
         row will be the zero length string.

         Note that it is possible to have seperate views of the same device
         accessed via different protocols. This is possible particular until
         SNMPv2 becomes established and is potentially true of bilingual
         agents."
    ::= { chasEntityEntry 5 }

chasEntityContext    OBJECT-TYPE
    SYNTAX  Context
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "The SNMPv1 Context which is used to access, via the
         transport identified by chasEntityTDomain and
         chasEntityTAddress, the view of the entity identified
         by this row in the this table.

         If the view of the entity identified by this table row
         is not accessed by SNMPv2 then the value of this object
         for this row will be the NULL OID {0 0}.

         Note that it is possible to have seperate views of the same entity
         accessed via different protocols. This is possible particular until
         SNMPv2 becomes established and is potentially true of bilingual
         agents."
    ::= { chasEntityEntry 6 }

-- The chasResource group.
-- This defines a mapping of physical relationship (modules/resources)

-- and a logical mapping of resource to entities.

-- Implementation of the resource group is mandatory.

-- Each physical module contains a number of logical
-- resource. Each resource is a building
-- block for constructing functional entities. This
-- table contains an entry for each resource in the
-- chassis, the type of entity this resource can
-- belong to and the current entity to which this
-- resource is assigned."

-- NOTE. In this model a resource resides on a module and is
-- entirely located on that module. This means there is a one to
-- one correspondance of resource to module.

-- NOTE. In this model a resource belongs to exactly ONE resource
-- at any particluar time. This means that there is always a
-- one to one correspondance of resource to entity.

chasPhyResourceTable  OBJET-TYPE
    SYNTAX  SEQUENCE of ChasPhyResourceEntry
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "This table contains one entry per resource in a particular
         chassis configuration. The table identifies each resource
         by its physical location within the chassis. In this way the
         table provides a direct mapping from resource to module.

         The table contains columns which identify the entity to which
         each resource is currently assigned, if any and so an indirect
         mapping is provided from resource to entity.

         If a particular chassis allows the software, or management
         configuration of resources to entities then this table controls
         that assignment by allowing the chasPhyResAssignment to be
         writable."
    ::= { chasResource 1 }

chasPhyResourceEntry  OBJECT-TYPE
    SYNTAX  ChasPhyResourceEntry
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
            "Defines a particular physical configuration relationship."
    INDEX { chasPhyResLocationType,
            chasPhyResLocation,
            chasPhyResIndex }
    ::= { chasResourceTable 1 }

ChasPhyResourceEntry ::= SEQUENCE {
    chasPhyResLocationType        INTEGER,
    chasPhyResLocation            INTEGER,
    chasPhyResIndex               INTEGER,
    chasPhyResType                OBJECT IDENTIFIER,
    chasPhyResEntityType          OBJECT IDENTIFIER,
    chasPhyResAssignment          INTEGER,
    chasPhyResEntitySubIndex      INTEGER
    }

chasPhyResLocationType  OBJECT-TYPE
    SYNTAX  INTEGER
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "A resource exists on a particular module.  A
         module is identified by it's physical location.
         Physical location is defined location type and an
         instance of that physical location type.  This
         object defines the location type.  This object can
         be used in conjunction with chasPhyResLocation to
         index the module table."
    ::= { chasPhyResourceEntry 1 }

chasPhyResLocation  OBJECT-TYPE
    SYNTAX  INTEGER
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
        "A resource exists on a particular module.  A
         module is identified by it's physical location.
         Physical location is defined location type and an
         instance of that physical location type.  This
         object defines a particular instance of the
         physical location."
    ::= { chasPhyResourceEntry 2 }

chasPhyResIndex  OBJECT-TYPE
    SYNTAX  INTEGER
    ACCESS  read-only
    STATUS  mandatory
    DESCRIPTION
            "A unique index for the chassis resource on this
            particular physical module."
    ::= { chasPhyResourceEntry 3 }

chasPhyResType OBJECT-TYPE
    SYNTAX OBJECT IDENTIFIER
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The type of resource. A number of values for this
         object are defined at the start of this MIB module
         under the chasResTypes branch. Other values may be
         defined for specific enterprises."
    ::= { chasPhyResourceEntry 4 }

chasPhyResEntityType OBJECT-TYPE
    SYNTAX OBJECT IDENTIFIER
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The value of this object identifies the type of entity to which this
         resource may be assigned. Suitable values are defined at the start of
         this MIB module under the chasEntityTypes branch.

         This object is provided so that an intelligent management application
         can provide a list of suitable existing entites to which this
         resource may be assigned. For assigment to be successful, the
         value of this object must match the value of chasEntityObjectId
         in the chasEntityTable for the entity to which the resource is
         to be assigned."
    ::= { chasPhyResourceEntry 5 }

chasPhyResAssignment OBJECT-TYPE
    SYNTAX  INTEGER
    access  read-write
    STATUS  mandatory
    DESCRIPTION
        "Each resource may be 'assigned' to an existing entity. The
         value of this object identifies the entity to which this object
         is currently assigned. If the resource identified by a
         particular row in this table is not currently assigned to
         an entity then the value of this object for that row will be