-- extracted from draft-ietf-disman-conditionmib-01.txt -- at Thu Nov 22 06:07:18 2001 ARC-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Unsigned32 FROM SNMPv2-SMI ConditionType FROM COND-MIB MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF arcMIB MODULE-IDENTITY LAST-UPDATED "200111150000Z" ORGANIZATION " " CONTACT-INFO "Kam Lam Lucent Technologies E-mail: hklam@lucent.com." DESCRIPTION "The MIB module describes the objects for controlling a resource in reporting an condition that it detectes. Alarm Report Control is a feature that provides an automatic in-service provisioning capability. Alarm reporting is turned off on a per-resource basis for a selective set of alarm types (i.e., potential alarm conditions) to allow sufficient time for customer testing and other maintenance activities in an "alarm free" state. Once a resource is ready for service , alarm reporting is automatically (or manually) turned on. There are four ARC states:ALM, NALM, NALM-QI, or NALMTI ALM may transition to NALM, NALM-QI, or NAML-TI by management request. NALM may transition to ALM, NALM-QI, or NAML-TI by management request. NALM-QI may transition to NALM or ALM by management request. NALM-QI may transition to ALM automatically if qualified problem-free (if NALM-QI-CD is not supported) or if the CD timer expired (if NALM-QI-CD is supported) NALM-TI may transition to ALM or NALM by management request. NALM-TI may transition to ALM automatically if the TI timer expired. Further details of ARC state transitions are defined in Figure 3 of M.3100 Amd3." REVISION "200111150000Z" DESCRIPTION "The initial version." ::={ mib-2 yy} ------------------ -- MIB Objects ------------------ arcMIBTimeIntervals OBJECT IDENTIFIER ::= { arcMIB 1 } arcMIBObjects OBJECT IDENTIFIER ::= { arcMIB 2 } arcMIBTITimeInterval OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "This variable indicates the time interval used for the nalmTI state, in units of second. It is a pre-defined length of time in which the resource will stay in the NALM-TI state before transition into the ALM state. " ::= { arcMIBTimeIntervals 1 } arcMIBCDTimeInterval OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "This variable indicates the time interval used for the nalmQICD state, in units of second. It is a pre-defined length of time in which the resource will stay in the NALM-QI-CD state before transition into the ALM state after it is problem-free." ::= { arcMIBTimeIntervals 2 } arcTable OBJECT-TYPE SYNTAX SEQUENCE OF ArcEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of arc settings on the system." ::= { arcMIBObjects 1 } arcEntry OBJECT-TYPE SYNTAX ArcEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A conceptual row that contains information about the ARC setting of a resource in the system." INDEX { arcIndex, arcAlarmType } ::= { arcTable 1 } ArcEntry ::= SEQUENCE { arcIndex OBJECT IDENTIFIER, arcAlarmType ConditionType, arcState INTEGER, arcNalmTimeRemaining Unsigned32 } arcIndex OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS not-accessible STATUS current DESCRIPTION "This object uniquely identifies a resource, which is under the arcState's control for the associated arcAlarmType." ::= { arcEntry 1 } arcAlarmType OBJECT-TYPE SYNTAX ConditionType MAX-ACCESS read-create STATUS current DESCRIPTION "This object identifies the alarm type controled by the arcState. Only one alarm type is identified for each entry." ::= { arcEntry 2 } arcState OBJECT-TYPE SYNTAX INTEGER { alm (1), nalm (2), nalmQI (3), nalmTI (4), nalmQICD (5) } MAX-ACCESS read-write STATUS current DESCRIPTION "The object controls the alarm report of a resource. A manager can set the arcState to either alm, nalm, nalmQI, or nalmTI. ALM: Alarm reporting is turned on (i.e., is allowed). NALM: Alarm reporting is turned off. NALM-TI: Alarm reporting is turned off for a time interval. (TI - Time Inhibit). NALM-QI: Alarm reporting is turned off for a selected set of alarm types until the resource is qualified problem-free for a specified persistence interval. Problem-free means that none of the conditions corresponding to the selected alarm types exist. (QI - Qualified Inhibit). NALM-QI-CD: This is a substate of NALM-QI and performs the persistence timing count down function after the resource is qualified problem-free. (CD - Count Down). According to the requirements in M.3100 Amendement3, a resource supporting the ARC feature shall support the ALM state and at least one of the NALM, NALM-TI, and NALM-QI states. NALM-QI-CD is an optional substate of NALM-QI. Once the resource enters the alm state for the specified alarm type, the corresponding entry will be deleted from the arc table. The manual setting of the arcState to alm has the effect of removing the entry from the arc table. The value of nalamQICD is a transitional state from nalmQI to alm. It is optional depending on the type and the implementation of the resource. If it is supported, before the state is transitioned from nalmQI to alm, a count down period is activated for a duration set by the object arcNalmCDTimeInterval. When the time is up, the arcState is set to alm." ::= { arcEntry 3 } arcNalmTimeRemaining OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "This variable indicates the time remaining in the NALM-TI interval or the NALM-QI-CD interval, in units of second. At the moment the resource enters the NALM-TI state, this variable will have the initial value equal to the value of arcNalmTITimeInterval and then starts decrementing as time goes by. Similarly at the moment the resource enters the NALM-QI-CD state, this variable will have the initial value equal to the value of arcNalmCDTimeInterval and then starts decrementing as time goes by. This variable is read-write and thus will allow the manager to extend or shorten the remaining time when the resource is in the NALM-TI or NALM-QI-CD state as needed. If this variable is supported and the resource is currently not in the NALM-TI nor NAML-QI-CD state, the value of this variable shall equal to zero." ::= { arcEntry 4 } -------------------------- -- conformance information -------------------------- arcConformance OBJECT IDENTIFIER ::= { arcMIB 3 } arcCompliances OBJECT IDENTIFIER ::= { arcConformance 1 } arcCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for systems supporting the ARC MIB." MODULE -- this module MANDATORY-GROUPS { arcSettingGroup } ::= { arcCompliances 1 } arcGroups OBJECT IDENTIFIER ::= { arcConformance 2 } arcSettingGroup OBJECT-GROUP OBJECTS { arcIndex, arcAlarmType } STATUS current DESCRIPTION "ARC Setting group." ::= { arcGroups 1} arcTIGroup OBJECT-GROUP OBJECTS { arcMIBTITimeInterval, arcNalmTimeRemaining } STATUS current DESCRIPTION "ARC Time Inhibit group." ::= { arcGroups 2} arcQICDGroup OBJECT-GROUP OBJECTS { arcMIBCDTimeInterval, arcNalmTimeRemaining } STATUS current DESCRIPTION "ARC Quality Inhibit (QI) Count Down (CD) group." ::= { arcGroups 3} END