1-- ***************************************************************** 2-- CISCO-CALL-HISTORY-MIB.my: Cisco call history MIB file 3-- 4-- January 1995, Bibek A. Das 5-- 6-- Copyright (c) 1995-1998 by cisco Systems, Inc. 7-- All rights reserved. 8-- 9-- ***************************************************************** 10 11CISCO-CALL-HISTORY-MIB DEFINITIONS ::= BEGIN 12 13IMPORTS 14 MODULE-IDENTITY, 15 OBJECT-TYPE, 16 Integer32 17 FROM SNMPv2-SMI 18 DisplayString, 19 TimeStamp 20 FROM SNMPv2-TC 21 MODULE-COMPLIANCE, 22 OBJECT-GROUP 23 FROM SNMPv2-CONF 24 InterfaceIndex 25 FROM IF-MIB 26 ciscoMgmt 27 FROM CISCO-SMI; 28 29 30ciscoCallHistoryMib MODULE-IDENTITY 31 LAST-UPDATED "9611190000Z" 32 ORGANIZATION "Cisco Systems, Inc." 33 CONTACT-INFO 34 " Cisco Systems 35 Customer Service 36 37 Postal: 170 W Tasman Drive 38 San Jose, CA 95134 39 USA 40 41 Tel: +1 800 553-NETS 42 43 E-mail: cs-wan@cisco.com" 44 DESCRIPTION 45 "The MIB module to describe and store the call information 46 of the routers for accounting purposes." 47 REVISION "9508150000Z" 48 DESCRIPTION 49 "Fix typo which caused conflicting syntax." 50 REVISION "9507200000Z" 51 DESCRIPTION 52 "Add a new object ciscoCallHistoryDialReason to the call 53 history table." 54 REVISION "9508150000Z" 55 DESCRIPTION 56 "Add new objects to the call history table to store the 57 time of day, and transmitted/received packets/bytes." 58 REVISION "9611190000Z" 59 DESCRIPTION 60 "Add new objects to the call history table to store the 61 advice of charge information for recorded units or 62 currency type, amount and multipler." 63 64 ::= { ciscoMgmt 27 } 65 66-- This MIB describes the objects defined and used for storing the 67-- call information for all calls. 68 69-- Call History Mib objects definitions 70 71ciscoCallHistoryMibObjects OBJECT IDENTIFIER ::= { ciscoCallHistoryMib 1 } 72 73ciscoCallHistory OBJECT IDENTIFIER ::= { ciscoCallHistoryMibObjects 1 } 74 75ciscoCallHistoryTableMaxLength OBJECT-TYPE 76 SYNTAX Integer32 (0..500) 77 MAX-ACCESS read-write 78 STATUS current 79 DESCRIPTION 80 "The upper limit on the number of entries that the 81 ciscoCallHistoryTable may contain. A value of 0 82 will prevent any history from being retained. When 83 this table is full, the oldest entry will be deleted 84 and the new one will be created." 85 DEFVAL { 100 } 86 ::= { ciscoCallHistory 1 } 87 88ciscoCallHistoryRetainTimer OBJECT-TYPE 89 SYNTAX Integer32 (0..500) 90 UNITS "minutes" 91 MAX-ACCESS read-write 92 STATUS current 93 DESCRIPTION 94 "The minimum amount of time that an ciscoCallHistoryEntry 95 will be maintained before being deleted. A value of 96 0 will prevent any history from being retained, but 97 will not prevent callCompletion traps being genarated." 98 DEFVAL { 15 } 99 ::= { ciscoCallHistory 2 } 100 101-- ciscoCallHistoryTable 102-- Table to store the past call information. The call information will 103-- include the destination number, the call connect time, the call 104-- disconnect time and the disconnection cause. These calls could 105-- be circuit switched or they could be virtual circuits. 106-- History of each and every call will be stored. An entry will be 107-- created when a call gets disconnected. At the time 108-- of creation, the entry will contain the connect time and the 109-- disconnect time and other call information." 110 111ciscoCallHistoryTable OBJECT-TYPE 112 SYNTAX SEQUENCE OF CallHistoryEntry 113 MAX-ACCESS not-accessible 114 STATUS current 115 DESCRIPTION 116 "A table containing information about specific 117 calls to a specific destination." 118 ::= { ciscoCallHistory 3 } 119 120ciscoCallHistoryEntry OBJECT-TYPE 121 SYNTAX CallHistoryEntry 122 MAX-ACCESS not-accessible 123 STATUS current 124 DESCRIPTION 125 "The information regarding a single Connection." 126 INDEX { ciscoCallHistoryStartTime, ciscoCallHistoryIndex } 127 ::= { ciscoCallHistoryTable 1 } 128 129 130CallHistoryEntry ::= 131 SEQUENCE { 132 ciscoCallHistoryStartTime TimeStamp, 133 ciscoCallHistoryIndex Integer32, 134 ciscoCallHistoryCallingNumber OCTET STRING, 135 ciscoCallHistoryCalledNumber OCTET STRING, 136 ciscoCallHistoryInterfaceNumber InterfaceIndex, 137 ciscoCallHistoryDestinationAddress OCTET STRING, 138 ciscoCallHistoryDestinationHostName DisplayString, 139 ciscoCallHistoryCallDisconnectCause INTEGER, 140 ciscoCallHistoryCallConnectionTime TimeStamp, 141 ciscoCallHistoryCallDisconnectTime TimeStamp, 142 ciscoCallHistoryDialReason DisplayString, 143 ciscoCallHistoryConnectTimeOfDay DisplayString, 144 ciscoCallHistoryDisconnectTimeOfDay DisplayString, 145 ciscoCallHistoryTransmitPackets Integer32, 146 ciscoCallHistoryTransmitBytes Integer32, 147 ciscoCallHistoryReceivePackets Integer32, 148 ciscoCallHistoryReceiveBytes Integer32, 149 ciscoCallHistoryRecordedUnits Integer32, 150 ciscoCallHistoryCurrency DisplayString, 151 ciscoCallHistoryCurrencyAmount Integer32, 152 ciscoCallHistoryMultiplier INTEGER 153 } 154 155ciscoCallHistoryStartTime OBJECT-TYPE 156 SYNTAX TimeStamp 157 MAX-ACCESS not-accessible 158 STATUS current 159 DESCRIPTION 160 "The value of sysUpTime when this call history entry was 161 created. This will be useful for an NMS to retrieve all 162 calls after a specific time." 163 ::= { ciscoCallHistoryEntry 1 } 164 165ciscoCallHistoryIndex OBJECT-TYPE 166 SYNTAX Integer32 (1..2147483647) 167 MAX-ACCESS not-accessible 168 STATUS current 169 DESCRIPTION 170 "Index variable to access the CallHistoryEntry objects 171 of the ciscoCallHistoryTable." 172 ::= { ciscoCallHistoryEntry 2 } 173 174ciscoCallHistoryCallingNumber OBJECT-TYPE 175 SYNTAX OCTET STRING (SIZE (1..255)) 176 MAX-ACCESS read-only 177 STATUS current 178 DESCRIPTION 179 "The calling number for this call. If the number is 180 not available, then it will have a length of zero. 181 The variable is instantiated if this is an incoming 182 call." 183 ::= { ciscoCallHistoryEntry 3 } 184 185ciscoCallHistoryCalledNumber OBJECT-TYPE 186 SYNTAX OCTET STRING (SIZE (1..255)) 187 MAX-ACCESS read-only 188 STATUS current 189 DESCRIPTION 190 "The number this call is connected to. This variable is 191 instantiated if this is an outgoing call." 192 ::= { ciscoCallHistoryEntry 4 } 193 194 195ciscoCallHistoryInterfaceNumber OBJECT-TYPE 196 SYNTAX InterfaceIndex 197 MAX-ACCESS read-only 198 STATUS current 199 DESCRIPTION 200 "This is the ifIndex value of the highest number of interface 201 through which the call was made." 202 ::= { ciscoCallHistoryEntry 5 } 203 204 205ciscoCallHistoryDestinationAddress OBJECT-TYPE 206 SYNTAX OCTET STRING (SIZE (1..60)) 207 MAX-ACCESS read-only 208 STATUS current 209 DESCRIPTION 210 "The address of the host this call is connected 211 to, if it is available. Most devices/routers connected 212 to an interface have an address and this object will 213 store that. The variable is not instantiated if it 214 is not available." 215 ::= { ciscoCallHistoryEntry 6 } 216 217ciscoCallHistoryDestinationHostName OBJECT-TYPE 218 SYNTAX DisplayString 219 MAX-ACCESS read-only 220 STATUS current 221 DESCRIPTION 222 "The name of the host this call is 223 connected to. Most devices/routers connected to 224 an interface have a name and this object will 225 store that name." 226 ::= { ciscoCallHistoryEntry 7 } 227 228ciscoCallHistoryCallDisconnectCause OBJECT-TYPE 229 SYNTAX INTEGER { 230 other(1), 231 normalDisconnectSent(2), 232 normalDisconnectReceived(3), 233 networkOutOfOrder(4), 234 callRejected(5), 235 userBusy(6), 236 noCircuitChannelAvailable(7), 237 interworkingError(8) 238 } 239 MAX-ACCESS read-only 240 STATUS current 241 DESCRIPTION 242 "The reason for the call termination." 243 ::= { ciscoCallHistoryEntry 8 } 244 245ciscoCallHistoryCallConnectionTime OBJECT-TYPE 246 SYNTAX TimeStamp 247 MAX-ACCESS read-only 248 STATUS current 249 DESCRIPTION 250 "The value of sysUpTime when the call was connected." 251 ::= { ciscoCallHistoryEntry 9 } 252 253 254ciscoCallHistoryCallDisconnectTime OBJECT-TYPE 255 SYNTAX TimeStamp 256 MAX-ACCESS read-only 257 STATUS current 258 DESCRIPTION 259 "The value of sysUpTime when the call got disconnected 260 last." 261 ::= { ciscoCallHistoryEntry 10 } 262 263ciscoCallHistoryDialReason OBJECT-TYPE 264 SYNTAX DisplayString 265 MAX-ACCESS read-only 266 STATUS current 267 DESCRIPTION 268 "The reason for initiating this call. This may include 269 the destination address of the interesting packet that 270 forced us to dial. This variable is instantiated for 271 an outgoing call." 272 ::= { ciscoCallHistoryEntry 11 } 273 274ciscoCallHistoryConnectTimeOfDay OBJECT-TYPE 275 SYNTAX DisplayString 276 MAX-ACCESS read-only 277 STATUS current 278 DESCRIPTION 279 "The time of day at the time of call connect." 280 ::= { ciscoCallHistoryEntry 12 } 281 282ciscoCallHistoryDisconnectTimeOfDay OBJECT-TYPE 283 SYNTAX DisplayString 284 MAX-ACCESS read-only 285 STATUS current 286 DESCRIPTION 287 "The time of day when the call disconnected." 288 ::= { ciscoCallHistoryEntry 13 } 289 290ciscoCallHistoryTransmitPackets OBJECT-TYPE 291 SYNTAX Integer32 292 MAX-ACCESS read-only 293 STATUS current 294 DESCRIPTION 295 "Number of packets transmitted when this call was up." 296 ::= { ciscoCallHistoryEntry 14 } 297 298ciscoCallHistoryTransmitBytes OBJECT-TYPE 299 SYNTAX Integer32 300 MAX-ACCESS read-only 301 STATUS current 302 DESCRIPTION 303 "Number of Bytes transmitted when this call was up." 304 ::= { ciscoCallHistoryEntry 15 } 305 306ciscoCallHistoryReceivePackets OBJECT-TYPE 307 SYNTAX Integer32 308 MAX-ACCESS read-only 309 STATUS current 310 DESCRIPTION 311 "Number of packets received when this call was up." 312 ::= { ciscoCallHistoryEntry 16 } 313 314ciscoCallHistoryReceiveBytes OBJECT-TYPE 315 SYNTAX Integer32 316 MAX-ACCESS read-only 317 STATUS current 318 DESCRIPTION 319 "Number of Bytes received when this call was up." 320 ::= { ciscoCallHistoryEntry 17 } 321 322ciscoCallHistoryRecordedUnits OBJECT-TYPE 323 SYNTAX Integer32 (0..16777215) 324 MAX-ACCESS read-only 325 STATUS current 326 DESCRIPTION 327 "Advice of Charge recorded units when this call was up." 328 REFERENCE 329 "ISDN AOC supplementary service DSS1 protocol ETS 300 182" 330 ::= { ciscoCallHistoryEntry 18 } 331 332ciscoCallHistoryCurrency OBJECT-TYPE 333 SYNTAX DisplayString 334 MAX-ACCESS read-only 335 STATUS current 336 DESCRIPTION 337 "Advice of Charge currency type." 338 REFERENCE 339 "ISDN AOC supplementary service DSS1 protocol ETS 300 182" 340 ::= { ciscoCallHistoryEntry 19 } 341 342ciscoCallHistoryCurrencyAmount OBJECT-TYPE 343 SYNTAX Integer32 (0..16777215) 344 MAX-ACCESS read-only 345 STATUS current 346 DESCRIPTION 347 "Advice of Charge currency amount when this call was up." 348 REFERENCE 349 "ISDN AOC supplementary service DSS1 protocol ETS 300 182" 350 ::= { ciscoCallHistoryEntry 20 } 351 352ciscoCallHistoryMultiplier OBJECT-TYPE 353 SYNTAX INTEGER { 354 oneThousandth(0), 355 oneHundreth(1), 356 oneTenth(2), 357 one(3), 358 ten(4), 359 hundred(5), 360 thousand(6) 361 } 362 MAX-ACCESS read-only 363 STATUS current 364 DESCRIPTION 365 "Advice of Charge multiplier for currency amount" 366 REFERENCE 367 "ISDN AOC supplementary service DSS1 protocol ETS 300 182" 368 ::= { ciscoCallHistoryEntry 21 } 369 370-- conformance information 371 372ciscoCallHistoryMibConformance OBJECT IDENTIFIER ::= { ciscoCallHistoryMib 2 } 373ciscoCallHistoryMibCompliances OBJECT IDENTIFIER ::= { ciscoCallHistoryMibConformance 1 } 374ciscoCallHistoryMibGroups OBJECT IDENTIFIER ::= { ciscoCallHistoryMibConformance 2 } 375 376 377-- compliance statements 378 379ciscoCallHistoryMibCompliance MODULE-COMPLIANCE 380 STATUS obsolete -- superseded by ciscoCallHistoryMibComplianceRev1 381 DESCRIPTION 382 "The compliance statement for entities which implement 383 the Cisco call History MIB" 384 MODULE -- this module 385 MANDATORY-GROUPS { ciscoCallHistoryMibGroup } 386 ::= { ciscoCallHistoryMibCompliances 1 } 387 388ciscoCallHistoryMibComplianceRev1 MODULE-COMPLIANCE 389 STATUS obsolete -- superseded by ciscoCallHistoryMibComplianceV11R01 390 DESCRIPTION 391 "The compliance statement for entities which implement 392 the Cisco call History MIB" 393 MODULE -- this module 394 MANDATORY-GROUPS { ciscoCallHistoryMibGroupRev1 } 395 ::= { ciscoCallHistoryMibCompliances 2 } 396 397ciscoCallHistoryMibComplianceV11R01 MODULE-COMPLIANCE 398 STATUS obsolete -- superseded by ciscoCallHistoryMibComplianceV11R02 399 DESCRIPTION 400 "The compliance statement for entities which implement 401 the Cisco call History MIB" 402 MODULE -- this module 403 MANDATORY-GROUPS { ciscoCallHistoryMibGroupRev1, 404 ciscoCallHistoryMibGlobalsGroup } 405 ::= { ciscoCallHistoryMibCompliances 3 } 406 407ciscoCallHistoryMibComplianceV11R02 MODULE-COMPLIANCE 408 STATUS current 409 DESCRIPTION 410 "The compliance statement for entities which implement 411 the Cisco call History MIB" 412 MODULE -- this module 413 MANDATORY-GROUPS { ciscoCallHistoryMibGroupRev2, 414 ciscoCallHistoryMibGlobalsGroup } 415 ::= { ciscoCallHistoryMibCompliances 4 } 416 417 418-- units of conformance 419 420ciscoCallHistoryMibGroup OBJECT-GROUP 421 OBJECTS { 422 ciscoCallHistoryCallingNumber, 423 ciscoCallHistoryCalledNumber, 424 ciscoCallHistoryInterfaceNumber, 425 ciscoCallHistoryDestinationAddress, 426 ciscoCallHistoryDestinationHostName, 427 ciscoCallHistoryCallDisconnectCause, 428 ciscoCallHistoryCallConnectionTime, 429 ciscoCallHistoryCallDisconnectTime 430 } 431 STATUS obsolete -- superseded by ciscoCallHistoryMibGroupRev1 432 DESCRIPTION 433 "A collection of objects providing the call History MIB capability." 434 ::= { ciscoCallHistoryMibGroups 1 } 435 436ciscoCallHistoryMibGroupRev1 OBJECT-GROUP 437 OBJECTS { 438 ciscoCallHistoryCallingNumber, 439 ciscoCallHistoryCalledNumber, 440 ciscoCallHistoryInterfaceNumber, 441 ciscoCallHistoryDestinationAddress, 442 ciscoCallHistoryDestinationHostName, 443 ciscoCallHistoryCallDisconnectCause, 444 ciscoCallHistoryCallConnectionTime, 445 ciscoCallHistoryCallDisconnectTime, 446 ciscoCallHistoryDialReason, 447 ciscoCallHistoryConnectTimeOfDay, 448 ciscoCallHistoryDisconnectTimeOfDay, 449 ciscoCallHistoryTransmitPackets, 450 ciscoCallHistoryTransmitBytes, 451 ciscoCallHistoryReceivePackets, 452 ciscoCallHistoryReceiveBytes 453 } 454 STATUS obsolete -- superseded by ciscoCallHistoryMibGroupRev2 455 DESCRIPTION 456 "A collection of objects providing the call History MIB capability." 457 ::= { ciscoCallHistoryMibGroups 2 } 458 459ciscoCallHistoryMibGroupRev2 OBJECT-GROUP 460 OBJECTS { 461 ciscoCallHistoryCallingNumber, 462 ciscoCallHistoryCalledNumber, 463 ciscoCallHistoryInterfaceNumber, 464 ciscoCallHistoryDestinationAddress, 465 ciscoCallHistoryDestinationHostName, 466 ciscoCallHistoryCallDisconnectCause, 467 ciscoCallHistoryCallConnectionTime, 468 ciscoCallHistoryCallDisconnectTime, 469 ciscoCallHistoryDialReason, 470 ciscoCallHistoryConnectTimeOfDay, 471 ciscoCallHistoryDisconnectTimeOfDay, 472 ciscoCallHistoryTransmitPackets, 473 ciscoCallHistoryTransmitBytes, 474 ciscoCallHistoryReceivePackets, 475 ciscoCallHistoryReceiveBytes, 476 ciscoCallHistoryRecordedUnits, 477 ciscoCallHistoryCurrency, 478 ciscoCallHistoryCurrencyAmount, 479 ciscoCallHistoryMultiplier 480 } 481 STATUS current 482 DESCRIPTION 483 "A collection of objects providing the call History MIB capability." 484 ::= { ciscoCallHistoryMibGroups 3 } 485 486ciscoCallHistoryMibGlobalsGroup OBJECT-GROUP 487 OBJECTS { 488 ciscoCallHistoryTableMaxLength, 489 ciscoCallHistoryRetainTimer 490 } 491 STATUS current 492 DESCRIPTION 493 "A collection of objects providing control over the retention 494 of call History." 495 ::= { ciscoCallHistoryMibGroups 4 } 496 497END 498 499