1 kumpf 1.2 // ===================================================================
2 // Title: Interoperability MOF Specification 2.7
3 // Filename: CIM_Interop27.mof
4 // Version: 2.7
5 // Status: Final
6 // Date: April 04 2003
7 // ===================================================================
8 // Copyright 2001-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 object classes below are listed in an order that
45 // avoids forward references. Required objects, defined
46 // by other working groups, are omitted.
47 // ==================================================================
48 // 17 Mar 2003 - Version 2.7 Final
49 // CR981 - Remove Experimental Qualifier
50 // Note: Leave Provider Registration classes Experimental in
51 // V2.8
52 // CR957 - Add missing enumeration for ClassInfo
53 // CR956 - Properties in CIM_ObjectManagerCommunicationMechanism
54 // should be arrays.
55 // CR954 - Correct Model Correspondence
56 // CR953 - Add Write to SystemIdentification.IdentificationData
57 // CR926 - Add ObjectManagerCommunicationMechanism.Version
58 // 12 Nov 2002 - Version 2.7.1 Preliminary
59 // CR920 - Remove Key qualifier from the properties,
60 // NamespaceInManager.Antecedent and
61 // CIMOMStatisticalData.Instance since their
62 // superclasses have defined keys
63 // 23 Sep 2002 - Version 2.7 Preliminary
64 kumpf 1.2 // CR816 - Provider Registration
65 // CR838 - Add class to collect CIMOM statistical data
66 // CR856 - Protocol Adapter Model
67 // CR858 - Correct subclassing of ProviderInModule
68 // CR859 - Add Key qualifier to ProviderModule.Name
69 // (Correcting CR816)
70 // CR890 - Corrections to CommMechanismForAdapter
71 // 09 May 2002 - Version 2.6 Final
72 // ==================================================================
73
74 #pragma Locale ("en_US")
75
76
77 // ==================================================================
78 // Compile prerequisite: Core and Event MOFs
79 // ==================================================================
80
81
82 // ==================================================================
83 // WBEMService
84 // ==================================================================
85 kumpf 1.2 [Abstract, Version ("2.6.0"), Description (
86 "An abstract class for WBEM services such as the "
87 "ObjectManager (CIM Server), Providers, protocol adapters, "
88 "or other pluggable components. A type of CIM_Service "
89 "that provides associated capabilities and details about the "
90 "communication capabilities, namespaces, etc. for a specific "
91 "WBEMService.") ]
92 class CIM_WBEMService : CIM_Service {
93 };
94
95
96 // ==================================================================
97 // ObjectManager
98 // ==================================================================
99 [Version ("2.7.0"), Description (
100 "A type of CIM_Service that defines the capabilities of the "
101 "CIM Server in which this ObjectManager class resides. Details "
102 "related to communicating with the ObjectManager, and the "
103 "Manager's basic capabilities, are stored in instances of the "
104 "associated CommunicationMechanism class available through the "
105 "CommMechanismForManager association. It is assumed that "
106 kumpf 1.2 "Basic Read operations must be supported by all "
107 "ObjectManager's in order to retrieve any additional "
108 "detail.") ]
109 class CIM_ObjectManager : CIM_WBEMService {
110
111 [Write, Description (
112 "The GatherStatisticalData property is used to control the "
113 "gathering of statistical data made accessible through the "
114 "CIM_CIMOMStatisticalData objects. If set to true, the "
115 "data is gathered and can be accessed. If false, the "
116 "CIM_CIMOMStatisticalData instance MAY exist but MUST "
117 "show zero values for the counter properties.") ]
118 boolean GatherStatisticalData = true;
119 };
120
121
122 // ==================================================================
123 // ObjectManagerCommunicationMechanism
124 // ==================================================================
125 [Version ("2.7.0"), Description (
126 "The class, ObjectManagerCommunicationMechanism, describes "
127 kumpf 1.2 "access to an ObjectManager. It describes a protocol and "
128 "data encoding that can be used for communication. When all "
129 "instances of this class are enumerated for an ObjectManager "
130 "(using the CommMechanismForManager association), all possible "
131 "protocol and encoding schemes will be known. Also, specific "
132 "capabilities (for example, basic read or query) that are "
133 "supported in the protocol/encoding are described - using the "
134 "ProfilesSupported property.") ]
135 class CIM_ObjectManagerCommunicationMechanism : CIM_ServiceAccessPoint {
136
137 [Required, Description (
138 "CommunicationMechanism describes an encoding and protocol "
139 "which can be used to communicate with the ObjectManager. "
140 "At this time, only one encoding and protocol are standardized "
141 "by the DMTF - 2 \"CIM-XML\". If this is supported by an "
142 "ObjectManager, the specified value should be indicated. In the "
143 "future, other 'standard' mechanisms may be defined. In addition, "
144 "a vendor specific encoding/protocol value may be specified by "
145 "using the value 1, \"Other\", and defining the mechanism in the "
146 "OtherComminicationMechanismDescription property."),
147 ValueMap {"0", "1", "2"},
148 kumpf 1.2 Values {"Unknown", "Other", "CIM-XML"},
149 ModelCorrespondence {
150 "CIM_ObjectManagerCommunicationMechanism."
151 "OtherCommunicationMechanismDescription"} ]
152 uint16 CommunicationMechanism;
153
154 [Description (
155 "A free-form string providing a description of the "
156 "supported encoding and protocol when 1, \"Other\", is "
157 "specified in CommunicationMechanism."),
158 ModelCorrespondence {
159 "CIM_ObjectManagerCommunicationMechanism.CommunicationMechanism"} ]
160 string OtherCommunicationMechanismDescription;
161
162 [Required, Description (
163 "Enumerated array describing the types of operations "
164 "supported by the ObjectManager, using the encoding/protocol "
165 "specified in the property, CommunicationMechanism. "
166 "The enumeration is based on the Functional Profiles defined "
167 "for conformance in the DMTF document, Specification for CIM "
168 "Operations over HTTP."),
169 kumpf 1.2 ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9"},
170 Values {"Unknown", "Other", "Basic Read", "Basic Write",
171 "Schema Manipulation", "Instance Manipulation",
172 "Association Traversal", "Query Execution",
173 "Qualifier Declaration", "Indications"},
174 ArrayType ("Indexed"),
175 ModelCorrespondence {
176 "CIM_ObjectManagerCommunicationMechanism."
177 "FunctionalProfileDescriptions"} ]
178 uint16 FunctionalProfilesSupported[];
179
180 [Description (
181 "Free-form strings providing descriptions of the supported "
182 "operations of the object manager. Entries in the array "
183 "are correlated with those in the ProfilesSupported array. "
184 "An entry in this Descriptions array MUST be provided when "
185 "1, \"Other\", is specified in the ProfilesSupported array."),
186 ArrayType ("Indexed"),
187 ModelCorrespondence {
188 "CIM_ObjectManagerCommunicationMechanism."
189 "FunctionalProfilesSupported"} ]
190 kumpf 1.2 string FunctionalProfileDescriptions[];
191
192 [Required, Description (
193 "Boolean indicating whether the ObjectManager supports "
194 "multiple operation requests (TRUE) or only simple requests "
195 "(FALSE).") ]
196 boolean MultipleOperationsSupported;
197
198 [Required, Description (
199 "Enumerated array describing the types of authentication "
200 "supported by the ObjectManager, using the encoding/protocol. "
201 "specified in the property, CommunicationMEchanism. "
202 "The defined values represent the authentication defined in "
203 "the DMTF document, Specification for CIM Operations over HTTP."),
204 ValueMap {"0", "1", "2", "3", "4"},
205 Values {"Unknown", "Other", "None", "Basic", "Digest"},
206 ArrayType ("Indexed"),
207 ModelCorrespondence {
208 "CIM_ObjectManagerCommunicationMechanism."
209 "AuthenticationMechanismDescriptions"} ]
210 uint16 AuthenticationMechanismsSupported[];
211 kumpf 1.2
212 [Description (
213 "Free-form strings providing descriptions of the "
214 "supported mechanisms. Entries in this array are correlated "
215 "with those in the AuthenticationMechanismsSupported array. "
216 "An entry in this Descriptions array MUST be provided when "
217 "1, \"Other\", is specified in AuthenticationMechanismsSupported."),
218 ArrayType ("Indexed"),
219 ModelCorrespondence {
220 "CIM_ObjectManagerCommunicationMechanism."
221 "AuthenticationMechanismsSupported"} ]
222 string AuthenticationMechanismDescriptions[];
223
224 [Required, Description (
225 "Provides the protocol version for this service "
226 "access point. Version information MUST be in "
227 "the form of M.N, where M is a numeric that describes "
228 "the Major version and N is a numeric that describes "
229 "the minor version.") ]
230 string Version;
231 };
232 kumpf 1.2
233
234 // ==================================================================
235 // CIMXMLCommunicationMechanism
236 // ==================================================================
237 [Version ("2.6.0"), Description (
238 "This class specializes ObjectManagerCommunicationMechanism, "
239 "adding properties specific to the CIM-XML protocol (XML "
240 "encoding and CIM Operations).") ]
241 class CIM_CIMXMLCommunicationMechanism :
242 CIM_ObjectManagerCommunicationMechanism {
243
244 [Override ("CommunicationMechanism"), Required]
245 uint16 CommunicationMechanism = 2;
246
247 [Override ("Version"), Required, Description (
248 "Enumeration describing the CIM-XML protocol version "
249 "supported by the ObjectManager."),
250 ValueMap {"1.0", "1.1", "1.2"} ]
251 string Version;
252
253 kumpf 1.2 [Deprecated {"CIM_CIMXMLCommunicationMechanism.Version"},
254 Required, Description (
255 "Enumeration describing the CIM-XML protocol version "
256 "supported by the ObjectManager. It is deprecated "
257 "in lieu of a more general, inherited property (Version)."),
258 ValueMap {"0", "1"},
259 Values {"Unknown", "1.0"} ]
260 uint16 CIMXMLProtocolVersion;
261
262 [Required, Description (
263 "Describes whether the CIM Server is strictly validating "
264 "(validates the XML document against the DTD) or not "
265 "(loosely validating).") ]
266 boolean CIMValidated;
267 };
268
269
270 // ==================================================================
271 // CommMechanismForManager
272 // ==================================================================
273 [Association, Version ("2.6.0"), Description (
274 kumpf 1.2 "CommMechanismForManager is an association between an "
275 "ObjectManager and an ObjectManagerCommunicationMechanism "
276 "class. The latter describes a possible encoding/protocol/"
277 "set of operations for accessing the referenced "
278 "ObjectManager.") ]
279 class CIM_CommMechanismForManager : CIM_ServiceAccessBySAP {
280
281 [Override ("Antecedent"), Min (1), Max (1), Description (
282 "The specific ObjectManager whose communication mechanism "
283 "is described.") ]
284 CIM_ObjectManager REF Antecedent;
285
286 [Override ("Dependent"), Min (1), Description (
287 "The encoding/protocol/set of operations that may be used "
288 "to communicate with the referenced ObjectManager.") ]
289 CIM_ObjectManagerCommunicationMechanism REF Dependent;
290 };
291
292
293
294 // ==================================================================
295 kumpf 1.2 // ProtocolAdapter
296 // ==================================================================
297 [Version ("2.7.0"), Description (
298 "A ProtocolAdapter is a Service of the CIM Object Manager. It "
299 "is responsible for accepting incoming requests on a particular "
300 "protocol, and translating and forwarding the request to the CIM "
301 "Object Manager. It is also responsible for translating and "
302 "sending the response from the CIM Object Manager.") ]
303 class CIM_ProtocolAdapter : CIM_WBEMService {
304
305 [Override ("Name"), Description (
306 "A human-readable name that uniquely identifies the Protocol"
307 "Adapter within a system.") ]
308 string Name;
309
310 [Required, Description (
311 "An implementation specific string that identifies the "
312 "handle to the ProtocolAdapter.") ]
313 string Handle;
314
315 [Required, Description (
316 kumpf 1.2 "ProtocolAdapterType enumerates the kind of Protocol"
317 "Adapter."),
318 ValueMap {"1", "2", "3"},
319 Values {"Other", "Client", "Provider"},
320 ModelCorrespondence {
321 "CIM_ProtocolAdapter.OtherProtocolAdapterType"} ]
322 uint16 ProtocolAdapterType;
323
324 [Description (
325 "The type(s) of ProtocolAdapter when \"Other\" is included "
326 "in ProtocolAdapterType property."),
327 ModelCorrespondence {
328 "CIM_ProtocolAdapter.ProtocolAdapterType"} ]
329 string OtherProtocolAdapterType;
330 };
331
332
333 // ==================================================================
334 // CommMechanismForAdapter
335 // ==================================================================
336 [Association, Version ("2.7.0"), Description (
337 kumpf 1.2 "CommMechanismForAdapter is an association between an "
338 "ObjectManager's communication mechanism and a ProtocolAdapter "
339 "that supports that mechanism to translate requests and "
340 "responses for the Object Manager.") ]
341 class CIM_CommMechanismForAdapter : CIM_Dependency {
342
343 [Override ("Antecedent"), Description (
344 "The specific ProtocolAdapter whose communication mechanism "
345 "with the CIM Object Manager is described.") ]
346 CIM_ProtocolAdapter REF Antecedent;
347
348 [Override ("Dependent"), Min (1), Description (
349 "The encoding/protocol/set of operations that may be used "
350 "to communicate between the Object Manager and the "
351 "referenced ProtocolAdapter.") ]
352 CIM_ObjectManagerCommunicationMechanism REF Dependent;
353 };
354
355
356 // ==================================================================
357 // Namespace
358 kumpf 1.2 // ==================================================================
359 [Version ("2.6.0"), Description (
360 "Namespace provides a domain (in other words, a container), "
361 "in which the instances [of a class] are guaranteed to be "
362 "unique per the KEY qualifier definitions. It is named "
363 "relative to the CIM_ObjectManager implementation that "
364 "provides such a domain.") ]
365 class CIM_Namespace : CIM_ManagedElement {
366
367 [Propagated("CIM_ObjectManager.SystemCreationClassName"), Key,
368 MaxLen (256), Description (
369 "The scoping System's CreationClassName.") ]
370 string SystemCreationClassName;
371
372 [Propagated("CIM_ObjectManager.SystemName"), Key, MaxLen (256),
373 Description ("The scoping System's Name.") ]
374 string SystemName;
375
376 [Propagated ("CIM_ObjectManager.CreationClassName"), Key,
377 MaxLen (256), Description (
378 "The scoping ObjectManager's CreationClassName.") ]
379 kumpf 1.2 string ObjectManagerCreationClassName;
380
381 [Propagated ("CIM_ObjectManager.Name"), Key, MaxLen (256),
382 Description ("The scoping ObjectManager's Name.") ]
383 string ObjectManagerName;
384
385 [Key, MaxLen (256), Description (
386 "CreationClassName indicates the name of the class or the "
387 "subclass used in the creation of an instance. When used "
388 "with the other key properties of this class, this property "
389 "allows all instances of this class and its subclasses to "
390 "be uniquely identified.") ]
391 string CreationClassName;
392
393 [Key, MaxLen (256), Description (
394 "A string to uniquely identify the Namespace within "
395 "the ObjectManager.") ]
396 string Name;
397
398 [Required, Write, Description (
399 "Enumeration indicating the organization/schema of the "
400 kumpf 1.2 "Namespace's objects. For example, they may be instances "
401 "of classes of a specific CIM version."),
402 ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
403 "10", "200", "201", "202"},
404 Values {"Unknown", "Other", "CIM 1.0", "CIM 2.0",
405 "CIM 2.1", "CIM 2.2", "CIM 2.3", "CIM 2.4", "CIM 2.5",
406 "CIM 2.6", "CIM 2.7", "DMI Recast", "SNMP Recast",
407 "CMIP Recast"},
408 ModelCorrespondence {"CIM_Namespace.DescriptionOfClassInfo"} ]
409 uint16 ClassInfo;
410
411 [Write, Description (
412 "A string providing more detail (beyond the general "
413 "classification in ClassInfo) for the object hierarchy of "
414 "the Namespace."),
415 ModelCorrespondence {"CIM_Namespace.ClassInfo"} ]
416 string DescriptionOfClassInfo;
417 };
418
419
420 // ==================================================================
421 kumpf 1.2 // SystemIdentification
422 // ==================================================================
423 [Version ("2.7.0"), Description (
424 "A Namespace may represent data for one or many systems, "
425 "that are local, remote (different than the system on which "
426 "the ObjectManager is running) or aggregated. The System"
427 "Identification class provides enough data to identify the "
428 "system(s) represented in the Namespace. It is weak to "
429 "the Namespace.") ]
430 class CIM_SystemIdentification : CIM_ManagedElement {
431
432 [Propagated("CIM_Namespace.SystemCreationClassName"),Key,
433 MaxLen (256), Description (
434 "The scoping System's CreationClassName.") ]
435 string SystemCreationClassName;
436
437 [Propagated("CIM_Namespace.SystemName"), Key, MaxLen (256),
438 Description ("The scoping System's Name.") ]
439 string SystemName;
440
441 [Propagated ("CIM_Namespace.ObjectManagerCreationClassName"),
442 kumpf 1.2 Key, MaxLen (256), Description (
443 "The scoping ObjectManager's CreationClassName.") ]
444 string ObjectManagerCreationClassName;
445
446 [Propagated ("CIM_Namespace.ObjectManagerName"), Key,
447 MaxLen (256), Description (
448 "The scoping ObjectManager's Name.") ]
449 string ObjectManagerName;
450
451 [Propagated ("CIM_Namespace.CreationClassName"), Key,
452 MaxLen (256), Description (
453 "The scoping Namespace's CreationClassName.") ]
454 string NamespaceCreationClassName;
455
456 [Propagated ("CIM_Namespace.Name"), Key, MaxLen (256),
457 Description ("The scoping Namespace's Name.") ]
458 string NamespaceName;
459
460 [Key, MaxLen (256), Description (
461 "CreationClassName indicates the name of the class or the "
462 "subclass used in the creation of an instance. When used "
463 kumpf 1.2 "with the other key properties of this class, this property "
464 "allows all instances of this class and its subclasses to "
465 "be uniquely identified.") ]
466 string CreationClassName;
467
468 [Key, MaxLen (256), Description (
469 "A string uniquely identifying the name of the system "
470 "represented in the Namespace.") ]
471 string Name;
472
473 [Required, Write, Description (
474 "Enumeration indicating the format of the system "
475 "identification and/or addressing information."),
476 ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
477 "10", "11"},
478 Values {"Unknown", "Other", "Short DNS Name",
479 "Fully qualified DNS Name",
480 "Windows Domain Name", "NetWare Server Name",
481 "Unix Hostname", "Globally Unique System Identifier",
482 "IP Address", "Modem Dialup String", "MAC Address",
483 "IPMI Address" },
484 kumpf 1.2 ArrayType ("Indexed"),
485 ModelCorrespondence {
486 "CIM_SystemIdentification.IdentificationData",
487 "CIM_SystemIdentification.FormatDescriptions"} ]
488 uint16 IdentificationFormats[];
489
490 [Write, Description (
491 "Strings further describing the format of the system "
492 "identification information."),
493 ArrayType ("Indexed"),
494 ModelCorrespondence {
495 "CIM_SystemIdentification.IdentificationFormats",
496 "CIM_SystemIdentification.IdentificationData"} ]
497 string FormatDescriptions[];
498
499 [Write, Description (
500 "Strings containing the system identification information. "
501 "The format is described by the corresponding array item in "
502 "IdentificationFormats."),
503 ArrayType ("Indexed"),
504 ModelCorrespondence {
505 kumpf 1.2 "CIM_SystemIdentification.IdentificationFormats",
506 "CIM_SystemIdentification.FormatDescriptions"} ]
507 string IdentificationData[];
508 };
509
510
511 // ==================================================================
512 // NamespaceInManager
513 // ==================================================================
514 [Association, Version ("2.7.0"), Description (
515 "NamespaceInManager is an association describing the "
516 "Namespaces hosted by a CIM ObjectManager.") ]
517 class CIM_NamespaceInManager : CIM_Dependency {
518
519 [Override ("Antecedent"), Min (1), Max (1), Description (
520 "The ObjectManager containing a Namespace.") ]
521 CIM_ObjectManager REF Antecedent;
522
523 [Override ("Dependent"), Weak, Description (
524 "The Namespace in an ObjectManager.") ]
525 CIM_Namespace REF Dependent;
526 kumpf 1.2 };
527
528
529 // ==================================================================
530 // SystemInNamespace
531 // ==================================================================
532 [Association, Version ("2.6.0"), Description (
533 "SystemInNamespace is an association that allows enumeration "
534 "of the system(s) represented in a Namespace.") ]
535 class CIM_SystemInNamespace {
536
537 [Key, Min (1), Max (1), Description (
538 "The Namespace containing management objects from "
539 "one or more systems.") ]
540 CIM_Namespace REF ManagedNamespace;
541
542 [Key, Weak, Description (
543 "Identification information for systems in the Namespace.") ]
544 CIM_SystemIdentification REF Identification;
545
546 [Required, Write, Description (
547 kumpf 1.2 "A list of enumerated values providing a high level "
548 "description of the data contained and allowed in the "
549 "Namespace. Additional clarification is provided in the "
550 "DescriptionOfContainedData array."),
551 ArrayType ("Indexed"),
552 ValueMap {"0", "1", "2", "3", "4"},
553 Values {"Unknown", "Other", "Local System Data",
554 "Data Aggregated from Multiple Systems",
555 "Proxied Data"},
556 ModelCorrespondence {
557 "CIM_SystemInNamespace.DescriptionOfContainedData"} ]
558 uint16 ScopeOfContainedData[];
559
560 [Write, Description (
561 "An array of free-form strings providing more detailed "
562 "explanations for the data/objects contained in the "
563 "Namespace, as described by the ContainedData array. "
564 "Note, each entry of this array is related to the entry "
565 "in the ContainedData array that is located at the same "
566 "index."),
567 ArrayType ("Indexed"),
568 kumpf 1.2 ModelCorrespondence {
569 "CIM_SystemInNamespace.ScopeOfContainedData"} ]
570 string DescriptionOfContainedData[];
571 };
572
573
574 // ==================================================================
575 // IdentificationOfManagedSystem
576 // ==================================================================
577 [Association, Version ("2.6.0"), Description (
578 "IdentificationOfManagedSystem is an association that "
579 "links the SystemIdentification object to the CIM_System(s) "
580 "that are being identified and represented in the "
581 "Namespace.") ]
582 class CIM_IdentificationOfManagedSystem : CIM_Dependency {
583
584 [Override ("Antecedent"), Max (1), Description (
585 "The System which is identified.") ]
586 CIM_System REF Antecedent;
587
588 [Override ("Dependent"), Max (1), Description (
589 kumpf 1.2 "The SystemIdentification information.") ]
590 CIM_SystemIdentification REF Dependent;
591 };
592
593
594 // ==================================================================
595 // CIMOMStatisticalData
596 // ==================================================================
597 [Version ("2.7.0"), Description (
598 "CIM_CIMOMStatisticalData provides statistical data about the "
599 "performance of the CIM Object Manager. Each object of this "
600 "class provides elapsed time and size data for a particular type "
601 "of CIM operation. All operations of that type, "
602 "regardless of the CIM operations protocol being used, are "
603 "accumulated in one object and covers the CIM "
604 "operations issued by all clients of the Object Manager "
605 "scoping the instance. Batched CIM operations are accumulated "
606 "into a separate operation type for \"Batched\". "
607 "The counters in this class SHOULD be implemented such that they "
608 "always increment and naturally wrap around when their numerical "
609 "limit is exceeded. A client that calculates the difference of "
610 kumpf 1.2 "two snapshots of a counter at the beginning and end of a "
611 "measurement interval should get the correct result, even if "
612 "there was a wrap-around in between obtaining the two "
613 "snapshots. (Two or more wrap arounds will result in wrong data "
614 "being calculated.) The gathering of the data can be controlled "
615 "through the property, CIM_ObjectManager.GatherStatisticalData. "
616 "The time interval to which the statistical data applies, "
617 "ends at the current time and therefore includes the most "
618 "current CIM operations. The interval starts when the "
619 "statistical data gathering was last turned on for the Object "
620 "Manager.") ]
621 class CIM_CIMOMStatisticalData : CIM_StatisticalData {
622
623 [Override ("InstanceId"), Description (
624 "The InstanceId property opaquely identifies a unique instance "
625 "of CIMOMStatisticalData and MUST be unique within a namespace. "
626 "In order to ensure uniqueness, the value of InstanceIdD MUST be "
627 "constructed in the following manner: \n"
628 " CIM<ID> \n"
629 "The <ID> MUST include a CIM Object Manager specified unique "
630 "identifier.") ]
631 kumpf 1.2 string InstanceId;
632
633 [Required, Description (
634 "The OperationType property identifies the type of CIM operation "
635 "for which data is reported in this instance. Batched CIM "
636 "operations (consisting of multiple simple CIM operations) are "
637 "reported against the \"Batched\" type only."),
638 ValueMap {"0", "1", "2", "3", "4",
639 "5", "6", "7", "8", "9",
640 "10", "11", "12", "13", "14",
641 "15", "16", "17", "18", "19",
642 "20", "21", "22", "23", "24",
643 "25", "26" },
644 Values {"Unknown", "Other",
645 "Batched", "GetClass",
646 "GetInstance", "DeleteClass",
647 "DeleteInstance", "CreateClass",
648 "CreateInstance", "ModifyClass",
649 // 10
650 "ModifyInstance", "EnumerateClasses",
651 "EnumerateClassNames", "EnumerateInstances",
652 kumpf 1.2 "EnumerateInstanceNames", "ExecQuery",
653 "Associators", "AssociatorNames",
654 "References", "ReferenceNames",
655 // 20
656 "GetProperty", "SetProperty",
657 "GetQualifier", "SetQualifier",
658 "DeleteQualifier", "EnumerateQualifiers",
659 "IndicationDelivery" },
660 ModelCorrespondence {
661 "CIM_CIMOMStatisticalData.OtherOperationType"} ]
662 uint16 OperationType;
663
664 [Description (
665 "The OtherOperationType property identifies the operation "
666 "if the OperationType property has a value of 1 "
667 "(\"Other\"). For all other values of OperationType, "
668 "the property is NULL."),
669 MaxLen (64),
670 ModelCorrespondence {
671 "CIM_CIMOMStatisticalData.OperationType"} ]
672 string OtherOperationType;
673 kumpf 1.2
674 [Required, Description (
675 "The NumberOfOperations property contains the number of CIM "
676 "operations of the specified type. This property can be "
677 "used to calculate average values per CIM operation."),
678 Counter ]
679 uint64 NumberOfOperations;
680
681 [Required, Description (
682 "The CimomElapsedTime property contains the elapsed time spent "
683 "in the CIM Object Manager for this operation type, not "
684 "counting the elapsed time spent in providers and the "
685 "underlying instrumentation. The measurement points for this "
686 "property SHOULD be at the transport layer interface on the "
687 "network side, and at the provider interface on the "
688 "instrumentation side of the CIM Object Manager."),
689 Counter ]
690 datetime CimomElapsedTime;
691
692 [Required, Description (
693 "The ProviderElapsedTime property contains the elapsed time spent "
694 kumpf 1.2 "in all providers involved with this operation type, including "
695 "the underlying instrumentation. The measurement point for this "
696 "property SHOULD be from the provider interface of the "
697 "CIM Object Manager."),
698 Counter ]
699 datetime ProviderElapsedTime;
700
701 [Description (
702 "The RequestSize property contains the size of the operation "
703 "requests sent to the CIM Object Manager. Any overhead "
704 "of protocols above the transport protocol SHOULD be "
705 "included in the count. For example, for the HTTP protocol, "
706 "the size would include the size of the HTTP payload "
707 "and the size of the HTTP headers."),
708 Counter, Units ("Bytes") ]
709 uint64 RequestSize;
710
711 [Description (
712 "The ResponseSize property contains the size of the operation "
713 "responses sent back from the CIM Object Manager. Any "
714 "overhead of protocols above the transport protocol SHOULD "
715 kumpf 1.2 "be included in the count. For example, for the HTTP "
716 "protocol, the size would include the size of the HTTP payload "
717 "and the size of the HTTP headers."),
718 Counter, Units ("Bytes") ]
719 uint64 ResponseSize;
720 };
721
722
723 // ==================================================================
724 // end of file
725 // ==================================================================
|
Return to
CIM_Interop27.mof
CVS log
Up to [Pegasus] / pegasus / Schemas / CIM27