1 tony  1.1 // ===================================================================
  2           // Title:       Network Buffers 2.8
  3           // Filename:    Network27_Buffers.mof
  4           // Version:     2.8.0
  5           // Status:      Final
  6           // Date:        Jan 26, 2004
  7           // ===================================================================
  8           // Copyright 1998-2003 Distributed Management Task Force, Inc. (DMTF).
  9           // All rights reserved.
 10           // DMTF is a not-for-profit association of industry members dedicated
 11           // to promoting enterprise and systems management and interoperability.
 12           // DMTF specifications and documents may be reproduced for uses
 13           // consistent with this purpose by members and non-members,
 14           // provided that correct attribution is given.
 15           // As DMTF specifications may be revised from time to time,
 16           // the particular version and release date should always be noted.
 17           // 
 18           // Implementation of certain elements of this standard or proposed
 19           // standard may be subject to third party patent rights, including
 20           // provisional patent rights (herein "patent rights"). DMTF makes
 21           // no representations to users of the standard as to the existence
 22 tony  1.1 // of such rights, and is not responsible to recognize, disclose, or
 23           // identify any or all such third party patent right, owners or
 24           // claimants, nor for any incomplete or inaccurate identification or
 25           // disclosure of such rights, owners or claimants. DMTF shall have no
 26           // liability to any party, in any manner or circumstance, under any
 27           // legal theory whatsoever, for failure to recognize, disclose, or
 28           // identify any such third party patent rights, or for such party's
 29           // reliance on the standard or incorporation thereof in its product,
 30           // protocols or testing procedures. DMTF shall have no liability to
 31           // any party implementing such standard, whether such implementation
 32           // is foreseeable or not, nor to any patent owner or claimant, and shall
 33           // have no liability or responsibility for costs or losses incurred if
 34           // a standard is withdrawn or modified after publication, and shall be
 35           // indemnified and held harmless by any party implementing the
 36           // standard from any and all claims of infringement by a patent owner
 37           // for such implementations.
 38           // 
 39           // For information about patents held by third-parties which have
 40           // notified the DMTF that, in their opinion, such patent may relate to
 41           // or impact implementations of DMTF standards, visit
 42           // http://www.dmtf.org/about/policies/disclosures.php.
 43 tony  1.1 // ===================================================================
 44           // Description: The Network Model extends the management concepts to
 45           //              represent protocol interfaces and network/protocol
 46           //              services.  This file defines the classes to manage
 47           //              network buffers.
 48           // 
 49           //              The object classes below are listed in an order that
 50           //              avoids forward references. Required objects, defined
 51           //              by other working groups, are omitted.
 52           // ==================================================================
 53           // Change Log for v2.7
 54           // CR790 - Add classes to support MPLS
 55           // CR982 - MPLS classes remain as Experimental for CIM V2.8
 56           // Change Log for v2.8
 57           // CR1061 - Add MPLSBuffers and MPLSBufferEndpointBuffers classes
 58           // CR1191 - CIM_MPLSBuffers and CIM_MPLSEndpointBuffers remain
 59           // experimental
 60           //          in CIM v2.9
 61           // CR1217 - Deprecate BufferPool.BufferSize in lieu of a larger uint
 62           // definition.
 63           // ===================================================================
 64 tony  1.1 
 65           #pragma Locale ("en_US")
 66           
 67           
 68           // ===================================================================
 69           // BufferPool
 70           // ===================================================================
 71              [Version ( "2.6.0" ), Description (
 72                  "This class represents the use of buffers by a Queuing Service. "
 73                  "The existence and management of individual buffers will be "
 74                  "modeled in a future release. At the current level of "
 75                  "abstraction, modeling the existence of the BufferPool is "
 76                  "necessary. Long term, it is not sufficient. \n"
 77                  "\n"
 78                  "In implementations where there are multiple buffer sizes, an "
 79                  "instance of BufferPool should be defined for each set of "
 80                  "buffers with identical or similar sizes. These instances of "
 81                  "buffer pools can then be grouped together using the "
 82                  "CollectedBuffersPool association. \n"
 83                  "\n"
 84                  "Note that this class is derived from CollectionOfMSEs, and not "
 85 tony  1.1        "from Forwarding or ConditioningService. BufferPool is only a "
 86                  "collection of storage, and is NOT a Service.")]
 87           class CIM_BufferPool : CIM_CollectionOfMSEs {
 88           
 89                 [Key, Override ( "CollectionID" ), Description (
 90                     "This property is defined in the CollectionOfMSEs class, but "
 91                     "is overridden here to serve as part of the (composite) key "
 92                     "that identifies the BufferPool instance."), 
 93                  MaxLen ( 256 )]
 94              string CollectionID;
 95           
 96                 [Key, Description (
 97                     "CreationClassName indicates the name of the class or the "
 98                     "subclass used in the creation of an instance. When used "
 99                     "with the other key properties of this class, this property "
100                     "allows all instances of this class and its subclasses to be "
101                     "uniquely identified."), 
102                  MaxLen ( 256 )]
103              string CreationClassName;
104           
105                 [Description (
106 tony  1.1           "The Name property defines the label by which the object is "
107                     "known."), 
108                  MaxLen ( 256 )]
109              string Name;
110           
111                 [Deprecated { "CIM_BufferPool.SizeOfBuffers" }, Description (
112                     "This property is a 16-bit unsigned integer, and defines the "
113                     "number of bytes in each buffer. It is deprecated in lieu of "
114                     "a similar uint32 property."), 
115                  Units ( "Bytes" )]
116              uint16 BufferSize;
117           
118           
119                 [Description (
120                     "This property is a 32-bit unsigned integer, and defines the "
121                     "number of bytes in each buffer."), 
122                  Units ( "Bytes" )]
123              uint32 SizeOfBuffers;
124           
125           
126                 [Description (
127 tony  1.1           "This property is a 32-bit unsigned integer, and defines the "
128                     "total number of buffers in the Pool.")]
129              uint32 TotalBuffers;
130           
131                 [Description (
132                     "This property is a 32-bit unsigned integer, and defines the "
133                     "number of buffers in the Pool that are currently not "
134                     "allocated to any instance of a QueuingService. Buffers "
135                     "allocated to a QueuingService could either be in use "
136                     "(containing packet data), or allocated to a Queue pending "
137                     "the arrival of new packet data.")]
138              uint32 AvailableBuffers;
139           
140                 [Description (
141                     "This property is a 32-bit unsigned integer, and defines the "
142                     "number of buffers in the Pool that have been simultaneously "
143                     "allocated to multiple instances of QueuingService.")]
144              uint32 SharedBuffers;
145           };
146           
147           
148 tony  1.1 // ==================================================================
149           // CollectedBufferPool
150           // ==================================================================
151              [Association, Aggregation, Version ( "2.6.0" ), Description (
152                  "CIM_CollectedBufferPool is an aggregation association "
153                  "representing that a Pool may itself be contained in a 'higher "
154                  "level' Pool.")]
155           class CIM_CollectedBufferPool : CIM_MemberOfCollection {
156           
157                 [Aggregate, Override ( "Collection" ), Description (
158                     "The 'higher level' or parent Pool.")]
159              CIM_BufferPool REF Collection;
160           
161                 [Override ( "Member" ), Description (
162                     "The 'collected' Pool.")]
163              CIM_BufferPool REF Member;
164           };
165           
166           
167           // ===================================================================
168           // end of file
169 tony  1.1 // ===================================================================