HCNUM-TC.txt 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
  1. HCNUM-TC DEFINITIONS ::= BEGIN
  2. IMPORTS
  3. MODULE-IDENTITY, mib-2, Counter64
  4. FROM SNMPv2-SMI
  5. TEXTUAL-CONVENTION
  6. FROM SNMPv2-TC;
  7. hcnumTC MODULE-IDENTITY
  8. LAST-UPDATED "200006080000Z"
  9. ORGANIZATION "IETF OPS Area"
  10. CONTACT-INFO
  11. " E-mail: mibs@ops.ietf.org
  12. Subscribe: majordomo@psg.com
  13. with msg body: subscribe mibs
  14. Andy Bierman
  15. Cisco Systems Inc.
  16. 170 West Tasman Drive
  17. San Jose, CA 95134 USA
  18. +1 408-527-3711
  19. abierman@cisco.com
  20. Keith McCloghrie
  21. Cisco Systems Inc.
  22. 170 West Tasman Drive
  23. San Jose, CA 95134 USA
  24. +1 408-526-5260
  25. kzm@cisco.com
  26. Randy Presuhn
  27. BMC Software, Inc.
  28. Office 1-3141
  29. 2141 North First Street
  30. San Jose, California 95131 USA
  31. +1 408 546-1006
  32. rpresuhn@bmc.com"
  33. DESCRIPTION
  34. "A MIB module containing textual conventions
  35. for high capacity data types. This module
  36. addresses an immediate need for data types not directly
  37. supported in the SMIv2. This short-term solution
  38. is meant to be deprecated as a long-term solution
  39. is deployed."
  40. REVISION "200006080000Z"
  41. DESCRIPTION
  42. "Initial Version of the High Capacity Numbers
  43. MIB module, published as RFC 2856."
  44. ::= { mib-2 78 }
  45. CounterBasedGauge64 ::= TEXTUAL-CONVENTION
  46. STATUS current
  47. DESCRIPTION
  48. "The CounterBasedGauge64 type represents a non-negative
  49. integer, which may increase or decrease, but shall never
  50. exceed a maximum value, nor fall below a minimum value. The
  51. maximum value can not be greater than 2^64-1
  52. (18446744073709551615 decimal), and the minimum value can
  53. not be smaller than 0. The value of a CounterBasedGauge64
  54. has its maximum value whenever the information being modeled
  55. is greater than or equal to its maximum value, and has its
  56. minimum value whenever the information being modeled is
  57. smaller than or equal to its minimum value. If the
  58. information being modeled subsequently decreases below
  59. (increases above) the maximum (minimum) value, the
  60. CounterBasedGauge64 also decreases (increases).
  61. Note that this TC is not strictly supported in SMIv2,
  62. because the 'always increasing' and 'counter wrap' semantics
  63. associated with the Counter64 base type are not preserved.
  64. It is possible that management applications which rely
  65. solely upon the (Counter64) ASN.1 tag to determine object
  66. semantics will mistakenly operate upon objects of this type
  67. as they would for Counter64 objects.
  68. This textual convention represents a limited and short-term
  69. solution, and may be deprecated as a long term solution is
  70. defined and deployed to replace it."
  71. SYNTAX Counter64
  72. ZeroBasedCounter64 ::= TEXTUAL-CONVENTION
  73. STATUS current
  74. DESCRIPTION
  75. "This TC describes an object which counts events with the
  76. following semantics: objects of this type will be set to
  77. zero(0) on creation and will thereafter count appropriate
  78. events, wrapping back to zero(0) when the value 2^64 is
  79. reached.
  80. Provided that an application discovers the new object within
  81. the minimum time to wrap it can use the initial value as a
  82. delta since it last polled the table of which this object is
  83. part. It is important for a management station to be aware
  84. of this minimum time and the actual time between polls, and
  85. to discard data if the actual time is too long or there is
  86. no defined minimum time.
  87. Typically this TC is used in tables where the INDEX space is
  88. constantly changing and/or the TimeFilter mechanism is in
  89. use.
  90. Note that this textual convention does not retain all the
  91. semantics of the Counter64 base type. Specifically, a
  92. Counter64 has an arbitrary initial value, but objects
  93. defined with this TC are required to start at the value
  94. zero. This behavior is not likely to have any adverse
  95. effects on management applications which are expecting
  96. Counter64 semantics.
  97. This textual convention represents a limited and short-term
  98. solution, and may be deprecated as a long term solution is
  99. defined and deployed to replace it."
  100. SYNTAX Counter64
  101. END