1 kumpf 1.2 // ===================================================================
  2           // Title:       Network Buffers 2.7
  3           // Filename:    Network27_Buffers.mof
  4           // Version:     2.7.0
  5           // Status:      Final
  6           // Date:        March 31, 2003
  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 kumpf 1.2 // 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 kumpf 1.2 // ===================================================================
 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           // ===================================================================
 57            
 58           #pragma Locale ("en_US")
 59           
 60           
 61           // ===================================================================
 62           // BufferPool
 63           // ===================================================================
 64 kumpf 1.2    [Version ("2.6.0"), Description (
 65                 "This class represents the use of buffers by a Queuing"
 66                 "Service. The existence and management of individual buffers "
 67                 "will be modeled in a future release. At the current level "
 68                 "of abstraction, modeling the existence of the BufferPool "
 69                 "is necessary.  Long term, it is not sufficient. \n"
 70                 "\n"
 71                 "In implementations where there are multiple "
 72                 "buffer sizes, an instance of BufferPool should be "
 73                 "defined for each set of buffers with identical or similar "
 74                 "sizes. These instances of buffer pools can then be grouped "
 75                 "together using the CollectedBuffersPool association. \n"
 76                 "\n"
 77                 "Note that this class is derived from CollectionOfMSEs, "
 78                 "and not from Forwarding or ConditioningService. BufferPool "
 79                 "is only a collection of storage, and is NOT a Service.") ]
 80           class CIM_BufferPool : CIM_CollectionOfMSEs {
 81           
 82                   [Key, Override ("CollectionID"), MaxLen (256), 
 83                    Description (
 84                    "This property is defined in the CollectionOfMSEs class, "
 85 kumpf 1.2          "but is overridden here to serve as part of the " 
 86                    "(composite) key that identifies the BufferPool instance.") ]
 87               string CollectionID;
 88           
 89                   [Key, MaxLen (256), Description (
 90                    "CreationClassName indicates the name of the class or the "
 91                    "subclass used in the creation of an instance. When used "
 92                    "with the other key properties of this class, this property "
 93                    "allows all instances of this class and its subclasses to "
 94                    "be uniquely identified.") ]
 95               string CreationClassName;
 96           
 97                   [MaxLen (256), Description (
 98                    "The Name property defines the label by which the object "
 99                    "is known.") ] 
100               string Name;
101           
102                   [Description (
103                    "This property is a 16-bit unsigned integer, and defines "
104                    "the number of bytes in each buffer."),
105                    Units ("Bytes") ]
106 kumpf 1.2     uint16 BufferSize;
107           
108                   [Description (
109                    "This property is a 32-bit unsigned integer, and defines "
110                    "the total number of buffers in the Pool.") ]
111               uint32 TotalBuffers;
112           
113                   [Description (
114                    "This property is a 32-bit unsigned integer, and defines "
115                    "the number of buffers in the Pool that are currently "
116                    "not allocated to any instance of a QueuingService. "
117                    "Buffers allocated to a QueuingService could either be "
118                    "in use (containing packet data), or allocated to a Queue "
119                    "pending the arrival of new packet data.") ]
120               uint32 AvailableBuffers;
121           
122                   [Description (
123                    "This property is a 32-bit unsigned integer, and defines "
124                    "the number of buffers in the Pool that have been "
125                    "simultaneously allocated to multiple instances of "
126                    "QueuingService.") ]
127 kumpf 1.2     uint32 SharedBuffers;
128           };
129           
130           
131           // ==================================================================
132           // CollectedBufferPool
133           // ==================================================================
134              [Association, Aggregation, Version ("2.6.0"), 
135               Description (
136                 "CIM_CollectedBufferPool is an aggregation association "
137                 "representing that a Pool may itself be contained "
138                 "in a 'higher level' Pool.") ]
139           class CIM_CollectedBufferPool : CIM_MemberOfCollection {
140           
141                   [Override("Collection"), Aggregate, 
142                    Description ("The 'higher level' or parent Pool.") ]
143               CIM_BufferPool REF Collection;
144           
145                   [Override("Member"),
146                    Description ("The 'collected' Pool.") ]
147               CIM_BufferPool REF Member;
148 kumpf 1.2 };
149           
150           
151           // ===================================================================
152           // end of file
153           // ===================================================================