-- MIB file created 04-Nov-2005 16:37:16, by -- SMICng version 2.2.11-beta(PRO)(Solaris), January 20, 2001. Enterprise key cisco.com CISCO-VOICE-CONNECTIVITY-MIB DEFINITIONS ::= BEGIN -- From file: "CISCO-VOICE-CONNECTIVITY-MIB.my" -- Compile options "4 7 F H N O W 03 06 0B 0G 0N 0T" IMPORTS DateAndTime, TruthValue, MacAddress, AutonomousType, RowPointer FROM SNMPv2-TC-v1 SnmpAdminString FROM SNMP-FRAMEWORK-MIB ciscoMgmt FROM CISCO-SMI IANAifType FROM IANAifType-MIB InetAddressType, InetAddress FROM INET-ADDRESS-MIB Gauge FROM RFC1155-SMI OBJECT-TYPE FROM RFC-1212 TRAP-TYPE FROM RFC-1215; ciscoVoiceConnectivityMIB OBJECT IDENTIFIER ::= { ciscoMgmt 393 } -- MODULE-IDENTITY -- LastUpdated -- 200509130000Z -- OrgName -- Cisco Systems, Inc. -- ContactInfo -- Cisco Systems -- Customer Service -- -- Postal: 170 W Tasman Drive -- San Jose, CA 95134 -- USA -- -- Tel: +1 800 553-NETS -- -- E-mail: cs-itm@cisco.com -- Descr -- This MIB module provides connectivity related -- information for devices (e.g., 'connectivity between -- voice gateway, phones, gatekeepers and call processing -- agent'). The MIB can be used by network management -- applications to collect the information regarding voice -- connectivity among the devices in the network. The MIB -- can also be used to retrieve the status of voice -- connectivity between the devices. -- -- *** ABBREVIATIONS, ACRONYMS, AND SYMBOLS *** -- -- SCCP - Skinny Client Control Protocol -- -- SGCP - Simple Gateway Control Protocol -- -- MGCP - Media Gateway Control Protocol -- -- H323 - H.323 protocol -- -- SIP - Session Initiation Protocol -- -- -- *** DEFINITIONS *** -- -- CALL AGENT -- A call processing agent component of a device in IP -- telephony and VoIP network. -- -- PORT -- A port on the device that is associated with call -- processing agent. -- -- REGISTRATION -- In an IP telephony network, there are typically keep- -- alive messages or expected registration refresh timers -- that are used to formulate the registration status of -- devices and/or users. -- Possible values of the registration status are as -- follows: -- registered: The port has successfully registered with -- the call agent -- -- unregistered: The port is no longer registered with the -- call agent -- -- rejected: Registration request from the port was -- rejected by the call agent. -- RevDate -- 200509130000Z -- RevDescr -- The initial version of this MIB module. ciscoVoiceConnectivityMIBNotifs OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIB 0 } ciscoVoiceConnectivityMIBObjects OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIB 1 } ciscoVoiceConnectivityMIBConform OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIB 2 } cvcCallAgent OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIBObjects 1 } cvcPort OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIBObjects 2 } cvcCallAgentConnection OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIBObjects 3 } cvcNotif OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIBObjects 4 } cvcMIBCompliances OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIBConform 1 } cvcMIBGroups OBJECT IDENTIFIER ::= { ciscoVoiceConnectivityMIBConform 2 } cvcCallAgentTable OBJECT-TYPE SYNTAX SEQUENCE OF CvcCallAgentEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains information about call agents. When the network management subsystem implements this MIB, this table lists the call agents that exist in this system. This table will contain one entry per call agent. When systems other than those hosting call agents implement this MIB, this table will contain the list of call agents to which ports of this system are associated. The entries would be representative of remote call agents. For example, if a device is a voice gateway having a T1 port associated with three call processing agents, then this table will have three entries representing each of the three call processing agents. The network management subsystem adds conceptual rows to this table for every call agent." ::= { cvcCallAgent 1 } cvcCallAgentEntry OBJECT-TYPE SYNTAX CvcCallAgentEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry (conceptual row) in the cvcCallAgent table, providing associated call agent information such as call agent's IP address and its type." INDEX { cvcCallAgentIndex } ::= { cvcCallAgentTable 1 } CvcCallAgentEntry ::= SEQUENCE { cvcCallAgentIndex Gauge, cvcCallAgentName SnmpAdminString, cvcCallAgentInetAddressType InetAddressType, cvcCallAgentInetAddress InetAddress, cvcCallAgentType AutonomousType } cvcCallAgentIndex OBJECT-TYPE SYNTAX Gauge(1..4294967295) ACCESS not-accessible STATUS mandatory DESCRIPTION "An arbitrary integer, a unique value for each call agent associated with the device." ::= { cvcCallAgentEntry 1 } cvcCallAgentName OBJECT-TYPE SYNTAX SnmpAdminString(SIZE(0..128)) -- Rsyntax OCTET STRING(SIZE(0..128)) ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates name of the call agent given by call agent administrator." ::= { cvcCallAgentEntry 2 } cvcCallAgentInetAddressType OBJECT-TYPE SYNTAX InetAddressType -- Rsyntax INTEGER { -- ?? enum value of zero may cause problems -- unknown(0), -- ipv4(1), -- ipv6(2), -- ipv4z(3), -- ipv6z(4), -- dns(16) -- } ACCESS read-only STATUS mandatory DESCRIPTION "This object reflects a particular type of internet address and provides the context for interpreting one or more address objects elsewhere in this MIB module." REFERENCE "RFC 3291, section 3" ::= { cvcCallAgentEntry 3 } cvcCallAgentInetAddress OBJECT-TYPE SYNTAX InetAddress -- Rsyntax OCTET STRING(SIZE(0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the IP address of the call agent. The type of internet address is indicated by the value of cvcCallAgentInetAddressType." REFERENCE "RFC 3291, section 3" ::= { cvcCallAgentEntry 4 } cvcCallAgentType OBJECT-TYPE SYNTAX AutonomousType -- Rsyntax OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the type of call agent. A list of call agent types can be found in the CISCO-VOICE-APPLICATIONS-OID-MIB." ::= { cvcCallAgentEntry 5 } cvcPortTable OBJECT-TYPE SYNTAX SEQUENCE OF CvcPortEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains information about ports. When the network management subsystem implements this MIB, this table lists all the ports associated with the call agents listed in cvcCallAgentTable. When systems other than those hosting call agents implement this MIB, this table will contain information of all the ports of the system,associated with the call agents listed in cvcCallAgentTable. The network management subsystem adds conceptual rows to this table for every port associated to call agent." ::= { cvcPort 1 } cvcPortEntry OBJECT-TYPE SYNTAX CvcPortEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry (conceptual row) in the port table, providing the port or interface information such as name, IP address, type, MAC address, type of the device containing this port and protocol used by the port." INDEX { cvcPortIndex } ::= { cvcPortTable 1 } CvcPortEntry ::= SEQUENCE { cvcPortIndex Gauge, cvcPortAssociation RowPointer, cvcPortDeviceName SnmpAdminString, cvcPortInetAddressType InetAddressType, cvcPortInetAddress InetAddress, cvcPortMACAddress MacAddress, cvcPortType IANAifType, cvcProductCategory INTEGER, cvcProtocol INTEGER, cvcVirtualInterfaceDN SnmpAdminString } cvcPortIndex OBJECT-TYPE SYNTAX Gauge(1..4294967295) ACCESS not-accessible STATUS mandatory DESCRIPTION "An arbitrary integer value uniquely identifying each physical or virtual port of the device associated with call agent." ::= { cvcPortEntry 1 } cvcPortAssociation OBJECT-TYPE SYNTAX RowPointer -- Rsyntax OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "An association to conceptual row of the port define within another MIB group. This can be used to get more information about the port defined in other MIB group. For example, to get more information about the T1 port defined in this table, this attribute points to a row in ifTable for that T1 port, e.g value for this attribute will be 'ifIndex.5'." ::= { cvcPortEntry 2 } cvcPortDeviceName OBJECT-TYPE SYNTAX SnmpAdminString -- Rsyntax OCTET STRING(SIZE(0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "The device name under which this port has been registered with call agent. This is a mandatory field that represents the port." ::= { cvcPortEntry 3 } cvcPortInetAddressType OBJECT-TYPE SYNTAX InetAddressType -- Rsyntax INTEGER { -- ?? enum value of zero may cause problems -- unknown(0), -- ipv4(1), -- ipv6(2), -- ipv4z(3), -- ipv6z(4), -- dns(16) -- } ACCESS read-only STATUS mandatory DESCRIPTION "This object reflects a particular type of internet address and provides the context for interpreting one or more address objects elsewhere in this MIB module." REFERENCE "RFC 3291, section 3" ::= { cvcPortEntry 4 } cvcPortInetAddress OBJECT-TYPE SYNTAX InetAddress -- Rsyntax OCTET STRING(SIZE(0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the IP address of the port. The type of internet address is indicated bythe value of cvcPortInetAddressType." REFERENCE "RFC 3291, section 3" ::= { cvcPortEntry 5 } cvcPortMACAddress OBJECT-TYPE SYNTAX MacAddress -- Rsyntax OCTET STRING(SIZE(6)) ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the MAC address of the port. For ports which do not have such an address, this object should contain an octet string of zero length." ::= { cvcPortEntry 6 } cvcPortType OBJECT-TYPE SYNTAX IANAifType -- Rsyntax INTEGER { -- other(1), -- regular1822(2), -- hdh1822(3), -- ddnX25(4), -- rfc877x25(5), -- ethernetCsmacd(6), -- iso88023Csmacd(7), -- iso88024TokenBus(8), -- iso88025TokenRing(9), -- iso88026Man(10), -- starLan(11), -- proteon10Mbit(12), -- proteon80Mbit(13), -- hyperchannel(14), -- fddi(15), -- lapb(16), -- sdlc(17), -- ds1(18), -- e1(19), -- basicISDN(20), -- primaryISDN(21), -- propPointToPointSerial(22), -- ppp(23), -- softwareLoopback(24), -- eon(25), -- ethernet3Mbit(26), -- nsip(27), -- slip(28), -- ultra(29), -- ds3(30), -- sip(31), -- frameRelay(32), -- rs232(33), -- para(34), -- arcnet(35), -- arcnetPlus(36), -- atm(37), -- miox25(38), -- sonet(39), -- x25ple(40), -- iso88022llc(41), -- localTalk(42), -- smdsDxi(43), -- frameRelayService(44), -- v35(45), -- hssi(46), -- hippi(47), -- modem(48), -- aal5(49), -- sonetPath(50), -- sonetVT(51), -- smdsIcip(52), -- propVirtual(53), -- propMultiplexor(54), -- ieee80212(55), -- fibreChannel(56), -- hippiInterface(57), -- frameRelayInterconnect(58), -- aflane8023(59), -- aflane8025(60), -- cctEmul(61), -- fastEther(62), -- isdn(63), -- v11(64), -- v36(65), -- g703at64k(66), -- g703at2mb(67), -- qllc(68), -- fastEtherFX(69), -- channel(70), -- ieee80211(71), -- ibm370parChan(72), -- escon(73), -- dlsw(74), -- isdns(75), -- isdnu(76), -- lapd(77), -- ipSwitch(78), -- rsrb(79), -- atmLogical(80), -- ds0(81), -- ds0Bundle(82), -- bsc(83), -- async(84), -- cnr(85), -- iso88025Dtr(86), -- eplrs(87), -- arap(88), -- propCnls(89), -- hostPad(90), -- termPad(91), -- frameRelayMPI(92), -- x213(93), -- adsl(94), -- radsl(95), -- sdsl(96), -- vdsl(97), -- iso88025CRFPInt(98), -- myrinet(99), -- voiceEM(100), -- voiceFXO(101), -- voiceFXS(102), -- voiceEncap(103), -- voiceOverIp(104), -- atmDxi(105), -- atmFuni(106), -- atmIma(107), -- pppMultilinkBundle(108), -- ipOverCdlc(109), -- ipOverClaw(110), -- stackToStack(111), -- virtualIpAddress(112), -- mpc(113), -- ipOverAtm(114), -- iso88025Fiber(115), -- tdlc(116), -- gigabitEthernet(117) -- } ACCESS read-only STATUS mandatory DESCRIPTION "The type of port. Additional values for cvcPortType are assigned by the Internet Assigned Numbers Authority (IANA), through updating the syntax of the IANAifType textual convention. If the port type is not defined in IANAifType, then value of this object will be other(1). In this case, port type can be identified either by productCategory or by referring to other MIB pointed by cvcPortAssociation." ::= { cvcPortEntry 7 } cvcProductCategory OBJECT-TYPE SYNTAX INTEGER { phone(1), gateway(2), h323Device(3), ctiDevice(4), voiceMailDevice(5), mediaResourceDevice(6), huntListDevice(7), sipDevice(8) } ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates type of the device that contains the port." ::= { cvcPortEntry 8 } cvcProtocol OBJECT-TYPE SYNTAX INTEGER { sccp(1), sgcp(2), mgcp(3), h323(4), sip(5) } ACCESS read-only STATUS mandatory DESCRIPTION " Protocol the port use for communication to its associated device." REFERENCE "RFC 3435 on Media Gateway Control Protocol (MGCP) Version 1.0 RFC 3261 - SIP: Session Initiation Protocol ITU-T Recommendation H.323v.4,'Packet-based multimedia communications systems', November 2000." ::= { cvcPortEntry 9 } cvcVirtualInterfaceDN OBJECT-TYPE SYNTAX SnmpAdminString -- Rsyntax OCTET STRING(SIZE(0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "This attribute indicates directory number of the port. This attribute is applicable only to virtual or logical interface that is associated with call agent." ::= { cvcPortEntry 10 } cvcCallAgentConnectionTable OBJECT-TYPE SYNTAX SEQUENCE OF CvcCallAgentConnectionEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains current registration status information for all the ports, listed in cvcPortTable, that are associated with the call agents listed cvcCallAgentTable. The network management subsystem adds a conceptual row to this table per port and its associated call agent pair. Entries in this table depends on entries in cvcPortTable and cvcCallAgentTable. Deletion of any entry in those other two table will result in deletion of corresponding entry in this table." ::= { cvcCallAgentConnection 1 } cvcCallAgentConnectionEntry OBJECT-TYPE SYNTAX CvcCallAgentConnectionEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry (conceptual row) in the cvcCallAgentConnectionTable, containing the information about a port or interface's registration status to call agents." INDEX { cvcPortIndex, cvcCallAgentIndex } ::= { cvcCallAgentConnectionTable 1 } CvcCallAgentConnectionEntry ::= SEQUENCE { cvcCallAgentPriority Gauge, cvcRegistrationStatus INTEGER, cvcStatusReason INTEGER, cvcLastStatusChangeTime DateAndTime, cvcLastRegisteredTime DateAndTime } cvcCallAgentPriority OBJECT-TYPE SYNTAX Gauge ACCESS read-only STATUS mandatory DESCRIPTION "A port can be associated with multiple call agents. In case of failure of the call agent to which the port has been registered, port falls back to the back-up call agent. To achieve this redundancy each call agent is assigned a priority number in context of port. This object indicates the call agent's priority number." ::= { cvcCallAgentConnectionEntry 1 } cvcRegistrationStatus OBJECT-TYPE SYNTAX INTEGER { unknown(1), notapplicable(2), registered(3), unregistered(4), rejected(5) } ACCESS read-only STATUS mandatory DESCRIPTION "This syntax is used to identify the registration status of the port with call agent. unknown: The registration status of the port is unknown. notapplicable: The registration status of the port is not applicable registered: The port has successfully registered with the call agent unregistered: The port is no longer registered with the call agent rejected: Registration request from the port was rejected by the call agent." ::= { cvcCallAgentConnectionEntry 2 } cvcStatusReason OBJECT-TYPE SYNTAX INTEGER { noError(1), unknown(2), configurationError(3), deviceNameUnresolveable(4), maxDevRegReached(5), connectivityError(6), initializationError(7), deviceReset(8) } ACCESS read-only STATUS mandatory DESCRIPTION "This syntax is used as means of identifying the reasons for a device registration error. Following are possible reason of registration status value. noError: No Error unknown: Unknown error cause configurationError: Device configuration error deviceNameUnresolveable: Unable to resolve the device name to an IP address maxDevRegReached: Maximum number of device registration have been reached connectivityError: Call agent is unable to establish communication with the device during registration initializationError: An error occurred during initialization of the device deviceReset: Indicates that the error was due to device reset." ::= { cvcCallAgentConnectionEntry 3 } cvcLastStatusChangeTime OBJECT-TYPE SYNTAX DateAndTime -- Rsyntax OCTET STRING(SIZE(8|11)) ACCESS read-only STATUS mandatory DESCRIPTION "The time registration status of the port changed." ::= { cvcCallAgentConnectionEntry 4 } cvcLastRegisteredTime OBJECT-TYPE SYNTAX DateAndTime -- Rsyntax OCTET STRING(SIZE(8|11)) ACCESS read-only STATUS mandatory DESCRIPTION "The time the port last registered with the call agent." ::= { cvcCallAgentConnectionEntry 5 } cvcNotifEnable OBJECT-TYPE SYNTAX TruthValue -- Rsyntax INTEGER { -- true(1), -- false(2) -- } ACCESS read-write STATUS mandatory DESCRIPTION "This variable indicates whether the system generates notifications defined in this MIB. A false value will prevent all the notifications from being generated by this system." DEFVAL { false } ::= { cvcNotif 1 } cvcPortRegistrationStatusChange TRAP-TYPE -- Reverse mappable trap ENTERPRISE ciscoVoiceConnectivityMIB VARIABLES { cvcPortDeviceName, cvcCallAgentInetAddress, cvcCallAgentPriority, cvcRegistrationStatus, cvcStatusReason, cvcLastStatusChangeTime, cvcLastRegisteredTime } -- Status -- mandatory DESCRIPTION "A cvcPortRegistrationStatusChange notification is generated when the value of cvcRegistrationStatus changes. It can be utilized by an NMS to get current registration status change information. cvcPortDeviceName and cvcCallAgentInetAddress can be used by NMS to get information about the port and call agent from cvcPortTable and cvcCallAgentTable respectively. An NMS should periodically check the value of cvcLastStatusChangeTime to detect any missed cvcPortRegistrationStatusChange notification-events due to network problem or any other problem." ::= 1 cvcCallAgentGroup OBJECT IDENTIFIER ::= { cvcMIBGroups 1 } -- OBJECT-GROUP -- Status -- mandatory -- Descr -- A collection of objects which provide info like IP address and -- HostName about all call agents to which the ports are -- configured to register. Also it has call agent type. -- objects -- cvcCallAgentName, cvcCallAgentInetAddressType, -- cvcCallAgentInetAddress, cvcCallAgentType cvcPortGroup OBJECT IDENTIFIER ::= { cvcMIBGroups 2 } -- OBJECT-GROUP -- Status -- mandatory -- Descr -- A collection of objects which provide info about all port/ -- interface of the device that are configured to register to -- call agents. Not all objects are applicable to all type of -- ports or interface. For example some port does not have -- MACAddress in that case cvcPortMACAddress need not have to be -- populated. Similarly for some device cvcPortAssociation is not -- applicable for example phone, in that case cvcPortAssociation -- object will not be populated but DeviceName, MCAAddress and -- IPAddress will be populated. -- objects -- cvcPortAssociation, cvcPortDeviceName, cvcPortInetAddressType, -- cvcPortInetAddress, cvcPortMACAddress, cvcPortType, -- cvcProductCategory, cvcProtocol, cvcVirtualInterfaceDN cvcCallAgentConnectionGroup OBJECT IDENTIFIER ::= { cvcMIBGroups 3 } -- OBJECT-GROUP -- Status -- mandatory -- Descr -- A collection of objects which provides registration status -- information for the port to the call agents defined in -- cvcPortTable and cvcCallAgentTable. This also provides -- information about the reason why registration is failed or -- rejected. It provides last time when status changes and last -- registered time. In some cases, registration status is not -- applicable for example H.323 gateway association with call -- agent, in that case most of these object will not be populated -- except cvcCallAgentPriority which can be used to find -- association of port with call agent. -- objects -- cvcCallAgentPriority, cvcRegistrationStatus, cvcStatusReason, -- cvcLastStatusChangeTime, cvcLastRegisteredTime cvcNotifGroup OBJECT IDENTIFIER ::= { cvcMIBGroups 4 } -- OBJECT-GROUP -- Status -- mandatory -- Descr -- A collection of objects which provide info about all the -- notifications generated by the device that implement this MIB. -- -- Implementation of this group is optional. -- objects -- cvcNotifEnable cvcNotificationsGroup OBJECT IDENTIFIER ::= { cvcMIBGroups 5 } -- NOTIFICATION-GROUP -- Status -- mandatory -- Descr -- A collection of notifications that are generated by -- CISCO-VOICE-CONNECTIVITY-MIB. This is important information -- when some management application decide not to poll but only -- rely on notification. -- -- Implementation of this group is optional. -- notifications -- cvcPortRegistrationStatusChange cvcMIBCompliance OBJECT IDENTIFIER ::= { cvcMIBCompliances 1 } -- MODULE-COMPLIANCE -- Status -- mandatory -- Descr -- The compliance statement for entities which implement the -- CISCO-VOICE-CONNECTIVITY-MIB. -- Module -- >>current<< -- MandGroup -- cvcCallAgentGroup -- MandGroup -- cvcPortGroup -- MandGroup -- cvcCallAgentConnectionGroup -- OptGroup -- cvcNotifGroup -- OptGroup -- cvcNotificationsGroup END