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