1 marek 1.1 // Copyright (c) 2005 DMTF.  All rights reserved.
  2           // <change cr="SysDevCR00714.001" type ="change">Update of
  3           // descriptions based on Tech Edit review.</
  4           // <change cr="ArchCR00066.004" type="add">Add UmlPackagePath
  5           // qualifier values to CIM Schema.</change>
  6           // ==================================================================
  7           //  CIM_PhysicalElement
  8           // ==================================================================
  9              [Abstract, Version ( "2.10.0" ), 
 10               UMLPackagePath ( "CIM::Core::Physical" ), 
 11               Description ( 
 12                  "Subclasses of CIM_PhysicalElement define any component of a "
 13                  "System that has a distinct physical identity. Instances of "
 14                  "this class can be defined as an object that can be seen or "
 15                  "touched. All Processes, Files, and LogicalDevices are "
 16                  "considered not to be Physical Elements. For example, it is not "
 17                  "possible to touch the functionality of a \'modem.\' You can "
 18                  "touch only the card or package that implements the modem. The "
 19                  "same card could also implement a LAN adapter. PhysicalElements "
 20                  "are tangible ManagedSystemElements that have a physical "
 21                  "manifestation of some sort. \n"
 22 marek 1.1        "\n"
 23                  "Note that the properties of PhysicalElement describe a "
 24                  "hardware entity. Possible replacement (FRU) information is "
 25                  "defined by following the ElementFRU association to one or more "
 26                  "instances of the ReplacementFRU class. This definition allows "
 27                  "a client to determine what hardware can be replaced (FRUed) "
 28                  "and what \'spare\' parts might be required by a customer or "
 29                  "engineer doing the replacement. If it can be instrumented or "
 30                  "manually determined that an element actually replaced (FRUed) "
 31                  "another, then this can be described in the model using the "
 32                  "ElementHasBeenFRUed association." )]
 33           class CIM_PhysicalElement : CIM_ManagedSystemElement {
 34           
 35                 [Key, Description ( 
 36                     "An arbitrary string that uniquely identifies the "
 37                     "Physical Element and serves as the key of the Element. "
 38                     "The Tag property can contain information such as asset "
 39                     "tag or serial number data. The key for PhysicalElement "
 40                     "is placed very high in the object hierarchy in order to "
 41                     "independently identify the hardware or entity, "
 42                     "regardless of physical placement in or on Cabinets, "
 43 marek 1.1           "Adapters, and so on. For example, a hotswappable or "
 44                     "removable component can be taken from its containing "
 45                     "(scoping) Package and be temporarily unused. The object "
 46                     "still continues to exist and can even be inserted into a "
 47                     "different scoping container. Therefore, the key for "
 48                     "Physical Element is an arbitrary string and is defined "
 49                     "independently of any placement or location-oriented "
 50                     "hierarchy." ), 
 51                  MaxLen ( 256 )]
 52              string Tag;
 53           
 54                 [Override ( "Description" ), 
 55                  Description ( "A textual description of the PhysicalElement." ), 
 56                  MappingStrings { "MIF.DMTF|FRU|003.3" }]
 57              string Description;
 58           
 59                 [Key, Description ( 
 60                     "CreationClassName indicates the name of the class or the "
 61                     "subclass used in the creation of an instance. When used "
 62                     "with the other key properties of this class, this "
 63                     "property allows all instances of this class and its "
 64 marek 1.1           "subclasses to be uniquely identified." ), 
 65                  MaxLen ( 256 )]
 66              string CreationClassName;
 67           
 68                 [Override ( "ElementName" ), 
 69                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalName" }]
 70              string ElementName;
 71           
 72                 [Description ( 
 73                     "The name of the organization responsible for producing "
 74                     "the PhysicalElement. This organization might be the "
 75                     "entity from whom the Element is purchased, but this is "
 76                     "not necessarily true. The latter information is "
 77                     "contained in the Vendor property of CIM_Product." ), 
 78                  MaxLen ( 256 ), 
 79                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalMfgName", 
 80                     "MIF.DMTF|FRU|003.4" }]
 81              string Manufacturer;
 82           
 83                 [Description ( 
 84                     "The name by which the PhysicalElement is generally known." ), 
 85 marek 1.1        MaxLen ( 256 ), 
 86                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalDescr", 
 87                     "MIF.DMTF|FRU|003.5" }]
 88              string Model;
 89           
 90                 [Description ( 
 91                     "The stock-keeping unit number for this PhysicalElement." ), 
 92                  MaxLen ( 64 )]
 93              string SKU;
 94           
 95                 [Description ( 
 96                     "A manufacturer-allocated number used to identify the "
 97                     "Physical Element." ), 
 98                  MaxLen ( 256 ), 
 99                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalSerialNum", 
100                     "MIF.DMTF|FRU|003.7" }]
101              string SerialNumber;
102           
103                 [Description ( 
104                     "A string that indicates the version of the PhysicalElement."
105                      ), 
106 marek 1.1        MaxLen ( 64 ), 
107                  MappingStrings { 
108                     "MIB.IETF|Entity-MIB.entPhysicalHardwareRev", 
109                     "MIF.DMTF|FRU|003.8" }]
110              string Version;
111           
112                 [Description ( 
113                     "The part number assigned by the organization that is "
114                     "responsible for producing or manufacturing the "
115                     "PhysicalElement." ), 
116                  MaxLen ( 256 ), 
117                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalModelName" }]
118              string PartNumber;
119           
120                 [Write, Description ( 
121                     "OtherIdentifyingInfo captures data in addition to Tag "
122                     "information. This information could be used to identify "
123                     "a Physical Element. One example is bar code data "
124                     "associated with an Element that also has an asset tag. "
125                     "Note that if only bar code data is available and is "
126                     "unique or able to be used as an Element key, this "
127 marek 1.1           "property would be null and the bar code data would be "
128                     "used as the class key, in the Tag property." ), 
129                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalAlias" }]
130              string OtherIdentifyingInfo;
131           
132                 [Description ( 
133                     "Boolean that indicates whether the PhysicalElement is "
134                     "powered on (TRUE) or is currently off (FALSE)." )]
135              boolean PoweredOn;
136           
137                 [Description ( 
138                     "The date that this PhysicalElement was manufactured." )]
139              datetime ManufactureDate;
140           
141                 [Description ( 
142                     "A vendor-specific hardware type for the PhysicalElement. "
143                     "It describes the specific equipment type for the "
144                     "element, as defined by the vendor or manufacturer." ), 
145                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalVendorType" }]
146              string VendorEquipmentType;
147           
148 marek 1.1       [Write, Description ( 
149                     "User-assigned and writeable asset-tracking identifier "
150                     "for the PhysicalElement." ), 
151                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalAssetID" }]
152              string UserTracking;
153           
154                 [Description ( 
155                     "Boolean that indicates whether this PhysicalElement can "
156                     "be FRUed (TRUE) or not (FALSE)." ), 
157                  MappingStrings { "MIB.IETF|Entity-MIB.entPhysicalIsFRU" }]
158              boolean CanBeFRUed;
159           
160           
161           };