1 karl 1.2 //====================================================================
2 // Title: Event MOF Specification 2.6
3 // Filename: CIM_Event26.mof
4 // Version: 2.6.0
5 // Status: Final
6 // Date: 06/04/2002
7 // ===================================================================
8 // Copyright 2001-2002 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 karl 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 karl 1.2 // ===================================================================
44 // Description: The Event Model describes types of notifications,
45 // whether generic (such as InstanceModification) or
46 // instrumentation-specific (such as AlertIndication).
47 // The model also defines classes to subscribe to/filter
48 // indications and describe their delivery.
49 //
50 // The object classes below are listed in an order that
51 // avoids forward references. Required objects, defined
52 // by other working groups, are omitted.
53 // ===================================================================
54 // 03/22/2002 - Correct naming of the class CIM_IndicationHandlerCIM-XML
55 // to remove the dash (CR619).
56 // 03/12/2002 - Add Version Qualifier to all classes (CR746).
57 // 05/23/2001 - v2.6 Change name of IndicationHandlerXMLHTTP to
58 // IndicationHandlerCIMXML to reflect DMTF naming
59 // convention; CIM-XML denotes XML encoded CIM
60 // operations over HTTP.
61 // ===================================================================
62
63 // ===================================================================
64 karl 1.2 // Pragmas
65 // ===================================================================
66 #pragma locale ("en_US")
67
68
69 //====================================================================
70 // CIM_Indication
71 //====================================================================
72 [Indication, Abstract, Version("2.6.0"),
73 Description (
74 "CIM_Indication is the abstract root class for all notifications "
75 "about changes in schema, objects and their data, and about "
76 "events detected by providers and instrumentation. Subclasses "
77 "represent specific types of notifications. \n"
78 "\n"
79 "To receive an Indication, a consumer (or subscriber) must create "
80 "an instance of CIM_IndicationFilter describing the criteria of "
81 "the notification, an instance of CIM_IndicationHandler describing "
82 "the delivery of the notification, and an instance of "
83 "CIM_IndicationSubscription associating the Filter and Handler.") ]
84 class CIM_Indication {
85 karl 1.2 [Description (
86 "The time and date of creation of the Indication. The property "
87 "may be set to NULL if the entity creating the Indication is "
88 "not capable of determing this information. Note that "
89 "IndicationTime may be the same for two Indications that are "
90 "generated in rapid succession.") ]
91 datetime IndicationTime;
92 };
93
94
95 //====================================================================
96 // CIM_ClassIndication
97 //====================================================================
98 [Indication, Abstract, Version("2.6.0"),
99 Description (
100 "CIM_ClassIndication is an abstract superclass describing changes "
101 "in the definition of the schema. Subclasses represent specific "
102 "types of change notifications, such as class creation, deletion "
103 "and modification.") ]
104 class CIM_ClassIndication : CIM_Indication {
105 [EmbeddedObject, Required,
106 karl 1.2 Description (
107 "The current definition of the class that is created, changed "
108 "or deleted in the schema. In the case of a CIM_ClassDeletion "
109 "Indication, the definition for the class just prior to "
110 "deletion should be placed in this property.") ]
111 string ClassDefinition;
112 };
113
114
115 //====================================================================
116 // CIM_ClassCreation
117 //====================================================================
118 [Indication, Version("2.6.0"),
119 Description (
120 "CIM_ClassCreation notifies when a new class is defined in the "
121 "schema.") ]
122 class CIM_ClassCreation : CIM_ClassIndication {
123 };
124
125
126 //====================================================================
127 karl 1.2 // CIM_ClassDeletion
128 //====================================================================
129 [Indication, Version("2.6.0"),
130 Description (
131 "CIM_ClassDeletion notifies when a class is deleted from the "
132 "schema.") ]
133 class CIM_ClassDeletion : CIM_ClassIndication {
134 };
135
136
137 //====================================================================
138 // CIM_ClassModification
139 //====================================================================
140 [Indication, Version("2.6.0"),
141 Description (
142 "CIM_ClassModification notifies when a class definition in the "
143 "schema is modified.") ]
144 class CIM_ClassModification : CIM_ClassIndication {
145 [EmbeddedObject, Required,
146 Description (
147 "A copy of the 'previous' class definition whose change "
148 karl 1.2 "generated the Indication. PreviousClassDefinition contains "
149 "an 'older' copy of the class' information, as compared to "
150 "what is found in the ClassDefinition property (inherited "
151 "from ClassIndication).") ]
152 string PreviousClassDefinition;
153 };
154
155
156 //====================================================================
157 // CIM_InstIndication
158 //====================================================================
159 [Indication, Abstract, Version("2.6.0"),
160 Description (
161 "CIM_InstIndication is an abstract superclass describing changes "
162 "to instances. Subclasses represent specific types of change "
163 "notifications, such as instance creation, deletion and "
164 "modification.") ]
165 class CIM_InstIndication : CIM_Indication {
166 [EmbeddedObject, Required,
167 Description (
168 "A copy of the instance that changed to generate the "
169 karl 1.2 "Indication. SourceInstance contains the current values of "
170 "the properties selected by the Indication"
171 "Filter's Query. In the case of CIM_InstDeletion, "
172 "the property values are copied before the instance is "
173 "deleted.") ]
174 string SourceInstance;
175 };
176
177
178 //====================================================================
179 // CIM_InstCreation
180 //====================================================================
181 [Indication, Version("2.6.0"),
182 Description (
183 "CIM_InstCreation notifies when a new instance is created.") ]
184 class CIM_InstCreation : CIM_InstIndication {
185 };
186
187
188 //====================================================================
189 // CIM_InstDeletion
190 karl 1.2 //====================================================================
191 [Indication, Version("2.6.0"),
192 Description (
193 "CIM_InstDeletion notifies when an existing instance is deleted.") ]
194 class CIM_InstDeletion : CIM_InstIndication {
195 };
196
197
198 //====================================================================
199 // CIM_InstModification
200 //====================================================================
201 [Indication, Version("2.6.0"),
202 Description (
203 "CIM_InstModification notifies when an instance is modified.") ]
204 class CIM_InstModification : CIM_InstIndication {
205 [EmbeddedObject, Required,
206 Description (
207 "A copy of the 'previous' instance whose change generated the "
208 "Indication. PreviousInstance contains 'older' values of "
209 "an instance's properties (as compared to SourceInstance), "
210 "selected by the IndicationFilter's Query.") ]
211 karl 1.2 string PreviousInstance;
212 };
213
214
215 //====================================================================
216 // CIM_InstMethodCall
217 //====================================================================
218 [Indication, Version("2.6.0"),
219 Description (
220 "CIM_InstMethodCall notifies when an instance's method is "
221 "invoked.") ]
222 class CIM_InstMethodCall : CIM_InstIndication {
223 [Required, Description (
224 "The name of the method invoked.") ]
225 string MethodName;
226
227 [EmbeddedObject, Description (
228 "The parameters of the method, formatted as an "
229 "EmbeddedObject (with a predefined class name of "
230 "\"__MethodParameters\".") ]
231 string MethodParameters;
232 karl 1.2
233 [Description (
234 "ReturnValue's data is dependent on the PreCall property. "
235 "When PreCall is TRUE, this property is NULL describing that "
236 "there is no method return value (since the method has not yet "
237 "executed). When PreCall is FALSE, ReturnValue contains a "
238 "string representation of the method's return value."),
239 ModelCorrespondence {"CIM_InstMethodCall.PreCall"} ]
240 string ReturnValue;
241
242 [Required, Description (
243 "Boolean indicating whether the Indication is sent before "
244 "the method begins executing (TRUE) or when the method "
245 "completes (FALSE). When TRUE, the inherited property "
246 "SourceInstance contains the value of the instance (the "
247 "properties defined by the Filter's Query clause), "
248 "before execution of the method. When PreCall is FALSE, "
249 "SourceInstance embeds the instance as it appears after "
250 "the completion of the method.") ]
251 boolean PreCall;
252 };
253 karl 1.2
254
255 //====================================================================
256 // CIM_InstRead
257 //====================================================================
258 [Indication, Version("2.6.0"),
259 Description (
260 "CIM_InstRead notifies when an instance is read but not "
261 "modified.") ]
262 class CIM_InstRead : CIM_InstIndication {
263 };
264
265
266 //====================================================================
267 // CIM_ProcessIndication
268 //====================================================================
269 [Indication, Abstract, Version("2.6.0"),
270 Description (
271 "An abstract superclass for specialized Indication classes, "
272 "addressing specific changes and alerts published by providers "
273 "and instrumentation. Subclasses include AlertIndication (with "
274 karl 1.2 "properties such as PerceivedSeverity and ProbableCause), and "
275 "SNMPTrapIndication (which recasts Traps as CIM indications).") ]
276 class CIM_ProcessIndication : CIM_Indication {
277 };
278
279
280 //====================================================================
281 // CIM_SNMPTrapIndication
282 //====================================================================
283 [Indication, Version("2.6.0"),
284 Description (
285 "A concrete class for mapping an SNMP Trap to CIM based on the "
286 "IETF RFC 1157. The usefulness of this class is to describe "
287 "common trap semantics. But, a complete understanding of any trap "
288 "data received relies on the Indicaton recipient having access to "
289 "the sender's MIB. Understanding can be improved by mapping the "
290 "SNMP domain to CIM, and using CIM LifeCycle and standard "
291 "subclasses of CIM_ProcessIndication.") ]
292 class CIM_SNMPTrapIndication : CIM_ProcessIndication {
293 [Description (
294 "Type of object generating the trap."),
295 karl 1.2 Mappingstrings {"PDU.IETF|RFC1157-TRAP-PDU.enterprise"} ]
296 string Enterprise;
297
298 [Description (
299 "Address of the object generating the trap."),
300 Mappingstrings {"PDU.IETF|RFC1157-TRAP-PDU.agent-addr"} ]
301 string AgentAddress;
302
303 [Description (
304 "An enumerated value that describes the generic trap type: \n"
305 "- The coldStart(0) trap signifies that the sending protocol "
306 "entity is reinitializing itself such that the agent's "
307 "configuration or the protocol entity implementation may be "
308 "altered. \n"
309 "- The warmStart(1) trap signifies that the sending protocol "
310 "entity is reinitializing itself such that neither the agent "
311 "configuration nor the protocol entity implementation is "
312 "altered. \n"
313 "- The linkDown(2) trap signifies that the sending protocol "
314 "recognizes a failure in one of the communication links "
315 "represented in the agent's configuration. The Trap-PDU of "
316 karl 1.2 "type linkDown contains as the first element of its "
317 "variable-bindings the name and value of the ifIndex instance "
318 "for the affected interface. \n"
319 "- The linkUp(3) trap signifies that the sending protocol "
320 "entity recognizes that one of the communication links "
321 "represented in the agent's configuration has come up. The "
322 "Trap-PDU of type linkUp contains as the first element of its "
323 "variable-bindings, the name and value of the ifIndex instance "
324 "for the affected interface. \n"
325 "- An authenticationFailure(4) trap signifies that the sending "
326 "protocol entity is the adressee of a protocol message that was "
327 "not properly authenticated. While implementations of SNMP must "
328 "be capable of generating this trap, they must also be capable "
329 "of suppressing the emission of such traps via an implementation-"
330 "specific mechanism. \n"
331 "- An egpNeighborLoss(5) trap signifies that an EGP neighbor for "
332 "whom the sending protocol entity was an EGP peer has been "
333 "marked as down and the peer relationship no longer pertains. "
334 "The Trap-PDU of type egpNeighborLoss contains as the first "
335 "element of its variable-bindings, the name and value of the "
336 "egpNeighAddr instance for the affected neighbor. \n"
337 karl 1.2 "- An enterpriseSpecific(6) trap signifies that the sending "
338 "protocol entity recognizes that some enterprise-specific "
339 "event has occurred. The specific-trap field identifies the "
340 "particular trap which occurred."),
341 Values {"Cold Start", "Warm Start", "Link Down", "Link Up",
342 "Authentication Failure", "EGP Neighbor Loss",
343 "Enterprise Specific"},
344 Mappingstrings {"PDU.IETF|RFC1157-TRAP-PDU.generic-trap"} ]
345 uint16 GenericTrap;
346
347 [Description ("Specific trap code."),
348 Mappingstrings {"PDU.IETF|RFC1157-TRAP-PDU.specific-trap"} ]
349 uint32 SpecificTrap;
350
351 [Description (
352 "Time elapsed between the last (re)intialization of the "
353 "managed entity and the generation of the trap."),
354 Mappingstrings {"PDU.IETF|RFC1157-TRAP-PDU.time-stamp"} ]
355 datetime TimeStamp;
356
357 [Description (
358 karl 1.2 "Object naming information (an OID) from the 'variable "
359 "binding' portion of the Trap. This array is correlated "
360 "with the VarBindSyntaxes and VarBindValues arrays. Each "
361 "entry is related to the entries in the other arrays, "
362 "that are located at the same index. In this way, the "
363 "variable binding's name/syntax/value tuple can be "
364 "constructed."), ArrayType ("Indexed"),
365 ModelCorrespondence {"CIM_SNMPTrapIndication.VarBindSyntaxes",
366 "CIM_SNMPTrapIndication.VarBindValues"},
367 Mappingstrings {"PDU.IETF|RFC1157-TRAP-PDU.variable-bindings"} ]
368 string VarBindNames[];
369
370 [Description (
371 "Object syntax information (defined as an enumerated value) "
372 "from the 'variable binding' portion of the Trap. This array "
373 "is correlated with the VarBindNames and VarBindValues "
374 "arrays. Each entry is related to the entries in the other "
375 "arrays, that are located at the same index. In this way, "
376 "the variable binding's name/syntax/value tuple can be "
377 "constructed."), ArrayType ("Indexed"),
378 ValueMap {"1", "2", "3", "4", "5", "6", "7", "8"},
379 karl 1.2 Values {"Integer", "OctetString", "ObjectIdentifier",
380 "NetworkAddress", "Counter", "Gauge",
381 "TimeTicks", "Opaque"},
382 ModelCorrespondence {"CIM_SNMPTrapIndication.VarBindNames",
383 "CIM_SNMPTrapIndication.VarBindValues"},
384 Mappingstrings {"PDU.IETF|RFC1157-TRAP-PDU.variable-bindings"} ]
385 uint16 VarBindSyntaxes[];
386
387 [Description (
388 "An OctetString representing object value information "
389 "from the 'variable binding' portion of the Trap. This "
390 "array is correlated with the VarBindNames and "
391 "VarBindSyntaxes arrays. Each entry is related to the "
392 "entries in the other arrays, that are located at the "
393 "same index. In this way, the variable binding's "
394 "name/syntax/value tuple can be constructed."),
395 ArrayType ("Indexed"), OctetString,
396 ModelCorrespondence {"CIM_SNMPTrapIndication.VarBindNames",
397 "CIM_SNMPTrapIndication.VarBindSyntaxes"},
398 Mappingstrings {"PDU.IETF|RFC1157-TRAP-PDU.variable-bindings"} ]
399 string VarBindValues[];
400 karl 1.2 };
401
402
403 //====================================================================
404 // CIM_AlertIndication
405 //====================================================================
406 [Indication, Version("2.6.0"),
407 Description (
408 "A concrete superclass for CIM Alert notifications. An "
409 "AlertIndication is a specialized type of CIM_Indication that "
410 "contains information about the severity, cause, recommended "
411 "actions and other data of a real world event. This event and its "
412 "data may or may not be modeled in the CIM class hierarchy.") ]
413 class CIM_AlertIndication : CIM_ProcessIndication {
414 [Description (
415 "A short description of the Indication."),
416 MappingStrings {"Recommendation.ITU|X733.Additional text"} ]
417 string Description;
418
419 [Description (
420 "The identifying information of the entity (ie, the instance) for "
421 karl 1.2 "which this Indication is generated. The property contains the "
422 "path of an instance, encoded as a string parameter - if the "
423 "instance is modeled in the CIM Schema. If not a CIM instance, "
424 "the property contains some identifying string that names the "
425 "entity for which the Alert is generated.") ]
426 string AlertingManagedElement;
427
428 [Required, Description (
429 "Primary classification of the Indication. The following values "
430 "are defined: \n"
431 "1 - Other. The Indication's OtherAlertType property conveys "
432 "its classification. Use of \"Other\" in an enumeration is a "
433 "standard CIM convention. It means that the current Indication "
434 "does not fit into the categories described by this enumeration. \n"
435 "2 - Communications Alert. An Indication of this type is "
436 "principally associated with the procedures and/or processes "
437 "required to convey information from one point to another. \n"
438 "3 - Quality of Service Alert. An Indication of this type is "
439 "principally associated with a degradation or errors in the "
440 "performance or function of an entity. \n"
441 "4 - Processing Error. An Indication of this type is "
442 karl 1.2 "principally associated with a software or processing fault. \n"
443 "5 - Device Alert. An Indication of this type is principally "
444 "associated with an equipment or hardware fault. \n"
445 "6 - Environmental Alert. An Indication of this type is "
446 "principally associated with a condition relating to an "
447 "enclosure in which the hardware resides, or other "
448 "environmental considerations. \n"
449 "7 - Model Change. The Indication addresses changes in the "
450 "Information Model. For example, it may embed a Lifecycle "
451 "Indication to convey the specific model change being "
452 "alerted. \n"
453 "8 - Security Alert. An Indication of this type is associated "
454 "with security violations, detection of viruses, and similar "
455 "issues."),
456 ValueMap {"1", "2", "3", "4", "5", "6", "7", "8"},
457 Values {"Other", "Communications Alert",
458 "Quality of Service Alert", "Processing Error",
459 "Device Alert", "Environmental Alert", "Model Change",
460 "Security Alert"},
461 MappingStrings {"Recommendation.ITU|X733.Event type"} ]
462 uint16 AlertType;
463 karl 1.2
464 [Description (
465 "A string describing the Alert type - used when the AlertType "
466 "property is set to 1, \"Other State Change\"."),
467 ModelCorrespondence {"CIM_AlertIndication.AlertType"} ]
468 string OtherAlertType;
469
470 [Required, Description (
471 "An enumerated value that describes the severity of the Alert"
472 "Indication from the notifier's point of view: \n"
473 "1 - Other, by CIM convention, is used to indicate that the "
474 "Severity's value can be found in the OtherSeverity property. \n"
475 "3 - Degraded/Warning should be used when its appropriate to let "
476 "the user decide if action is needed. \n"
477 "4 - Minor should be used to indicate action is needed, but the "
478 "situation is not serious at this time. \n"
479 "5 - Major should be used to indicate action is needed NOW. \n"
480 "6 - Critical should be used to indicate action is needed NOW "
481 "and the scope is broad (perhaps an imminent outage to a critical "
482 "resource will result). \n"
483 "7 - Fatal/NonRecoverable should be used to indicate an error "
484 karl 1.2 "occurred, but it's too late to take remedial action. \n"
485 "2 and 0 - Information and Unknown (respectively) follow common "
486 "usage. Literally, the AlertIndication is purely informational "
487 "or its severity is simply unknown."),
488 Values {"Unknown", "Other", "Information", "Degraded/Warning",
489 "Minor", "Major", "Critical", "Fatal/NonRecoverable"},
490 MappingStrings {"Recommendation.ITU|X733.Perceived severity"} ]
491 uint16 PerceivedSeverity;
492
493 [Description (
494 "Holds the value of the user defined severity value when "
495 "'Severity' is 1 (\"Other\")."),
496 ModelCorrespondence {"CIM_AlertIndication.PerceivedSeverity"} ]
497 string OtherSeverity;
498
499 [Required, Description (
500 "An enumerated value that describes the probable cause of the "
501 "situation which resulted in the AlertIndication."),
502 Values {"Unknown", "Other", "Adapter Error",
503 "Application Subsystem Failure", "Bandwidth Reduced",
504 "Connection Establishment Error",
505 karl 1.2 "Communications Protocol Error",
506 "Communications Subsystem Failure",
507 "Configuration/Customization Error", "Congestion",
508 "Corrupt Data", "CPU Cycles Limit Exceeded",
509 "Dataset/Modem Error", "Degraded Signal",
510 "DTE-DCE Interface Error", "Enclosure Door Open",
511 "Equipment Malfunction", "Excessive Vibration",
512 "File Format Error", "Fire Detected", "Flood Detected",
513 "Framing Error", "HVAC Problem", "Humidity Unacceptable",
514 "I/O Device Error", "Input Device Error", "LAN Error",
515 "Non-Toxic Leak Detected", "Local Node Transmission Error",
516 "Loss of Frame", "Loss of Signal",
517 "Material Supply Exhausted", "Multiplexer Problem",
518 "Out of Memory", "Output Device Error",
519 "Performance Degraded", "Power Problem",
520 "Pressure Unacceptable",
521 "Processor Problem (Internal Machine Error)",
522 "Pump Failure", "Queue Size Exceeded", "Receive Failure",
523 "Receiver Failure", "Remote Node Transmission Error",
524 "Resource at or Nearing Capacity", "Response Time Excessive",
525 "Retransmission Rate Excessive", "Software Error",
526 karl 1.2 "Software Program Abnormally Terminated",
527 "Software Program Error (Incorrect Results)",
528 "Storage Capacity Problem", "Temperature Unacceptable",
529 "Threshold Crossed", "Timing Problem",
530 "Toxic Leak Detected", "Transmit Failure",
531 "Transmitter Failure", "Underlying Resource Unavailable",
532 "Version MisMatch", "Previous Alert Cleared",
533 "Login Attempts Failed", "Software Virus Detected",
534 "Hardware Security Breached", "Denial of Service Detected",
535 "Security Credential MisMatch",
536 "Invalid Access of Data Detected"},
537 MappingStrings {"Recommendation.ITU|X733.Probable cause"} ]
538 uint16 ProbableCause;
539
540 [Description (
541 "Provides additional information related to the "
542 "ProbableCause.") ]
543 string ProbableCauseDescription;
544
545 [Description (
546 "Provides information on trending - trending up, down or "
547 karl 1.2 "no change."),
548 Values {"Unknown", "Not Applicable", "Trending Up",
549 "Trending Down", "No Change"},
550 MappingStrings {"Recommendation.ITU|X733.TrendIndication"} ]
551 uint16 Trending;
552
553 [Description (
554 "An identifier for the AlertIndication. This property is "
555 "similar to a key value in that it can be used for "
556 "identification, when correlating AlertIndications (see "
557 "the CorrelatedIndications array). Its value should be unique "
558 "as long as Alert correlations are reported, but may be "
559 "reused or left NULL if no future AlertIndications will "
560 "reference it in their CorrelatedIndications array."),
561 MappingStrings {
562 "Recommendation.ITU|X733.Notification identifier"} ]
563 string IndicationIdentifier;
564
565 [Description (
566 "A list of IndicationIdentifiers whose notifications are correlated "
567 "with (related to) this one."),
568 karl 1.2 MappingStrings {
569 "Recommendation.ITU|X733.Correlated notifications"} ]
570 string CorrelatedIndications[];
571
572 [Description (
573 "Free form descriptions of the recommended actions to take to "
574 "resolve the cause of the notification."),
575 MappingStrings {
576 "Recommendation.ITU|X733.Proposed repair actions"} ]
577 string RecommendedActions[];
578 };
579
580
581 //====================================================================
582 // CIM_ThresholdIndication
583 //====================================================================
584 [Indication, Version("2.6.0"),
585 Description (
586 "A subclass of CIM_AlertIndications carrying additional threshold "
587 "information related to the notification. This subclass is used "
588 "when one of the ProbableCauses is set to 53, \"Threshold "
589 karl 1.2 "Crossed\".") ]
590 class CIM_ThresholdIndication : CIM_AlertIndication {
591 [Description (
592 "A string describing the threshold or naming the property that "
593 "represents the threshold, if modeled in the CIM hierarchy. In "
594 "the latter case, the value should be written as <schema name>_"
595 "<class name>.<property name>."),
596 MappingStrings {"Recommendation.ITU|X733.Threshold information"} ]
597 string ThresholdIdentifier;
598
599 [Description (
600 "A string holding the current value of the threshold. This is "
601 "modeled as a string for universal mapping, similar to the "
602 "CIM_Sensor properties in the Device Model."),
603 MappingStrings {"Recommendation.ITU|X733.Threshold information"} ]
604 string ThresholdValue;
605
606 [Description (
607 "A string holding the current reading value that exceeds the "
608 "threshold. This is modeled as a string for universal mapping, "
609 "similar to the CIM_Sensor properties in the Device Model."),
610 karl 1.2 MappingStrings {"Recommendation.ITU|X733.Threshold information"} ]
611 string ObservedValue;
612 };
613
614
615 //====================================================================
616 // CIM_AlertInstIndication
617 //====================================================================
618 [Indication, Version("2.6.0"),
619 Description (
620 "A subclass of CIM_AlertIndication that embeds a CIM_Inst"
621 "Indication. It is used when adding AlertIndication data to a "
622 "LifeCycle Indication.") ]
623 class CIM_AlertInstIndication : CIM_AlertIndication {
624 [Override ("AlertType"), Description (
625 "The primary classification of the Indication, defaulted "
626 "to 7, \"Model Change\", for this class. This is done "
627 "because: 1) the primary purpose of AlertInstIndication is "
628 "to add Alert data to a LifeCycle Indication; and 2) LifeCycle "
629 "Indications deal with 'model changes'.") ]
630 uint16 AlertType = 7;
631 karl 1.2
632 [EmbeddedObject, Required,
633 Description (
634 "Embeds the InstIndication that is part of this Alert"
635 "Indication. Only the properties selected by the Indication"
636 "Filter's Query are included.") ]
637 string IndObject;
638 };
639
640
641 //====================================================================
642 // CIM_IndicationFilter
643 //====================================================================
644 [Version("2.6.0"),
645 Description (
646 "CIM_IndicationFilter defines the criteria for generating an "
647 "Indication and what data should be returned in the Indication. "
648 "It is derived from CIM_ManagedElement to allow modeling the "
649 "dependency of the filter on a specific service.") ]
650 class CIM_IndicationFilter: CIM_ManagedElement {
651 [Key, MaxLen (256),
652 karl 1.2 Description (
653 "A System's CreationClassName. The Filter is defined in the "
654 "context of a CIM_System, where it is hosted or to which it "
655 "applies. In a future release, a weak relationship will be "
656 "explicitly added to the model. This is not done now to allow "
657 "further refinement of the Filter definition and its "
658 "inheritance tree. Keys are defined now to allow the class to "
659 "be instantiated.") ]
660 string SystemCreationClassName;
661
662 [Key, MaxLen (256),
663 Description (
664 "A System's Name. The Filter is defined in the "
665 "context of a CIM_System, where it is hosted or to which it "
666 "applies. In a future release, a weak relationship will be "
667 "explicitly added to the model. This is not done now to allow "
668 "further refinement of the Filter definition and its "
669 "inheritance tree. Keys are defined now to allow the class to "
670 "be instantiated.") ]
671 string SystemName;
672
673 karl 1.2 [Key, MaxLen (256),
674 Description (
675 "Indicates the name of the class or the subclass used in the "
676 "creation of an instance. When used with the other key "
677 "properties of this class, it allows all instances of this "
678 "class and its subclasses to be uniquely identified.") ]
679 string CreationClassName;
680
681 [Key, Description (
682 "The name of the filter.") ]
683 string Name;
684
685 [Description (
686 "The path to a local namespace where the Indications "
687 "originate. If NULL, the namespace of the Filter registration "
688 "is assumed.") ]
689 string SourceNamespace;
690
691 [Required, Description (
692 "A query expression that defines the condition(s) under which "
693 "Indications will be generated. For some Indication classes, "
694 karl 1.2 "the query expression may also define the instance properties "
695 "to be copied to the CIM_InstIndication's SourceInstance and "
696 "PreviousInstance properties. Query language semantics include "
697 "projection (e.g., Select), range (e.g., From) and predicate "
698 "(e.g., Where)."),
699 ModelCorrespondence {"CIM_IndicationFilter.QueryLanguage"} ]
700 string Query;
701
702 [Required, Description (
703 "The language in which the query is expressed.") ]
704 string QueryLanguage;
705 };
706
707
708 //====================================================================
709 // CIM_IndicationHandler
710 //====================================================================
711 [Abstract, Version("2.6.0"),
712 Description (
713 "CIM_IndicationHandler is an abstract superclass describing how "
714 "an Indication is to be processd/delivered/'handled'. This may "
715 karl 1.2 "define a destination and protocol for delivering Indications, "
716 "or it may define a process to invoke. This class is derived "
717 "from CIM_ManagedElement to allow modeling the "
718 "dependency of the Handler on a specific service.") ]
719 class CIM_IndicationHandler: CIM_ManagedElement {
720 [Key, MaxLen (256),
721 Description (
722 "A System's CreationClassName. The Handler is defined in the "
723 "context of a CIM_System, where it is hosted or to which it "
724 "applies. In a future release, a weak relationship will be "
725 "explicitly added to the model. This is not done now to allow "
726 "further refinement of the Handler definition and its "
727 "inheritance tree. Keys are defined now to allow the class to "
728 "be instantiated.") ]
729 string SystemCreationClassName;
730
731 [Key, MaxLen (256),
732 Description (
733 "A System's Name. The Handler is defined in the "
734 "context of a CIM_System, where it is hosted or to which it "
735 "applies. In a future release, a weak relationship will be "
736 karl 1.2 "explicitly added to the model. This is not done now to allow "
737 "further refinement of the Handler definition and its "
738 "inheritance tree. Keys are defined now to allow the class to "
739 "be instantiated.") ]
740 string SystemName;
741
742 [Key, MaxLen (256),
743 Description (
744 "Indicates the name of the class or the subclass used in the "
745 "creation of an instance. When used with the other key properties "
746 "of this class, it allows all instances of this class "
747 "and its subclasses to be uniquely identified.") ]
748 string CreationClassName;
749
750 [Key, MaxLen (256),
751 Description (
752 "Indicates the name of this Handler.") ]
753 string Name;
754
755 [Description (
756 "The name of the entity that created and/or maintains this "
757 karl 1.2 "Handler.") ]
758 string Owner;
759 };
760
761
762 //====================================================================
763 // CIM_IndicationHandlerCIMXML
764 //====================================================================
765 [Version("2.6.0"),
766 Description (
767 "CIM_IndicationHandlerCIMXML describes the destination for "
768 "Indications to be delivered via CIM-XML.") ]
769 class CIM_IndicationHandlerCIMXML : CIM_IndicationHandler {
770 [Required, Description (
771 "The destination URL to which CIM-XML Indication messages "
772 "are to be delivered. The scheme prefix is implied and is not "
773 "required, but must be 'http:' if specified.") ]
774 string Destination;
775 };
776
777
778 karl 1.2 //====================================================================
779 // CIM_IndicationSubscription
780 //====================================================================
781 [Association, Version("2.6.0"),
782 Description (
783 "CIM_IndicationSubscription describes a flow of Indications. "
784 "The flow is specified by the referenced Filter, and directed to "
785 "the referenced destination or process in the Handler.") ]
786 class CIM_IndicationSubscription {
787 [Key, Description (
788 "The Filter that defines the criteria and data of the possible "
789 "Indications of this subscription.") ]
790 CIM_IndicationFilter REF Filter;
791
792 [Key, Description (
793 "The Handler addressing delivery of the possible Indications of "
794 "this subscription.") ]
795 CIM_IndicationHandler REF Handler;
796 };
797
798
799 karl 1.2 // ==================================================================
800 // end of file
801 // ==================================================================
|