(file) Return to Core28_Service.mof CVS log (file) (dir) Up to [Pegasus] / pegasus / Schemas / CIMPrelim28

  1 tony  1.1 // ===================================================================
  2           // Title:       Core Service2.8
  3           // Filename:    Core28_Service.mof
  4           // Version:     2.8
  5           // Release:     Preliminary
  6           // Date:        08/18/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. 225
 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 Core Model defines basic management concepts.
 45           //              This file defines the concepts for a Help Service
 46           // 
 47           //              The object classes below are listed in an order that
 48           //              avoids forward references. Required objects, defined
 49           //              by other working groups, are omitted.
 50           // ==================================================================
 51           // Change Log for v2.8 Preliminary
 52           // CR1092  - Move Service and SAP related classes to their own file
 53           // CR1124 - Add CIM_SAPAvailableForElement
 54           // CR1128 - Addition of HostedDependency
 55           // ==================================================================
 56           
 57           #pragma locale ("en_US")
 58           
 59           // ==================================================================
 60           // Service
 61           // ==================================================================
 62              [Abstract, Version ("2.7.0"), Description (
 63                  "A CIM_Service is a Logical Element that contains the "
 64 tony  1.1        "information necessary to represent and manage the "
 65                  "functionality provided by a Device and/or SoftwareFeature.  A "
 66                  "Service is a general-purpose object to configure and manage "
 67                  "the implementation of functionality.  It is not the "
 68                  "functionality itself.") ]
 69           class CIM_Service : CIM_EnabledLogicalElement {
 70           
 71                 [Key, Propagated ("CIM_System.CreationClassName"), Description (
 72                     "The scoping System's CreationClassName."), 
 73                  MaxLen (256) ]
 74              string SystemCreationClassName;
 75           
 76                 [Key, Propagated ("CIM_System.Name"), Description (
 77                     "The scoping System's Name."), 
 78                  MaxLen (256) ]
 79              string SystemName;
 80           
 81                 [Key, Description (
 82                     "CreationClassName indicates the name of the class or the "
 83                     "subclass used in the creation of an instance.  When used "
 84                     "with the other key properties of this class, this property "
 85 tony  1.1           "allows all instances of this class and its subclasses to be "
 86                     "uniquely identified."), 
 87                  MaxLen (256) ]
 88              string CreationClassName;
 89           
 90                 [Key, Override ("Name"), Description (
 91                     "The Name property uniquely identifies the Service and "
 92                     "provides an indication of the functionality that is "
 93                     "managed.  This functionality is described in more detail in "
 94                     "the object's Description property."), 
 95                  MaxLen (256) ]
 96              string Name;
 97           
 98                 [Write, Description (
 99                     "The name of the primary owner for the service, if one is "
100                     "defined.  The primary owner is the initial support contact "
101                     "for the Service."), 
102                  MaxLen (64), 
103                  MappingStrings {"MIF.DMTF|General Information|001.3"} ]
104              string PrimaryOwnerName;
105           
106 tony  1.1       [Write, Description (
107                     "A string that provides information on how the primary owner "
108                     "of the Service can be reached (e.g.  phone number, email "
109                     "address, ...)."), 
110                  MaxLen (256), 
111                  MappingStrings {"MIF.DMTF|General Information|001.4"} ]
112              string PrimaryOwnerContact;
113           
114                 [Deprecated {"CIM_Service.EnabledDefault"}, Description (
115                     "StartMode is a string value indicating whether the Service "
116                     "is automatically started by a System, Operating System, "
117                     "etc.  or only started upon request.  This property is "
118                     "deprecated in lieu of the EnabledDefault property inherited "
119                     "from EnabledLogicalElement, which addresses the same "
120                     "semantics.  The change to a uint16 data type was discussed "
121                     "when CIM V2.0 was defined.  However, existing V1.0 "
122                     "implementations used the string property and did not want "
123                     "to modify their code.  Therefore, StartMode was "
124                     "grandfathered into the Schema.  Use of the Deprecated "
125                     "qualifier allows the maintenance of the existing property, "
126                     "but also permits an improved, clarified definition using "
127 tony  1.1           "EnabledDefault."), 
128                  ValueMap {"Automatic", "Manual"}, MaxLen (10) ]
129              string StartMode;
130           
131                 [Description (
132                     "Started is a boolean indicating whether the Service has "
133                     "been started (TRUE), or stopped (FALSE).") ]
134              boolean Started;
135           
136                 [Description (
137                     "The StartService method places the Service in the started "
138                     "state.  Note that this method's function overlaps with the "
139                     "RequestedState property.  RequestedState was added to the "
140                     "model to maintain a record (i.e., a persisted value) of the "
141                     "last state request.  Invoking the StartService method "
142                     "should set the RequestedState property appropriately.  The "
143                     "method returns an integer value of 0 if the Service was "
144                     "successfully started, 1 if the request is not supported and "
145                     "any other number to indicate an error.  In a subclass, the "
146                     "set of possible return codes could be specified, using a "
147                     "ValueMap qualifier on the method.  The strings to which the "
148 tony  1.1           "ValueMap contents are 'translated' may also be specified in "
149                     "the subclass as a Values array qualifier.\n"
150                     "\n"
151                     "Note that this method overlaps in semantics with the "
152                     "RequestStateChange method inherited from "
153                     "EnabledLogicalElement.  This method is maintained since it "
154                     "has been widely implemented, and its simple 'start' "
155                     "semantics are convenient to use.") ]
156              uint32 StartService();
157           
158                 [Description (
159                     "The StopService method places the Service in the stopped "
160                     "state.  Note that this method's function overlaps with the "
161                     "RequestedState property.  RequestedState was added to the "
162                     "model to maintain a record (i.e., a persisted value) of the "
163                     "last state request.  Invoking the StopService method should "
164                     "set the RequestedState property appropriately.  The method "
165                     "returns an integer value of 0 if the Service was "
166                     "successfully stopped, 1 if the request is not supported and "
167                     "any other number to indicate an error.  In a subclass, the "
168                     "set of possible return codes could be specified, using a "
169 tony  1.1           "ValueMap qualifier on the method.  The strings to which the "
170                     "ValueMap contents are 'translated' may also be specified in "
171                     "the subclass as a Values array qualifier.\n"
172                     "\n"
173                     "Note that this method overlaps in semantics with the "
174                     "RequestStateChange method inherited from "
175                     "EnabledLogicalElement.  This method is maintained since it "
176                     "has been widely implemented, and its simple 'stop' "
177                     "semantics are convenient to use.") ]
178              uint32 StopService();
179           };
180           
181           
182           // ==================================================================
183           // HostedService
184           // ==================================================================
185              [Association, Version ("2.7.1000"), Description (
186                  "CIM_HostedService is an association between a Service and the "
187                  "System on which the functionality resides.  The cardinality of "
188                  "this association is 1-to-many.  A System may host many "
189                  "Services.  Services are weak with respect to their hosting "
190 tony  1.1        "System.  Heuristic: A Service is hosted on the System where "
191                  "the LogicalDevices or SoftwareFeatures that implement the "
192                  "Service are located.  The model does not represent Services "
193                  "hosted across multiple systems.  This is modeled as an "
194                  "ApplicationSystem that acts as an aggregation point for "
195                  "Services, that are each located on a single host.") ]
196           class CIM_HostedService : CIM_HostedDependency {
197           
198                 [Override ("Antecedent"), Min (1), Max (1), Description (
199                     "The hosting System.") ]
200              CIM_System REF Antecedent;
201           
202                 [Override ("Dependent"), Weak, Description (
203                     "The Service hosted on the System.") ]
204              CIM_Service REF Dependent;
205           };
206           
207           
208           // ==================================================================
209           // ProvidesServiceToElement
210           // ==================================================================
211 tony  1.1    [Association, Deprecated {"CIM_ServiceAvailableToElement"},
212               Version ("2.7.0"), Description (
213                  "The use of the CIM_ProvidesServiceToElement class has been "
214                  "deprecated.  Instead, ServiceAvailableToElement conveys the "
215                  "semantics of 'use', while the subclasses of ProvidesService "
216                  "ToElement (or the ConcreteDependency association) describe "
217                  "dependency relationships.  CIM_ProvidesServiceToElement was "
218                  "meant to generalize the ServiceServiceDependency association.  "
219                  "It tried to indicate that ManagedElements may use the "
220                  "functionality provided by one or more Services.  An example is "
221                  "that a Processor and an enclosure (a PhysicalElement) may use "
222                  "AlertOnLAN Services to signal an incomplete or erroneous "
223                  "boot.  In reality, AlertOnLAN is simply a HostedService on a "
224                  "computer system that is generally 'available for 'use' and not "
225                  "a dependency of the processor or enclosure.  To describe that "
226                  "use of the service may be restricted or have limited "
227                  "availability/ applicability, then the "
228                  "CIM_ServiceAvailableToElement association would be "
229                  "instantiated.") ]
230           class CIM_ProvidesServiceToElement : CIM_Dependency {
231           
232 tony  1.1       [Deprecated {"CIM_ServiceAvailableToElement.ServiceProvided"},
233                  Override ("Antecedent"), Description (
234                     "The Service provided.") ]
235              CIM_Service REF Antecedent;
236           
237                 [Deprecated {"CIM_ServiceAvailableToElement.UserOfService"},
238                  Override ("Dependent"), Description (
239                     "The ManagedElement dependent on the Service.") ]
240              CIM_ManagedElement REF Dependent;
241           };
242           
243           
244           // ==================================================================
245           // ServiceAvailableToElement
246           // ==================================================================
247              [Association, Version ("2.7.0"), Description (
248                  "CIM_ServiceAvailableToElement conveys the semantics of a "
249                  "Service being available for the 'use' of a ManagedElement.  An "
250                  "example is that a Processor and an enclosure (a "
251                  "PhysicalElement) may use AlertOnLAN Services to signal an "
252                  "incomplete or erroneous boot.  In reality, AlertOnLAN is "
253 tony  1.1        "simply a HostedService on a computer system that is generally "
254                  "'available for use', and not a dependency of the processor or "
255                  "enclosure.  To describe that use of this service is restricted "
256                  "or has limited availability/applicability, then the "
257                  "CIM_ServiceAvailableToElement association would be "
258                  "instantiated between the Service and specific CIM_Processors "
259                  "and CIM_Chassis .") ]
260           class CIM_ServiceAvailableToElement {
261           
262                 [Key, Description (
263                     "The Service that is available.") ]
264              CIM_Service REF ServiceProvided;
265           
266                 [Key, Description (
267                     "The ManagedElement that may use the Service.") ]
268              CIM_ManagedElement REF UserOfService;
269           };
270           
271           
272           // ===================================================================
273           // ServiceAffectsElement
274 tony  1.1 // ===================================================================
275              [Association, Version ("2.7.0"), Description (
276                  "ServiceAffectsElement represents an association between a "
277                  "Service and the ManagedElement(s) that may be affected by its "
278                  "execution.  Instantiating this association indicates that "
279                  "running the service will pose some burden on the "
280                  "ManagedElement that may affect performance, throughput, "
281                  "availability, etc.") ]
282           class CIM_ServiceAffectsElement {
283           
284                 [Key, Description (
285                     "The Managed Element affected by the Service.") ]
286              CIM_ManagedElement REF AffectedElement;
287           
288                 [Key, Description (
289                     "The Service that is affecting the ManagedElement.") ]
290              CIM_Service REF AffectingElement;
291           
292                 [Description (
293                     "An enumeration describing the 'effect' on the "
294                     "ManagedElement.  This array corresponds to the "
295 tony  1.1           "OtherElementEffectsDescriptions array, where the latter "
296                     "provides details related to the high-level 'effects' "
297                     "enumerated by this property.  Additional detail is required "
298                     "if the ElementEffects array contains the value 1, "
299                     "\"Other\"."), 
300                  ValueMap {"0", "1", "2", "3", "4"}, 
301                  Values {"Unknown", "Other", "Exclusive Use",
302                      "Performance Impact", "Element Integrity"}, 
303                  ArrayType ("Indexed"), 
304                  ModelCorrespondence { 
305                     "CIM_ServiceAffectsElement.OtherElementEffectsDescriptions"} ]
306              uint16 ElementEffects[];
307           
308                 [Description (
309                     "Provides details for the 'effect' at the corresponding "
310                     "array position in ElementEffects.  This information is "
311                     "required ElementEffects contains the value 1 (\"Other\")."), 
312                  ArrayType ("Indexed"), 
313                  ModelCorrespondence { 
314                     "CIM_ServiceAffectsElement.ElementEffects"} ]
315              string OtherElementEffectsDescriptions[];
316 tony  1.1 };
317           
318           
319           // ==================================================================
320           // ServiceServiceDependency
321           // ==================================================================
322              [Association, Version ("2.7.0"), Description (
323                  "CIM_ServiceServiceDependency is an association between a "
324                  "Service and another Service, indicating that the latter is "
325                  "required to be present, required to have completed, or must be "
326                  "absent for the former Service to provide its functionality.  "
327                  "For example, Boot Services may be dependent upon underlying "
328                  "system initialization Services.  In the case of the "
329                  "initialization Services, the Boot Service may be dependent on "
330                  "the init Services completing.\n"
331                  "Examining the ServiceServiceDependency class definition, note "
332                  "that its superclass ProvidesServiceToElement is deprecated.  "
333                  "Unfortunately, ProvidesServiceToElement cannot be removed from "
334                  "the object hierarchy without a major Schema release.  When/if "
335                  "this occurs, the ProvidesServiceToElement superclass will be "
336                  "removed, and ServiceServiceDependency will subclass from "
337 tony  1.1        "CIM_Dependency directly.") ]
338           class CIM_ServiceServiceDependency : CIM_ProvidesServiceToElement {
339           
340                 [Override ("Antecedent"), Description (
341                     "The required Service.") ]
342              CIM_Service REF Antecedent;
343           
344                 [Override ("Dependent"), Description (
345                     "The Service that is dependent on an underlying Service.") ]
346              CIM_Service REF Dependent;
347           
348                 [Description (
349                     "The nature of the Service to Service dependency.  This "
350                     "property describes that the associated Service must have "
351                     "completed (value=2), must be started (3) or must not be "
352                     "started (4) in order for the Service to function."), 
353                  ValueMap {"0", "1", "2", "3", "4"}, 
354                  Values {"Unknown", "Other", "Service Must Have Completed",
355                     "Service Must Be Started", "Service Must Not Be Started"} ]
356              uint16 TypeOfDependency;
357           
358 tony  1.1       [Description (
359                     "This property describes that the Antecedent Service must be "
360                     "restarted after the Dependent operation is complete.") ]
361              boolean RestartService;
362           };
363           
364           
365           // ==================================================================
366           // ServiceComponent
367           // ==================================================================
368              [Association, Aggregation, Version ("2.6.0"), Description (
369                  "The ServiceComponent aggregation models a set of subordinate "
370                  "Services that are aggregated together to form a higher-level "
371                  "service.") ]
372           class CIM_ServiceComponent : CIM_Component {
373           
374                 [Aggregate, Override ("GroupComponent"), Description (
375                     "The parent Service.") ]
376              CIM_Service REF GroupComponent;
377           
378                 [Override ("PartComponent"), Description (
379 tony  1.1           "The component Service.") ]
380              CIM_Service REF PartComponent;
381           };
382           
383           
384           // ==================================================================
385           // ServiceAccessPoint
386           // ==================================================================
387              [Abstract, Version ("2.6.0"), Description (
388                  "CIM_ServiceAccessPoint represents the ability to utilize or "
389                  "invoke a Service.  Access points represent that a Service is "
390                  "made available to other entities for use.") ]
391           class CIM_ServiceAccessPoint : CIM_EnabledLogicalElement {
392           
393                 [Key, Propagated ("CIM_System.CreationClassName"), Description (
394                     "The scoping System's CreationClassName."), 
395                  MaxLen (256) ]
396              string SystemCreationClassName;
397           
398                 [Key, Propagated ("CIM_System.Name"), Description (
399                     "The scoping System's Name."), 
400 tony  1.1        MaxLen (256) ]
401              string SystemName;
402           
403                 [Key, Description (
404                     "CreationClassName indicates the name of the class or the "
405                     "subclass used in the creation of an instance.  When used "
406                     "with the other key properties of this class, this property "
407                     "allows all instances of this class and its subclasses to be "
408                     "uniquely identified."), 
409                  MaxLen (256) ]
410              string CreationClassName;
411           
412                 [Key, Override ("Name"), Description (
413                     "The Name property uniquely identifies the "
414                     "ServiceAccessPoint and provides an indication of the "
415                     "functionality that is managed.  This functionality is "
416                     "described in more detail in the object's Description "
417                     "property."), 
418                  MaxLen (256) ]
419              string Name;
420           };
421 tony  1.1 
422           
423           // ==================================================================
424           // HostedAccessPoint
425           // ==================================================================
426              [Association, Version ("2.7.1000"), Description (
427                  "CIM_HostedAccessPoint is an association between a Service "
428                  "AccessPoint and the System on which it is provided.  The "
429                  "cardinality of this association is 1-to-many and is weak with "
430                  "respect to the System.  Each System may host many "
431                  "ServiceAccessPoints.  Heuristic: If the implementation of the "
432                  "ServiceAccessPoint is modeled, it must be implemented by a "
433                  "Device or SoftwareFeature that is part of the System hosting "
434                  "the ServiceAccessPoint.") ]
435           class CIM_HostedAccessPoint:CIM_HostedDependency {
436           
437                 [Override ("Antecedent"), Min (1), Max (1), Description (
438                     "The hosting System.") ]
439              CIM_System REF Antecedent;
440           
441                 [Override ("Dependent"), Weak, Description (
442 tony  1.1           "The SAP(s) that are hosted on this System.") ]
443              CIM_ServiceAccessPoint REF Dependent;
444           };
445           
446           // ==================================================================
447           // SAPAvailableForElement
448           // ==================================================================
449              [Association, Experimental, Version ("2.7.1000"), Description (
450                  "CIM_SAPAvailableForElement conveys the semantics of a Service "
451                  "Access Point being available for a ManagedElement.  When "
452                  "CIM_SAPAvailableForElement is not instantiated then the SAP is "
453                  "assumed to be generally available.  If instantiated, the SAP "
454                  "is only available for the associated ManagedElements.  For "
455                  "example, a device might provide management access through a "
456                  "URL.  This association allows the URL to be advertised for the "
457                  "device.") ]
458           class CIM_SAPAvailableForElement {
459           
460                 [Key, Description (
461                     "The Service Access Point that is available.") ]
462              CIM_ServiceAccessPoint REF AvailableSAP;
463 tony  1.1 
464                 [Key, Description (
465                     "The ManagedElement for which the SAP is available.") ]
466              CIM_ManagedElement REF ManagedElement;
467           };
468           
469           // ==================================================================
470           // ServiceSAPDependency
471           // ==================================================================
472              [Association, Version ("2.6.0"), Description (
473                  "CIM_ServiceSAPDependency is an association between a Service "
474                  "and a ServiceAccessPoint indicating that the referenced SAP is "
475                  "utilized by the Service to provide its functionality.  For "
476                  "example, Boot Services may invoke BIOS' Disk Services "
477                  "(interrupts) in order to function.") ]
478           class CIM_ServiceSAPDependency : CIM_Dependency {
479           
480                 [Override ("Antecedent"), Description (
481                     "The required ServiceAccessPoint.") ]
482              CIM_ServiceAccessPoint REF Antecedent;
483           
484 tony  1.1       [Override ("Dependent"), Description (
485                     "The Service that is dependent on an underlying SAP.") ]
486              CIM_Service REF Dependent;
487           };
488           
489           
490           // ==================================================================
491           // ServiceAccessBySAP
492           // ==================================================================
493              [Association, Version ("2.6.0"), Description (
494                  "CIM_ServiceAccessBySAP is an association that identifies the "
495                  "access points for a Service.  For example, a printer may be "
496                  "accessed by Netware, MacIntosh or Windows ServiceAccess "
497                  "Points, potentially hosted on different Systems.") ]
498           class CIM_ServiceAccessBySAP : CIM_Dependency {
499           
500                 [Override ("Antecedent"), Description (
501                     "The Service.") ]
502              CIM_Service REF Antecedent;
503           
504                 [Override ("Dependent"), Description (
505 tony  1.1           "An Access Point for a Service.  Access points are dependent "
506                     "in this relationship since they have no function without a "
507                     "corresponding Service.") ]
508              CIM_ServiceAccessPoint REF Dependent;
509           };
510           
511           
512           // ==================================================================
513           // SAPSAPDependency
514           // ==================================================================
515              [Association, Version ("2.6.0"), Description (
516                  "CIM_SAPSAPDependency is an association between a Service "
517                  "AccessPoint and another ServiceAccessPoint indicating that the "
518                  "latter is required in order for the former ServiceAccess Point "
519                  "to utilize or connect with its Service.  For example, to print "
520                  "at a network printer, local Print Access Points must utilize "
521                  "underlying network-related SAPs, or ProtocolEndpoints, in "
522                  "order to send the print request.") ]
523           class CIM_SAPSAPDependency : CIM_Dependency {
524           
525                 [Override ("Antecedent"), Description (
526 tony  1.1           "The required ServiceAccessPoint.") ]
527              CIM_ServiceAccessPoint REF Antecedent;
528           
529                 [Override ("Dependent"), Description (
530                     "The ServiceAccessPoint that is dependent on an underlying "
531                     "SAP.") ]
532              CIM_ServiceAccessPoint REF Dependent;
533           };
534           
535           
536           // ==================================================================
537           // ActiveConnection
538           // ==================================================================
539              [Association, Version ("2.7.0"), Description (
540                  "This association defines a connection that is currently "
541                  "communicating, or is configured to communicate, between two "
542                  "ServiceAccessPoints.  It is used when the connection is not "
543                  "treated as a ManagedElement itself (i.e., with Status, "
544                  "statistics, etc.), but its existence is known.  The SAPs that "
545                  "are connected are typically at the same networking or "
546                  "application layer.") ]
547 tony  1.1 class CIM_ActiveConnection : CIM_SAPSAPDependency {
548           
549                 [Override ("Antecedent"), Description (
550                     "A ServiceAccessPoint that is configured to communicate "
551                     "and/or is actively communicating with the Dependent SAP.  "
552                     "In a unidirectional connection, this is the SAP which is "
553                     "transmitting.") ]
554              CIM_ServiceAccessPoint REF Antecedent;
555           
556                 [Override ("Dependent"), Description (
557                     "A second SeriveAccessPoint that is/can communicate with the "
558                     "Antecedent SAP.  In a unidirectional connection, this is "
559                     "the SAP that is receiving the communication.") ]
560              CIM_ServiceAccessPoint REF Dependent;
561           
562                 [Deprecated {"No value"}, Description (
563                     "The type of traffic that is carried over this connection.  "
564                     "This property is deprecated since it is incorrectly placed "
565                     "on the association.  Unicast, broadcast or other traffic "
566                     "types are not a function of the connection between the "
567                     "referenced endpoints, but on the addressing, protocol, and "
568 tony  1.1           "basic functionality of the endpoints."), 
569                  ValueMap {"0", "1", "2", "3", "4", "5" }, 
570                  Values {"Unknown", "Other", "Unicast", "Broadcast", "Multicast",
571                     "Anycast"}, 
572                  ModelCorrespondence { 
573                     "CIM_ActiveConnection.OtherTrafficDescription" } ]
574              uint16 TrafficType;
575           
576                 [Deprecated {"No value"}, Description (
577                     "A string describing the type of traffic that is being "
578                     "carried over this instance when its Type property is set to "
579                     "1 (e.g., 'Other').  This property is deprecated since it is "
580                     "incorrectly placed on the association.  Unicast, broadcast "
581                     "or other traffic types are not a function of the connection "
582                     "between the referenced endpoints, but on the addressing, "
583                     "protocol, and basic functionality of the endpoints."), 
584                  MaxLen (64), 
585                  ModelCorrespondence { "CIM_ActiveConnection.TrafficType" } ]
586              string OtherTrafficDescription;
587           
588                 [Description (
589 tony  1.1           "TRUE means that this connection is uni-directional; FALSE "
590                     "means that this connection is bi-directional.  When the "
591                     "connection is unidirectional, the 'speaker' should be "
592                     "defined as the Antecedent reference.  In a bidirectional "
593                     "connection, the selection of which AccessPoint is the "
594                     "Antecedent or Dependent is immaterial.") ]
595              boolean IsUnidirectional;
596           };
597           
598           
599           // ==================================================================
600           // RemoteServiceAccessPoint
601           // ==================================================================
602              [Version ("2.7.1000"), Description (
603                  "RemoteServiceAccessPoint describes access and/or addressing "
604                  "information for a remote connection, that is known to a "
605                  "'local' network element.  This information is scoped/contained "
606                  "by the 'local' network element, since this is the context in "
607                  "which it is 'remote'. \n\n"
608                  "Why the remote access point is relevant and information on its "
609                  "use are described by subclassing RemoteService AccessPoint, or "
610 tony  1.1        "by associating to it.") ]
611           class CIM_RemoteServiceAccessPoint : CIM_ServiceAccessPoint {
612           
613                 [Description (
614                     "Access and/or addressing information for a remote "
615                     "connection.  This can be a host name, network address or "
616                     "similar information."), 
617                  ModelCorrespondence { "CIM_RemoteServiceAccessPoint.InfoFormat"} ]
618              string AccessInfo;
619           
620                 [Description (
621                     "An enumerated integer describing the format and "
622                     "interpretation of the AccessInfo property."), 
623                  ValueMap {"1", "2", "3", "4", "5", "6", "7", "8", "9", "10",
624                     "11", "12", "13", "100", "101", "102", "103", "104", "200",
625                     "201", "202", "203", "204", "205", "..", "32768..65535"}, 
626                  Values {"Other", "Host Name", "IPv4 Address", "IPv6 Address",
627                     "IPX Address", "DECnet Address", "SNA Address",
628                      "Autonomous System Number", "MPLS Label",
629                      "IPv4 Subnet Address", "IPv6 Subnet Address",
630                      "IPv4 Address Range", "IPv6 Address Range", "Dial String",
631 tony  1.1           "Ethernet Address", "Token Ring Address", "ATM Address",
632                     "Frame Relay Address", "URL", "FQDN", "User FQDN",
633                      "DER ASN1 DN", "DER ASN1 GN", "Key ID", "DMTF Reserved",
634                     "Vendor Reserved"}, 
635                  ModelCorrespondence { 
636                     "CIM_RemoteServiceAccessPoint.OtherInfoFormatDescription"} ]
637              uint16 InfoFormat;
638           
639                 [Description (
640                     "Describes the format when the property InfoFormat is set to "
641                     "1 (\"Other\")."), 
642                  ModelCorrespondence { "CIM_RemoteServiceAccessPoint.InfoFormat"} ]
643              string OtherInfoFormatDescription;
644           };
645           
646           
647           // ==================================================================
648           // RemotePort
649           // ==================================================================
650              [Version ("2.7.0"), Description (
651                  "RemotePort adds port information to the access data (such as "
652 tony  1.1        "IP Address), specified in and inherited from "
653                  "RemoteServiceAccessPoint.  For example, using the additional "
654                  "properties in this class, one could indicate that UDP Port 123 "
655                  "is accessed at IP Address xyz.  The IP Address would be "
656                  "specified in the inherited AccessInfo property, while the UDP "
657                  "Port number would be specified in this class' property, "
658                  "PortInfo.") ]
659           class CIM_RemotePort : CIM_RemoteServiceAccessPoint {
660           
661                 [Description (
662                     "Port information that may further specify the remote access "
663                     "information."), 
664                  ModelCorrespondence { "CIM_RemotePort.PortProtocol"} ]
665              string PortInfo;
666           
667                 [Description (
668                     "An enumerated integer describing the protocol of the port "
669                     "addressed by PortInformation."), 
670                  ValueMap {"1", "2", "3", "32768..65535"}, 
671                  Values {"Other", "TCP", "UDP", "Vendor Specific"}, 
672                  ModelCorrespondence { "CIM_RemotePort.OtherProtocolDescription"} ]
673 tony  1.1    uint16 PortProtocol;
674           
675                 [Description (
676                     "Describes the protocol when the property PortProtocol is "
677                     "set to 1 (\"Other\")."), 
678                  ModelCorrespondence { "CIM_RemotePort.PortProtocol"} ]
679              string OtherProtocolDescription;
680           };
681           
682           
683           // ==================================================================
684           // ServiceAccessURI
685           // ==================================================================
686              [Version ("2.7.0"), Description (
687                  "CIM_ServiceAccessURI represents the ability to utilize or "
688                  "invoke a Service via a uniform resource identifier.  RFC 1738 "
689                  "describes the Uniform Resource Locator which is a more "
690                  "specific form of a URI, and RFC 2396 describes the broader, "
691                  "inclusive URI.  Quoting from the RFC, 'A Uniform Resource "
692                  "Identifier (URI) is a compact string of characters for "
693                  "identifying an abstract or physical resource.' In the context "
694 tony  1.1        "of a ServiceAccessPoint, a URI contains the information "
695                  "necessary to access an associated service (associated via "
696                  "ServiceAccessBySAP), using a syntax specific to that service.") ]
697           class CIM_ServiceAccessURI : CIM_ServiceAccessPoint {
698           
699                 [Required, Description (
700                     "The LabeledURI property is based on RFC 2079 and its value "
701                     "and syntax is service specific."), 
702                  MaxLen (256) ]
703              string LabeledURI;
704           };
705           
706           
707           // ==================================================================
708           // ProtocolEndpoint
709           // ==================================================================
710              [Version ("2.7.1000"), Description (
711                  "A communication point from which data may be sent or "
712                  "received.  ProtocolEndpoints link system/computer interfaces "
713                  "to LogicalNetworks.") ]
714           class CIM_ProtocolEndpoint : CIM_ServiceAccessPoint {
715 tony  1.1 
716                 [Override ("Description"), 
717                  MappingStrings {"MIB.IETF|IF-MIB.ifDescr"} ]
718              string Description;
719           
720                 [Override ("OperationalStatus"), 
721                  MappingStrings {"MIB.IETF|IF-MIB.ifOperStatus"} ]
722              uint16 OperationalStatus[];
723           
724                 [Override ("EnabledState"), 
725                  MappingStrings {"MIB.IETF|IF-MIB.ifAdminStatus"} ]
726              uint16 EnabledState;
727           
728                 [Override ("TimeOfLastStateChange"), 
729                  MappingStrings {"MIB.IETF|IF-MIB.ifLastChange"} ]
730              datetime TimeOfLastStateChange;
731           
732                 [Override ("Name"), Description (
733                     "A string which identifies this ProtocolEndpoint with either "
734                     "a port or an interface on a device.  To ensure uniqueness, "
735                     "the Name property should be prepended or appended with "
736 tony  1.1           "information from the Type or OtherTypeDescription "
737                     "properties.  The method chosen is described in the "
738                     "NameFormat property of this class."), 
739                  MaxLen (256) ]
740              string Name;
741           
742                 [Description (
743                     "NameFormat contains the naming heuristic that is chosen to "
744                     "ensure that the value of the Name property is unique.  For "
745                     "example, one might choose to prepend the name of the port "
746                     "or interface with the Type of ProtocolEndpoint that this "
747                     "instance is (e.g., IPv4) followed by an underscore."), 
748                  MaxLen (256) ]
749              string NameFormat;
750           
751                 [Deprecated {"CIM_ProtocolEndpoint.ProtocolIFType"}, 
752                  Description (
753                     "ProtocolType is an enumeration providing information to "
754                     "categorize and classify different instances of this class.  "
755                     "For most instances, information in this enumeration and the "
756                     "subclass' definition overlap.  However, there are several "
757 tony  1.1           "cases where a specific subclass of ProtocolEndpoint is not "
758                     "required (for example, there is no Fibre Channel subclass "
759                     "of ProtocolEndpoint).  Hence, this property is needed to "
760                     "define the type of Endpoint.\n"
761                     "\n"
762                     "This property is deprecated in lieu of the ProtocolIFType "
763                     "enumeration.  This is done to have better alignment between "
764                     "the IETF's IF-MIB and this CIM class."), 
765                  ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
766                     "10", "11", "12", "13", "14", "15", "16", "17", "18", "19",
767                     "20", "21", "22", "23", "24", "25", "26", "27"}, 
768                  Values {"Unknown", "Other", "IPv4", "IPv6", "IPX", "AppleTalk",
769                     "DECnet", "SNA", "CONP", "CLNP", "VINES", "XNS", "ATM",
770                     "Frame Relay", "Ethernet", "TokenRing", "FDDI", "Infiniband",
771                     "Fibre Channel", "ISDN BRI Endpoint",
772                      "ISDN B Channel Endpoint", "ISDN D Channel Endpoint", 
773                  // 22  
774                  "IPv4/v6", "BGP", "OSPF", "MPLS", "UDP", "TCP"}, 
775                  ModelCorrespondence { 
776                     "CIM_ProtocolEndpoint.OtherTypeDescription"} ]
777              uint16 ProtocolType;
778 tony  1.1 
779                 [Experimental, Description (
780                     "ProtocolIFType is an enumeration synchronized with the IANA "
781                     "ifType MIB, maintained at the URL, http: "
782                     "//www.iana.org/assignments/ianaiftype-mib.  Also, // // "
783                     "additional values defined by the DMTF are included.  The "
784                     "property is used to categorize and classify instances of "
785                     "the ProtocolEndpoint class.  Note that if the "
786                     "ProtocolIFType is set to 1 (\"Other\"), then the type "
787                     "information should be provided in the OtherTypeDescription "
788                     "string property."), 
789                  ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
790                     "10", "11", "12", "13", "14", "15", "16", "17", "18", "19",
791                     "20", "21", "22", "23", "24", "25", "26", "27", "28", "29",
792                     "30", "31", "32", "33", "34", "35", "36", "37", "38", "39",
793                     "40", "41", "42", "43", "44", "45", "46", "47", "48", "49",
794                     "50", "51", "52", "53", "54", "55", "56", "57", "58", "59",
795                     "60", "61", "62", "63", "64", "65", "66", "67", "68", "69",
796                     "70", "71", "72", "73", "74", "75", "76", "77", "78", "79",
797                     "80", "81", "82", "83", "84", "85", "86", "87", "88", "89",
798                     "90", "91", "92", "93", "94", "95", "96", "97", "98", "99",
799 tony  1.1           "100", "101", "102", "103", "104", "105", "106", "107",
800                     "108", "109", "110", "111", "112", "113", "114", "115",
801                     "116", "117", "118", "119", "120", "121", "122", "123",
802                     "124", "125", "126", "127", "128", "129", "130", "131",
803                     "132", "133", "134", "135", "136", "137", "138", "139",
804                     "140", "141", "142", "143", "144", "145", "146", "147",
805                     "148", "149", "150", "151", "152", "153", "154", "155",
806                     "156", "157", "158", "159", "160", "161", "162", "163",
807                     "164", "165", "166", "167", "168", "169", "170", "171",
808                     "172", "173", "174", "175", "176", "177", "178", "179",
809                     "180", "181", "182", "183", "184", "185", "186", "187",
810                     "188", "189", "190", "191", "192", "193", "194", "195",
811                     "196", "197", "198", "199", "200", "201", "202", "203",
812                     "204", "205", "206", "207", "208", "209", "210", "211",
813                     "212", "213", "214", "215", "216", "217", "218", "219",
814                     "220", "221..4095", "4096", "4097", "4098", "4099", "4100",
815                     "4101", "4102", "4103", "4104", "4105", "4106", "4107",
816                     "4108", "4109", "4110", "4111", "4112", "4113", "4114",
817                     "4115", "4116..32767", "32768.."}, 
818                  Values {"Unknown", "Other", "Regular 1822", "HDH 1822",
819                     "DDN X.25", "RFC877 X.25", "Ethernet CSMA/CD",
820 tony  1.1           "ISO 802.3 CSMA/CD", "ISO 802.4 Token Bus",
821                     "ISO 802.5 Token Ring", 
822                  // 10 
823                     "ISO 802.6 MAN", "StarLAN", "Proteon 10Mbit", "Proteon 80Mbit",
824                     "HyperChannel", "FDDI", "LAP-B", "SDLC", "DS1", "E1", 
825                  // 20 
826                     "Basic ISDN", "Primary ISDN",
827                     "Proprietary Point-to-Point Serial", "PPP",
828                     "Software Loopback", "EON", "Ethernet 3Mbit", "NSIP",
829                     "SLIP", "Ultra", 
830                  // 30 
831                     "DS3", "SIP", "Frame Relay", "RS-232", "Parallel", "ARCNet",
832                     "ATM", "MIO X.25", "SONET", "X.25 PLE", 
833                  //40 
834                     "ISO 802.211c", "LocalTalk", "SMDS DXI", "Frame Relay Service",
835                     "V.35", "HSSI", "HIPPI", "Modem", "AAL5", "SONET Path", 
836                  // 50 
837                     "SONET VT", "SMDS ICIP", "Proprietary Virtual/Internal",
838                     "Proprietary Multiplexor", "IEEE 802.12", "Fibre Channel",
839                     "HIPPI Interface", "Frame Relay Interconnect",
840                     "ATM Emulated LAN for 802.3", "ATM Emulated LAN for 802.5", 
841 tony  1.1        // 60 
842                     "ATM Emulated Circuit", "Fast Ethernet (100BaseT)", "ISDN",
843                     "V.11", "V.36", "G703 at 64K", "G703 at 2Mb", "QLLC",
844                     "Fast Ethernet 100BaseFX", "Channel", 
845                  // 70  
846                     "IEEE 802.11", "IBM 260/370 OEMI Channel", "ESCON",
847                     "Data Link Switching", "ISDN S/T Interface",
848                     "ISDN U Interface", "LAP-D", "IP Switch",
849                     "Remote Source Route Bridging", "ATM Logical", 
850                  // 80 
851                     "DS0", "DS0 Bundle", "BSC", "Async", "Combat Net Radio",
852                     "ISO 802.5r DTR", "Ext Pos Loc Report System",
853                     "AppleTalk Remote Access Protocol",
854                     "Proprietary Connectionless", "ITU X.29 Host PAD", 
855                  // 90 
856                     "ITU X.3 Terminal PAD", "Frame Relay MPI", "ITU X.213", "ADSL",
857                     "RADSL", "SDSL", "VDSL", "ISO 802.5 CRFP", "Myrinet",
858                     "Voice Receive and Transmit", 
859                  // 100 
860                     "Voice Foreign Exchange Office",
861                     "Voice Foreign Exchange Service", "Voice Encapsulation",
862 tony  1.1           "Voice over IP", "ATM DXI", "ATM FUNI", "ATM IMA",
863                     "PPP Multilink Bundle", "IP over CDLC", "IP over CLAW", 
864                  // 110 
865                     "Stack to Stack", "Virtual IP Address", "MPC", "IP over ATM",
866                     "ISO 802.5j Fibre Token Ring", "TDLC", "Gigabit Ethernet",
867                     "HDLC", "LAP-F", "V.37", 
868                  // 120 
869                     "X.25 MLP", "X.25 Hunt Group", "Transp HDLC",
870                     "Interleave Channel", "FAST Channel",
871                     "IP (for APPN HPR in IP Networks)", "CATV MAC Layer",
872                     "CATV Downstream", "CATV Upstream", "Avalon 12MPP Switch", 
873                  // 130 
874                     "Tunnel", "Coffee", "Circuit Emulation Service",
875                     "ATM SubInterface", "Layer 2 VLAN using 802.1Q",
876                     "Layer 3 VLAN using IP", "Layer 3 VLAN using IPX",
877                     "Digital Power Line", "Multimedia Mail over IP", "DTM", 
878                  // 140 
879                     "DCN", "IP Forwarding", "MSDSL", "IEEE 1394",
880                     "IF-GSN/HIPPI-6400", "DVB-RCC MAC Layer",
881                     "DVB-RCC Downstream", "DVB-RCC Upstream", "ATM Virtual",
882                     "MPLS Tunnel", 
883 tony  1.1        // 150 
884                     "SRP", "Voice over ATM", "Voice over Frame Relay", "ISDL",
885                     "Composite Link", "SS7 Signaling Link",
886                     "Proprietary P2P Wireless", "Frame Forward",
887                     "RFC1483 Multiprotocol over ATM", "USB", 
888                  // 160 
889                     "IEEE 802.3ad Link Aggregate", "BGP Policy Accounting",
890                     "FRF .16 Multilink FR", "H.323 Gatekeeper", "H.323 Proxy",
891                     "MPLS", "Multi-Frequency Signaling Link", "HDSL-2", "S-HDSL",
892                     "DS1 Facility Data Link", 
893                  // 170 
894                     "Packet over SONET/SDH", "DVB-ASI Input", "DVB-ASI Output",
895                     "Power Line", "Non Facility Associated Signaling", "TR008",
896                     "GR303 RDT", "GR303 IDT", "ISUP",
897                     "Proprietary Wireless MAC Layer", 
898                  // 180 
899                     "Proprietary Wireless Downstream",
900                     "Proprietary Wireless Upstream", "HIPERLAN Type 2",
901                     "Proprietary Broadband Wireless Access Point to Mulipoint",
902                     "SONET Overhead Channel", "Digital Wrapper Overhead Channel",
903                     "ATM Adaptation Layer 2", "Radio MAC", "ATM Radio",
904 tony  1.1           "Inter Machine Trunk", 
905                  //190 
906                     "MVL DSL", "Long Read DSL", "Frame Relay DLCI Endpoint",
907                     "ATM VCI Endpoint", "Optical Channel", "Optical Transport",
908                     "Proprietary ATM", "Voice over Cable", "Infiniband",
909                     "TE Link", 
910                  // 200 
911                     "Q.2931", "Virtual Trunk Group", "SIP Trunk Group",
912                     "SIP Signaling", "CATV Upstream Channel", "Econet",
913                     "FSAN 155Mb PON", "FSAN 622Mb PON", "Transparent Bridge",
914                     "Line Group", 
915                  // 210 
916                     "Voice E&M Feature Group", "Voice FGD EANA", "Voice DID",
917                     "MPEG Transport", "6To4", "GTP", "Paradyne EtherLoop 1",
918                     "Paradyne EtherLoop 2", "Optical Channel Group", "HomePNA", 
919                  // 220 .. 4095 
920                     "GFP", "IANA Reserved", 
921                  // 4096 
922                     "IPv4", "IPv6", "IPv4/v6", "IPX", 
923                  // 4100 
924                     "DECnet", "SNA", "CONP", "CLNP", "VINES", "XNS",
925 tony  1.1           "ISDN B Channel Endpoint", "ISDN D Channel Endpoint", "BGP",
926                     "OSPF", 
927                  // 4110 
928                     "UDP", "TCP", "802.11a", "802.11b", "802.11g", "802.11h", 
929                  // 4116 .. 
930                     "DMTF Reserved", "Vendor Reserved"}, 
931                  MappingStrings {"MIB.IETF|IF-MIB.ifType"}, 
932                  ModelCorrespondence { 
933                     "CIM_ProtocolEndpoint.OtherTypeDescription"} ]
934              uint16 ProtocolIFType;
935           
936                 [Description (
937                     "A string describing the type of ProtocolEndpoint when the "
938                     "Type property of this class (or any of its subclasses) is "
939                     "set to 1 (i.e., \"Other\").  This property should be set to "
940                     "NULL when the Type property is any value other than 1."), 
941                  MaxLen (64), 
942                  ModelCorrespondence {"CIM_ProtocolEndpoint.ProtocolType",
943                     "CIM_ProtocolEndpoint.ProtocolIFType"} ]
944              string OtherTypeDescription;
945           };
946 tony  1.1 
947           
948           // ==================================================================
949           // BindsTo
950           // ==================================================================
951              [Association, Version ("2.6.0"), Description (
952                  "This association establishes a ServiceAccessPoint as a "
953                  "requestor of protocol services from a ProtocolEndpoint.  "
954                  "Typically, this association runs between SAPs and endpoints on "
955                  "a single system.  Since a ProtocolEndpoint is a kind of "
956                  "ServiceAccessPoint, this binding can be used to establish a "
957                  "layering of two protocols, the upper layer represented by the "
958                  "Dependent and the lower layer represented by the Antecedent.") ]
959           class CIM_BindsTo : CIM_SAPSAPDependency {
960           
961                 [Override ("Antecedent"), Description (
962                     "The lower-level endpoint which is accessed by the SAP.") ]
963              CIM_ProtocolEndpoint REF Antecedent;
964           
965                 [Override ("Dependent"), Description (
966                     "The AccessPoint or ProtocolEndpoint dependent on the lower "
967 tony  1.1           "level endpoint.") ]
968              CIM_ServiceAccessPoint REF Dependent;
969           };
970           
971           
972           // ==================================================================
973           // ProvidesEndpoint
974           // ==================================================================
975              [Association, Version ("2.7.0"), Description (
976                  "This association represents a ProtocolEndpoint provided by a "
977                  "Service, to allow access to the Service.") ]
978           class CIM_ProvidesEndpoint : CIM_ServiceAccessBySAP {
979           
980                 [Override ("Antecedent"), Description (
981                     "The Service that is accessed by the ProtocolEndpoint.") ]
982              CIM_Service REF Antecedent;
983           
984                 [Override ("Dependent"), Description (
985                     "The ProtocolEndpoint that provides access to the Service.") ]
986              CIM_ProtocolEndpoint REF Dependent;
987           };
988 tony  1.1 
989           // ===================================================================
990           // end of file
991           // ===================================================================

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2