.. _CIM-ComputerSystem: CIM_ComputerSystem ------------------ Class reference =============== Subclass of :ref:`CIM_System ` A class derived from System that is a special collection of ManagedSystemElements. This collection is related to the providing of compute capabilities and MAY serve as an aggregation point to associate one or more of the following elements: FileSystem, OperatingSystem, Processor and Memory (Volatile and/or NonVolatile Storage). Key properties ^^^^^^^^^^^^^^ | :ref:`Name ` | :ref:`CreationClassName ` Local properties ^^^^^^^^^^^^^^^^ .. _CIM-ComputerSystem-NameFormat: ``string`` **NameFormat** The ComputerSystem object and its derivatives are Top Level Objects of CIM. They provide the scope for numerous components. Having unique System keys is required. The NameFormat property identifies how the ComputerSystem Name is generated. The NameFormat ValueMap qualifier defines the various mechanisms for assigning the name. Note that another name can be assigned and used for the ComputerSystem that better suit a business, using the inherited ElementName property. If the NameFormat is set to "UUID", then the Name property shall be a UUID in its canonical form consisting of 32 hexadecimal digits in 5 groups separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters (32 digits and 4 hyphens). For the first three fields, the most significant digit is on the left. The last two fields are treated as eight separate bytes, each having their most significant digit on the left, and they follow each other from left to right. .. _CIM-ComputerSystem-OtherDedicatedDescriptions: ``string[]`` **OtherDedicatedDescriptions** A string describing how or why the system is dedicated when the Dedicated array includes the value 2, "Other". .. _CIM-ComputerSystem-ResetCapability: ``uint16`` **ResetCapability** If enabled (value = 4), the ComputerSystem can be reset via hardware (e.g. the power and reset buttons). If disabled (value = 3), hardware reset is not allowed. In addition to Enabled and Disabled, other Values for the property are also defined - "Not Implemented" (5), "Other" (1) and "Unknown" (2). ======== =============== ValueMap Values ======== =============== 1 Other 2 Unknown 3 Disabled 4 Enabled 5 Not Implemented ======== =============== .. _CIM-ComputerSystem-PowerManagementCapabilities: ``uint16[]`` **PowerManagementCapabilities** An enumerated array describing the power management capabilities of the ComputerSystem. The use of this property has been deprecated. Instead, the Power Capabilites property in an associated PowerManagement Capabilities class should be used. ======== ======================================== ValueMap Values ======== ======================================== 0 Unknown 1 Not Supported 2 Disabled 3 Enabled 4 Power Saving Modes Entered Automatically 5 Power State Settable 6 Power Cycling Supported 7 Timed Power On Supported ======== ======================================== .. _CIM-ComputerSystem-Dedicated: ``uint16[]`` **Dedicated** Enumeration indicating the purpose(s) to which the ComputerSystem is dedicated, if any, and what functionality is provided. For example, one could specify that the System is dedicated to "Print" (value=11) or acts as a "Hub" (value=8). Also, one could indicate that this is a general purpose system by indicating 'Not Dedicated' (value=0) but that it also hosts 'Print' (value=11) or mobile phone 'Mobile User Device' (value=17) services. A clarification is needed with respect to the value 17 ("Mobile User Device"). An example of a dedicated user device is a mobile phone or a barcode scanner in a store that communicates via radio frequency. These systems are quite limited in functionality and programmability, and are not considered 'general purpose' computing platforms. Alternately, an example of a mobile system that is 'general purpose' (i.e., is NOT dedicated) is a hand-held computer. Although limited in its programmability, new software can be downloaded and its functionality expanded by the user. A value of "Management" indicates this instance is dedicated to hosting system management software. A value of "Management Controller" indicates this instance represents specialized hardware dedicated to systems management (i.e., a Baseboard Management Controller (BMC) or service processor). The management scope of a "Management Controller" is typically a single managed system in which it is contained. A value of "Chassis Manager" indicates this instance represents a system dedicated to management of a blade chassis and its contained devices. This value would be used to represent a Shelf Controller. A "Chassis Manager" is an aggregation point for management and may rely on subordinate management controllers for the management of constituent parts. A value of "Host-based RAID Controller" indicates this instance represents a RAID storage controller contained within a host computer. A value of "Storage Device Enclosure" indicates this instance represents an enclosure that contains storage devices. A "Virtual Tape Library" is the emulation of a tape library by a Virtual Library System. A "Virtual Library System" uses disk storage to emulate tape libraries.A "FC Switch" indicates this instance is dedicated to switching layer 2 fibre channel frames. An "Ethernet Switch" indicates this instance is dedicated to switching layer 2 ethernet frames. ============ ========================== ValueMap Values ============ ========================== 0 Not Dedicated 1 Unknown 2 Other 3 Storage 4 Router 5 Switch 6 Layer 3 Switch 7 Central Office Switch 8 Hub 9 Access Server 10 Firewall 11 Print 12 I/O 13 Web Caching 14 Management 15 Block Server 16 File Server 17 Mobile User Device 18 Repeater 19 Bridge/Extender 20 Gateway 21 Storage Virtualizer 22 Media Library 23 ExtenderNode 24 NAS Head 25 Self-contained NAS 26 UPS 27 IP Phone 28 Management Controller 29 Chassis Manager 30 Host-based RAID controller 31 Storage Device Enclosure 32 Desktop 33 Laptop 34 Virtual Tape Library 35 Virtual Library System 36 Network PC/Thin Client 37 FC Switch 38 Ethernet Switch .. DMTF Reserved 32568..65535 Vendor Reserved ============ ========================== Local methods ^^^^^^^^^^^^^ .. _CIM-ComputerSystem-SetPowerState: ``uint32`` **SetPowerState** (``uint32`` PowerState, ``datetime`` Time) **Deprecated!** Sets the power state of the computer. The use of this method has been deprecated. Instead, use the SetPowerState method in the associated PowerManagementService class. **Parameters** *IN* ``uint32`` **PowerState** The Desired state for the COmputerSystem. ======== =========================== ValueMap Values ======== =========================== 1 Full Power 2 Power Save - Low Power Mode 3 Power Save - Standby 4 Power Save - Other 5 Power Cycle 6 Power Off 7 Hibernate 8 Soft Off ======== =========================== *IN* ``datetime`` **Time** Time indicates when the power state should be set, either as a regular date-time value or as an interval value (where the interval begins when the method invocation is received. Inherited properties ^^^^^^^^^^^^^^^^^^^^ | ``uint16`` :ref:`RequestedState ` | ``uint16`` :ref:`HealthState ` | ``string[]`` :ref:`StatusDescriptions ` | ``string`` :ref:`InstanceID ` | ``uint16`` :ref:`CommunicationStatus ` | ``string`` :ref:`Status ` | ``string`` :ref:`ElementName ` | ``datetime`` :ref:`InstallDate ` | ``uint16`` :ref:`TransitioningToState ` | ``string[]`` :ref:`IdentifyingDescriptions ` | ``datetime`` :ref:`TimeOfLastStateChange ` | ``uint16`` :ref:`PrimaryStatus ` | ``uint16`` :ref:`DetailedStatus ` | ``string[]`` :ref:`OtherIdentifyingInfo ` | ``string`` :ref:`Name ` | ``string[]`` :ref:`Roles ` | ``uint16`` :ref:`EnabledDefault ` | ``uint16`` :ref:`EnabledState ` | ``string`` :ref:`Caption ` | ``uint16[]`` :ref:`AvailableRequestedStates ` | ``string`` :ref:`Description ` | ``uint64`` :ref:`Generation ` | ``string`` :ref:`OtherEnabledState ` | ``uint16[]`` :ref:`OperationalStatus ` | ``uint16`` :ref:`OperatingStatus ` | ``string`` :ref:`PrimaryOwnerContact ` | ``string`` :ref:`CreationClassName ` | ``string`` :ref:`PrimaryOwnerName ` Inherited methods ^^^^^^^^^^^^^^^^^ | :ref:`RequestStateChange `