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