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

   1 a.dunfey 1.1 // ===================================================================
   2              // Title:       Software Resources
   3              // $State: Preliminary $
   4              // $Date: 2005/01/05 00:54:00 $
   5              // $Source: /home/dmtf2/dotorg/var/cvs/repositories/dev/Schema/MOF/Application_SWResources.mof,v $
   6              // $Revision: 1.9 $
   7              // ===================================================================
   8              //#pragma inLine ("Includes/copyright.inc")
   9              // Copyright 1998-2005 Distributed Management Task Force, Inc. (DMTF).
  10              // All rights reserved.
  11              // DMTF is a not-for-profit association of industry members dedicated
  12              // to promoting enterprise and systems management and interoperability.
  13              // DMTF specifications and documents may be reproduced for uses
  14              // consistent with this purpose by members and non-members,
  15              // provided that correct attribution is given.
  16              // As DMTF specifications may be revised from time to time,
  17              // the particular version and release date should always be noted.
  18              // 
  19              // Implementation of certain elements of this standard or proposed
  20              // standard may be subject to third party patent rights, including
  21              // provisional patent rights (herein "patent rights"). DMTF makes
  22 a.dunfey 1.1 // no representations to users of the standard as to the existence
  23              // of such rights, and is not responsible to recognize, disclose, or
  24              // identify any or all such third party patent right, owners or
  25              // claimants, nor for any incomplete or inaccurate identification or
  26              // disclosure of such rights, owners or claimants. DMTF shall have no
  27              // liability to any party, in any manner or circumstance, under any
  28              // legal theory whatsoever, for failure to recognize, disclose, or
  29              // identify any such third party patent rights, or for such party's
  30              // reliance on the standard or incorporation thereof in its product,
  31              // protocols or testing procedures. DMTF shall have no liability to
  32              // any party implementing such standard, whether such implementation
  33              // is foreseeable or not, nor to any patent owner or claimant, and shall
  34              // have no liability or responsibility for costs or losses incurred if
  35              // a standard is withdrawn or modified after publication, and shall be
  36              // indemnified and held harmless by any party implementing the
  37              // standard from any and all claims of infringement by a patent owner
  38              // for such implementations.
  39              // 
  40              // For information about patents held by third-parties which have
  41              // notified the DMTF that, in their opinion, such patent may relate to
  42              // or impact implementations of DMTF standards, visit
  43 a.dunfey 1.1 // http://www.dmtf.org/about/policies/disclosures.php.
  44              //#pragma inLine
  45              // ===================================================================
  46              // Description: The classes represent the characterization of
  47              //      software resources (SW resource). A SW resource is an
  48              //      abstraction of the utilization of other entities in the
  49              //      environment (communications, memory, files, etc.) within
  50              //      the context of the software entity being managed. This version
  51              //      version of software resources concentrates on
  52              //      entities to transfer data over space and time from the
  53              //      internal view of running software. Processor/CPU-like resources
  54              //      are not considered for now.
  55              //      Software for which resources exist can be vary from operating
  56              //      system to application systems. An application system is
  57              //      an entity that supports a particular business
  58              //      function and that can be managed as an independent unit.
  59              //      The behavior a software resource is that items bundled
  60              //      in transfers are input to or output from the resource.
  61              //      What happens to the items inside the resource depends on
  62              //      type of resource (transferring data over time or space) and
  63              //      the implementation.
  64 a.dunfey 1.1 //      The following types of software resources are considered:
  65              //      Buffer, Queue, Protocol Endpoint, Remote Interface, Pool,
  66              //      Cache, File and Database.
  67              //      The software resources consist of statistics that
  68              //      describe their input, output and allocation (size).
  69              //      An associated settings class allows for setting
  70              //      the limits (I/O, allocation) of the software
  71              //      resource. The limits are designed as one of the levers
  72              //      to manipulate and control the operation of the software
  73              //      through managing software resources. The statistics
  74              //      provide the operational parameters of the limits, performance
  75              //      metrics and error information for performance and fault
  76              //      management functions as well as management tasks like
  77              //      monitoring, reporting or root cause analysis.
  78              //      Some of the software resources (file, protocol endpoint
  79              //      and database) are linked to existing classes since they
  80              //      cannot share the same base class due to existing,
  81              //      incompatible inheritance hierarchies and the fact that they
  82              //      are concurrently viewed and controlled outside the software
  83              //      by the OS. Thus, software resources are aspects of these
  84              //      existing objects.
  85 a.dunfey 1.1 // 
  86              //      They are maintained as a separate MOF file in the
  87              //      Application Model.
  88              // 
  89              //      The object classes below are listed in an order that
  90              //      avoids forward references. Required objects, defined
  91              //      by other working groups, are omitted.
  92              // ==================================================================
  93              // Change Log for v2.9 Preliminary
  94              //      14 May 2004
  95              //         - CR 1312 - Original Software Resource Model
  96              // ===================================================================
  97              
  98              #pragma locale ("en_US")
  99              
 100              // ==================================================================
 101              // SoftwareResource
 102              // ==================================================================
 103                 [Experimental, Version ( "2.8.1000" ), Description (
 104                     "A Software Resource (SWR) is an abstraction of the utilization "
 105                     "of other entities in the environment (communications, memory, "
 106 a.dunfey 1.1        "files, etc.) within the context of the software entity being "
 107                     "managed. SWR have a component-like implementation that is "
 108                     "independently manageable from the real entity outside the "
 109                     "software. These implementations are often used for storage and "
 110                     "transmission. Thus, a Software Resource (SWR) is: \n"
 111                     "a) any entity that is used by a system (e.g. an application "
 112                     "system) to transfer data over space and time (i.e., no data "
 113                     "processing in terms of creation/deletion or modification of "
 114                     "data). In contrast to normal (application) services (i.e., the "
 115                     "abstraction of data processing in terms of its "
 116                     "creation/deletion etc.), the SWR has limits (bounds) that are "
 117                     "not to be exceeded. This version does not consider resources "
 118                     "like CPU. \n"
 119                     "b) the system's view of such a transfer entity. Note that the "
 120                     "software resource is ultimately contained by or related to a "
 121                     "limited (physical or logical) resource of the encompassing "
 122                     "(operating) system such as memory, storage or a communication "
 123                     "links. \n"
 124                     "Anything transferred by an SWR is called an 'item'. Items may "
 125                     "be data, code, connections, packets, etc.. Items are atomic in "
 126                     "the model, thus there is no partial items. \n"
 127 a.dunfey 1.1        "An instance only exists if a running system exists since it is "
 128                     "an internal component of the system implemented by its "
 129                     "software. Software resources are potentially external entities "
 130                     "like files viewed internally and (at least partially) "
 131                     "controlled by the software of the system. \n"
 132                     "SoftwareResource is contained by System via SystemComponent. "
 133                     "At least one system (e.g., one application system or a system "
 134                     "in general) contains 0 or more software resources. If more "
 135                     "than one system claims to contain the software resource, it is "
 136                     "a shared resource. \n"
 137                     "SoftwareResource is associated to SWRLimitSetting via "
 138                     "ElementSettingData. One software resource can have multiple "
 139                     "limit settings. Only one of the settings is the default and "
 140                     "one (potentially another one) is operational (current). "
 141                     "Settings can be shared by software resources. \n"
 142                     "SoftwareResource is associated to SWRStatistics via "
 143                     "ElementStatisticalData. In general, one software resource is "
 144                     "expected to have three statistics. The statistics type covers "
 145                     "each behavior characteristics at most once. I.e., the software "
 146                     "resource has at most one allocation statistcs, one input "
 147                     "statistics and one output statistics. Nevertheless, the "
 148 a.dunfey 1.1        "implementation of the software resource may exhibit more "
 149                     "statistics SWRStatistics instances that cover more "
 150                     "context-specific behavior characteristics.")]
 151              class CIM_SoftwareResource : CIM_EnabledLogicalElement {
 152              
 153                    [Key, Description (
 154                        "Within the scope of the instantiating Namespace, InstanceID "
 155                        "opaquely and uniquely identifies an instance of this class. "
 156                        "In order to ensure uniqueness within the NameSpace, the "
 157                        "value of InstanceID SHOULD be constructed using the "
 158                        "following 'preferred' algorithm: \n"
 159                        "<OrgID>:<LocalID> \n"
 160                        "Where <OrgID> and <LocalID> are separated by a colon ':', "
 161                        "and where <OrgID> MUST include a copyrighted, trademarked "
 162                        "or otherwise unique name that is owned by the business "
 163                        "entity creating/defining the InstanceID, or is a registered "
 164                        "ID that is assigned to the business entity by a recognized "
 165                        "global authority. (This is similar to the <Schema "
 166                        "Name>_<Class Name> structure of Schema class names.) In "
 167                        "addition, to ensure uniqueness <OrgID> MUST NOT contain a "
 168                        "colon (':'). When using this algorithm, the first colon to "
 169 a.dunfey 1.1           "appear in InstanceID MUST appear between <OrgID> and "
 170                        "<LocalID>. \n"
 171                        "<LocalID> is chosen by the business entity and SHOULD not "
 172                        "be re-used to identify different underlying (real-world) "
 173                        "elements. If the above 'preferred' algorithm is not used, "
 174                        "the defining entity MUST assure that the resultant "
 175                        "InstanceID is not re-used across any InstanceIDs produced "
 176                        "by this or other providers for this instance's NameSpace. \n"
 177                        "For DMTF defined instances, the 'preferred' algorithm MUST "
 178                        "be used with the <OrgID> set to 'CIM'.")]
 179                 string InstanceID;
 180              
 181                    [Description (
 182                        "IsAspect indicates whether the instance of this software "
 183                        "resource refers to another entity residing outside the - "
 184                        "software that implements the resource. This knowledge "
 185                        "should kept into account in order to solve control "
 186                        "conflicts. The property value is 'IsAspect' if the "
 187                        "instrumentation knows that there is a corresponding outside "
 188                        "managed entity, e.g., a file that corresponds to this "
 189                        "software resource. Values: \n"
 190 a.dunfey 1.1           "Is Aspect: The instance of the software resource is an "
 191                        "aspect. The logically identical entity external to the "
 192                        "software (e.g., a file) is known to exist. Is not Aspect: "
 193                        "The instance of the software resource is not an aspect. No "
 194                        "logically identical entity external to the software (e.g., "
 195                        "likely in the case of a buffer) is known to exist."), 
 196                     ValueMap { "0", "2" , "3", "4..32767", "32768..65535" }, 
 197                     Values { "Unknown", "Is Aspect", "Is not Aspect",
 198                        "DMTF Reserved","Vendor Reserved" }]
 199                 uint16 IsAspect;
 200              
 201              
 202                    [Description (
 203                        "The property value is 'Aspect Is in Use' if the software "
 204                        "resource is currently control of the software. E.g., it "
 205                        "still has a file handle of file. Any operations on the "
 206                        "corresponding outside entity (e.g., the file) can now "
 207                        "result in errors. E.g., the deletion of file from the "
 208                        "outside could be refused since it still opened by the "
 209                        "software. Note that currently no conflict resolution is "
 210                        "designed into software resource classes. \n"
 211 a.dunfey 1.1           "Values: \n"
 212                        "Aspect Is in Use: The software resource is in use by the "
 213                        "software (i.e., at least a reference to the resource is "
 214                        "held by the software). Access to the resource may result in "
 215                        "conflicting usage of any logically identical entity "
 216                        "external to this software. \n"
 217                        "Aspect Is not in Use: In special cases it may be the case "
 218                        "that the software resource is currently not controlled by "
 219                        "the software (i.e., a file is currently not accessed by the "
 220                        "software and the file handle is returned. The software "
 221                        "resource object exists without having the file in use."), 
 222                     ValueMap { "0", "2", "3", "4..32767", "32768..65535" }, 
 223                     Values { "Unknown", "Aspect Is in Use", "Aspect Is not in Use",
 224                        "DMTF Reserved","Vendor Reserved" }]
 225                 uint16 AspectInUse = 2;
 226              
 227                    [Description (
 228                        "ByReference indicates whether the software resource handles "
 229                        "only references to items, but not the items itself. This "
 230                        "can be the case for buffers or pools, where the items "
 231                        "reside in the memory that was originally allocated for them "
 232 a.dunfey 1.1           "and only the reference is kept in the buffer. Other "
 233                        "implementations or software resource types, especially "
 234                        "distributed resources that require data transfer over space "
 235                        "(i.e., communication) may deal with the entire item. \n"
 236                        "Values: \n"
 237                        "Items Are References: The software resource holds only "
 238                        "pointers to the items (e.g., connections in a connection "
 239                        "pool. \n"
 240                        "Items Are Copies: The software resources transfers entire "
 241                        "items, i.e., the items are copied from one place to another "
 242                        "(e.g., packets in a communication)."), 
 243                     ValueMap { "0", "2", "3", "4..32767", "32768..65535" }, 
 244                     Values { "Unknown", "Items Are References", "Items Are Copies",
 245                        "DMTF Reserved","Vendor Reserved" }]
 246                 uint16 ByReference;
 247              
 248                    [Description (
 249                        "The type of the software resource. Although the behavior of "
 250                        "the different software resource types is modeled similarly, "
 251                        "different names for resources transferring data over time "
 252                        "or/and space have been established. SoftwareResourceType "
 253 a.dunfey 1.1           "conveys their original, most common name. \n"
 254                        "Values: \n"
 255                        "Buffer: volatile storage (transfer over time). \n"
 256                        "Queue: transfer over time (the internal FIFO) and often "
 257                        "over space (as entry point to a communication link. Both, "
 258                        "volatile and persistent versions exit. \n"
 259                        "Protocol Endpoint: transfer over space, entry point to a "
 260                        "communication link \n"
 261                        "Remote Interface: A generalized protocol endpoint without a "
 262                        "specific protocol. Is a proxy. \n"
 263                        "Pool: A special buffer. Clearly the lower allocation limit "
 264                        "is the important limit, i.e., depletion of the pool is a "
 265                        "problem. \n"
 266                        "Cache: Another special buffer with an aging algorithm for "
 267                        "dropping items held in the cache. \n"
 268                        "File: the simplest form of persistent storage. \n"
 269                        "Database: a more sophisticated form of persistent storage "
 270                        "that may consist of several files."), 
 271                     ValueMap { "0", "2", "3", "4", "5", "6", "7", "8", "9",
 272                        "10..32767", "32768..65535" }, 
 273                     Values { "Unknown", "Buffer", "Queue", "Protocol Endpoint",
 274 a.dunfey 1.1           "Remote Interface", "Pool", "Cache", "File", "Database",
 275                        "DMTF Reserved","Vendor Reserved" }]
 276                 uint16 SoftwareResourceType;
 277              
 278                    [Description (
 279                        "Error situations may sometimes require drastic measures. "
 280                        "One of them being the complete re-initialization of an "
 281                        "software resource. Re-initialization includes that the "
 282                        "resource is emptied entirely and the limit settings are "
 283                        "newly applied. \n"
 284                        "Reintialize Already in Progress: software resource still "
 285                        "being reinitialized."), 
 286                     ValueMap { "0", "1", "2", "3", "4", "6", "7", "8", "9..32767",
 287                        "32768..65535" }, 
 288                     Values { "Success", "Not Supported", "Unknown", "Timeout",
 289                        "Failed", "Access Denied", "Not Found",
 290                        "Reinitialize already in Progress", "DMTF Reserved",
 291                        "Vendor Specific" }]
 292                 uint32 Reinitialize(); 
 293              };
 294              
 295 a.dunfey 1.1 
 296              // ==================================================================
 297              // SWRLimitSetting
 298              // ==================================================================
 299              
 300                 [Experimental, Version ( "2.8.1000" ), Description (
 301                     "SWRLimitSetting describes the limits of the software resource. "
 302                     "In essence it is possible to define 6 different types of "
 303                     "limits in groups of three. Each group consists of allocation, "
 304                     "input and output limits. One group is always expressed by "
 305                     "technical units (the default) and the other group in "
 306                     "domain-specific units (e.g., items per second as the input "
 307                     "limit). Thus, they are of different types. In order to avoid "
 308                     "inconsistencies, only one group of settings is writable. The "
 309                     "other one is derived from the writable limits. I.e., if "
 310                     "technical limits are specifiable by the user (the type of the "
 311                     "settings is technical) then the other set of limits (the "
 312                     "non-writeable and derived settings) are domain-specific. \n"
 313                     "SWRLimitSetting is associated to SoftwareResource via "
 314                     "ElementSettingData. One software resource can have multiple "
 315                     "limit settings. Only one of the settings is the default and "
 316 a.dunfey 1.1        "one (potentially another one) is operational (current). "
 317                     "Settings can be shared by software resources.")]
 318              class CIM_SWRLimitSetting : CIM_SettingData {
 319              
 320                    [Write, Description (
 321                        "This is the lower limit of the input of the software "
 322                        "resource. In general, the limit is a rate (i.e., items per "
 323                        "second or Bytes per second). The corresponding unit is "
 324                        "found at the property InputUnit. A null value indicates "
 325                        "that no lower limit exists. The property value can be "
 326                        "modified and is persisted on saving the modification."), 
 327                     ModelCorrespondence { "CIM_SWRLimitSetting.InputUnit" }]
 328                 uint32 LowerInputLimit;
 329              
 330                    [Write, Description (
 331                        "This is the upper limit of the input of the software "
 332                        "resource. In general, the limit is a rate (i.e., items per "
 333                        "second or Bytes per second). The corresponding unit is "
 334                        "found at the property InputUnit. A null value indicates "
 335                        "that no upper limit exists. The property value can be "
 336                        "modified and is persisted on saving the modification."), 
 337 a.dunfey 1.1        ModelCorrespondence { "CIM_SWRLimitSetting.InputUnit" }]
 338                 uint32 UpperInputLimit;
 339              
 340                    [Description (
 341                        "This is the unit of the input limits of the software "
 342                        "resource. In general, the unit describes a rate (i.e., "
 343                        "items per second or Bytes per second). A null value is only "
 344                        "allowed if neither upper nor lower limit exist. Otherwise, "
 345                        "the property value is read-only and assumed to be "
 346                        "correspond to the implementation of the software resource "
 347                        "to which the settings have to apply."), 
 348                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherInputUnit",
 349                        "CIM_SWRLimitSetting.LimitSettingType" }]
 350                 string InputUnit;
 351              
 352                    [Write, Description (
 353                        "This is the lower limit of the output of the software "
 354                        "resource. In general, the limit is a rate (i.e., items per "
 355                        "second or Bytes per second). The corresponding unit is "
 356                        "found at the property OutputUnit. A null value indicates "
 357                        "that no lower limit exists. The property value can be "
 358 a.dunfey 1.1           "modified and is persisted on saving the modification."), 
 359                     ModelCorrespondence { "CIM_SWRLimitSetting.OutputUnit" }]
 360                 uint32 LowerOutputLimit;
 361              
 362                    [Write, Description (
 363                        "This is the upper limit of the output of the software "
 364                        "resource. In general, the limit is a rate (i.e., items per "
 365                        "second or Bytes per second). The corresponding unit is "
 366                        "found at the property OutputUnit. A null value indicates "
 367                        "that no upper limit exists. The property value can be "
 368                        "modified and is persisted on saving the modification."), 
 369                     ModelCorrespondence { "CIM_SWRLimitSetting.OutputUnit" }]
 370                 uint32 UpperOutputLimit;
 371              
 372                    [Description (
 373                        "This is the unit of the output limits of the software "
 374                        "resource. In general, the unit describes a rate (i.e., "
 375                        "items per second or Bytes per second). A null value is only "
 376                        "allowed if neither upper nor lower limit exist. Otherwise, "
 377                        "the property value is read-only and assumed to be "
 378                        "correspond to the implementation of the software resource "
 379 a.dunfey 1.1           "to which the settings have to apply."), 
 380                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherOutputUnit",
 381                        "CIM_SWRLimitSetting.LimitSettingType" }]
 382                 string OutputUnit;
 383              
 384                    [Write, Description (
 385                        "This is the lower limit of the allocation (i.e., size) of "
 386                        "the software resource. In general, the limit is a quantity "
 387                        "(i.e., items or Megabytes). The corresponding unit is found "
 388                        "at the property AllocationUnit. A null value indicates that "
 389                        "no allocation limit exists. The property value can be "
 390                        "modified and is persisted on saving the modification."), 
 391                     ModelCorrespondence { "CIM_SWRLimitSetting.AllocationUnit" }]
 392                 uint32 LowerAllocationLimit;
 393              
 394                    [Write, Description (
 395                        "This is the upper limit of the allocation (i.e., size) of "
 396                        "the software resource. In general, the limit is a quantity "
 397                        "(i.e., items or Megabytes). The corresponding unit is found "
 398                        "at the property AllocationUnit. A null value indicates that "
 399                        "no allocation limit exists. The property value can be "
 400 a.dunfey 1.1           "modified and is persisted on saving the modification."), 
 401                     ModelCorrespondence { "CIM_SWRLimitSetting.AllocationUnit" }]
 402                 uint32 UpperAllocationLimit;
 403              
 404                    [Description (
 405                        "This is the unit of the allocation limits of the software "
 406                        "resource. In general, the unit describes a quantity (i.e., "
 407                        "items MegyBytes). A null value is only allowed if neither "
 408                        "upper nor lower limit exist. Otherwise, the property value "
 409                        "is read-only and assumed to correspond to the "
 410                        "implementation of the software resource to which the "
 411                        "settings have to apply. The default value is of the "
 412                        "technical domain (kB per second)."), 
 413                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherAllocationUnit",
 414                        "CIM_SWRLimitSetting.LimitSettingType" }]
 415                 string AllocationUnit ="MB";
 416              
 417                    [Description (
 418                        "This property is not null, if the lower input limit of the "
 419                        "software resource can be calculated from the property "
 420                        "LowerInputLimit. If LowerInputLimit is described by "
 421 a.dunfey 1.1           "technical units (i.e., InputUnit applies to the technical "
 422                        "domain), OtherLowerInputLimit is described by "
 423                        "domain-specific units."), 
 424                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherInputUnit" }]
 425                 uint32 OtherLowerInputLimit;
 426              
 427                    [Description (
 428                        "This property is not null, if the upper input limit of the "
 429                        "software resource can be calculated from the property "
 430                        "UpperInputLimit. If UpperInputLimit is described by "
 431                        "technical units (i.e., InputUnit applies to the technical "
 432                        "domain), OtherUpperInputLimit is described by "
 433                        "domain-specific units."), 
 434                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherInputUnit" }]
 435                 uint32 OtherUpperInputLimit;
 436              
 437                    [Description (
 438                        "This is the complementary unit of the input limits. If "
 439                        "InputUnit is a unit of the technical domain, OtherInputUnit "
 440                        "is a domain-specific unit."), 
 441                     ModelCorrespondence { "CIM_SWRLimitSetting.InputUnit" }]
 442 a.dunfey 1.1    string OtherInputUnit;
 443              
 444                    [Description (
 445                        "This property is not null, if the lower output limit of the "
 446                        "software resource can be calculated from the property "
 447                        "LowerOutputLimit. If LowerOutputLimit is described by "
 448                        "technical units (i.e., OutputUnit applies to the technical "
 449                        "domain), OtherLowerOutputLimit is described by "
 450                        "domain-specific units."), 
 451                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherOutputUnit" }]
 452                 uint32 OtherLowerOutputLimit;
 453              
 454                    [Description (
 455                        "This property is not null, if the upper output limit of the "
 456                        "software resource can be calculated from the property "
 457                        "UpperOutputLimit. If UpperOutputLimit is described by "
 458                        "technical units (i.e., OutputUnit applies to the technical "
 459                        "domain), OtherUpperOutputLimit is described by "
 460                        "domain-specific units."), 
 461                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherOutputUnit" }]
 462                 uint32 OtherUpperOutputLimit;
 463 a.dunfey 1.1 
 464                    [Description (
 465                        "This is the complementary unit of the output limits. If "
 466                        "OutputUnit is a unit of the technical domain, "
 467                        "OtherOutputUnit is a domain-specific unit."), 
 468                     ModelCorrespondence { "CIM_SWRLimitSetting.OutputUnit" }]
 469                 string OtherOutputUnit;
 470              
 471                    [Description (
 472                        "This property is not null, if the lower allocation limit of "
 473                        "the software resource can be calculated from the property "
 474                        "LowerAllocationLimit. If LowerAllocationLimit is described "
 475                        "by technical units (i.e., AllocationUnit applies to the "
 476                        "technical domain), OtherLowerAllocationLimit is described "
 477                        "by domain-specific units."), 
 478                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherAllocationUnit" 
 479                        }]
 480                 uint32 OtherLowerAllocationLimit;
 481              
 482                    [Description (
 483                        "This property is not null, if the upper allocation limit of "
 484 a.dunfey 1.1           "the software resource can be calculated from the property "
 485                        "UpperAllocationLimit. If UpperAllocationLimit is described "
 486                        "by technical units (i.e., AllocationUnit applies to the "
 487                        "technical domain), OtherUpperAllocationLimit is described "
 488                        "by domain-specific units."), 
 489                     ModelCorrespondence { "CIM_SWRLimitSetting.OtherAllocationUnit" 
 490                        }]
 491                 uint32 OtherUpperAllocationLimit;
 492              
 493                    [Description (
 494                        "This is the complementary unit of the output limits. If "
 495                        "OutputUnit is a unit of the technical domain, "
 496                        "OtherOutputUnit is a domain-specific unit."), 
 497                     ModelCorrespondence { "CIM_SWRLimitSetting.AllocationUnit" }]
 498                 string OtherAllocationUnit;
 499              
 500                    [Description (
 501                        "LimitSettingType describes whether the limits are specified "
 502                        "in terms of technical units or domain-specific units. "
 503                        "Domain-specific is meant to be the items unit or 'business' "
 504                        "unit of the usage the software resource. It may range from "
 505 a.dunfey 1.1           "objects or tables (in a buffer) to orders in a queue. It "
 506                        "depends on the implementation and usage context of the "
 507                        "software resource. The default is the technical domain. \n"
 508                        "Values: \n"
 509                        "Technical: The writable setting properties are assigned a "
 510                        "technical unit e.g Kilobytes. \n"
 511                        "Domain-Specific: The writable setting properties are "
 512                        "assigned a business-like, item-oriented unit e.g messages, "
 513                        "objects, orders, etc.."), 
 514                     ValueMap { "0", "2", "3", "4..32767", "32768..65535" }, 
 515                     Values { "Unknown", "Technical", "Domain-Specific",
 516                        "DMTF Reserved","Vendor Reserved" }]
 517                 uint16 LimitSettingType = 2;
 518              };
 519              
 520              
 521              // ==================================================================
 522              // SWRStatistics
 523              // ==================================================================
 524              
 525                 [Experimental, Version ( "2.8.1000" ), Description (
 526 a.dunfey 1.1        "This is base class for the software resource statistics. "
 527                     "Depending on the implementation it can be of six types that "
 528                     "identify the unit type (technical or domain-specific) and the "
 529                     "behavioral characteristic of the software resource "
 530                     "(allocation, input or output). The statistics is also the "
 531                     "place at which the corresponding operational settings of the "
 532                     "software resource appear. These parameters are changeable "
 533                     "on-the-fly (i.e., they are writable). They bear the same "
 534                     "constraints regarding their interdependencies between "
 535                     "technical and domain-specific units as SWRLimitSettings. \n"
 536                     "Point metrics apply to the point in time of end of the sample, "
 537                     "interval metrics apply to the sample interval. It is up to the "
 538                     "implementation of the statistcs whether the sample interval "
 539                     "ends at the point in time of the request of the instance of "
 540                     "this class (working with internal ring buffers) or whether the "
 541                     "underlying instrumentation autonomously determines the "
 542                     "beginning and the end of the sample interval. \n"
 543                     "SWRStatistics is associated to SoftwareResource via "
 544                     "ElementStatisticalData. In general, one software resource is "
 545                     "expected to have three statistics. The statistics type covers "
 546                     "each behavior characteristics at most once. I.e., the software "
 547 a.dunfey 1.1        "resource has at most one allocation statistcs, one input "
 548                     "statistics and one output statistics. Nevertheless, the "
 549                     "implementation of the software resource may exhibit more "
 550                     "statistics SWRStatistics instances that cover more "
 551                     "context-specific behavior characteristics.")]
 552              class CIM_SWRStatistics : CIM_StatisticalData {
 553              
 554                    [Write, Description (
 555                        "This is an operational lower limit parameter of the "
 556                        "software resource. The limit applies to input, output or "
 557                        "allocation according to the statistics type. The "
 558                        "corresponding unit is found at the property Unit. A null "
 559                        "value indicates that no lower limit exists. The property "
 560                        "value can be modified. Whether changes are persisted on "
 561                        "saving the modification depends on the implementation of "
 562                        "the software resource. The default behavior is no "
 563                        "persistence."), 
 564                     ModelCorrespondence { "CIM_SWRLimitSetting.LowerInputLimit",
 565                        "CIM_SWRLimitSetting.LowerOutputLimit",
 566                        "CIM_SWRLimitSetting.LowerAllocationLimit" }]
 567                 uint32 LowerLimit;
 568 a.dunfey 1.1 
 569                    [Write, Description (
 570                        "This is an operational upper limit parameter of the "
 571                        "software resource. The limit applies to input, output or "
 572                        "allocation according to the statistics type. The "
 573                        "corresponding unit is found at the property Unit. A null "
 574                        "value indicates that no upper limit exists. The property "
 575                        "value can be modified. Whether changes are persisted on "
 576                        "saving the modification depends on the implementation of "
 577                        "the software resource. The default behavior is no "
 578                        "persistence."), 
 579                     ModelCorrespondence { "CIM_SWRLimitSetting.UpperInputLimit",
 580                        "CIM_SWRLimitSetting.UpperOutputLimit",
 581                        "CIM_SWRLimitSetting.UpperAllocationLimit" }]
 582                 uint32 UpperLimit;
 583              
 584                    [Description (
 585                        "This is the unit of the numeric metrics and the set of "
 586                        "upper and lower limits of the software resource. The "
 587                        "property should always have a value, null should not "
 588                        "appear.The property value is read-only and assumed to "
 589 a.dunfey 1.1           "correspond to the implementation of the software resource "
 590                        "to which the operational parameters and metrics apply. The "
 591                        "default value is of the technical domain (Kilobytes)."), 
 592                     ModelCorrespondence { "CIM_SWRLimitSetting.InputUnit",
 593                        "CIM_SWRLimitSetting.OutputUnit",
 594                        "CIM_SWRLimitSetting.AllocationUnit" }]
 595                 string Unit = "kB";
 596              
 597                    [Description (
 598                        "This property is not null, if the operational lower limit "
 599                        "parameter of the software resource can be calculated from "
 600                        "the property LowerLimit. If LowerLimit is described by "
 601                        "technical units (i.e., InputUnit applies to the technical "
 602                        "domain), OtherLowerLimit is described by domain-specific "
 603                        "units.")]
 604                 uint32 OtherLowerLimit;
 605              
 606                    [Description (
 607                        "This property is not null, if the operational upper limit "
 608                        "parameter of the software resource can be calculated from "
 609                        "the property UpperLimit. If UpperLimit is described by "
 610 a.dunfey 1.1           "technical units (i.e., InputUnit applies to the technical "
 611                        "domain), OtherUpperLimit is described by domain-specific "
 612                        "units.")]
 613                 uint32 OtherUpperLimit;
 614              
 615                    [Description (
 616                        "This is the complementary unit of the operational limit "
 617                        "parameters. If Unit is a unit of the technical domain, "
 618                        "OtherUnit is a domain-specific unit.")]
 619                 string OtherUnit;
 620              
 621                    [Description (
 622                        "Characteristic allows for the distinction of the software "
 623                        "resource behavior characteristics. This is either the "
 624                        "allocation, input and output. \n"
 625                        "Values: \n"
 626                        "Allocation: Statistics about the size of the software "
 627                        "resource. \n"
 628                        "Input: Statistics about the data transfer into the software "
 629                        "resource. \n"
 630                        "Output: Statistics about the data transfer from the "
 631 a.dunfey 1.1           "software resource."), 
 632                     ValueMap { "0", "2", "3", "4", "5..32767", "32768..65535" }, 
 633                     Values { "Unknown", "Allocation", "Input", "Output",
 634                        "DMTF Reserved","Vendor Reserved" }]
 635                 uint16 Characteristic;
 636              
 637                    [Description (
 638                        "StatisticsType describes whether the statistics is "
 639                        "specified in terms of technical units or domain-specific "
 640                        "units. Domain-specific is meant to be the items unit or "
 641                        "'business' unit of the usage the software resource. It may "
 642                        "range from objects or tables (in a buffer) to orders in a "
 643                        "queue. It depends on the implementation and usage context "
 644                        "of the software resource. The default is the technical "
 645                        "domain. \n"
 646                        "Values: \n"
 647                        "Technical: The writable operational parameters and the "
 648                        "affected metrics are assigned a technical unit e.g "
 649                        "Kilobytes. \n"
 650                        "Domain-Specific: The writable operational parameters and "
 651                        "the affected metrics are assigned a business-like, "
 652 a.dunfey 1.1           "item-oriented unit e.g messages, objects, orders, etc.."), 
 653                     ValueMap { "0", "2", "3", "4..32767", "32768..65535" }, 
 654                     Values { "Unknown", "Technical", "Domain-Specific",
 655                        "DMTF Reserved","Vendor Reserved" }]
 656                 uint16 StatisticsType = 2;
 657              
 658              
 659                    [Description (
 660                        "This is the error code of the first error that occurs "
 661                        "during the sample interval. It is assumed that the first "
 662                        "error, detected throughout the sample interval, is the "
 663                        "first symptom of the root cause and therefore closer than "
 664                        "the last error. Unrelated, subsequent errors during the "
 665                        "sample interval of the statistics do not show up. Such a "
 666                        "behavior is tolerable compared to the relatively short "
 667                        "length of the sample interval. \n"
 668                        "Values: \n"
 669                        "Unspecified Error: No error code can be determined. \n"
 670                        "Violate Upper Limit: The upper limit of the behavior "
 671                        "characteristic (allocation, input, output) was exceeded. \n"
 672                        "Violate Lower Limit: The lower limit was underrun. \n"
 673 a.dunfey 1.1           "Erroneous Transfer: The transfer had to be aborted. This "
 674                        "message does not overlap with 'Erroneous Item'. \n"
 675                        "Erroneous Item: The handling of at least one item was "
 676                        "problematic and the item had to be dropped, suspended or "
 677                        "rejected. \n"
 678                        "Access to Software Resource Denied: The access control of "
 679                        "software resource refused the use of the it."), 
 680                     ValueMap { "0", "2", "3", "4", "5", "6", "7..32767",
 681                        "32768..65535" }, 
 682                     Values { "Unspecified Error", "Violate Upper Limit",
 683                        "Violate Lower Limit",
 684                        "Erroneous Transfer" , "Erroneous Item",
 685                        "Access to Software Resource Denied", "DMTF Reserved",
 686                        "Vendor Reserved" }]
 687                 uint16 FirstError;
 688              
 689                    [Description (
 690                        "FirstErrorTimeStamp is the point in time at which "
 691                        "FirstError was detected.")]
 692                 datetime FirstErrorTimeStamp;
 693              
 694 a.dunfey 1.1       [Description (
 695                        "This is the error code of the last error that occured. The "
 696                        "value of LastError remains from one sample interval to the "
 697                        "next even if a sample interval is error-free. \n"
 698                        "Values: \n"
 699                        "Unspecified Error: No error code can be determined. \n"
 700                        "Violate Upper Limit: The upper limit of the behavior "
 701                        "characteristic (allocation, input, output) was exceeded. \n"
 702                        "Violate Lower Limit: The lower limit was underrun. \n"
 703                        "Erroneous Transfer: The transfer had to be aborted. This "
 704                        "message does not overlap with 'Erroneous Item'. \n"
 705                        "Erroneous Item: The handling of at least one item was "
 706                        "problematic and the item had to be dropped, suspended or "
 707                        "rejected. \n"
 708                        "Access to Software Resource Denied: The access control of "
 709                        "software resource refused the use of the it."), 
 710                     ValueMap { "0", "2", "3", "4", "5", "6", "7..32767",
 711                        "32768..65535" }, 
 712                     Values { "Unspecified Error", "Violate Upper Limit",
 713                        "Violate Lower Limit",
 714                        "Erroneous Transfer" , "Erroneous Item",
 715 a.dunfey 1.1           "Access to Software Resource Denied", "DMTF Reserved",
 716                        "Vendor Reserved" }]
 717                 uint16 LastError;
 718              
 719                    [Description (
 720                        "LastErrorTimeStamp is the point in time at which FirstError "
 721                        "was detected.")]
 722                 datetime LastErrorTimeStamp;
 723              
 724                    [Description (
 725                        "ErrorCount is the count of errors that have been detected "
 726                        "throughout the sample interval.")]
 727                 uint32 ErrorCount;
 728              };
 729              
 730              
 731              // ==================================================================
 732              // SWRAllocationStatistics
 733              // ==================================================================
 734              
 735                 [Experimental, Version ( "2.8.1000" ), Description (
 736 a.dunfey 1.1        "The metrics of SWRAllocationStatistics describe the allocation "
 737                     "of the software resource. The allocation is basically the size "
 738                     "of the software resource in terms of technical units (e.g., "
 739                     "kB) or domain-specific units (e.g., the number of items (e.g., "
 740                     "the number of messages if the software resource is of the type "
 741                     "'queue'). \n"
 742                     "The operational parameters regarding the allocation limits are "
 743                     "surfaced also. Further details can be found in the description "
 744                     "of the base class SWRStatistics. \n"
 745                     "The metrics found in this statistics are raw values that "
 746                     "describe the allocation behavior of the software resource as "
 747                     "simple as possible. Thus, the metric values can be used most "
 748                     "flexibly (e.g., cumulative, averaged, etc.). The drawback of "
 749                     "the flexibility is that the likelyhood of required "
 750                     "calculations - subsequent to retrieval of the values - "
 751                     "increases in order to result in rates or statistical data "
 752                     "needed for monitoring and reporting.")]
 753              class CIM_SWRAllocationStatistics : CIM_SWRStatistics {
 754              
 755                    [Description (
 756                        "AllocationLevel describes the current size of the software "
 757 a.dunfey 1.1           "resource in units corresponding to the type of the "
 758                        "statistics (e.g., technical based on Kilobytes). The unit "
 759                        "can be found at the CIM_SWRStatistics.Unit. \n"
 760                        "The metric is a point metric and applies to the point in "
 761                        "time of the end of the sample interval. \n"
 762                        "A value of null indicates that no allocation level is "
 763                        "available. \n"
 764                        "The initial value is 0."), 
 765                     ModelCorrespondence { "CIM_SWRStatistics.Unit" }]
 766                 uint32 AllocationLevel;
 767              
 768                    [Description (
 769                        "OtherAllocationLevel describes the current size of the "
 770                        "software resource in complementary units compared to "
 771                        "AllocationLevel (e.g., domain-specific units like the "
 772                        "number of items: buffered objects or pooled connections). "
 773                        "The unit can be found at CIM_SWRStatistics.OtherUnit. \n"
 774                        "The metric is a point metric and applies to the point in "
 775                        "time of the end of the sample interval. A value of null "
 776                        "indicates that no allocation level is available. \n"
 777                        "The initial value is 0."), 
 778 a.dunfey 1.1        ModelCorrespondence { "CIM_SWRStatistics.OtherUnit",
 779                        "CIM_SWRAllocationStatistics.AllocationLevel" }]
 780                 uint32 OtherAllocationLevel;
 781              
 782                    [Description (
 783                        "AverageItemResidenceTime describes the average period of "
 784                        "time that items reside in the software resource. This is "
 785                        "particular interesting for blocked or (volatile) storage "
 786                        "software resources. The average takes all items into "
 787                        "account that are output from the software resource (i.e., "
 788                        "the items' residence time ends). \n"
 789                        "A value of null indicates that no average is available. \n"
 790                        "The initial value is 0.")]
 791                 datetime AverageItemResidenceTime;
 792              
 793                    [Description (
 794                        "AllocationHighWaterMark describes allocation peak (highest "
 795                        "allocation level) reached throughout the sample interval. "
 796                        "The unit depends on the type of the statistics. The "
 797                        "timestamp that corresponds to the high water mark is not "
 798                        "presented since the sample interval is small enough that "
 799 a.dunfey 1.1           "the exact point in time is not significant. The metric is "
 800                        "targeted to quantify errors like the violation of the upper "
 801                        "limit or any capacity problems. A value of null indicates "
 802                        "that no allocation level is available. \n"
 803                        "The initial value is 0."), 
 804                     ModelCorrespondence { "CIM_SWRStatistics.Unit",
 805                        "CIM_SWRAllocationStatistics.AllocationHighWaterMark" }]
 806                 uint32 AllocationHighWaterMark;
 807              
 808                    [Description (
 809                        "HighWaterMarkTimeStamp is the point in time at which the "
 810                        "high water mark was detected. \n"
 811                        "The initial value is 0."), 
 812                     ModelCorrespondence { 
 813                        "CIM_SWRAllocationStatistics.AllocationHighWaterMark" }]
 814                 datetime HighWaterMarkTimeStamp;
 815              
 816                    [Description (
 817                        "DroppedAllocationQuantity allows to further quantify the "
 818                        "error of the software resource is over-used and upper "
 819                        "limits are reached. In such a case, aging algorithms or "
 820 a.dunfey 1.1           "other priorization algorithms implemented by the software "
 821                        "resource may enforce the deletion of items. "
 822                        "DroppedAllocationQuantity counts the items dropped due the "
 823                        "resolution of such an overload. The metric's unit depends "
 824                        "on the type of the statistics. If no items have been "
 825                        "dropped, the value is 0. The property value is null if no "
 826                        "numeric value can be provided. \n"
 827                        "The initial value is 0.")]
 828                 uint32 DroppedAllocationQuantity;
 829              };
 830              
 831              
 832              // ==================================================================
 833              // SWRIOStatistics
 834              // ==================================================================
 835              
 836                 [Experimental, Version ( "2.8.1000" ), Description (
 837                     "The metrics of SWRIOStatistics describe the transfer behavior "
 838                     "of the software resource in one particular direction (input or "
 839                     "the output). The transfer is basically the amount of data "
 840                     "input to or output from the software resource during a sample "
 841 a.dunfey 1.1        "interval in terms of technical units (e.g., kB) or "
 842                     "domain-specific units (e.g., the number of items (e.g., the "
 843                     "number of messages if the software resource is of the type "
 844                     "'queue'). \n"
 845                     "The operational parameters regarding the allocation limits are "
 846                     "surfaced also. Further details can be found in the description "
 847                     "of the base class SWRStatistics. \n"
 848                     "The metrics found in this statistics are raw values that "
 849                     "describe the allocation behavior of the software resource as "
 850                     "simple as possible. Thus, the metric values can be used most "
 851                     "flexibly (e.g., cumulative, averaged, etc.). The drawback of "
 852                     "the flexibility is that the likelyhood of required "
 853                     "calculations - subsequent to retrieval of the values - "
 854                     "increases in order to result in rates or statistical data "
 855                     "needed for monitoring and reporting.")]
 856              class CIM_SWRIOStatistics : CIM_SWRStatistics {
 857              
 858                    [Description (
 859                        "TransferredQuantity describes the quantity transferred "
 860                        "to/from the software resource in units corresponding to the "
 861                        "type of the statistics (e.g., technical based on "
 862 a.dunfey 1.1           "Kilobytes). The unit can be found at the "
 863                        "CIM_SWRStatistics.Unit. The direction of the transfer can "
 864                        "be found at the type of the statistics. \n"
 865                        "The metric accumulates the transfer quantity over the "
 866                        "sample interval and is the gross amount of data transferred "
 867                        "to/from the software resource. \n"
 868                        "A value of null indicates that no quantity is available. "
 869                        "The value is 0 if no transfer happened or all transfers "
 870                        "where empty. (Note that this must be true for both the "
 871                        "request and the response). \n"
 872                        "The corresponding limits are expected to be a rate. One "
 873                        "method to detect limit violations require the division of "
 874                        "TransferredQuantity by the sample interval in order to "
 875                        "result in rate that then can be compared to the "
 876                        "corresponding limit. \n"
 877                        "The initial value is 0."), 
 878                     ModelCorrespondence { "CIM_SWRStatistics.Unit",
 879                        "CIM_SWRStatistics.StatisticsType" }]
 880                 uint32 TransferredQuantity;
 881              
 882                    [Description (
 883 a.dunfey 1.1           "OtherTransferredQuantity describes the transfer size of the "
 884                        "software resource in complementary units compared to "
 885                        "AllocationLevel (e.g., domain-specific units like the "
 886                        "number of items: buffered objects or pooled connections). "
 887                        "The unit can be found at CIM_SWRStatistics.OtherUnit. \n"
 888                        "The metric accumulates the transfer quantity over the "
 889                        "sample interval. \n"
 890                        "A value of null indicates that no quantity is available. \n"
 891                        "The initial value is 0."), 
 892                     ModelCorrespondence { "CIM_SWRStatistics.OtherUnit",
 893                        "CIM_SWRIOStatistics.TransferredQuantity" }]
 894                 uint32 OtherTransferredQuantity;
 895              
 896                    [Description (
 897                        "Transfers is the count of all transfers (sucessful or not) "
 898                        "that happened during the sample interval. If the value is "
 899                        "null no number can be provided. \n"
 900                        "The initial value is 0.")]
 901                 uint32 Transfers;
 902              
 903                    [Description (
 904 a.dunfey 1.1           "AverageTransferTime is the average time all counted "
 905                        "transfers took during the sample interval. If the value is "
 906                        "null no average can be provided. \n"
 907                        "The initial value is 0.")]
 908                 datetime AverageTransferTime;
 909              
 910                    [Description (
 911                        "SuccessfulTransfers is the count of all transfers that "
 912                        "could be executing fully (i.e., transfer all items "
 913                        "requested) during the sample interval. If the value is null "
 914                        "no number can be provided. In case of errors, the property "
 915                        "can be used to quantify the quality with which the software "
 916                        "resource works. \n"
 917                        "The initial value is 0.")]
 918                 uint32 SuccessfulTransfers;
 919              
 920                    [Description (
 921                        "SuccessfulQuantity specifies the successfully transferred "
 922                        "amount of data to/from the software resource. It is the net "
 923                        "amount in contrast to TransferredQuantity. \n"
 924                        "The unit can be found at the CIM_SWRStatistics.Unit. The "
 925 a.dunfey 1.1           "direction of the transfer can be found at the type of the "
 926                        "statistics. \n"
 927                        "If the value is null no number can be provided. \n"
 928                        "The initial value is 0."), 
 929                     ModelCorrespondence { "CIM_SWRStatistics.Unit" }]
 930                 uint32 SuccessfulQuantity;
 931              
 932                    [Description (
 933                        "CountOfActiveTransfers is a point metric and applies to the "
 934                        "point in time of the end of the sample interval. It "
 935                        "describes the number of in-progress transfers. This also "
 936                        "includes pending, suspended, open and asynchronous requests "
 937                        "that obviously have not been acknowledged to the requestor "
 938                        "of the transfer. If the implementation of the resource is "
 939                        "single process, single thread and synchronous (i.e., no "
 940                        "internal queue), the number cannot be greater than 1 since "
 941                        "no parallel requests can occur. \n"
 942                        "A value of null indicates that no count is available. A "
 943                        "value of 0 indicates no active requests. An increasing "
 944                        "number indicates that the software resource hangs and a "
 945                        "reinitialize() can solve the problem. \n"
 946 a.dunfey 1.1           "The initial value is 0.")]
 947                 uint32 CountOfActiveTransfers;
 948              
 949                    [Description (
 950                        "LastActivity is the point in time at which the last "
 951                        "transfer ended. The timestamp is 0 if "
 952                        "CountOfActiveTransfers is greater than 0, i.e., at least "
 953                        "one transfer is still in progress and, thus, the software "
 954                        "resource is still active. Even if a transfer is still in "
 955                        "progress, LastActivity can be a valid point in time, if the "
 956                        "software resource is currently idle due to internal wait "
 957                        "states or deadlocks. Thus, activity is defined as the "
 958                        "software resource is actively carrying out inputs and "
 959                        "outputs. LastActivity may refer to a point in time that is "
 960                        "outside the sample interval. This is, the instrumentation "
 961                        "internally keeps the timestamp during the lifetime of the "
 962                        "software resource. The metric can be used to better "
 963                        "quantify what happens at the interfaces of the software "
 964                        "resource. \n"
 965                        "The initial value is 0.")]
 966                 datetime LastActivity;
 967 a.dunfey 1.1 };
 968              
 969              
 970              // ==================================================================
 971              // SWRPEP
 972              // ==================================================================
 973              
 974                 [Experimental, Version ( "2.8.1000" ), Description (
 975                     "This protocol endpoint is an software resource of software "
 976                     "(e.g., an application system). It may be the internal view of "
 977                     "an external ProtocolEndpoint which is controlled entirely or "
 978                     "partially by the software.")]
 979              class CIM_SWRPEP : CIM_SoftwareResource {
 980              
 981                    [Override ( "IsAspect" ), Description (
 982                        "The default is that it is an aspect (value 2).")]
 983                 uint16 IsAspect = 2;
 984              
 985                    [Override ( "ByReference" ), Description (
 986                        "The default is that item references are in the PEP (value "
 987                        "2).")]
 988 a.dunfey 1.1    uint16 ByReference = 2;
 989              
 990                    [Override ( "SoftwareResourceType" ), Description (
 991                        "The default is of course 'Protocol Endpoint' (value 3).")]
 992                 uint16 SoftwareResourceType = 3;
 993              };
 994              
 995              
 996              // ==================================================================
 997              // SWRFile
 998              // ==================================================================
 999              
1000                 [Experimental, Version ( "2.8.1000" ), Description (
1001                     "This file is an software resource of software. It may be the "
1002                     "internal view of an external LogicalFile which is controlled "
1003                     "entirely or partially by the software.")]
1004              class CIM_SWRFile : CIM_SoftwareResource {
1005              
1006                    [Override ( "IsAspect" ), Description (
1007                        "The default is that it is an aspect (value 2).")]
1008                 uint16 IsAspect = 2;
1009 a.dunfey 1.1 
1010                    [Override ( "ByReference" ), Description (
1011                        "The default is that item copies are in the file (value 2).")]
1012                 uint16 ByReference = 2;
1013              
1014                    [Override ( "SoftwareResourceType" ), Description (
1015                        "The default is of course 'File' (value 7).")]
1016                 uint16 SoftwareResourceType = 7;
1017              };
1018              
1019              
1020              // ==================================================================
1021              // SWRDatabase
1022              // ==================================================================
1023              
1024                 [Experimental, Version ( "2.8.1000" ), Description (
1025                     "This database is an software resource of software. It may be "
1026                     "the internal view of an external CommonDatabase which is "
1027                     "controlled entirely or partially by the software. \n"
1028                     "SWRDatabase should not be confused with databases commonly "
1029                     "provided by database systems and used by software (e.g., "
1030 a.dunfey 1.1        "application systems). It describes databases that are "
1031                     "implemented by the software.")]
1032              class CIM_SWRDatabase : CIM_SoftwareResource {
1033              
1034                    [Override ( "IsAspect" ), Description (
1035                        "The default is that it is an aspect (value 2).")]
1036                 uint16 IsAspect = 2;
1037              
1038                    [Override ( "ByReference" ), Description (
1039                        "The default is that item copies are in the database (value "
1040                        "2).")]
1041                 uint16 ByReference = 2;
1042              
1043                    [Override ( "SoftwareResourceType" ), Description (
1044                        "The default is of course 'Database' (value 8).")]
1045                 uint16 SoftwareResourceType = 8;
1046              };
1047              
1048              
1049              // ==================================================================
1050              // SWRManageableAspect
1051 a.dunfey 1.1 // ==================================================================
1052              
1053                 [Association, Experimental, Version ( "2.8.1000" ), Description (
1054                     "SWRManageableAspect is the association that allows to express "
1055                     "the shared control between an software resource (as being the "
1056                     "interval view of the software) and its corresponding external "
1057                     "entity, e.g., a LogicalFile. It is possible to express that "
1058                     "several systems (that run software) and one external, "
1059                     "incompassing system (in general the OS) exercise control.")]
1060              class CIM_SWRManageableAspect : CIM_LogicalIdentity {
1061              
1062                    [Override ( "SameElement" ), Description (
1063                        "This reference points to the software resource that is "
1064                        "aspect in the relationship.")]
1065                 CIM_SoftwareResource REF SameElement;
1066              
1067                    [Override ( "SystemElement" ), Max ( 1 ), Description (
1068                        "This reference points to the entity viewed and controlled "
1069                        "by the external, encompassing system like the OS. It is not "
1070                        "the aspect.")]
1071                 CIM_ManagedElement REF SystemElement;
1072 a.dunfey 1.1 };
1073              
1074              
1075              // ==================================================================
1076              // SWRPEPAspect
1077              // ==================================================================
1078              
1079                 [Association, Experimental, Version ( "2.8.1000" ), Description (
1080                     "SWRPEPAspect is the association between multiple communication "
1081                     "endpoint software resources (i.e., the aspects) and the one "
1082                     "endpoint controlled by the operating system or middleware "
1083                     "outside the software.")]
1084              class CIM_SWRPEPAspect : CIM_SWRManageableAspect {
1085              
1086                    [Override ( "SystemElement" ), Description (
1087                        "The protocol endpoint which is viewed as software resource.")]
1088                 CIM_ProtocolEndpoint REF SystemElement;
1089              
1090                    [Override ( "SameElement" ), Description (
1091                        "SameElement is the aspect: the software resource 'Protocol "
1092                        "Endpoint'.")]
1093 a.dunfey 1.1    CIM_SWRPEP REF SameElement;
1094              };
1095              
1096              
1097              // ==================================================================
1098              // SWRFileAspect
1099              // ==================================================================
1100              
1101                 [Association, Experimental, Version ( "2.8.1000" ), Description (
1102                     "SWRFileAspect is the association between multiple file "
1103                     "software resources (i.e., the aspects) and the one file "
1104                     "controlled by the operating system.")]
1105              class CIM_SWRFileAspect : CIM_SWRManageableAspect {
1106              
1107                    [Override ( "SystemElement" ), Description (
1108                        "The logical file which is viewed as software resource.")]
1109                 CIM_LogicalFile REF SystemElement;
1110              
1111                    [Override ( "SameElement" ), Description (
1112                        "SameElement is the aspect: the software resource 'File'.")]
1113                 CIM_SWRFile REF SameElement;
1114 a.dunfey 1.1 };
1115              
1116              
1117              // ===================================================================
1118              // end of file
1119              // ===================================================================

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2