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