Connected: An Internet Encyclopedia
RFC 1902 - 7.11. Usage Example

Top: Connected: An Internet Encyclopedia
Up: Requests For Comments
Up: RFC 1902
Up: 7. Mapping of the OBJECT-TYPE macro
Prev: 7.10. Mapping of the OBJECT-TYPE value
Next: 8. Mapping of the NOTIFICATION-TYPE macro

### 7.11. Usage Example

Consider how one might define a conceptual table and its subordinates. (This example uses the RowStatus textual convention defined in [3].)

    evalSlot OBJECT-TYPE
        SYNTAX      INTEGER
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
                "The index number of the first unassigned entry in the
                evaluation table.

                A management station should create new entries in the
                evaluation table using this algorithm:  first, issue a
                management protocol retrieval operation to determine the
                value of evalSlot; and, second, issue a management protocol
                set operation to create an instance of the evalStatus object
                setting its value to createAndGo(4) or createAndWait(5).  If
                this latter operation succeeds, then the management station
                may continue modifying the instances corresponding to the
                newly created conceptual row, without fear of collision with
                other management stations."
        ::= { eval 1 }

    evalTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF EvalEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
                "The (conceptual) evaluation table."
        ::= { eval 2 }

    evalEntry OBJECT-TYPE
        SYNTAX      EvalEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
                "An entry (conceptual row) in the evaluation table."
        INDEX   { evalIndex }
        ::= { evalTable 1 }

    EvalEntry ::=
        SEQUENCE {
            evalIndex       Integer32,
            evalString      DisplayString,
            evalValue       Integer32,
            evalStatus      RowStatus
        }

    evalIndex OBJECT-TYPE
        SYNTAX      Integer32
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
                "The auxiliary variable used for identifying instances of
                the columnar objects in the evaluation table."
            ::= { evalEntry 1 }

    evalString OBJECT-TYPE
        SYNTAX      DisplayString
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
                "The string to evaluate."
            ::= { evalEntry 2 }

    evalValue OBJECT-TYPE
        SYNTAX      Integer32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
                "The value when evalString was last executed."
        DEFVAL  { 0 }
            ::= { evalEntry 3 }

    evalStatus OBJECT-TYPE
        SYNTAX      RowStatus
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
                "The status column used for creating, modifying, and
                deleting instances of the columnar objects in the evaluation
                table."
        DEFVAL  { active }
            ::= { evalEntry 4 }

Next: 8. Mapping of the NOTIFICATION-TYPE macro

Connected: An Internet Encyclopedia
RFC 1902 - 7.11. Usage Example