-- extracted from draft-ietf-ipcdn-docsisevent-mib-00.txt -- at Sat Nov 25 16:04:51 2000 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 docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, docsIfCmtsCmStatusDocsisVersion FROM DOCS-IF-EXT-MIB ifPhysAddress FROM IF-MIB; docsDevTrapMIB MODULE-IDENTITY LAST-UPDATED "000926000000Z" ORGANIZATION "Cisco Systems, Inc." 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 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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 docsIfDevDocsisCapability and docsIfDevDocsisOperStatus 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 (actually the cable card 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 cable card MAC address. These objects are docsDevEvLevel, docsDevId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, and ifPhysAddress. The values of docsDevEvLevel, docsDevId, and docsDevEvText are similar to what in CM traps. The values of docsIfCmtsCmStatusDocsisVersion and docsIfCmtsCmStatusMacAddress are from the docsIfCmtsCmStatusEntry (defined in DOCS-IF-MIB) corresponding to a conneced CM. The docsIfDevDocsisCapability indicates the CMTS DOCSIS capability. The ifPhysAddress value is the MAC address of the cable card which connected to the CM. " ::= { docsDev 10 } -- -- docsDevNotification OBJECT IDENTIFIER ::= { docsDev 2 } -- docsDevTraps OBJECT IDENTIFIER ::= { docsDevNotification 1 } docsDevCmTraps OBJECT IDENTIFIER ::= { docsDevNotification 2 } docsDevCmtsTraps OBJECT IDENTIFIER ::= { docsDevNotification 3 } docsDevCmInitTLVUnknownTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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 docsIfDevDocsisCapability and docsIfDevDocsisOperStatus 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. This part of information is uniformed across all CM traps. " ::= { docsDevCmTraps 1 } docsDevCmDynServReqFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic service request happened during the dynamic services process. " ::= { docsDevCmTraps 2 } docsDevCmDynServResFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, ifPhysAddress, docsIfCmCmtsAddress } STATUS current DESCRIPTION "An event to report the failure of a BPKM operation. " ::= { docsDevCmTraps 6 } docsDevCmDynamicSATrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, ifPhysAddress, docsIfCmCmtsAddress, docsDevSwFilename, docsDevSwServer } STATUS current DESCRIPTION "An event to report the failure of the verification of code file happened during a secure software upgrade attempt. The values of docsDevSwFilename, and docsDevSwServer indicate the software image name and the server IP address the image is from. " ::= { docsDevCmTraps 12 } docsDevCmTODFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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 } docsDevCmDCCResFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfDevDocsisCapability, docsIfDevDocsisOperStatus, 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, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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. DocsIfCmtsCmStatusDocsisVersion and docsIfCmtsCmStatusMacAddress indicate the docsis version and the MAC address of the requesting CM. docsIfDevDocsisCapability and ifPhysAddress indicate the docsis version of the CMTS and the MAC address of the CMTS 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, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 3 } docsDevCmtsInitRegAckFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 4 } docsDevCmtsDynServReqFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 5 } docsDevCmtsDynServResFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 6 } docsDevCmtsDynServAckFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 7 } docsDevCmtsBpiInitTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 8 } docsDevCmtsBPKMTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a BPKM operation which is detected in the CMTS side. " ::= { docsDevCmtsTraps 9 } docsDevCmtsDynamicSATrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, ifPhysAddress } STATUS current DESCRIPTION "An event to report the failure of a dynamic security association operation which is detected in the CMTS side. " ::= { docsDevCmtsTraps 10 } docsDevCmtsDCCReqFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 11 } docsDevCmtsDCCResFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 12 } docsDevCmtsDCCAckFailTrap NOTIFICATION-TYPE OBJECTS { docsDevEvLevel, docsDevEvId, docsDevEvText, docsIfCmtsCmStatusDocsisVersion, docsIfCmtsCmStatusMacAddress, docsIfDevDocsisCapability, 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 13} -- -- Conformance definitions -- docsDevTrapConformance OBJECT IDENTIFIER ::= { docsDev 11 } docsDevTrapGroups OBJECT IDENTIFIER ::= { docsDevTrapConformance 1 } docsDevTrapCompliances OBJECT IDENTIFIER ::= { docsDevTrapConformance 2 } docsDevTrapCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for MCNS Cable Modems and Cable Modem Termination Systems." MODULE -- docsDevTrap -- mandatory groups GROUP docsIfDevDocsisVersionGroup DESCRIPTION "Mandatory in both CM and CMTS." GROUP docsDevCmNotificationGroup DESCRIPTION "Mandatory in Cable Modem." GROUP docsDevCmtsNotificationGroup DESCRIPTION "Mandatory in Cable Modem Termination Systems." ::= { docsDevTrapCompliances 2 } docsDevCmNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { docsDevCmInitTLVUnknownTrap, docsDevCmDynServReqFailTrap, docsDevCmDynServResFailTrap, docsDevCmDynServAckFailTrap, docsDevCmBpiInitTrap, docsDevCmBPKMTrap, docsDevCmDynamicSATrap, docsDevCmDHCPFailTrap, docsDevCmSwUpgradeInitTrap, docsDevCmSwUpgradeFailTrap, docsDevCmSwUpgradeSuccessTrap, docsDevCmSwUpgradeCVCTrap, docsDevCmTODFailTrap, docsDevCmDCCReqFailTrap, docsDevCmDCCResFailTrap, docsDevCmDCCAckFailTrap } STATUS current DESCRIPTION "A collection of CM notifications providing device status and control." ::= { docsDevTrapGroups 10 } docsDevCmtsNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { docsDevCmtsInitRegReqFailTrap, docsDevCmtsInitRegRspFailTrap, docsDevCmtsInitRegAckFailTrap , docsDevCmtsDynServReqFailTrap, docsDevCmtsDynServResFailTrap, docsDevCmtsDynServAckFailTrap, docsDevCmtsBpiInitTrap, docsDevCmtsBPKMTrap, docsDevCmtsDynamicSATrap, docsDevCmtsDCCReqFailTrap, docsDevCmtsDCCResFailTrap, docsDevCmtsDCCAckFailTrap } STATUS current DESCRIPTION "A collection of CMTS notifications providing device status and control." ::= { docsDevTrapGroups 11 } 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. --