1 a.dunfey 1.1 // ===================================================================
2 // Title: Physical_StoragePackage
3 // $State: Exp $
4 // $Date: 2004/11/29 18:31:43 $
5 // $RCSfile: Physical_StoragePackage.mof,v $
6 // $Revision: 1.2.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 Physical Model defines modeling concepts related
47 // to actual boxes and packaging. This file defines the
48 // concepts related to storage media (physical packaging
49 // and statistics).
50 //
51 // The object classes below are listed in an order that
52 // avoids forward references. Required objects, defined
53 // by other working groups, are omitted.
54 // ==================================================================
55 // Change Log for 2.8 Final
56 // CR1031 - PackageLocation
57 // CR1233 - SysDev omnibus minor MOF correction CR
58 //
59 // Change Log for v2.7 Final
60 // CR970 - Removal of the Experimental qualifier.
61 //
62 // Change Log for v2.7
63 // CR721 - Add MediaPhysicalStatData that subclasses off the new
64 a.dunfey 1.1 // StatisticalData hierarchy
65 // ==================================================================
66
67 #pragma locale ("en_US")
68
69
70 // ===================================================================
71 // StorageMediaLocation
72 // ===================================================================
73 [Version ( "2.8.0" ), Description (
74 "StorageMediaLocation is a PackageLocation where PhysicalMedia "
75 "may be placed. This class is typically used in the context of "
76 "a StorageLibrary. Examples of StorageMediaLocations are Media "
77 "AccessDevices, InterLibraryPorts or 'slots' in a Library's "
78 "panel.")]
79 class CIM_StorageMediaLocation : CIM_PackageLocation {
80
81 [Description (
82 "The type of Location. For example, whether this is an "
83 "individual Media \"Slot\" (value=2), a MediaAccessDevice "
84 "(value=4) or a \"Magazine\" (value=3) is indicated in this "
85 a.dunfey 1.1 "property."),
86 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9" },
87 Values { "Unknown", "Other", "Slot", "Magazine",
88 "MediaAccessDevice", "InterLibrary Port",
89 "Limited Access Port", "Door", "Shelf", "Vault" }]
90 uint16 LocationType;
91
92 [Description (
93 "Certain StorageMediaLocations may only be able to accept a "
94 "limited set of PhysicalMedia MediaTypes. This property "
95 "defines an array containing the types of Media that are "
96 "acceptable for placement in the Location. Additional "
97 "information and description of the contained MediaTypes can "
98 "be provided using the TypesDescription array. Also, size "
99 "data (for example, DVD disc diameter) can be specified "
100 "using the MediaSizesSupported array. \n"
101 "\n"
102 "Values defined here correspond to those in the CIM_Physical "
103 "Media.MediaType property. This allows quick comparisons "
104 "using value equivalence calculations. It is understood that "
105 "there is no external physical difference between (for "
106 a.dunfey 1.1 "example) DVD- Video and DVD-RAM. But, equivalent values in "
107 "both the Physical Media and StorageMediaLocation "
108 "enumerations allows for one for one comparisons with no "
109 "additional processing logic (i.e., the following is not "
110 "required ... if \"DVD-Video\" then value=\"DVD\")."),
111 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
112 "10", "11", "12", "13", "14", "15", "16", "17", "18", "19",
113 "20", "21", "22", "23", "24", "25", "26", "27", "28", "29",
114 "30", "31", "32", "33", "34", "35", "36", "37", "38", "39",
115 "40", "41", "42", "43", "44", "45", "46", "47", "48", "49",
116 "50", "51", "52", "53", "54", "55", "56", "57", "58", "59",
117 "60", "61", "62", "63", "64", "65", "66" },
118 Values { "Unknown", "Other", "Tape Cartridge", "QIC Cartridge",
119 "AIT Cartridge", "DTF Cartridge", "DAT Cartridge",
120 "8mm Tape Cartridge", "19mm Tape Cartridge", "DLT Cartridge",
121 // 10
122 "Half-Inch Magnetic Tape Cartridge", "Cartridge Disk",
123 "JAZ Disk", "ZIP Disk", "SyQuest Disk",
124 "Winchester Removable Disk", "CD-ROM", "CD-ROM/XA", "CD-I",
125 "CD Recordable",
126 // 20
127 a.dunfey 1.1 "WORM", "Magneto-Optical", "DVD", "DVD-RW+", "DVD-RAM",
128 "DVD-ROM", "DVD-Video", "Divx", "Floppy/Diskette",
129 "Hard Disk",
130 // 30
131 "Memory Card", "Hard Copy", "Clik Disk", "CD-RW", "CD-DA",
132 "CD+", "DVD Recordable", "DVD-RW", "DVD-Audio", "DVD-5",
133 // 40
134 "DVD-9", "DVD-10", "DVD-18", "Magneto-Optical Rewriteable",
135 "Magneto-Optical Write Once",
136 "Magneto-Optical Rewriteable (LIMDOW)",
137 "Phase Change Write Once", "Phase Change Rewriteable",
138 "Phase Change Dual Rewriteable", "Ablative Write Once",
139 // 50
140 "Near Field Recording", "MiniQic", "Travan",
141 "8mm Metal Particle", "8mm Advanced Metal Evaporate", "NCTP",
142 "LTO Ultrium", "LTO Accelis", "9 Track Tape",
143 "18 Track Tape",
144 // 60
145 "36 Track Tape", "Magstar 3590", "Magstar MP", "D2 Tape",
146 "Tape - DST Small", "Tape - DST Medium", "Tape - DST Large" },
147 ArrayType ( "Indexed" ),
148 a.dunfey 1.1 ModelCorrespondence { "CIM_PhysicalMedia.MediaType",
149 "CIM_StorageMediaLocation.MediaSizesSupported" }]
150 uint16 MediaTypesSupported[];
151
152 [Description (
153 "The sizes (in inches) of the particular MediaTypes that may "
154 "be placed in the Location. Note, each entry of this array "
155 "is related to the entry in the MediaTypesSupported array "
156 "that is located at the same index."),
157 Units ( "Inches" ), ArrayType ( "Indexed" ),
158 ModelCorrespondence { "CIM_PhysicalMedia.MediaType",
159 "CIM_StorageMediaLocation.MediaSizesSupported",
160 "CIM_StorageMediaLocation.TypeDescriptions" }]
161 real32 MediaSizesSupported[];
162
163 [Description (
164 "A StorageMediaLocation may hold more than one PhysicalMedia "
165 "- for example, a Magazine. This property indicates the "
166 "Physical Media capacity of the Location.")]
167 uint32 MediaCapacity;
168
169 a.dunfey 1.1 [Description (
170 "This property provides additional detail related to the "
171 "entries in the MediaTypesSupported array. This is "
172 "especially critical when the MediaTypesSupported value is 1 "
173 "(\"Other\"). Note, each entry of this array is related to "
174 "the entry in MediaTypesSupported that is located at the "
175 "same index."),
176 ArrayType ( "Indexed" ),
177 ModelCorrespondence {
178 "CIM_StorageMediaLocation.MediaTypesSupported" }]
179 string TypeDescriptions[];
180 };
181
182
183 // ===================================================================
184 // Magazine
185 // ===================================================================
186 [Version ( "2.6.0" ), Description (
187 "StorageMediaLocations are typically slots or spaces where "
188 "removable media are located. However, a specific kind of "
189 "MediaLocation is a Magazine. This entity represents a single "
190 a.dunfey 1.1 "physical container with multiple StorageMediaLocations in it. "
191 "All the MediaLocations within the Magazine are added/removed "
192 "together. Often, this container has a Barcode or other label "
193 "for identification. This is the unique data captured in the "
194 "CIM_Magazine class. Magazine's label properties are defined "
195 "exactly as are labels for PhysicalMedia.")]
196 class CIM_Magazine : CIM_StorageMediaLocation {
197
198 [Description (
199 "One or more strings on 'labels' on the Magazine. The format "
200 "of the labels and their state (readable, unreadable, "
201 "upside-down) are indicated in the corresponding "
202 "LabelFormats and LabelStates array properties."),
203 ArrayType ( "Indexed" ),
204 ModelCorrespondence { "CIM_Magazine.LabelStates",
205 "CIM_Magazine.LabelFormats" }]
206 string PhysicalLabels[];
207
208 [Description (
209 "An array of enumerated integers describing the states of "
210 "each of the labels on a Magazine. The Labels themselves are "
211 a.dunfey 1.1 "listed in the PhysicalLabels property. Note, each entry of "
212 "this array is related to the entry in PhysicalLabels that "
213 "is located at the same index."),
214 ValueMap { "0", "1", "2" },
215 Values { "OK/Readable", "Unreadable", "Upside Down" },
216 ArrayType ( "Indexed" ),
217 ModelCorrespondence { "CIM_Magazine.PhysicalLabels" }]
218 uint16 LabelStates[];
219
220 [Description (
221 "An array of enumerated integers describing the formats of "
222 "each of the labels on a Magazine. The Labels themselves are "
223 "listed in the PhysicalLabels property. Note, each entry of "
224 "this array is related to the entry in PhysicalLabels that "
225 "is located at the same index."),
226 ValueMap { "0", "1", "2", "3", "4", "5" },
227 Values { "Barcode", "Radio Frequency Identification",
228 "OCR (Optical Character Recognition)",
229 "MICR (Magnetic Ink Character Recognition)",
230 "7 Character Barcode", "9 Character Barcode" },
231 ArrayType ( "Indexed" ),
232 a.dunfey 1.1 ModelCorrespondence { "CIM_Magazine.PhysicalLabels" }]
233 uint16 LabelFormats[];
234 };
235
236
237 // ===================================================================
238 // MediaPhysicalStatData
239 // ===================================================================
240 [Version ( "2.7.0" ), Description (
241 "Statistics related to reading physical labels and picks/puts "
242 "at a specific StorageMediaLocation, or for a specific piece of "
243 "PhysicalMedia. The same class is used to represent this data - "
244 "whether for a Location (independent of the Media), OR for the "
245 "Media (independent of its StorageMediaLocation). The element "
246 "whose statistics are described is associated using the "
247 "relationship, ElementStatisticalData.")]
248 class CIM_MediaPhysicalStatData : CIM_StatisticalData {
249
250 [Description (
251 "The number of successful physical label scans."),
252 Counter]
253 a.dunfey 1.1 uint64 ScanSuccesses;
254
255 [Description (
256 "The number of failed physical label scans."),
257 Counter]
258 uint64 ScanFailures;
259
260 [Description (
261 "The number of retried physical label scans."),
262 Counter]
263 uint64 ScanRetries;
264
265 [Description (
266 "The number of successful picks."),
267 Counter]
268 uint64 PickSuccesses;
269
270 [Description (
271 "The number of failed picks."),
272 Counter]
273 uint64 PickFailures;
274 a.dunfey 1.1
275 [Description (
276 "The number of retried picks."),
277 Counter]
278 uint64 PickRetries;
279
280 [Description (
281 "The number of successful puts."),
282 Counter]
283 uint64 PutSuccesses;
284
285 [Description (
286 "The number of failed puts."),
287 Counter]
288 uint64 PutFailures;
289
290 [Description (
291 "The number of retried puts."),
292 Counter]
293 uint64 PutRetries;
294 };
295 a.dunfey 1.1
296
297 // ===================================================================
298 // MediaPhysicalStatInfo
299 // ===================================================================
300 [Deprecated { "CIM_MediaPhysicalStatData" }, Version ( "2.7.0" ),
301 Description (
302 "Statistics related to reading physical labels and picks/puts "
303 "at a specific StorageMediaLocation, or for a specific piece of "
304 "PhysicalMedia. Although the same class is used to represent "
305 "this data, at the instance level the object holds information "
306 "for the Location (independent of the Media), OR for the Media "
307 "(independent of its StorageMediaLocation). This class is "
308 "deprecated in lieu of MediaPhysicalStatData, to take advantage "
309 "of the simplified key structure defined there.")]
310 class CIM_MediaPhysicalStatInfo : CIM_PhysicalStatisticalInformation {
311
312 [Deprecated { "CIM_MediaPhysicalStatData.ScanSuccesses" },
313 Description (
314 "The number of successful physical label scans."),
315 Counter]
316 a.dunfey 1.1 uint64 ScanSuccesses;
317
318 [Deprecated { "CIM_MediaPhysicalStatData.ScanFailures" },
319 Description (
320 "The number of failed physical label scans."),
321 Counter]
322 uint64 ScanFailures;
323
324 [Deprecated { "CIM_MediaPhysicalStatData.ScanRetries" },
325 Description (
326 "The number of retried physical label scans."),
327 Counter]
328 uint64 ScanRetries;
329
330 [Deprecated { "CIM_MediaPhysicalStatData.PickSuccesses" },
331 Description (
332 "The number of successful picks."),
333 Counter]
334 uint64 PickSuccesses;
335
336 [Deprecated { "CIM_MediaPhysicalStatData.PickFailures" },
337 a.dunfey 1.1 Description (
338 "The number of failed picks."),
339 Counter]
340 uint64 PickFailures;
341
342 [Deprecated { "CIM_MediaPhysicalStatData.PickRetries" },
343 Description (
344 "The number of retried picks."),
345 Counter]
346 uint64 PickRetries;
347
348 [Deprecated { "CIM_MediaPhysicalStatData.PutSuccesses" },
349 Description (
350 "The number of successful puts."),
351 Counter]
352 uint64 PutSuccesses;
353
354 [Deprecated { "CIM_MediaPhysicalStatData.PutFailures" },
355 Description (
356 "The number of failed puts."),
357 Counter]
358 a.dunfey 1.1 uint64 PutFailures;
359
360 [Deprecated { "CIM_MediaPhysicalStatData.PutRetries" },
361 Description (
362 "The number of retried puts."),
363 Counter]
364 uint64 PutRetries;
365
366 [Deprecated { "CIM_StatisticalData.ResetSelectedStats" },
367 Description (
368 "Method to reset the statistical counters. The method takes "
369 "one parameter as input - an integer indicating which "
370 "counter to reset. For this input parameter, 0 indicates "
371 "all, 1-3 reset the scan-related counters, 4-6 reset the "
372 "'pick'-related counters, and 7-9 reset the 'put'-related "
373 "counters. The method returns 0 if successful, 1 if not "
374 "supported, and any other value if an error occurred. A "
375 "method is specified so that the Element's instrumentation "
376 "can also reset its internal processing and counters. The "
377 "set of possible return codes should be specified in a "
378 "ValueMap qualifier on the method. The strings to which the "
379 a.dunfey 1.1 "ValueMap contents are 'translated' should be specified as a "
380 "Values array qualifier on the method.")]
381 uint32 ResetCounter (
382 [IN, Description (
383 "The counter to reset."),
384 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9" },
385 Values { "All", "Scan Successes", "Scan Failures",
386 "Scan Retries", "Pick Successes", "Pick Failures",
387 "Pick Retries", "Put Successes", "Put Failures",
388 "Put Retries" }]
389 uint16 SelectedCounter);
390 };
391
392
393 // ===================================================================
394 // end of file
395 // ===================================================================
|