-- extracted from draft-ietf-ipcdn-docsisevent-mib-01.txt -- at Sat Mar 3 06:04:38 2001 DOCS-CABLE-DEVICE-TRAP-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, NOTIFICATION-TYPE FROM SNMPv2-SMI MODULE-COMPLIANCE, NOTIFICATION-GROUP FROM SNMPv2-CONF docsDev, -- docsDevBase, docsDevEvLevel, docsDevEvId, docsDevEvText, docsDevSwFilename, docsDevSwServer, docsDevServerDhcp, docsDevServerTime, docsDevNotification FROM DOCS-CABLE-DEVICE-MIB -- RFC2669 docsIfCmCmtsAddress, docsIfCmtsCmStatusMacAddress FROM DOCS-IF-MIB -- RFC2670 docsIfDocsisCapability, docsIfDocsisOperMode, docsIfCmtsCmStatusDocsisMode FROM DOCS-IF-EXT-MIB ifPhysAddress FROM IF-MIB; docsDevTrapMIB MODULE-IDENTITY LAST-UPDATED "0101160000Z" -- January 16, 2001 ORGANIZATION "IETF IPCDN Working Group" CONTACT-INFO " Junming Gao Cisco Systems Inc " DESCRIPTION "CABLE DEVICE TRAP MIB is an extension of the CABLE DEVICE MIB defined in RFC2669. It defines various trap objects for both cable modem and cable modem termination system. There are two groups of SNMP notification objects are defined. One group is for notifying cable modem events and one group for notifying cable modem termination system events. Common to all CM notification objects (traps) is that in their OBJECTS statements, A CM trap contains information about the event priority, the event Id, the event message body, the CM DOCSIS capability, the CM DOCSIS register registration status, the cable interface MAC address of the cable modem and the cable card MAC address of the CMTS to which the modem is connected to. These objects are docsDevEvLevel, docsDevId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress and docsIfCmCmtsAddress. The values of docsDevEvLevel, docsDevId, and docsDevEvText are from the entry which logs this event in the docsDevEventTable, which is defined in DOCS-CABLE-DEVICE-MIB of RFC2669. The docsIfDocsisCapability and docsIfDocsisOperMode are defined in DOCS-IF-EXT-MIB. The ifPhysAddress value is the MAC address of the cable interface of this cable modem. The docsIfCmCmtsAddress specifies the MAC address of the CMTS (if there is a cable card/interface in the CMTS, then it is actually the cable interface interface MAC address to which the CM is connected). Individual CM trap may contain additional objects to provide necessary information. Common to all CMTS notification objects (traps) is that in their OBJECTS statements, A CMTS trap contains information about the event priority, the event Id, the event message body, the connected CM DOCSIS register status, the CM cable interface MAC address, the CMTS DOCSIS register status and the CMTS MAC address. These objects are docsDevEvLevel, docsDevId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, and ifPhysAddress. The values of docsDevEvLevel, docsDevId, and docsDevEvText are similar to what in CM traps. The values of docsIfCmtsCmStatusDocsisMode and docsIfCmtsCmStatusMacAddress are from the docsIfCmtsCmStatusEntry (defined in DOCS-IF-MIB) corresponding to a conneced CM. The docsIfDocsisCapability indicates the CMTS DOCSIS capability. The ifPhysAddress value is the CMTS MAC address (if there is a cable card/interface in the CMTS, then it is actually the MAC address of the cable interface which connected to the CM). " REVISION "0010080000Z" DESCRIPTION "Initial Version. " ::= { docsDev 10 } -- -- docsDevNotification OBJECT IDENTIFIER ::= { docsDev 2 } -- docsDevTraps OBJECT IDENTIFIER ::= { docsDevNotification 1 } docsDevTrapControl OBJECT IDENTIFIER ::= { docsDevTraps 1} docsDevCmTraps OBJECT IDENTIFIER ::= { docsDevTraps 2 0 } docsDevCmtsTraps OBJECT IDENTIFIER ::= { docsDevTraps 3 0 } docsDevCmTrapControl OBJECT-TYPE SYNTAX BITS { cmInitTLVUnknownTrap(0), cmDynServReqFailTrap(1), cmDynServRspFailTrap(2), cmDynServAckFailTrap(3), cmBpiInitTrap(4), cmBPKMTrap(5), cmDynamicSATrap(6), cmDHCPFailTrap(7), cmSwUpgradeInitTrap(8), cmSwUpgradeFailTrap(9), cmSwUpgradeSuccessTrap(10), cmSwUpgradeCVCTrap(11), cmTODFailTrap(12), cmDCCReqFailTrap(13), cmDCCRspFailTrap(14), cmDCCAckFailTrap(15) } MAX-ACCESS read-write STATUS current DESCRIPTION "The object is used to enable CM traps. From left to right, the set bit indicates the corresponding CM trap is enabled. For example, if the first bit is set, then docsDevCmInitTLVUnknownTrap is enabled. If it is zero, the trap is disabled. " ::= { docsDevTrapControl 1 } docsDevCmtsTrapControl OBJECT-TYPE SYNTAX BITS { cmtsInitRegReqFailTrap(0), cmtsInitRegRspFailTrap(1), cmtsInitRegAckFailTrap(2), cmtsDynServReqFailTrap(3), cmtsDynServRspFailTrap(4), cmtsDynServAckFailTrap(5), cmtsBpiInitTrap(6), cmtsBPKMTrap(7), cmtsDynamicSATrap(8), cmtsDCCReqFailTrap(9), cmtsDCCRspFailTrap(10), cmtsDCCAckFailTrap(11) } MAX-ACCESS read-write STATUS current DESCRIPTION "The object is used to enable CMTS traps. From right to left, the set bit indicates the corresponding CMTS trap is enabled. For example, if the first bit is set, then docsDevCmtsInitRegRspFailTrap is enabled. If it is zero, the trap is disabled. " ::= { docsDevTrapControl 2 } docsDevCmInitTLVUnknownTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "Event due to detection of unknown TLV during the TLV parsing process. The values of docsDevEvLevel, docsDevId, and DocsDevEvText are from the entry which logs this event in the docsDevEventTable. The docsIfDocsisCapability and docsIfDocsisOperMode indicate the DOCSIS version information. The ifPhysAddress value is the MAC address of the cable interface of this cable modem. The docsIfCmCmtsAddress specifies the MAC address of the CMTS to which the CM is connected (if there is a cable card/interface in the CMTS, then it is actually the MAC address of the cable interface which connected to the CM). This part of information is uniformed across all CM traps. " ::= { docsDevCmTraps 1 } docsDevCmDynServReqFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic service request happened during the dynamic services process. " ::= { docsDevCmTraps 2 } docsDevCmDynServRspFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic service response happened during the dynamic services process. " ::= { docsDevCmTraps 3} docsDevCmDynServAckFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic service acknowledgement happened during the dynamic services process. " ::= { docsDevCmTraps 4} docsDevCmBpiInitTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a BPI initialization attempt happened during the registration process. " ::= { docsDevCmTraps 5 } docsDevCmBPKMTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a BPKM operation. " ::= { docsDevCmTraps 6 } docsDevCmDynamicSATrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic security association operation. " ::= { docsDevCmTraps 7 } docsDevCmDHCPFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress, docsDevServerDhcp } STATUS current DESCRIPTION "An event to report the failure of a DHCP server. The value of docsDevServerDhcp is the IP address of the DHCP server. " ::= { docsDevCmTraps 8 } docsDevCmSwUpgradeInitTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress, docsDevSwFilename, docsDevSwServer } STATUS current DESCRIPTION "An event to report a software upgrade initiated event. The values of docsDevSwFilename, and docsDevSwServer indicate the software image name and the server IP address the image is from. " ::= { docsDevCmTraps 9 } docsDevCmSwUpgradeFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress, docsDevSwFilename, docsDevSwServer } STATUS current DESCRIPTION "An event to report the failure of a software upgrade attempt. The values of docsDevSwFilename, and docsDevSwServer indicate the software image name and the server IP address the image is from. " ::= { docsDevCmTraps 10 } docsDevCmSwUpgradeSuccessTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress, docsDevSwFilename, docsDevSwServer } STATUS current DESCRIPTION "An event to report the Software upgrade success event. The values of docsDevSwFilename, and docsDevSwServer indicate the software image name and the server IP address the image is from. " ::= { docsDevCmTraps 11 } docsDevCmSwUpgradeCVCFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of the verification of code file happened during a secure software upgrade attempt. " ::= { docsDevCmTraps 12 } docsDevCmTODFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress, docsDevServerTime } STATUS current DESCRIPTION "An event to report the failure of a time of day server. The value of docsDevServerTime indicates the server IP address. " ::= { docsDevCmTraps 13 } docsDevCmDCCReqFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic channel change request happened during the dynamic channel change process in the CM side. " ::= { docsDevCmTraps 14 } docsDevCmDCCRspFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic channel change response happened during the dynamic channel change process in the CM side. " ::= { docsDevCmTraps 15 } docsDevCmDCCAckFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDocsisCapability, docsIfDocsisOperMode, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic channel change acknowledgement happened during the dynamic channel change process in the CM side. " ::= { docsDevCmTraps 16} docsDevCmtsInitRegReqFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a registration request from CM happened during the CM initialization process and detected in the CMTS side. The values of docsDevEvLevel, docsDevId, and docsDevEvText are from the entry which logs this event in the docsDevEventTable. DocsIfCmtsCmStatusDocsisMode and docsIfCmtsCmStatusMacAddress indicate the docsis version and the MAC address of the requesting CM. docsIfDocsisCapability and ifPhysAddress indicate the docsis version of the CMTS and the MAC address of the CMTS (if there is a cable card/interface in the CMTS, then it is actually the MAC address of the cable interface which connected to the CM)cable card connected to the CM. This part of information is uniformed across all CMTS traps. " ::= { docsDevCmtsTraps 1 } docsDevCmtsInitRegRspFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a registration response happened during the CM initialization process and detected in the CMTS side. " ::= { docsDevCmtsTraps 2 } docsDevCmtsInitRegAckFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a registration acknowledgement from CM happened during the CM initialization process and detected in the CMTS side. " ::= { docsDevCmtsTraps 3 } docsDevCmtsDynServReqFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic service request happened during the dynamic services process and detected in the CMTS side. " ::= { docsDevCmtsTraps 4 } docsDevCmtsDynServRspFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic service response happened during the dynamic services process and detected in the CMTS side. " ::= { docsDevCmtsTraps 5 } docsDevCmtsDynServAckFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic service acknowledgement happened during the dynamic services process and detected in the CMTS side. " ::= { docsDevCmtsTraps 6 } docsDevCmtsBpiInitTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a BPI initialization attempt happened during the CM registration process and detected in the CMTS side. " ::= { docsDevCmtsTraps 7 } docsDevCmtsBPKMTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a BPKM operation which is detected in the CMTS side. " ::= { docsDevCmtsTraps 8 } docsDevCmtsDynamicSATrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic security association operation which is detected in the CMTS side. " ::= { docsDevCmtsTraps 9 } docsDevCmtsDCCReqFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic channel change request happened during the dynamic channel change process in the CM side and detected in the CMTS side. " ::= { docsDevCmtsTraps 10 } docsDevCmtsDCCRspFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic channel change response happened during the dynamic channel change process in the CMTS side. " ::= { docsDevCmtsTraps 11 } docsDevCmtsDCCAckFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisMode, docsIfCmtsCmStatusMacAddress, docsIfDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic channel change acknowledgement happened during the dynamic channel change process in the CMTS side. " ::= { docsDevCmtsTraps 12} -- -- Conformance definitions -- docsDevTrapConformance OBJECT IDENTIFIER ::= { docsDevTraps 2 } docsDevTrapGroups OBJECT IDENTIFIER ::= { docsDevTrapConformance 1 } docsDevTrapCompliances OBJECT IDENTIFIER ::= { docsDevTrapConformance 2 } docsDevCmTrapCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for Cable Modem Traps and Control " MODULE -- docsDevTrap -- mandatory groups GROUP docsDevCmTrapControlGroup DESCRIPTION "Mandatory in CM." GROUP docsDevCmNotificationGroup DESCRIPTION "Mandatory in Cable Modem." ::= { docsDevTrapCompliances 1 } docsDevCmTrapControlGroup OBJECT-GROUP OBJECTS { docsDevCmTrapControl } STATUS current DESCRIPTION "CM must support docsDevCmTrapControl." ::= { docsDevTrapGroups 1 } docsDevCmNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { docsDevCmInitTLVUnknownTrap, docsDevCmDynServReqFailTrap, docsDevCmDynServRspFailTrap, docsDevCmDynServAckFailTrap, docsDevCmBpiInitTrap, docsDevCmBPKMTrap, docsDevCmDynamicSATrap, docsDevCmDHCPFailTrap, docsDevCmSwUpgradeInitTrap, docsDevCmSwUpgradeFailTrap, docsDevCmSwUpgradeSuccessTrap, docsDevCmSwUpgradeCVCTrap, docsDevCmTODFailTrap, docsDevCmDCCReqFailTrap, docsDevCmDCCRspFailTrap, docsDevCmDCCAckFailTrap } STATUS current DESCRIPTION "A collection of CM notifications providing device status and control." ::= { docsDevTrapGroups 2 } docsDevCmtsTrapCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for MCNS Cable Modems and Cable Modem Termination Systems." MODULE -- docsDevTrap -- mandatory groups GROUP docsDevCmtsTrapControlGroup DESCRIPTION "Mandatory in CMTS." GROUP docsDevCmtsNotificationGroup DESCRIPTION "Mandatory in Cable Modem Termination Systems." ::= { docsDevTrapCompliances 2 } docsDevCmtsTrapControlGroup OBJECT-GROUP OBJECTS { docsDevCmtsTrapControl } STATUS current DESCRIPTION "CMTS must support docsDevCmtsTrapControl." ::= { docsDevTrapGroups 3 } docsDevCmtsNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { docsDevCmtsInitRegReqFailTrap, docsDevCmtsInitRegRspFailTrap, docsDevCmtsInitRegAckFailTrap , docsDevCmtsDynServReqFailTrap, docsDevCmtsDynServRspFailTrap, docsDevCmtsDynServAckFailTrap, docsDevCmtsBpiInitTrap, docsDevCmtsBPKMTrap, docsDevCmtsDynamicSATrap, docsDevCmtsDCCReqFailTrap, docsDevCmtsDCCRspFailTrap, docsDevCmtsDCCAckFailTrap } STATUS current DESCRIPTION "A collection of CMTS notifications providing device status and control." ::= { docsDevTrapGroups 4 } 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. --