1 a.dunfey 1.1 // ===================================================================
2 // Title: System_OperatingSystem
3 // $State: Exp $
4 // $Date: 2004/11/29 18:31:43 $
5 // $RCSfile: System_OperatingSystem.mof,v $
6 // $Revision: 1.5.2.3 $
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 System Model defines system related management
47 // concepts. This file defines the specific concepts for
48 // operating systems.
49 //
50 // The object classes below are listed in an order that
51 // avoids forward references. Required objects, defined
52 // by other working groups, are omitted.
53 // ==================================================================
54 // Change Log for v2.7 Final
55 // CR935 - Rename OperationSystem.OSTypes value "VM/ESA" to "VM" and
56 // add new "z/OS" value
57 //
58 // Change Log for v2.7
59 // CR757 - Change the subclassing of OperatingSystem from Logical
60 // Element to EnabledLogicalElement
61 // CR767 - Add the Compostion qualifer to InstalledOS
62 // CR770 - Extend OperatingSystem.OSType to include "Windows XP"
63 // - Add model correspondence to OperatingSystem.OSType
64 a.dunfey 1.1 // CR876 - Rename the "Digital Unix" operating system type to
65 // "Tru64 UNIX".
66 // ===================================================================
67
68 #pragma locale ("en_US")
69
70
71 // ===================================================================
72 // OperatingSystem
73 // ===================================================================
74 [Version ( "2.7.0" ), Description (
75 "An OperatingSystem is software/firmware that makes a "
76 "ComputerSystem's hardware usable, and implements and/or "
77 "manages the resources, file systems, processes, user "
78 "interfaces, services, ... available on the ComputerSystem.")]
79 class CIM_OperatingSystem : CIM_EnabledLogicalElement {
80
81 [Key, Propagated ( "CIM_ComputerSystem.CreationClassName" ),
82 Description (
83 "The scoping ComputerSystem's CreationClassName."),
84 MaxLen ( 256 )]
85 a.dunfey 1.1 string CSCreationClassName;
86
87 [Key, Propagated ( "CIM_ComputerSystem.Name" ), Description (
88 "The scoping ComputerSystem's Name."),
89 MaxLen ( 256 )]
90 string CSName;
91
92 [Key, Description (
93 "CreationClassName indicates the name of the class or the "
94 "subclass used in the creation of an instance. When used "
95 "with the other key properties of this class, this property "
96 "allows all instances of this class and its subclasses to be "
97 "uniquely identified."),
98 MaxLen ( 256 )]
99 string CreationClassName;
100
101 [Key, Override ( "Name" ), Description (
102 "The inherited Name serves as key of an OperatingSystem "
103 "instance within a ComputerSystem."),
104 MaxLen ( 256 ),
105 MappingStrings { "MIF.DMTF|Operating System|001.2" }]
106 a.dunfey 1.1 string Name;
107
108 [Description (
109 "A integer indicating the type of OperatingSystem."),
110 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
111 "10", "11", "12", "13", "14", "15", "16", "17", "18", "19",
112 "20", "21", "22", "23", "24", "25", "26", "27", "28", "29",
113 "30", "31", "32", "33", "34", "35", "36", "37", "38", "39",
114 "40", "41", "42", "43", "44", "45", "46", "47", "48", "49",
115 "50", "51", "52", "53", "54", "55", "56", "57", "58", "59",
116 "60", "61", "62", "63", "64", "65", "66", "67", "68" },
117 Values { "Unknown", "Other", "MACOS", "ATTUNIX", "DGUX",
118 "DECNT", "Tru64 UNIX", "OpenVMS", "HPUX", "AIX",
119 //10
120 "MVS", "OS400", "OS/2", "JavaVM", "MSDOS", "WIN3x", "WIN95",
121 "WIN98", "WINNT", "WINCE",
122 //20
123 "NCR3000", "NetWare", "OSF", "DC/OS", "Reliant UNIX",
124 "SCO UnixWare", "SCO OpenServer", "Sequent", "IRIX",
125 "Solaris",
126 //30
127 a.dunfey 1.1 "SunOS", "U6000", "ASERIES", "TandemNSK", "TandemNT",
128 "BS2000", "LINUX", "Lynx", "XENIX", "VM",
129 //40
130 "Interactive UNIX", "BSDUNIX", "FreeBSD", "NetBSD",
131 "GNU Hurd", "OS9", "MACH Kernel", "Inferno", "QNX", "EPOC",
132 //50
133 "IxWorks", "VxWorks", "MiNT", "BeOS", "HP MPE", "NextStep",
134 "PalmPilot", "Rhapsody", "Windows 2000", "Dedicated",
135 //60
136 "OS/390", "VSE", "TPF","Windows (R) Me", "Caldera Open UNIX",
137 "OpenBSD", "Not Applicable", "Windows XP", "z/OS" },
138 ModelCorrespondence {
139 "CIM_OperatingSystem.OtherTypeDescription",
140 "CIM_SoftwareElement.TargetOperatingSystem" }]
141 uint16 OSType;
142
143 [Description (
144 "A string describing the manufacturer and OperatingSystem "
145 "type - used when the OperatingSystem property, OSType, is "
146 "set to 1 or 59 (\"Other\" or \"Dedicated\"). The format of "
147 "the string inserted in OtherTypeDescription should be "
148 a.dunfey 1.1 "similar in format to the Values strings defined for OSType. "
149 "OtherTypeDescription should be set to NULL when OSType is "
150 "any value other than 1 or 59."),
151 MaxLen ( 64 ),
152 ModelCorrespondence { "CIM_OperatingSystem.OSType" }]
153 string OtherTypeDescription;
154
155 [Description (
156 "A string describing the Operating System's version number. "
157 "The format of the version information is as follows: <Major "
158 "Number>.<Minor Number>.<Revision> or <Major Number>.<Minor "
159 "Number>.<Revision Letter>."),
160 MappingStrings { "MIF.DMTF|Operating System|001.3" }]
161 string Version;
162
163 [Description (
164 "Time when the OperatingSystem was last booted."),
165 MappingStrings { "MIF.DMTF|General Information|001.5" }]
166 datetime LastBootUpTime;
167
168 [Description (
169 a.dunfey 1.1 "OperatingSystem's notion of the local date and time of day."),
170 MappingStrings { "MIB.IETF|HOST-RESOURCES-MIB.hrSystemDate",
171 "MIF.DMTF|General Information|001.6" }]
172 datetime LocalDateTime;
173
174 [Description (
175 "CurrentTimeZone indicates the number of minutes the "
176 "OperatingSystem is offset from Greenwich Mean Time. Either "
177 "the number is positive, negative or zero."),
178 Units ( "Minutes" )]
179 sint16 CurrentTimeZone;
180
181 [Description (
182 "Number of user licenses for the OperatingSystem. If "
183 "unlimited, enter 0.")]
184 uint32 NumberOfLicensedUsers;
185
186 [Description (
187 "Number of user sessions for which the OperatingSystem is "
188 "currently storing state information."),
189 Gauge,
190 a.dunfey 1.1 MappingStrings { "MIF.DMTF|Host System|001.4",
191 "MIB.IETF|HOST-RESOURCES-MIB.hrSystemNumUsers" }]
192 uint32 NumberOfUsers;
193
194 [Description (
195 "Number of process contexts currently loaded or running on "
196 "the OperatingSystem."),
197 Gauge,
198 MappingStrings { "MIF.DMTF|Host System|001.5",
199 "MIB.IETF|HOST-RESOURCES-MIB.hrSystemProcesses" }]
200 uint32 NumberOfProcesses;
201
202 [Description (
203 "Maximum number of process contexts the OperatingSystem can "
204 "support. If there is no fixed maximum, the value should be "
205 "0. On systems that have a fixed maximum, this object can "
206 "help diagnose failures that occur when the maximum is "
207 "reached."),
208 MappingStrings { "MIF.DMTF|Host System|001.6",
209 "MIB.IETF|HOST-RESOURCES-MIB.hrSystemMaxProcesses" }]
210 uint32 MaxNumberOfProcesses;
211 a.dunfey 1.1
212 [Description (
213 "Total swap space in Kbytes. This value may be NULL "
214 "(unspecified) if swap space is not distinguished from page "
215 "files. However, some Operating Systems distinguish these "
216 "concepts. For example, in UNIX, whole processes can be "
217 "'swapped out' when the free page list falls and remains "
218 "below a specified amount."),
219 Units ( "KiloBytes" )]
220 uint64 TotalSwapSpaceSize;
221
222 [Description (
223 "Number of Kbytes of virtual memory. For example, this may "
224 "be calculated by adding the amount of total RAM to the "
225 "amount of paging space (ie, adding the amount of memory "
226 "in/aggregated by the ComputerSystem to the property, "
227 "SizeStoredInPagingFiles."),
228 Units ( "KiloBytes" ),
229 MappingStrings { "MIF.DMTF|System Memory Settings|001.5" }]
230 uint64 TotalVirtualMemorySize;
231
232 a.dunfey 1.1 [Description (
233 "Number of Kbytes of virtual memory currently unused and "
234 "available. For example, this may be calculated by adding "
235 "the amount of free RAM to the amount of free paging space "
236 "(ie, adding the properties, FreePhysicalMemory and "
237 "FreeSpace InPagingFiles)."),
238 Units ( "KiloBytes" ), Gauge,
239 MappingStrings { "MIF.DMTF|System Memory Settings|001.6" }]
240 uint64 FreeVirtualMemory;
241
242 [Description (
243 "Number of Kbytes of physical memory currently unused and "
244 "available."),
245 Units ( "KiloBytes" ), Gauge,
246 MappingStrings { "MIF.DMTF|System Memory Settings|001.2",
247 "MIF.UNIX|Host Physical Memory|6.1" }]
248 uint64 FreePhysicalMemory;
249
250 [Description (
251 "The total amount of physical memory (in Kbytes) available "
252 "to the OperatingSystem. This value does not necessarily "
253 a.dunfey 1.1 "indicate the true amount of physical memory, but what is "
254 "reported to the OperatingSystem as available to it."),
255 Units ( "KiloBytes" )]
256 uint64 TotalVisibleMemorySize;
257
258 [Description (
259 "The total number of KBytes that can be stored in the "
260 "OperatingSystem's paging files. 0 indicates that there are "
261 "no paging files."),
262 Units ( "KiloBytes" ),
263 MappingStrings { "MIF.DMTF|System Memory Settings|001.3" }]
264 uint64 SizeStoredInPagingFiles;
265
266 [Description (
267 "The total number of KBytes that can be mapped into the "
268 "OperatingSystem's paging files without causing any other "
269 "pages to be swapped out. 0 indicates that there are no "
270 "paging files."),
271 Units ( "KiloBytes" ), Gauge,
272 MappingStrings { "MIF.DMTF|System Memory Settings|001.4" }]
273 uint64 FreeSpaceInPagingFiles;
274 a.dunfey 1.1
275 [Description (
276 "Maximum number of Kbytes of memory that can be allocated to "
277 "a Process. For Operating Systems with no virtual memory, "
278 "this value is typically equal to the total amount of "
279 "physical Memory minus memory used by the BIOS and OS. For "
280 "some Operating Systems, this value may be infinity - in "
281 "which case, 0 should be entered. In other cases, this value "
282 "could be a constant - for example, 2G or 4G."),
283 Units ( "KiloBytes" )]
284 uint64 MaxProcessMemorySize;
285
286 [Description (
287 "Boolean indicating whether the OperatingSystem is "
288 "distributed across several ComputerSystem nodes. If so, "
289 "these nodes should be grouped as a Cluster.")]
290 boolean Distributed;
291
292 [Description (
293 "A value that indicates the maximum processes that a user "
294 "can have associate with it.")]
295 a.dunfey 1.1 uint32 MaxProcessesPerUser;
296
297 [Description (
298 "Requests a reboot of the OperatingSystem. The return value "
299 "should be 0 if the request was successfully executed, 1 if "
300 "the request is not supported and some other value if an "
301 "error occurred. In a subclass, the set of possible return "
302 "codes could be specified, using a ValueMap qualifier on the "
303 "method. The strings to which the ValueMap contents are "
304 "'translated' may also be specified in the subclass as a "
305 "Values array qualifier.")]
306 uint32 Reboot();
307
308 [Description (
309 "Requests a shutdown of the OperatingSystem. The return "
310 "value should be 0 if the request was successfully executed, "
311 "1 if the request is not supported and some other value if "
312 "an error occurred. It is up to the implementation or "
313 "subclass of OperatingSystem to establish dependencies "
314 "between the Shutdown and Reboot methods, and for example, "
315 "to provide more sophisticated capabilities such as "
316 a.dunfey 1.1 "scheduled shutdown/ reboot, etc. In a subclass, the set of "
317 "possible return codes could be specified, using a ValueMap "
318 "qualifier on the method. The strings to which the ValueMap "
319 "contents are 'translated' may also be specified in the "
320 "subclass as a Values array qualifier.")]
321 uint32 Shutdown();
322 };
323
324
325 // ===================================================================
326 // InstalledOS
327 // ===================================================================
328 [Association, Aggregation, Composition, Version ( "2.7.0" ),
329 Description (
330 "A link between the ComputerSystem and the OperatingSystem(s) "
331 "installed or loaded on it. An OperatingSystem is 'installed' "
332 "on a ComputerSystem, when placed on one of its StorageExtents "
333 "- for example, copied to a disk drive or downloaded to Memory. "
334 "Using this definition, an OperatingSystem is 'installed' on a "
335 "NetPC when downloaded via the network.")]
336 class CIM_InstalledOS : CIM_SystemComponent {
337 a.dunfey 1.1
338 [Aggregate, Override ( "GroupComponent" ), Min ( 1 ), Max ( 1 ),
339 Description (
340 "The ComputerSystem.")]
341 CIM_ComputerSystem REF GroupComponent;
342
343 [Override ( "PartComponent" ), Weak, Description (
344 "The OperatingSystem installed on the ComputerSystem.")]
345 CIM_OperatingSystem REF PartComponent;
346
347 [Description (
348 "Boolean indicating that the OperatingSystem is the default "
349 "OS for the ComputerSystem."),
350 MappingStrings { "MIF.DMTF|Operating System|001.4" }]
351 boolean PrimaryOS;
352 };
353
354
355 // ===================================================================
356 // RunningOS
357 // ===================================================================
358 a.dunfey 1.1 [Association, Version ( "2.6.0" ), Description (
359 "RunningOS indicates the currently executing OperatingSystem. "
360 "At most one OperatingSystem can execute at any time on a "
361 "ComputerSystem. 'At most one' is specified, since the Computer "
362 "System may not be currently booted, or its OperatingSystem may "
363 "be unknown.")]
364 class CIM_RunningOS : CIM_Dependency {
365
366 [Override ( "Antecedent" ), Max ( 1 ), Description (
367 "The OperatingSystem currently running on the "
368 "ComputerSystem.")]
369 CIM_OperatingSystem REF Antecedent;
370
371 [Override ( "Dependent" ), Max ( 1 ), Description (
372 "The ComputerSystem.")]
373 CIM_ComputerSystem REF Dependent;
374 };
375
376
377 // ===================================================================
378 // BootOSFromFS
379 a.dunfey 1.1 // ===================================================================
380 [Association, Version ( "2.6.0" ), Description (
381 "A link between the OperatingSystem and the FileSystem(s) from "
382 "which this OperatingSystem is loaded. The association is many- "
383 "to-many since a Distributed OS could depend on several File "
384 "Systems in order to correctly and completely load.")]
385 class CIM_BootOSFromFS : CIM_Dependency {
386
387 [Override ( "Antecedent" ), Description (
388 "The FileSystem from which the OperatingSystem is loaded.")]
389 CIM_FileSystem REF Antecedent;
390
391 [Override ( "Dependent" ), Description (
392 "The OperatingSystem.")]
393 CIM_OperatingSystem REF Dependent;
394 };
395
396
397 // ===================================================================
398 // end of file
399 // ===================================================================
|