1 marek 1.1 // Copyright (c) 2005 DMTF.  All rights reserved.
  2           // <change cr="SysDevCR00711.001" type ="change">Update of
  3           // descriptions based on Tech Edit review.</change>
  4           // <change cr="ArchCR00066.004" type="add">Add UmlPackagePath
  5           // qualifier values to CIM Schema.</change>
  6           // <change cr="CIMCoreCR00902" type="add">Promoted OtherIdentifyingInfo
  7           // and IdentifyingDescription from ComputerSystem to System.</change>
  8           // ==================================================================
  9           //  CIM_System
 10           // ==================================================================
 11              [Abstract, Version ( "2.15.0" ), 
 12               UMLPackagePath ( "CIM::Core::CoreElements" ), 
 13               Description ( 
 14                  "CIM_System represents an entity made up of component parts "
 15                  "(defined by the SystemComponent relationship), that operates "
 16                  "as a \'functional whole\'. Systems are top-level objects in "
 17                  "the CIM hierarchy, requiring no scoping or weak relationships "
 18                  "in order to exist and have context. It should be reasonable to "
 19                  "uniquely name and manage a System at an enterprise level. For "
 20                  "example, a ComputerSystem is a kind of System that can be "
 21                  "uniquely named and independently managed in an enterprise. "
 22 marek 1.1        "However, these qualities are not true for the power supply (or "
 23                  "the power supply sub-\'system\') within the computer. \n"
 24                  "\n"
 25                  "Although a System can be viewed as a Collection, this view is "
 26                  "not the correct model. A Collection is simply a \'bag\' that "
 27                  "\'holds\' its members. A System is a higher-level abstraction, "
 28                  "built out of its individual components. It is more than the "
 29                  "sum of its parts. Note that System is a subclass of "
 30                  "EnabledLogicalElement which allows the entire abstraction to "
 31                  "be functionally enabled or disabled at a higher level than "
 32                  "enabling or disabling its component parts." )]
 33           class CIM_System : CIM_EnabledLogicalElement {
 34           
 35                 [Key, Description ( 
 36                     "CreationClassName indicates the name of the class or the "
 37                     "subclass used in the creation of an instance. When used "
 38                     "with the other key properties of this class, this "
 39                     "property allows all instances of this class and its "
 40                     "subclasses to be uniquely identified." ), 
 41                  MaxLen ( 256 )]
 42              string CreationClassName;
 43 marek 1.1 
 44                 [Key, Override ( "Name" ), 
 45                  Description ( 
 46                     "The inherited Name serves as the key of a System "
 47                     "instance in an enterprise environment." ), 
 48                  MaxLen ( 256 )]
 49              string Name;
 50           
 51                 [Description ( 
 52                     "The System object and its derivatives are top-level "
 53                     "objects of CIM. They provide the scope for numerous "
 54                     "components. Having unique System keys is required. A "
 55                     "heuristic can be defined in individual System subclasses "
 56                     "to attempt to always generate the same System Name Key. "
 57                     "The NameFormat property identifies how the System name "
 58                     "was generated, using the heuristic of the subclass." ), 
 59                  MaxLen ( 64 )]
 60              string NameFormat;
 61           
 62                 [Write, Description ( 
 63                     "The name of the primary system owner. The system owner "
 64 marek 1.1           "is the primary user of the system." ), 
 65                  MaxLen ( 64 ), 
 66                  MappingStrings { "MIF.DMTF|General Information|001.3" }]
 67              string PrimaryOwnerName;
 68           
 69                 [Write, Description ( 
 70                     "A string that provides information on how the primary "
 71                     "system owner can be reached (for example, phone number, "
 72                     "e-mail address, and so on)." ), 
 73                  MaxLen ( 256 ), 
 74                  MappingStrings { "MIF.DMTF|General Information|001.4" }]
 75              string PrimaryOwnerContact;
 76           
 77                 [Write, Description ( 
 78                     "An array (bag) of strings that specifies the "
 79                     "administrator -defined roles this System plays in the "
 80                     "managed environment. Examples might be \'Building 8 "
 81                     "print server\' or \'Boise user directories\'. A single "
 82                     "system may perform multiple roles. \n"
 83                     "Note that the instrumentation view of the \'roles\' of a "
 84                     "System is defined by instantiating a specific subclass "
 85 marek 1.1           "of System, or by properties in a subclass, or both. For "
 86                     "example, the purpose of a ComputerSystem is defined "
 87                     "using the Dedicated and OtherDedicatedDescription "
 88                     "properties." )]
 89              string Roles[];
 90           
 91                 [Description ( 
 92                     "OtherIdentifyingInfo captures additional data, beyond "
 93                     "System Name information, that could be used to identify "
 94                     "a ComputerSystem. One example would be to hold the Fibre "
 95                     "Channel World-Wide Name (WWN) of a node. Note that if "
 96                     "only the Fibre Channel name is available and is unique "
 97                     "(able to be used as the System key), then this property "
 98                     "would be NULL and the WWN would become the System key, "
 99                     "its data placed in the Name property." ), 
100                  ArrayType ( "Indexed" ), 
101                  MaxLen ( 256 ), 
102                  ModelCorrespondence { "CIM_System.IdentifyingDescriptions" }]
103              string OtherIdentifyingInfo[];
104           
105                 [Description ( 
106 marek 1.1           "An array of free-form strings providing explanations and "
107                     "details behind the entries in the OtherIdentifying Info "
108                     "array. Note, each entry of this array is related to the "
109                     "entry in OtherIdentifyingInfo that is located at the "
110                     "same index." ), 
111                  ArrayType ( "Indexed" ), 
112                  ModelCorrespondence { "CIM_System.OtherIdentifyingInfo" }]
113              string IdentifyingDescriptions[];
114           
115           
116           };