1 kumpf 1.2 // ===================================================================
  2           // Title:       Core Software 2.7
  3           // Filename:    Core27_Software.mof
  4           // Version:     2.7.0
  5           // Release:     Final
  6           // Date:        03/31/03
  7           // ===================================================================
  8           // Copyright 2002-2003 Distributed Management Task Force, Inc. (DMTF).
  9           // All rights reserved.  
 10           // DMTF is a not-for-profit association of industry members dedicated 
 11           // to promoting enterprise and systems management and interoperability. 
 12           // DMTF specifications and documents may be reproduced for uses
 13           // consistent with this purpose by members and non-members, 
 14           // provided that correct attribution is given. 
 15           // As DMTF specifications may be revised from time to time, 
 16           // the particular version and release date should always be noted.
 17           //
 18           // Implementation of certain elements of this standard or proposed 
 19           // standard may be subject to third party patent rights, including 
 20           // provisional patent rights (herein "patent rights"). DMTF makes 
 21           // no representations to users of the standard as to the existence 
 22 kumpf 1.2 // of such rights, and is not responsible to recognize, disclose, or
 23           // identify any or all such third party patent right, owners or 
 24           // claimants, nor for any incomplete or inaccurate identification or 
 25           // disclosure of such rights, owners or claimants. DMTF shall have no 
 26           // liability to any party, in any manner or circumstance, under any 
 27           // legal theory whatsoever, for failure to recognize, disclose, or 
 28           // identify any such third party patent rights, or for such party's
 29           // reliance on the standard or incorporation thereof in its product, 
 30           // protocols or testing procedures. DMTF shall have no liability to 
 31           // any party implementing such standard, whether such implementation 
 32           // is foreseeable or not, nor to any patent owner or claimant, and shall 
 33           // have no liability or responsibility for costs or losses incurred if 
 34           // a standard is withdrawn or modified after publication, and shall be
 35           // indemnified and held harmless by any party implementing the 
 36           // standard from any and all claims of infringement by a patent owner 
 37           // for such implementations.
 38           //
 39           // For information about patents held by third-parties which have 
 40           // notified the DMTF that, in their opinion, such patent may relate to 
 41           // or impact implementations of DMTF standards, visit 
 42           // http://www.dmtf.org/about/policies/disclosures.php.
 43 kumpf 1.2 // ===================================================================
 44           // Description: The Core Model defines basic management concepts. 
 45           //              This file defines the SoftwareIdentity class, 
 46           //              representing software assets/inventory/units of
 47           //              existence. 
 48           //
 49           //              The object classes below are listed in an order that
 50           //              avoids forward references. Required objects, defined 
 51           //              by other working groups, are omitted.
 52           // ==================================================================
 53           // Change Log for v2.7
 54           // CR968 - Remove the Experimental qualifier
 55           // CR994 - Update the description of InstanceID
 56           //
 57           // Change Log for v2.7
 58           // CR753 - Add SoftwareIdentity 
 59           // CR904 - Added missing brackets to SoftwareIdentity.
 60           //         ClassificationDescriptions array 
 61           // ===================================================================
 62                
 63           #pragma locale ("en_US")
 64 kumpf 1.2 
 65           
 66           // ==================================================================
 67           // SoftwareIdentity
 68           // ==================================================================
 69           [Version ("2.7.0"), Description (
 70               "  SoftwareIdentity represents software, viewed as an asset "
 71               "and/or individually identifiable entity (similar to Physical"
 72               "Element). It does NOT indicate whether the software is installed, "
 73               "executing, etc. (The latter is the role of the SoftwareFeature/"
 74               "SoftwareElement classes and the Application Model.) Since "
 75               "software may be acquired, SoftwareIdentity can be associated "
 76               "with a Product using the ProductSoftwareComponent relationship. \n"
 77               "  Note that the Application Model manages the deployment and "
 78               "installation of software via the classes, SoftwareFeatures and "
 79               "SoftwareElements. The deployment/installation concepts are "
 80               "related to the asset/identity one. In fact, a SoftwareIdentity "
 81               "may correspond to a Product, or to one or more SoftwareFeatures "
 82               "or SoftwareElements - depending on the granularity of these "
 83               "classes and the deployment model. The correspondence of Software"
 84               "Identity to Product, SoftwareFeature or SoftwareElement is "
 85 kumpf 1.2     "indicated using the ConcreteIdentity association.  Note that "
 86               "there may not be sufficient detail or instrumentation to "
 87               "instantiate ConcreteIdentity. And, if the association is "
 88               "instantiated, some duplication of information may result. For "
 89               "example, the Vendor described in the instances of Product and "
 90               "SoftwareIdentity MAY be the same. However, this is not "
 91               "necessarily true, and it is why vendor and similar information "
 92               "are duplicated in this class. \n"
 93               "  Note that ConcreteIdentity can also be used to describe "
 94               "the relationship of the software to any LogicalFiles "
 95               "that result from installing it. As above, there may not be "
 96               "sufficient detail or instrumentation to instantiate this "
 97               "association.") ]
 98           class CIM_SoftwareIdentity : CIM_LogicalElement {
 99           
100               [Key, Description (  
101                   "Within the scope of the instantiating Namespace, InstanceID "
102                   "opaquely and uniquely identifies an instance of this class. "
103                   "In order to ensure uniqueness within the NameSpace, the "
104                   "value of InstanceID SHOULD be constructed using the "
105                   "following 'preferred' algorithm: \n"
106 kumpf 1.2         "   <OrgID>:<LocalID> \n"
107                   "Where <OrgID> and <LocalID> are separated by a colon ':', "
108                   "and where <OrgID> MUST include a copyrighted, trademarked "
109                   "or otherwise unique name that is owned by the business entity "
110                   "creating/defining the InstanceID, or is a registered ID that is "
111                   "assigned to the business entity by a recognized global "
112                   "authority (This is similar to the <Schema Name>_<Class Name> "
113                   "structure of Schema class names.) In addition, to ensure "
114                   "uniqueness <OrgID> MUST NOT contain a colon (':'). When using "
115                   "this algorithm, the first colon to appear in "
116                   "InstanceID MUST appear between <OrgID> and <LocalID>.  \n"
117                   "   <LocalID> is chosen by the business entity and SHOULD not be "
118                   "re-used to identify different underlying (real-world) elements. "
119                   "If the above 'preferred' algorithm is not used, the defining "
120                   "entity MUST assure that the resultant InstanceID is not "
121                   "re-used across any InstanceIDs produced by this or other "
122                   "providers for this instance's NameSpace. \n"
123                   "For DMTF defined instances, the 'preferred' algorithm MUST be "
124                   "used with the <OrgID> set to 'CIM'.") ]        
125               string InstanceID;
126           
127 kumpf 1.2     [Description (
128                   "The major number component of the software's version "
129                   "information - for example, '12' from version "
130                   "12.1(3)T. This property is defined as a numeric value "
131                   "to allow the determination of 'newer' vs. 'older' releases. "
132                   "A 'newer' major release is indicated by a larger numeric "
133                   "value.") ]
134               uint16 MajorVersion;
135           
136               [Description (
137                   "The minor number component of the software's version "
138                   "information - for example, '1' from version "
139                   "12.1(3)T. This property is defined as a numeric value "
140                   "to allow the determination of 'newer' vs. 'older' releases. "
141                   "A 'newer' minor release is indicated by a larger numeric "
142                   "value.") ]
143               uint16 MinorVersion;
144           
145               [Description (
146                   "The revision or maintenance release component of the "
147                   "software's version information - for example, '3' from "
148 kumpf 1.2         "version 12.1(3)T. This property is defined as a numeric value "
149                   "to allow the determination of 'newer' vs. 'older' releases. "
150                   "A 'newer' revision is indicated by a larger numeric "
151                   "value.") ]
152               uint16 RevisionNumber;
153           
154               [Description (
155                   "The build number of the software.") ]
156               uint16 BuildNumber;
157           
158               [Description (
159                   "A string representing the complete software version "
160                   "information - for example, '12.1(3)T'. This string and "
161                   "the numeric major/minor/revision/build properties are "
162                   "complementary. Since vastly different representations and "
163                   "semantics exist for versions, it is not assumed that "
164                   "one representation is sufficient to permit a client to "
165                   "perform computations (i.e., the values are numeric) and "
166                   "a user to recognize the software's version (i.e., the "
167                   "values are understandable and readable). Hence, both "
168                   "numeric and string representations of version are provided.") ]
169 kumpf 1.2     string VersionString;
170           
171               [Description (
172                   "Specifies the target operating systems of the software. "
173                   "Due to the extreme variability in operating systems, "
174                   "this property is defined as a string array.") ] 
175               string TargetOperatingSystems[];
176           
177               [Description (
178                   "Manufacturer of this software.") ] 
179               string Manufacturer;
180               
181               [Description (
182                   "The language editions supported by the software. The "
183                   "language codes defined in ISO 639 should be used. ") ]
184               string Languages[];
185           
186               [Description (
187                   "An array of enumerated integers that classify this software. "
188                   "For example, the software could be instrumentation (value=5) "
189                   "or firmware and diagnostic software (6 and 7)."),
190 kumpf 1.2         ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9"}, 
191                   Values {"Unknown", "Other", "Driver", 
192                       "Configuration Software", "Application Software", 
193                       "Instrumentation", "Firmware/BIOS", 
194                       "Diagnostic Software", "Operating System", "Middleware"}, 
195                   ArrayType ("Indexed"), 
196                   ModelCorrespondence {
197                       "CIM_SoftwareIdentity.ClassificationDescriptions"} ]
198               uint16 Classifications[];
199           
200               [Description (
201                   "An array of free-form strings providing more detailed "
202                   "explanations for any of the entries in the Classifications "
203                   "array. Note that each entry is related to one in the "
204                   "Classifications array located at the same index."),
205                   ArrayType ("Indexed"),
206                   ModelCorrespondence {"CIM_SoftwareIdentity.Classifications"} ]
207               string ClassificationDescriptions[];
208           };
209           
210           
211 kumpf 1.2 // ===================================================================
212           // end of file
213           // ===================================================================