1 karl 1.1 // ===================================================================
2 // Title: Physical Storage Media Packaging 2.7
3 // Filename: Physical27_StoragePackage.mof
4 // Version: 2.7.0
5 // Release: Preliminary
6 // Date: 07/02/02
7 // ===================================================================
8 // Copyright 2002 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 karl 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 karl 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 v2.7
54 // CR721 - Add MediaPhysicalStatData that subclasses off the new
55 // StatisticalData hierarchy
56 // ==================================================================
57
58 #pragma locale ("en_US")
59
60
61 // ===================================================================
62 // StorageMediaLocation
63 // ===================================================================
64 karl 1.1 [Version ("2.6.0"), Description (
65 "StorageMediaLocation is a PhysicalPackage where PhysicalMedia "
66 "may be placed. This class describes an entity that holds Media "
67 "and is not just a 'place' (as is conveyed by the CIM_Location "
68 "object). This class is typically used in the context of a "
69 "StorageLibrary. Examples of StorageMediaLocations are Media"
70 "AccessDevices, InterLibraryPorts or 'slots' in a Library's "
71 "panel.") ]
72 class CIM_StorageMediaLocation : CIM_PhysicalPackage {
73 [Description (
74 "The type of Location. For example, whether this is an "
75 "individual Media \"Slot\" (value=2), a MediaAccessDevice "
76 "(value=4) or a \"Magazine\" (value=3) is indicated in this "
77 "property."),
78 ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9"},
79 Values {"Unknown", "Other", "Slot", "Magazine",
80 "MediaAccessDevice", "InterLibrary Port",
81 "Limited Access Port", "Door", "Shelf", "Vault"} ]
82 uint16 LocationType;
83
84 [Description (
85 karl 1.1 "LocationCoordinates represent the physical location of the "
86 "the StorageMediaLocation instance. The property is defined "
87 "as a free-form string to allow the location information to "
88 "be described in vendor-unique terminology.") ]
89 string LocationCoordinates;
90
91 [Description (
92 " Certain StorageMediaLocations may only be able to accept a "
93 "limited set of PhysicalMedia MediaTypes. This property "
94 "defines an array containing the types of Media that are "
95 "acceptable for placement in the Location. Additional "
96 "information and description of the contained MediaTypes "
97 "can be provided using the TypesDescription array. Also, "
98 "size data (for example, DVD disc diameter) can be specified "
99 "using the MediaSizesSupported array. \n\n"
100 " Values defined here correspond to those in the CIM_Physical"
101 "Media.MediaType property. This allows quick comparisons using "
102 "value equivalence calculations. It is understood that there "
103 "is no external physical difference between (for example) DVD-"
104 "Video and DVD-RAM. But, equivalent values in both the Physical"
105 "Media and StorageMediaLocation enumerations allows for one "
106 karl 1.1 "for one comparisons with no additional processing logic "
107 "(i.e., the following is not required ... if \"DVD-Video\" "
108 "then value=\"DVD\")."),
109 ArrayType ("Indexed"),
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"},
117 Values {"Unknown", "Other", "Tape Cartridge", "QIC Cartridge",
118 "AIT Cartridge", "DTF Cartridge", "DAT Cartridge",
119 "8mm Tape Cartridge", "19mm Tape Cartridge",
120 "DLT Cartridge",
121 // 10
122 "Half-Inch Magnetic Tape Cartridge",
123 "Cartridge Disk", "JAZ Disk", "ZIP Disk", "SyQuest Disk",
124 "Winchester Removable Disk", "CD-ROM", "CD-ROM/XA",
125 "CD-I", "CD Recordable",
126 // 20
127 karl 1.1 "WORM", "Magneto-Optical",
128 "DVD", "DVD-RW+", "DVD-RAM", "DVD-ROM", "DVD-Video",
129 "Divx", "Floppy/Diskette", "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",
135 "Magneto-Optical Rewriteable",
136 "Magneto-Optical Write Once",
137 "Magneto-Optical Rewriteable (LIMDOW)",
138 "Phase Change Write Once", "Phase Change Rewriteable",
139 "Phase Change Dual Rewriteable", "Ablative Write Once",
140 // 50
141 "Near Field Recording", "MiniQic", "Travan",
142 "8mm Metal Particle", "8mm Advanced Metal Evaporate",
143 "NCTP", "LTO Ultrium", "LTO Accelis", "9 Track Tape",
144 "18 Track Tape",
145 // 60
146 "36 Track Tape", "Magstar 3590", "Magstar MP", "D2 Tape",
147 "Tape - DST Small", "Tape - DST Medium",
148 karl 1.1 "Tape - DST Large"},
149 ModelCorrespondence {"CIM_PhysicalMedia.MediaType",
150 "CIM_StorageMediaLocation.MediaSizesSupported"} ]
151 uint16 MediaTypesSupported[];
152
153 [Description (
154 "The sizes (in inches) of the particular MediaTypes that may "
155 "be placed in the Location. Note, each entry of this array "
156 "is related to the entry in the MediaTypesSupported array that "
157 "is located at the same index."),
158 ArrayType ("Indexed"), Units ("Inches"),
159 ModelCorrespondence {"CIM_PhysicalMedia.MediaType",
160 "CIM_StorageMediaLocation.MediaSizesSupported",
161 "CIM_StorageMediaLocation.TypeDescriptions"} ]
162 real32 MediaSizesSupported[];
163
164 [Description (
165 "A StorageMediaLocation may hold more than one PhysicalMedia - "
166 "for example, a Magazine. This property indicates the Physical"
167 "Media capacity of the Location.") ]
168 uint32 MediaCapacity;
169 karl 1.1
170 [Description (
171 "This property provides additional detail related to the "
172 "entries in the MediaTypesSupported array. This is "
173 "especially critical when the MediaTypesSupported value "
174 "is 1 (\"Other\"). Note, each entry of this array is "
175 "related to the entry in MediaTypesSupported that is "
176 "located at the same index. "),
177 ArrayType ("Indexed"),
178 ModelCorrespondence {
179 "CIM_StorageMediaLocation.MediaTypesSupported"} ]
180 string TypeDescriptions[];
181 };
182
183
184 // ===================================================================
185 // Magazine
186 // ===================================================================
187 [Version ("2.6.0"), Description (
188 "StorageMediaLocations are typically slots or spaces where "
189 "removable media are located. However, a specific kind of "
190 karl 1.1 "MediaLocation is a Magazine. This entity represents a single "
191 "physical container with multiple StorageMediaLocations in it. "
192 "All the MediaLocations within the Magazine are added/removed "
193 "together. Often, this container has a Barcode or other label "
194 "for identification. This is the unique data captured in the "
195 "CIM_Magazine class. Magazine's label properties are defined "
196 "exactly as are labels for PhysicalMedia. ") ]
197 class CIM_Magazine : CIM_StorageMediaLocation {
198 [Description (
199 "One or more strings on 'labels' on the Magazine. The "
200 "format of the labels and their state (readable, unreadable, "
201 "upside-down) are indicated in the corresponding LabelFormats "
202 "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 "
211 karl 1.1 "are listed in the PhysicalLabels property. Note, each entry "
212 "of this array is related to the entry in PhysicalLabels that "
213 "is located at the same index."),
214 ArrayType ("Indexed"),
215 ValueMap {"0", "1", "2"},
216 Values {"OK/Readable", "Unreadable", "Upside Down"},
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 "
223 "are listed in the PhysicalLabels property. Note, each entry "
224 "of this array is related to the entry in PhysicalLabels that "
225 "is located at the same index."),
226 ArrayType ("Indexed"),
227 ValueMap {"0", "1", "2", "3", "4", "5"},
228 Values {"Barcode", "Radio Frequency Identification",
229 "OCR (Optical Character Recognition)",
230 "MICR (Magnetic Ink Character Recognition)",
231 "7 Character Barcode", "9 Character Barcode"},
232 karl 1.1 ModelCorrespondence {"CIM_Magazine.PhysicalLabels"} ]
233 uint16 LabelFormats[];
234 };
235
236 // ===================================================================
237 // MediaPhysicalStatInfo
238 // ===================================================================
239 [Version ("2.6.0"), Description (
240 "Statistics related to reading physical labels and picks/puts "
241 "at a specific StorageMediaLocation, or for a specific piece "
242 "of PhysicalMedia. Although the same class is used to represent "
243 "this data, at the instance level the object holds information "
244 "for the Location (independent of the Media), OR for the Media "
245 "(independent of its StorageMediaLocation).") ]
246 class CIM_MediaPhysicalStatInfo : CIM_PhysicalStatisticalInformation {
247
248 [Description (
249 "The number of successful physical label scans."),
250 Counter]
251 uint64 ScanSuccesses;
252
253 karl 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 karl 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 [Description (
294 "Method to reset the statistical counters. The method "
295 karl 1.1 "takes one parameter as input - an integer indicating which "
296 "counter to reset. For this input parameter, 0 indicates all, "
297 "1-3 reset the scan-related counters, 4-6 reset the "
298 "'pick'-related counters, and 7-9 reset the 'put'-related "
299 "counters. The method returns 0 if successful, 1 if not "
300 "supported, and any other value if an error occurred. A method "
301 "is specified so that the Element's instrumentation can also "
302 "reset its internal processing and counters. The set of "
303 "possible return codes should be specified in a ValueMap "
304 "qualifier on the method. The strings to which the ValueMap "
305 "contents are 'translated' should be specified as a Values "
306 "array qualifier on the method.") ]
307 uint32 ResetCounter (
308 [IN,
309 ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9"},
310 Values {"All", "Scan Successes", "Scan Failures",
311 "Scan Retries", "Pick Successes", "Pick Failures",
312 "Pick Retries", "Put Successes", "Put Failures",
313 "Put Retries"} ]
314 uint16 SelectedCounter);
315 };
316 karl 1.1
317
318 // ===================================================================
319 // MediaPhysicalStatData
320 // ===================================================================
321 [Experimental, Version ("2.7.0"), Description (
322 "Statistics related to reading physical labels and picks/puts "
323 "at a specific StorageMediaLocation, or for a specific piece "
324 "of PhysicalMedia. The same class is used to represent "
325 "this data - whether for a Location (independent of the Media), "
326 "OR for the Media (independent of its StorageMediaLocation). "
327 "The element whose statistics are described is associated "
328 "using the relationship, ElementStatisticalData.") ]
329 class CIM_MediaPhysicalStatData : CIM_StatisticalData {
330
331 [Description (
332 "The number of successful physical label scans."),
333 Counter]
334 uint64 ScanSuccesses;
335
336 [Description (
337 karl 1.1 "The number of failed physical label scans."),
338 Counter]
339 uint64 ScanFailures;
340
341 [Description (
342 "The number of retried physical label scans."),
343 Counter]
344 uint64 ScanRetries;
345
346 [Description (
347 "The number of successful picks."),
348 Counter]
349 uint64 PickSuccesses;
350
351 [Description (
352 "The number of failed picks."),
353 Counter]
354 uint64 PickFailures;
355
356 [Description (
357 "The number of retried picks."),
358 karl 1.1 Counter]
359 uint64 PickRetries;
360
361 [Description (
362 "The number of successful puts."),
363 Counter]
364 uint64 PutSuccesses;
365
366 [Description (
367 "The number of failed puts."),
368 Counter]
369 uint64 PutFailures;
370
371 [Description (
372 "The number of retried puts."),
373 Counter]
374 uint64 PutRetries;
375 };
376
377
378 // ===================================================================
379 karl 1.1 // end of file
380 // ===================================================================
|