1 kumpf 1.1 <html xmlns:o="urn:schemas-microsoft-com:office:office"
2 xmlns:w="urn:schemas-microsoft-com:office:word"
3 xmlns="http://www.w3.org/TR/REC-html40">
4
5 <head>
6 <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
7 <meta name=ProgId content=Word.Document>
8 <meta name=Generator content="Microsoft Word 9">
9 <meta name=Originator content="Microsoft Word 9">
10 <link rel=File-List
11 href="./WBEM%20Java%20Client%20Release%20Notes%202_0Alpha2_files/filelist.xml">
12 <title>WBEM Java Client Release Notes</title>
13 <!--[if gte mso 9]><xml>
14 <o:DocumentProperties>
15 <o:Subject>WBEM Java Client Release Notes </o:Subject>
16 <o:Author>Bapu Patil</o:Author>
17 <o:Template>normal</o:Template>
18 <o:LastAuthor>Bapu Patil</o:LastAuthor>
19 <o:Revision>2</o:Revision>
20 <o:TotalTime>180</o:TotalTime>
21 <o:LastPrinted>2003-05-14T18:27:00Z</o:LastPrinted>
22 kumpf 1.1 <o:Created>2003-05-15T19:31:00Z</o:Created>
23 <o:LastSaved>2003-05-15T19:31:00Z</o:LastSaved>
24 <o:Pages>15</o:Pages>
25 <o:Words>3806</o:Words>
26 <o:Characters>21696</o:Characters>
27 <o:Lines>180</o:Lines>
28 <o:Paragraphs>43</o:Paragraphs>
29 <o:CharactersWithSpaces>26644</o:CharactersWithSpaces>
30 <o:Version>9.4402</o:Version>
31 </o:DocumentProperties>
32 </xml><![endif]--><!--[if gte mso 9]><xml>
33 <w:WordDocument>
34 <w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>
35 <w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>
36 <w:UseMarginsForDrawingGridOrigin/>
37 <w:Compatibility>
38 <w:FootnoteLayoutLikeWW8/>
39 <w:ShapeLayoutLikeWW8/>
40 <w:AlignTablesRowByRow/>
41 <w:ForgetLastTabAlignment/>
42 <w:LayoutRawTableWidth/>
43 kumpf 1.1 <w:LayoutTableRowsApart/>
44 </w:Compatibility>
45 </w:WordDocument>
46 </xml><![endif]-->
47 <style>
48 <!--
49 /* Font Definitions */
50 @font-face
51 {font-family:Wingdings;
52 panose-1:5 0 0 0 0 0 0 0 0 0;
53 mso-font-charset:2;
54 mso-generic-font-family:auto;
55 mso-font-pitch:variable;
56 mso-font-signature:0 268435456 0 0 -2147483648 0;}
57 @font-face
58 {font-family:"Futura Bk";
59 panose-1:0 0 0 0 0 0 0 0 0 0;
60 mso-font-alt:"Times New Roman";
61 mso-font-charset:0;
62 mso-generic-font-family:roman;
63 mso-font-format:other;
64 kumpf 1.1 mso-font-pitch:auto;
65 mso-font-signature:0 0 0 0 0 0;}
66 @font-face
67 {font-family:"Comic Sans MS";
68 panose-1:3 15 7 2 3 3 2 2 2 4;
69 mso-font-charset:0;
70 mso-generic-font-family:script;
71 mso-font-pitch:variable;
72 mso-font-signature:647 0 0 0 159 0;}
73 /* Style Definitions */
74 p.MsoNormal, li.MsoNormal, div.MsoNormal
75 {mso-style-parent:"";
76 margin:0in;
77 margin-bottom:.0001pt;
78 mso-pagination:widow-orphan;
79 font-size:10.0pt;
80 font-family:"Times New Roman";
81 mso-fareast-font-family:"Times New Roman";}
82 h1
83 {mso-style-next:Normal;
84 margin-top:12.0pt;
85 kumpf 1.1 margin-right:0in;
86 margin-bottom:3.0pt;
87 margin-left:0in;
88 mso-pagination:widow-orphan;
89 mso-outline-level:1;
90 font-size:14.0pt;
91 mso-bidi-font-size:10.0pt;
92 font-family:Arial;
93 mso-font-kerning:14.0pt;
94 font-weight:bold;
95 mso-bidi-font-weight:normal;}
96 h2
97 {mso-style-next:Normal;
98 margin-top:12.0pt;
99 margin-right:0in;
100 margin-bottom:3.0pt;
101 margin-left:0in;
102 mso-pagination:widow-orphan;
103 mso-outline-level:2;
104 font-size:12.0pt;
105 mso-bidi-font-size:10.0pt;
106 kumpf 1.1 font-family:Arial;
107 font-weight:bold;
108 mso-bidi-font-weight:normal;
109 font-style:italic;
110 mso-bidi-font-style:normal;}
111 h3
112 {mso-style-next:Normal;
113 margin-top:12.0pt;
114 margin-right:0in;
115 margin-bottom:3.0pt;
116 margin-left:0in;
117 mso-pagination:widow-orphan;
118 mso-outline-level:3;
119 font-size:12.0pt;
120 mso-bidi-font-size:10.0pt;
121 font-family:Arial;
122 font-weight:normal;}
123 h4
124 {mso-style-next:Normal;
125 margin:0in;
126 margin-bottom:.0001pt;
127 kumpf 1.1 mso-pagination:widow-orphan;
128 mso-outline-level:4;
129 font-size:12.0pt;
130 mso-bidi-font-size:10.0pt;
131 font-family:"Times New Roman";
132 font-weight:bold;}
133 h5
134 {mso-style-next:Normal;
135 margin:0in;
136 margin-bottom:.0001pt;
137 mso-pagination:widow-orphan;
138 mso-outline-level:5;
139 font-size:14.0pt;
140 mso-bidi-font-size:10.0pt;
141 font-family:"Times New Roman";
142 font-weight:normal;}
143 p.MsoNormalIndent, li.MsoNormalIndent, div.MsoNormalIndent
144 {margin-top:0in;
145 margin-right:0in;
146 margin-bottom:0in;
147 margin-left:.5in;
148 kumpf 1.1 margin-bottom:.0001pt;
149 mso-pagination:widow-orphan;
150 font-size:10.0pt;
151 font-family:"Times New Roman";
152 mso-fareast-font-family:"Times New Roman";}
153 p.MsoList2, li.MsoList2, div.MsoList2
154 {margin-top:0in;
155 margin-right:0in;
156 margin-bottom:0in;
157 margin-left:.5in;
158 margin-bottom:.0001pt;
159 text-indent:-.25in;
160 mso-pagination:widow-orphan;
161 font-size:10.0pt;
162 font-family:"Times New Roman";
163 mso-fareast-font-family:"Times New Roman";}
164 p.MsoListBullet2, li.MsoListBullet2, div.MsoListBullet2
165 {mso-style-update:auto;
166 margin-top:0in;
167 margin-right:0in;
168 margin-bottom:0in;
169 kumpf 1.1 margin-left:.5in;
170 margin-bottom:.0001pt;
171 text-indent:-.25in;
172 mso-pagination:widow-orphan;
173 mso-list:l0 level1 lfo16;
174 tab-stops:list .5in;
175 font-size:10.0pt;
176 font-family:"Times New Roman";
177 mso-fareast-font-family:"Times New Roman";}
178 p.MsoSignature, li.MsoSignature, div.MsoSignature
179 {margin-top:0in;
180 margin-right:0in;
181 margin-bottom:0in;
182 margin-left:3.0in;
183 margin-bottom:.0001pt;
184 mso-pagination:widow-orphan;
185 font-size:10.0pt;
186 font-family:"Times New Roman";
187 mso-fareast-font-family:"Times New Roman";}
188 p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
189 {margin:0in;
190 kumpf 1.1 margin-bottom:.0001pt;
191 mso-pagination:widow-orphan;
192 mso-layout-grid-align:none;
193 font-size:10.0pt;
194 font-family:"Comic Sans MS";
195 mso-fareast-font-family:"Times New Roman";
196 mso-bidi-font-family:"Times New Roman";
197 font-weight:bold;}
198 p.MsoBodyTextIndent, li.MsoBodyTextIndent, div.MsoBodyTextIndent
199 {margin-top:0in;
200 margin-right:0in;
201 margin-bottom:6.0pt;
202 margin-left:.25in;
203 mso-pagination:widow-orphan;
204 font-size:10.0pt;
205 font-family:"Times New Roman";
206 mso-fareast-font-family:"Times New Roman";}
207 p.MsoListContinue2, li.MsoListContinue2, div.MsoListContinue2
208 {margin-top:0in;
209 margin-right:0in;
210 margin-bottom:6.0pt;
211 kumpf 1.1 margin-left:.5in;
212 mso-pagination:widow-orphan;
213 font-size:10.0pt;
214 font-family:"Times New Roman";
215 mso-fareast-font-family:"Times New Roman";}
216 p.MsoBodyText2, li.MsoBodyText2, div.MsoBodyText2
217 {margin:0in;
218 margin-bottom:.0001pt;
219 mso-pagination:widow-orphan;
220 font-size:12.0pt;
221 mso-bidi-font-size:10.0pt;
222 font-family:"Times New Roman";
223 mso-fareast-font-family:"Times New Roman";}
224 a:link, span.MsoHyperlink
225 {color:blue;
226 text-decoration:underline;
227 text-underline:single;}
228 a:visited, span.MsoHyperlinkFollowed
229 {color:purple;
230 text-decoration:underline;
231 text-underline:single;}
232 kumpf 1.1 p
233 {margin-right:0in;
234 mso-margin-top-alt:auto;
235 mso-margin-bottom-alt:auto;
236 margin-left:0in;
237 mso-pagination:widow-orphan;
238 font-size:12.0pt;
239 font-family:"Times New Roman";
240 mso-fareast-font-family:"Times New Roman";}
241 pre
242 {margin:0in;
243 margin-bottom:.0001pt;
244 mso-pagination:widow-orphan;
245 tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;
246 font-size:10.0pt;
247 font-family:"Courier New";
248 mso-fareast-font-family:"Courier New";}
249 tt
250 {mso-ascii-font-family:"Courier New";
251 mso-fareast-font-family:"Courier New";
252 mso-hansi-font-family:"Courier New";
253 kumpf 1.1 mso-bidi-font-family:"Courier New";}
254 p.CcList, li.CcList, div.CcList
255 {mso-style-name:"Cc List";
256 margin:0in;
257 margin-bottom:.0001pt;
258 mso-pagination:widow-orphan;
259 font-size:10.0pt;
260 font-family:"Times New Roman";
261 mso-fareast-font-family:"Times New Roman";}
262 p.ShortReturnAddress, li.ShortReturnAddress, div.ShortReturnAddress
263 {mso-style-name:"Short Return Address";
264 margin:0in;
265 margin-bottom:.0001pt;
266 mso-pagination:widow-orphan;
267 font-size:10.0pt;
268 font-family:"Times New Roman";
269 mso-fareast-font-family:"Times New Roman";}
270 p.PPLine, li.PPLine, div.PPLine
271 {mso-style-name:"PP Line";
272 mso-style-parent:Signature;
273 margin-top:0in;
274 kumpf 1.1 margin-right:0in;
275 margin-bottom:0in;
276 margin-left:3.0in;
277 margin-bottom:.0001pt;
278 mso-pagination:widow-orphan;
279 font-size:10.0pt;
280 font-family:"Times New Roman";
281 mso-fareast-font-family:"Times New Roman";}
282 p.InsideAddressName, li.InsideAddressName, div.InsideAddressName
283 {mso-style-name:"Inside Address Name";
284 margin:0in;
285 margin-bottom:.0001pt;
286 mso-pagination:widow-orphan;
287 font-size:10.0pt;
288 font-family:"Times New Roman";
289 mso-fareast-font-family:"Times New Roman";}
290 @page Section1
291 {size:8.5in 11.0in;
292 margin:1.0in 1.25in 1.0in 1.25in;
293 mso-header-margin:.5in;
294 mso-footer-margin:.5in;
295 kumpf 1.1 mso-paper-source:0;}
296 div.Section1
297 {page:Section1;}
298 /* List Definitions */
299 @list l0
300 {mso-list-id:-125;
301 mso-list-type:simple;
302 mso-list-template-ids:-218198392;}
303 @list l0:level1
304 {mso-level-number-format:bullet;
305 mso-level-style-link:"List Bullet 2";
306 mso-level-text:\F0B7;
307 mso-level-tab-stop:.5in;
308 mso-level-number-position:left;
309 text-indent:-.25in;
310 font-family:Symbol;}
311 @list l1
312 {mso-list-id:247084106;
313 mso-list-type:hybrid;
314 mso-list-template-ids:1643154800 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
315 @list l1:level1
316 kumpf 1.1 {mso-level-tab-stop:.5in;
317 mso-level-number-position:left;
318 text-indent:-.25in;}
319 @list l2
320 {mso-list-id:252513578;
321 mso-list-type:hybrid;
322 mso-list-template-ids:811916116 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
323 @list l2:level1
324 {mso-level-tab-stop:.5in;
325 mso-level-number-position:left;
326 text-indent:-.25in;}
327 @list l3
328 {mso-list-id:524485251;
329 mso-list-type:hybrid;
330 mso-list-template-ids:-175104624 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
331 @list l3:level1
332 {mso-level-number-format:bullet;
333 mso-level-text:\F0B7;
334 mso-level-tab-stop:.5in;
335 mso-level-number-position:left;
336 text-indent:-.25in;
337 kumpf 1.1 font-family:Symbol;}
338 @list l4
339 {mso-list-id:749347362;
340 mso-list-type:hybrid;
341 mso-list-template-ids:1295564480 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
342 @list l4:level1
343 {mso-level-number-format:bullet;
344 mso-level-text:\F0B7;
345 mso-level-tab-stop:.5in;
346 mso-level-number-position:left;
347 text-indent:-.25in;
348 font-family:Symbol;}
349 @list l5
350 {mso-list-id:1156529437;
351 mso-list-type:hybrid;
352 mso-list-template-ids:1568459352 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
353 @list l5:level1
354 {mso-level-start-at:2;
355 mso-level-tab-stop:.5in;
356 mso-level-number-position:left;
357 text-indent:-.25in;}
358 kumpf 1.1 @list l6
359 {mso-list-id:1305546433;
360 mso-list-type:hybrid;
361 mso-list-template-ids:1768434552 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
362 @list l6:level1
363 {mso-level-tab-stop:.5in;
364 mso-level-number-position:left;
365 text-indent:-.25in;}
366 @list l7
367 {mso-list-id:1324700588;
368 mso-list-type:hybrid;
369 mso-list-template-ids:1419687056 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
370 @list l7:level1
371 {mso-level-tab-stop:.5in;
372 mso-level-number-position:left;
373 text-indent:-.25in;}
374 @list l8
375 {mso-list-id:1505632988;
376 mso-list-type:hybrid;
377 mso-list-template-ids:904969346 1896489038 -1021140422 616970556 753855378 -307702454 337287590 -362651142 1385077412 129915254;}
378 @list l8:level1
379 kumpf 1.1 {mso-level-number-format:bullet;
380 mso-level-text:\F0B7;
381 mso-level-tab-stop:.5in;
382 mso-level-number-position:left;
383 text-indent:-.25in;
384 mso-ansi-font-size:10.0pt;
385 font-family:Symbol;}
386 @list l8:level2
387 {mso-level-tab-stop:1.0in;
388 mso-level-number-position:left;
389 text-indent:-.25in;}
390 @list l8:level3
391 {mso-level-tab-stop:1.5in;
392 mso-level-number-position:left;
393 text-indent:-.25in;}
394 @list l8:level4
395 {mso-level-tab-stop:2.0in;
396 mso-level-number-position:left;
397 text-indent:-.25in;}
398 @list l8:level5
399 {mso-level-tab-stop:2.5in;
400 kumpf 1.1 mso-level-number-position:left;
401 text-indent:-.25in;}
402 @list l8:level6
403 {mso-level-tab-stop:3.0in;
404 mso-level-number-position:left;
405 text-indent:-.25in;}
406 @list l8:level7
407 {mso-level-tab-stop:3.5in;
408 mso-level-number-position:left;
409 text-indent:-.25in;}
410 @list l8:level8
411 {mso-level-tab-stop:4.0in;
412 mso-level-number-position:left;
413 text-indent:-.25in;}
414 @list l8:level9
415 {mso-level-tab-stop:4.5in;
416 mso-level-number-position:left;
417 text-indent:-.25in;}
418 @list l9
419 {mso-list-id:1739132725;
420 mso-list-type:hybrid;
421 kumpf 1.1 mso-list-template-ids:417074740 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
422 @list l9:level1
423 {mso-level-number-format:bullet;
424 mso-level-text:\F0B7;
425 mso-level-tab-stop:.5in;
426 mso-level-number-position:left;
427 text-indent:-.25in;
428 font-family:Symbol;}
429 @list l10
430 {mso-list-id:2007662374;
431 mso-list-type:hybrid;
432 mso-list-template-ids:1413667294 -1837347444 1447836560 -2085591486 1525986426 420924086 1411915016 220890626 1754024258 -168013522;}
433 @list l10:level1
434 {mso-level-number-format:bullet;
435 mso-level-text:\F0B7;
436 mso-level-tab-stop:.5in;
437 mso-level-number-position:left;
438 text-indent:-.25in;
439 mso-ansi-font-size:10.0pt;
440 font-family:Symbol;}
441 @list l10:level2
442 kumpf 1.1 {mso-level-tab-stop:1.0in;
443 mso-level-number-position:left;
444 text-indent:-.25in;}
445 @list l10:level3
446 {mso-level-tab-stop:1.5in;
447 mso-level-number-position:left;
448 text-indent:-.25in;}
449 @list l10:level4
450 {mso-level-tab-stop:2.0in;
451 mso-level-number-position:left;
452 text-indent:-.25in;}
453 @list l10:level5
454 {mso-level-tab-stop:2.5in;
455 mso-level-number-position:left;
456 text-indent:-.25in;}
457 @list l10:level6
458 {mso-level-tab-stop:3.0in;
459 mso-level-number-position:left;
460 text-indent:-.25in;}
461 @list l10:level7
462 {mso-level-tab-stop:3.5in;
463 kumpf 1.1 mso-level-number-position:left;
464 text-indent:-.25in;}
465 @list l10:level8
466 {mso-level-tab-stop:4.0in;
467 mso-level-number-position:left;
468 text-indent:-.25in;}
469 @list l10:level9
470 {mso-level-tab-stop:4.5in;
471 mso-level-number-position:left;
472 text-indent:-.25in;}
473 @list l11
474 {mso-list-id:2122145077;
475 mso-list-type:hybrid;
476 mso-list-template-ids:229274478 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
477 @list l11:level1
478 {mso-level-tab-stop:.5in;
479 mso-level-number-position:left;
480 text-indent:-.25in;}
481 ol
482 {margin-bottom:0in;}
483 ul
484 kumpf 1.1 {margin-bottom:0in;}
485 -->
486 </style>
487 </head>
488
489 <body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
490
491 <div class=Section1>
492
493 <h1 align=center style='text-align:center'>WBEM Services</h1>
494
495 <h1 align=center style='text-align:center'>Java Client SDK Version 2.0 Alpha 2</h1>
496
497 <h1 align=center style='text-align:center'><span style="mso-spacerun:
498 yes"> </span>Release Notes</h1>
499
500 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;
501 tab-stops:list .5in'><![if !supportLists]><span style='font-style:normal;
502 mso-bidi-font-style:italic'>1.<span style='font:7.0pt "Times New Roman"'>
503 </span></span><![endif]><span style='font-style:normal;mso-bidi-font-style:
504 italic'>Overview<o:p></o:p></span></h2>
505 kumpf 1.1
506 <p style='margin-right:.4in;text-align:justify'>The WBEM Java Client SDK is a
507 set of APIs that contain the components necessary to write management
508 applications that communicate with WBEM-enabled management devices using XML and
509 HTTP communication standards. </p>
510
511 <p style='margin-right:.4in;text-align:justify'>WBEM applications request
512 information or services from the Common Information Model (CIM) Object Manager
513 through the WBEM APIs. These APIs represent CIM objects as Java classes. These
514 APIs can be used to describe managed objects and retrieve information about
515 managed objects on a system. </p>
516
517 <p style='margin-right:.4in;text-align:justify'>WBEM client applications use
518 the <tt><span style='font-size:10.0pt;font-family:"Courier New"'>org.snia.wbem.client</span></tt>
519 APIs to manipulate CIM objects. A client application uses the CIM API to
520 construct an object (for example, a class, instance, or namespace) and then
521 initializes, or instantiates that object. The application uses the client APIs
522 to pass the object to the CIM Object Manager (CIMOM) and request an operation,
523 such as creating a CIM class, instance, or deleting an instance.</p>
524
525 <p style='margin-right:.4in;text-align:justify'>CIM Listener (org.snia.wbem.listener)
526 kumpf 1.1 provides interfaces to process CIM/XML Indications.</p>
527
528 <p style='margin-right:.4in;text-align:justify'>The javadoc documentation
529 includes the following packages that the client applications require to make
530 CIM operation requests to a CIM Object Manager. </p>
531
532 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'><span
533 style='mso-tab-count:1'> </span>org.snia.wbem.client</p>
534
535 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'><span
536 style='mso-tab-count:1'> </span>org.snia.wbem.cim</p>
537
538 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'><span
539 style='mso-tab-count:1'> </span>org.snia.wbemcfg</p>
540
541 <p style='margin-right:.4in;margin-left:.5in;text-align:justify'>org.snia.wbem.listener</p>
542
543 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;
544 tab-stops:list .5in'><![if !supportLists]><span style='font-style:normal;
545 mso-bidi-font-style:italic'>2.<span style='font:7.0pt "Times New Roman"'>
546 </span></span><![endif]><span style='font-style:normal;mso-bidi-font-style:
547 kumpf 1.1 italic'>Requirements<o:p></o:p></span></h2>
548
549 <p class=MsoNormal><span style='font-family:"Courier New"'> <o:p></o:p></span></p>
550
551 <ul style='margin-top:0in' type=disc>
552 <li class=MsoNormal style='mso-list:l10 level1 lfo3;tab-stops:list .5in'><span
553 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The apache xerces XML
554 parser 1.4.4. <o:p></o:p></span></li>
555 </ul>
556
557 <p class=MsoNormal style='text-indent:.5in'><span style='font-size:12.0pt;
558 mso-bidi-font-size:10.0pt'>You must use Xerces 1.4.4 version. It can be
559 downloaded from<o:p></o:p></span></p>
560
561 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
562 style="mso-spacerun: yes"> </span><span style='mso-tab-count:1'> </span><a
563 href="http://xml.apache.org/dist/xerces-j/">http://xml.apache.org/dist/xerces-j/</a><o:p></o:p></span></p>
564
565 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
566
567 <ul style='margin-top:0in' type=disc>
568 kumpf 1.1 <li class=MsoNormal style='mso-list:l8 level1 lfo6;tab-stops:list .5in'><span
569 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Java 1.4 version ( JRE
570 1.4 )</span> <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p></o:p></span></li>
571 </ul>
572
573 <p class=MsoNormal style='margin-left:.5in'><span style='font-size:12.0pt;
574 mso-bidi-font-size:10.0pt'>Java 1.4 version is used because it includes JSSE
575 (for SSL), JAAS (Java authentication), JCE (Crypto). Note that all these
576 packages (JSEE, JAAS, JCE) are not part of earlier versions of Java. You may
577 download Java 1.4 from http://www.hp.com/go/java/.<o:p></o:p></span></p>
578
579 <p class=MsoNormal style='margin-left:.25in'><span style='font-size:12.0pt;
580 mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
581
582 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
583 Java CLASSPATH must include the following:<o:p></o:p></span></p>
584
585 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
586
587 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CLASSPATH=$JAVA_HOME/jre/lib/rt.jar:$JAVA_HOME/jre/lib/jsse.jar:$XERCES_HOME/xerces-1_4_4/xerces.jar:$CIMCLIENT_HOME/cimclient.jar:.<o:p></o:p></span></p>
588
589 kumpf 1.1 <p class=MsoNormal><span style='font-family:"Courier New"'> <o:p></o:p></span></p>
590
591 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;
592 tab-stops:list .5in'><![if !supportLists]><span style='font-style:normal;
593 mso-bidi-font-style:italic'>3.<span style='font:7.0pt "Times New Roman"'>
594 </span></span><![endif]><span style='font-style:normal;mso-bidi-font-style:
595 italic'>What's new in Alpha 2 Release<o:p></o:p></span></h2>
596
597 <p class=MsoBodyText2>This version supports both SSL and non-SSL based CIM/XML
598 indications.<span style="mso-spacerun: yes"> </span>Two-way SSL authentication
599 is always enabled with CIM/XML Indications. Client SDK now includes the CIM
600 Listener interfaces for writing CIM/XML indication consumers. Please refer to
601 Java documentation of org.snia.wbem.listener package. You can also refer to the
602 “CIM-XML Listener” section in this document on how to write consumers.</p>
603
604 <p class=MsoNormal><b><i><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Note:</span></i></b><span
605 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> SSL is fully supported with
606 Alpha 2 release and onwards.<o:p></o:p></span></p>
607
608 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
609
610 kumpf 1.1 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
611 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo12;tab-stops:
612 list .5in'><![if !supportLists]><span style='font-style:normal;mso-bidi-font-style:
613 italic'>4.<span style='font:7.0pt "Times New Roman"'>
614 </span></span><![endif]><span style='font-style:normal;mso-bidi-font-style:
615 italic'>Writing WBEM Clients<o:p></o:p></span></h2>
616
617 <p class=MsoNormal> </p>
618
619 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
620 mso-bidi-font-size:10.0pt'>WBEM client applications use the </span><tt><span
621 style='font-size:12.0pt;mso-bidi-font-size:10.0pt;mso-ascii-font-family:"Times New Roman";
622 mso-hansi-font-family:"Times New Roman"'>org.snia.wbem.client</span></tt><span
623 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> APIs to manipulate CIM
624 objects on the CIM Object Manager. A client application uses classes in </span><tt><span
625 style='font-size:12.0pt;mso-bidi-font-size:10.0pt;mso-ascii-font-family:"Times New Roman";
626 mso-hansi-font-family:"Times New Roman"'>org.snia.wbem.cim package </span></tt><span
627 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>to construct an object (for
628 example, a class, instance, or namespace) and initializes that object. Then
629 uses the client APIs to pass the object to the CIMOM and request a CIM
630 operation, such as creating a CIM class, instance, or namespace.<o:p></o:p></span></p>
631 kumpf 1.1
632 <p>Client applications typically follow this sequence:</p>
633
634 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>1.<span
635 style='font-size:7.0pt'> </span>Connect to the
636 CIMOM using <tt><span style='font-size:10.0pt;font-family:"Courier New"'>CIMClient</span></tt>.
637 A client application connects to the CIMOM before performing a CIM operation,
638 such as creating a CIM class or updating a CIM instance. </p>
639
640 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>2.<span
641 style='font-size:7.0pt'> </span>Use the client
642 APIs to request CIM operations. Most of the client programs perform tasks such
643 as creating, deleting and modifying classes and instances; enumerating
644 instances; invoking provider methods; and handling errors and exceptions. </p>
645
646 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>3.<span
647 style='font-size:7.0pt'> </span>Close the client
648 connection to the CIM Object Manager using <tt><span style='font-size:10.0pt;
649 font-family:"Courier New"'>CIMClient</span></tt>, to free the server resources
650 used by the client session. </p>
651
652 kumpf 1.1 <p class=MsoNormal> </p>
653
654 <h3><b>Opening a Client Connection<o:p></o:p></b></h3>
655
656 <p class=MsoNormal> </p>
657
658 <p class=MsoBodyText2>Client applications typically import the required CIM
659 classes and create CIM objects and then open client connection.<span
660 style="mso-spacerun: yes"> </span>Some of the common imports and CIM object
661 creations are show below.</p>
662
663 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
664
665 <div style='border:solid windowtext .5pt;padding:1.0pt 0in 1.0pt 31.0pt'>
666
667 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
668 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
669 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.client.CIMClient;<o:p></o:p></span></p>
670
671 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
672 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
673 kumpf 1.1 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMNameSpace;<o:p></o:p></span></p>
674
675 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
676 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
677 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMObjectPath;<o:p></o:p></span></p>
678
679 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
680 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
681 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMClass;<o:p></o:p></span></p>
682
683 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
684 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
685 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMProperty;<o:p></o:p></span></p>
686
687 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
688 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
689 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMInstance;<o:p></o:p></span></p>
690
691 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
692 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
693 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMValue;<o:p></o:p></span></p>
694 kumpf 1.1
695 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
696 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
697 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMQualifierType;<o:p></o:p></span></p>
698
699 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
700 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
701 12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMException;<o:p></o:p></span></p>
702
703 </div>
704
705 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
706
707 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
708
709 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 31.0pt'>
710
711 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
712 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
713 12.0pt;mso-bidi-font-size:10.0pt'>CIMNameSpace clientNameSpace = null;<o:p></o:p></span></p>
714
715 kumpf 1.1 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
716 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
717 12.0pt;mso-bidi-font-size:10.0pt'>CIMClient cc = null;<o:p></o:p></span></p>
718
719 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
720 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
721 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
722
723 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
724 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
725 12.0pt;mso-bidi-font-size:10.0pt'>int portNo = CIMNameSpace.DEFAULT_PORT;<o:p></o:p></span></p>
726
727 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
728 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
729 12.0pt;mso-bidi-font-size:10.0pt'>String nameSpace =
730 "root/cimv2";<span style="mso-spacerun: yes"> </span>//
731 namespace<o:p></o:p></span></p>
732
733 </div>
734
735 <p class=MsoNormal> </p>
736 kumpf 1.1
737 <p class=MsoNormal><span style='font-family:"Courier New"'> <o:p></o:p></span></p>
738
739 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
740 mso-bidi-font-size:10.0pt'>To open a client connection, you use the </span><tt><span
741 style='font-size:12.0pt;mso-bidi-font-size:10.0pt;mso-ascii-font-family:"Times New Roman";
742 mso-hansi-font-family:"Times New Roman"'>CIMClient</span></tt><span
743 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class to connect to the CIM
744 Object Manager. You must specify the required type of connection (HTTP or
745 HTTPS) in the CIMNameSpace constructor. If connection type is not specified the
746 HTTP is used as the default. You must also specify the user name and password
747 for the connection to the specified CIM server.<o:p></o:p></span></p>
748
749 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
750 mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
751
752 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
753 mso-bidi-font-size:10.0pt'>Example HTTP connection:<o:p></o:p></span></p>
754
755 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
756 mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
757 kumpf 1.1
758 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 0in'>
759
760 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
761 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
762 mso-bidi-font-size:10.0pt;mso-bidi-font-weight:bold;mso-bidi-font-style:italic'><span
763 style="mso-spacerun: yes"> </span></span><span style='font-size:12.0pt;
764 mso-bidi-font-size:10.0pt'>String hostURL = "<b>http</b>://" +
765 hostname + ":" + portNo;<o:p></o:p></span></p>
766
767 <p style='margin:0in;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
768 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='mso-bidi-font-size:
769 10.0pt'><span style="mso-spacerun: yes"> </span>try <o:p></o:p></span></p>
770
771 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
772 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
773 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
774
775 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
776 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
777 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
778 kumpf 1.1 </span>clientNameSpace = new CIMNameSpace(hostURL, nameSpace);<o:p></o:p></span></p>
779
780 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
781 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
782 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
783 </span>cc = new CIMClient(clientNameSpace, "guest",
784 "guest", CIMClient.HTTP);<o:p></o:p></span></p>
785
786 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
787 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
788 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>} <o:p></o:p></span></p>
789
790 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
791 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
792 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
793 </span>catch (CIMException e) <o:p></o:p></span></p>
794
795 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
796 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
797 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
798
799 kumpf 1.1 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
800 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
801 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
802 </span>System.err.println("Failed to access CIMOM: " + e);<o:p></o:p></span></p>
803
804 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
805 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
806 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
807
808 </div>
809
810 <p class=MsoNormal> </p>
811
812 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
813
814 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Example
815 HTTPS connection:<o:p></o:p></span></p>
816
817 <p class=MsoNormal> </p>
818
819 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 0in'>
820 kumpf 1.1
821 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
822 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
823 mso-bidi-font-size:10.0pt;mso-bidi-font-weight:bold;mso-bidi-font-style:italic'><span
824 style="mso-spacerun: yes"> </span></span><span style='font-size:12.0pt;
825 mso-bidi-font-size:10.0pt'>String hostURL = "<b>https</b>://" +
826 hostname + ":" + portNo;<o:p></o:p></span></p>
827
828 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
829 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
830 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>try
831 <o:p></o:p></span></p>
832
833 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
834 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
835 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
836
837 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
838 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
839 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
840 </span>clientNameSpace = new CIMNameSpace(hostURL, nameSpace);<o:p></o:p></span></p>
841 kumpf 1.1
842 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
843 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
844 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
845 </span>cc = new CIMClient(clientNameSpace, "guest",
846 "guest", CIMClient.HTTP);<o:p></o:p></span></p>
847
848 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
849 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
850 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>} <o:p></o:p></span></p>
851
852 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
853 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
854 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
855 </span>catch (CIMException e) <o:p></o:p></span></p>
856
857 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
858 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
859 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
860
861 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
862 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
863 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
864 </span>System.err.println("Failed to access CIMOM: " + e);<o:p></o:p></span></p>
865
866 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
867 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
868 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
869
870 </div>
871
872 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
873
874 <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:Arial;
875 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
876 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
877 </span>
878
879 <h3><b>Performing CIM Operations <o:p></o:p></b></h3>
880
881 <p class=MsoNormal> </p>
882
883 kumpf 1.1 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
884 following examples show how to do CIM operations using org.snia.wbem.client
885 APIs.<o:p></o:p></span></p>
886
887 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
888
889 <h4> </h4>
890
891 <h4>Enumerating classes</h4>
892
893 <p class=MsoNormal> </p>
894
895 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
896 following example shows how to do <i>enumerateClasses </i>of <i>CIM_ComputerSystem</i><o:p></o:p></span></p>
897
898 <p class=MsoNormal> </p>
899
900 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 31.0pt'>
901
902 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
903 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
904 kumpf 1.1 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
905 </span>try<o:p></o:p></span></p>
906
907 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
908 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
909 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
910 </span>{<o:p></o:p></span></p>
911
912 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
913 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
914 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
915 </span>System.out.println("\n*** Enumerate classes - No DEEP");<o:p></o:p></span></p>
916
917 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
918 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
919 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
920 </span>CIMObjectPath path = new CIMObjectPath("CIM_ComputerSystem");<o:p></o:p></span></p>
921
922 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
923 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
924 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
925 kumpf 1.1
926 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
927 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
928 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
929 </span>Boolean deepInheritance = false;<o:p></o:p></span></p>
930
931 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
932 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
933 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
934 </span>Boolean localOnly = true;<o:p></o:p></span></p>
935
936 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
937 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
938 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
939 </span>Boolean includeQualifiers = true;<o:p></o:p></span></p>
940
941 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
942 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
943 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
944 </span>Boolean includeClassOrigin = true;<o:p></o:p></span></p>
945
946 kumpf 1.1 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
947 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
948 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
949
950 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
951 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
952 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
953 </span>Enumeration en = cc.enumerateClasses(path, deepInheritance,<o:p></o:p></span></p>
954
955 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
956 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
957 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
958 yes"> </span><span style="mso-spacerun:
959 yes"> </span>localOnly, includeQualifiers,<o:p></o:p></span></p>
960
961 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
962 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
963 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
964 yes">
965 </span>includeClassOrigin);<o:p></o:p></span></p>
966
967 kumpf 1.1 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
968 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
969 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
970 </span>if (en != null)<o:p></o:p></span></p>
971
972 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
973 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
974 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
975 </span>{<o:p></o:p></span></p>
976
977 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
978 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
979 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
980 yes"> </span>while ( en.hasMoreElements() )<o:p></o:p></span></p>
981
982 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
983 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
984 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
985 yes"> </span>{<o:p></o:p></span></p>
986
987 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
988 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
989 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
990 yes"> </span>CIMClass cimclass = (CIMClass)
991 en.nextElement();<o:p></o:p></span></p>
992
993 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
994 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
995 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
996 yes"> </span>System.out.println("Class name: " +
997 cimclass.getName());<o:p></o:p></span></p>
998
999 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1000 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1001 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
1002 yes"> </span>}<o:p></o:p></span></p>
1003
1004 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1005 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1006 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1007 </span>}<o:p></o:p></span></p>
1008
1009 kumpf 1.1 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1010 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1011 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1012 </span>}<o:p></o:p></span></p>
1013
1014 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1015 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1016 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1017 </span>catch (CIMException ce)<o:p></o:p></span></p>
1018
1019 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1020 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1021 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1022 </span>{<o:p></o:p></span></p>
1023
1024 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1025 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1026 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1027 </span>System.err.println("Failed to enumerate classes: " + ce);<o:p></o:p></span></p>
1028
1029 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1030 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1031 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1032 </span>}<o:p></o:p></span></p>
1033
1034 </div>
1035
1036 <p class=MsoNormal style='margin-left:.5in'><span style='font-size:12.0pt;
1037 mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1038
1039 <h4> </h4>
1040
1041 <b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";
1042 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
1043 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1044 </span></b>
1045
1046 <h4>InvokeMethod Operation</h4>
1047
1048 <p class=MsoNormal> </p>
1049
1050 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
1051 kumpf 1.1 following example shows how to do <i>invokeMethod </i>on a <i>Sample_MethodProvider.</i><o:p></o:p></span></p>
1052
1053 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1054
1055 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 4.0pt'>
1056
1057 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1058 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1059 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1060 </span>// NOTE: The following test requires the Sample_MethodProviderClass<o:p></o:p></span></p>
1061
1062 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1063 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1064 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1065 </span>// and a sample method provider for Sample_MethodProviderClass.<o:p></o:p></span></p>
1066
1067 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1068 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1069 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1070 </span>//<o:p></o:p></span></p>
1071
1072 kumpf 1.1 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1073 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1074 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1075 </span>System.out.println("\n*** Invoke Method.");<o:p></o:p></span></p>
1076
1077 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1078 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1079 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1080 </span>String testNameSpace = "root/SampleProvider";<o:p></o:p></span></p>
1081
1082 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1083 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1084 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1085 </span>String testClassName = "Sample_MethodProviderClass";<o:p></o:p></span></p>
1086
1087 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1088 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1089 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1090 </span>String methodName = "SayHello";<o:p></o:p></span></p>
1091
1092 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1093 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1094 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1095 </span>String inParamValue = "Yoda";<o:p></o:p></span></p>
1096
1097 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1098 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1099 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1100 </span>String goodReply = "Hello, " + inParamValue + "!";<o:p></o:p></span></p>
1101
1102 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1103 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1104 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1105 </span>String goodParam = "From Neverland";<o:p></o:p></span></p>
1106
1107 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1108 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1109 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1110
1111 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1112 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1113 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1114 kumpf 1.1 </span>CIMObjectPath currentPath;<o:p></o:p></span></p>
1115
1116 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1117 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1118 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1119 </span>Vector inParams = new Vector();<o:p></o:p></span></p>
1120
1121 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1122 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1123 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1124 </span>Vector outParams = new Vector();<o:p></o:p></span></p>
1125
1126 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1127 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1128 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1129 </span>CIMValue retValue;<o:p></o:p></span></p>
1130
1131 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1132 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1133 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1134
1135 kumpf 1.1 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1136 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1137 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1138 </span>try<o:p></o:p></span></p>
1139
1140 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1141 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1142 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1143 </span>{<o:p></o:p></span></p>
1144
1145 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1146 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1147 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1148 </span>// construct CIMObjectPath<o:p></o:p></span></p>
1149
1150 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1151 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1152 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1153 </span>//<o:p></o:p></span></p>
1154
1155 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1156 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1157 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1158 </span>currentPath = new CIMObjectPath(testClassName);<o:p></o:p></span></p>
1159
1160 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1161 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1162 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1163
1164 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1165 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1166 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1167 </span>// set the namespace<o:p></o:p></span></p>
1168
1169 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1170 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1171 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1172 </span>//<o:p></o:p></span></p>
1173
1174 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1175 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1176 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1177 kumpf 1.1 </span>currentPath.setNameSpace(testNameSpace);<o:p></o:p></span></p>
1178
1179 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1180 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1181 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1182
1183 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1184 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1185 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1186 </span>// create parameter vectors<o:p></o:p></span></p>
1187
1188 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1189 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1190 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1191 </span>//<o:p></o:p></span></p>
1192
1193 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1194 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1195 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1196 </span>inParams.addElement( new CIMProperty("dummy",<o:p></o:p></span></p>
1197
1198 kumpf 1.1 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1199 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1200 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1201 </span><span style='mso-tab-count:2'> </span>new
1202 CIMValue(inParamValue, CIMDataType.getPredefinedType(<o:p></o:p></span></p>
1203
1204 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1205 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1206 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
1207 yes"> </span>CIMDataType.STRING))));<o:p></o:p></span></p>
1208
1209 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1210 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1211 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1212
1213 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1214 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1215 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1216 </span>// call invokeMethod<o:p></o:p></span></p>
1217
1218 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1219 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1220 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1221 </span>//<o:p></o:p></span></p>
1222
1223 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1224 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1225 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1226 </span>retValue=cc.invokeMethod(currentPath, methodName, inParams,<o:p></o:p></span></p>
1227
1228 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1229 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1230 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
1231 yes"> </span>outParams);<o:p></o:p></span></p>
1232
1233 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1234 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1235 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1236 </span>System.out.println("InvokeMethod response = " +
1237 retValue.toString());<o:p></o:p></span></p>
1238
1239 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1240 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1241 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1242 </span>}<o:p></o:p></span></p>
1243
1244 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1245 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1246 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1247 </span>catch (CIMException ce)<o:p></o:p></span></p>
1248
1249 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1250 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1251 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1252 </span>{<o:p></o:p></span></p>
1253
1254 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1255 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1256 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1257 </span>System.err.println("invokeMethod Failed: " + ce);<o:p></o:p></span></p>
1258
1259 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1260 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style="mso-spacerun:
1261 kumpf 1.1 yes"> </span>}<span style="mso-spacerun: yes"> </span></p>
1262
1263 </div>
1264
1265 <h3><b> <o:p></o:p></b></h3>
1266
1267 <h3><b>Closing Client Connection<o:p></o:p></b></h3>
1268
1269 <p class=MsoNormal><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></b></p>
1270
1271 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Clients
1272 may close the connection by calling the CIMClient.close() method. Client
1273 connection will also be closed when the CIMClient object goes out of scope. <o:p></o:p></span></p>
1274
1275 <p class=MsoNormal> </p>
1276
1277 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 0in'>
1278
1279 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1280 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1281 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>try<o:p></o:p></span></p>
1282 kumpf 1.1
1283 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1284 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1285 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
1286
1287 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1288 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1289 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1290 </span>if( cc != null ) <o:p></o:p></span></p>
1291
1292 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1293 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1294 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1295 </span>{<o:p></o:p></span></p>
1296
1297 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1298 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1299 mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
1300 yes"> </span>cc.close();<o:p></o:p></span></p>
1301
1302 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1303 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1304 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1305 </span>}<o:p></o:p></span></p>
1306
1307 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1308 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1309 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
1310
1311 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1312 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1313 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1314 </span>catch (CIMException ce)<o:p></o:p></span></p>
1315
1316 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1317 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1318 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
1319
1320 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1321 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1322 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1323 </span>System.err.println("Failed to close connection: " + ce);<o:p></o:p></span></p>
1324 kumpf 1.1
1325 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1326 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1327 mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
1328
1329 </div>
1330
1331 <p class=MsoNormal><b style='mso-bidi-font-weight:normal'><i style='mso-bidi-font-style:
1332 normal'> <o:p></o:p></i></b></p>
1333
1334 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
1335 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo12;tab-stops:
1336 list .5in'><![if !supportLists]><span style='font-style:normal;mso-bidi-font-style:
1337 italic'>5.<span style='font:7.0pt "Times New Roman"'>
1338 </span></span><![endif]><span style='font-style:normal;mso-bidi-font-style:
1339 italic'>SSL Certificate Management<o:p></o:p></span></h2>
1340
1341 <p class=MsoNormal style='margin-right:.4in;text-align:justify'> </p>
1342
1343 <p style='margin-right:.4in;text-align:justify'><b>Importing Certificates into
1344 Java Trust Store<o:p></o:p></b></p>
1345 kumpf 1.1
1346 <p style='margin-right:.4in;text-align:justify'>1. Export the server
1347 certificate from the .pem file. </p>
1348
1349 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'>Use <span
1350 style='font-family:"Courier New"'>openssl</span> command to export Pegasus
1351 CIMServer certificate file. <span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:
1352 "Courier New"'><o:p></o:p></span></p>
1353
1354 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'><span
1355 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>#
1356 /opt/wbem/sbin/openssl x509 -in /var/opt/wbem/server.pem -out server.cer<o:p></o:p></span></p>
1357
1358 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1359 10.0pt;mso-bidi-font-family:"Courier New"'>2. Import the server certificate in
1360 to the client trust store.<o:p></o:p></span></p>
1361
1362 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1363 10.0pt;mso-bidi-font-family:"Courier New"'><span style="mso-spacerun:
1364 yes"> </span>- Copy the server certificate on to the client system.<o:p></o:p></span></p>
1365
1366 kumpf 1.1 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1367 10.0pt;mso-bidi-font-family:"Courier New"'><span style="mso-spacerun:
1368 yes"> </span>- Use Java </span><span style='mso-bidi-font-size:10.0pt;
1369 font-family:"Courier New"'>keytool</span><span style='mso-bidi-font-size:10.0pt;
1370 mso-bidi-font-family:"Courier New"'> to import the certificate into the client
1371 trust store.<o:p></o:p></span></p>
1372
1373 <p style='margin-right:.4in;margin-left:.5in;text-align:justify'><span
1374 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'># keytool
1375 -import -alias sequoia1 -file server.cer -keystore mytruststore<o:p></o:p></span></p>
1376
1377 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1378 10.0pt;mso-bidi-font-family:"Courier New"'>You will be asked to enter a
1379 password. The password is required only for modifying mytruststore in the
1380 future. The keytool creates the trust store if it is not already exists and
1381 then import the specified certificate. (For example we entered the password as
1382 “wbem01”)<o:p></o:p></span></p>
1383
1384 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1385 10.0pt;mso-bidi-font-family:"Courier New"'>3. Specify the truststore in the
1386 command line of the client application using “-Djavax.net.ssl.trustStore”.<o:p></o:p></span></p>
1387 kumpf 1.1
1388 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1389 10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p></span></p>
1390
1391 <p style='margin-right:.4in;text-align:justify'><span style='font-size:11.0pt;
1392 mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java -Djavax.net.ssl.trustStore=mytruststore
1393 <MyClient> <system> root/cimv2 5989 ssl<o:p></o:p></span></p>
1394
1395 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1396 10.0pt;mso-bidi-font-family:"Courier New"'>4. If your client application is
1397 written to update the truststore file programmatically then you must also
1398 specify the password that was used to create the truststore using<span
1399 style="mso-spacerun: yes"> </span>“-Djavax.net.ssl.trustStorePassword”.<o:p></o:p></span></p>
1400
1401 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1402 10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p></span></p>
1403
1404 <p style='margin-right:.4in'><span style='font-size:11.0pt;mso-bidi-font-size:
1405 10.0pt;mso-bidi-font-family:"Courier New"'>java
1406 -Djavax.net.ssl.trustStore=mytruststore<span style="mso-spacerun: yes">
1407 </span>-Djavax.net.ssl.trustStorePassword=wbem01 <MyClient><span
1408 kumpf 1.1 style="mso-spacerun: yes"> </span><system> root/cimv2 5989 ssl<span
1409 style="mso-spacerun: yes"> </span><o:p></o:p></span></p>
1410
1411 <p style='margin-right:.4in;text-align:justify'><b> <o:p></o:p></b></p>
1412
1413 <p style='margin-right:.4in;text-align:justify'><b>Viewing Certificates and
1414 Trust Store files</b><b><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:
1415 "Courier New"'><o:p></o:p></span></b></p>
1416
1417 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1418 10.0pt;mso-bidi-font-family:"Courier New"'><span style="mso-spacerun:
1419 yes"> </span>1.You view certificates in a certificate file using keytool
1420 command.<o:p></o:p></span></p>
1421
1422 <p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:
1423 .25in'><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>keytool
1424 -printcert -file server.cer<o:p></o:p></span></p>
1425
1426 <p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:
1427 -.25in;tab-stops:list .5in'><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:
1428 "Courier New"'>1.</span><span style='font-size:7.0pt'>
1429 kumpf 1.1 </span><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>You
1430 can view all the certificates in a truststore using the keytool command.<o:p></o:p></span></p>
1431
1432 <p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:
1433 .25in'><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>keytool
1434 -list -v -keystore mytruststore</span><b><o:p></o:p></b></p>
1435
1436 <h2><span style='font-style:normal;mso-bidi-font-style:italic'> <o:p></o:p></span></h2>
1437
1438 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;
1439 tab-stops:list .5in'><![if !supportLists]><span style='font-style:normal;
1440 mso-bidi-font-style:italic'>6.<span style='font:7.0pt "Times New Roman"'>
1441 </span></span><![endif]><span style='font-style:normal;mso-bidi-font-style:
1442 italic'>Writing A Trust Manager<o:p></o:p></span></h2>
1443
1444 <p style='margin-right:.4in;text-align:justify'>The primary responsibility of
1445 the TrustManager is to determine whether the presented authentication
1446 credentials should be trusted or not. If the credentials are not trusted, the
1447 connection will be terminated. If no trust manager is specified by the client
1448 application then JSSE will use its own trust manager that supports
1449 authentication based on X.509 public key certificates. </p>
1450 kumpf 1.1
1451 <p style='margin-right:.4in;text-align:justify'>If the default X509TrustManager
1452 behavior isn't suitable for your situation, you can implement your own
1453 X509TrustManager. JSSE interface allows you to override certification
1454 validation and continue the SSL handshake. You can also use the interface to
1455 discontinue an SSL handshake by performing additional validation on a server's
1456 digital certificate chain.</p>
1457
1458 <p style='margin-right:.4in;text-align:justify'>When an SSL client connects to
1459 an SSL server, the SSL server presents its digital certificate chain to the
1460 client for authentication. This certificate chain can contain invalid digital
1461 certificates. As per the SSL specification, the client should drop the SSL
1462 connection once it discovers an invalid certificate. However, some applications
1463 such as Web Browsers ask the user whether to accept the invalid certificate.
1464 The Trust Manager eliminates this inconsistent practice by enabling you to
1465 control when to continue or discontinue an SSL connection. Using a Trust
1466 Manager you can perform custom checks before continuing an SSL connection. For
1467 example, you can use the Trust Manager to specify that only users from specific
1468 localities, such as towns, states, or countries, or users with other special
1469 attributes, to gain access via the SSL connection. </p>
1470
1471 kumpf 1.1 <p style='margin-right:.4in;text-align:justify'>Here is an example of a Trust
1472 Manager that basically ignores the server certificates chain by not validating
1473 the certificate chain. It accepts any certificates from any server and goes
1474 ahead with SSL handshake.<b> <o:p></o:p></b></p>
1475
1476 <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";
1477 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
1478 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1479 </span>
1480
1481 <div style='border:solid windowtext .5pt;padding:1.0pt 31.0pt 1.0pt 4.0pt'>
1482
1483 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1484 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1485 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1486 12.0pt;mso-bidi-font-size:10.0pt'>import java.security.cert.*;<o:p></o:p></span></p>
1487
1488 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1489 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1490 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1491 12.0pt;mso-bidi-font-size:10.0pt'>import java.security.KeyStore;<o:p></o:p></span></p>
1492 kumpf 1.1
1493 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1494 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1495 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1496 12.0pt;mso-bidi-font-size:10.0pt'>import javax.net.*;<o:p></o:p></span></p>
1497
1498 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1499 margin-left:9.0pt;margin-bottom:.0001pt;tab-stops:400.5pt;border:none;
1500 mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span
1501 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import javax.net.ssl.*;<o:p></o:p></span></p>
1502
1503 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1504 margin-left:9.0pt;margin-bottom:.0001pt;tab-stops:400.5pt;border:none;
1505 mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span
1506 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1507
1508 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1509 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1510 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1511 12.0pt;mso-bidi-font-size:10.0pt'>/**<o:p></o:p></span></p>
1512
1513 kumpf 1.1 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1514 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1515 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1516 12.0pt;mso-bidi-font-size:10.0pt'>This class implements the X509TrustManager
1517 interface.<span style="mso-spacerun: yes"> </span>It does not validate the
1518 certificate chain sent by the server, it basically ignores the certificate
1519 chain and goes ahead with the SSL hand shake. <o:p></o:p></span></p>
1520
1521 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1522 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1523 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1524 12.0pt;mso-bidi-font-size:10.0pt'>*/<o:p></o:p></span></p>
1525
1526 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1527 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1528 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1529 12.0pt;mso-bidi-font-size:10.0pt'>public class DontValidateCertificate
1530 implements X509TrustManager<o:p></o:p></span></p>
1531
1532 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1533 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1534 kumpf 1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1535 12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p></span></p>
1536
1537 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1538 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1539 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1540 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1541 </span>X509TrustManager<span style="mso-spacerun: yes">
1542 </span>myX509TrustManager;<o:p></o:p></span></p>
1543
1544 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1545 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1546 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1547 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1548
1549 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1550 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1551 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1552 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1553 </span>/**<o:p></o:p></span></p>
1554
1555 kumpf 1.1 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1556 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1557 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1558 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1559 </span>* checkClientTrusted checks to see if the chain is in the <o:p></o:p></span></p>
1560
1561 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1562 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1563 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1564 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1565 </span>* keyStore object.<o:p></o:p></span></p>
1566
1567 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1568 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1569 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1570 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1571 </span>*/<o:p></o:p></span></p>
1572
1573 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1574 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1575 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1576 kumpf 1.1 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1577 </span>public void checkClientTrusted(X509Certificate[] chain, <o:p></o:p></span></p>
1578
1579 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1580 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1581 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1582 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
1583 yes"> </span>String authType) throws
1584 CertificateException<span style="mso-spacerun: yes"> </span><o:p></o:p></span></p>
1585
1586 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1587 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1588 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1589 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1590 </span>{ <o:p></o:p></span></p>
1591
1592 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1593 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1594 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1595 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1596 </span>}<o:p></o:p></span></p>
1597 kumpf 1.1
1598 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1599 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1600 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1601 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1602
1603 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1604 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1605 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1606 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1607 </span>/**<o:p></o:p></span></p>
1608
1609 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1610 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1611 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1612 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1613 </span>* checkServerTrusted verifies to see if the chain is in the <o:p></o:p></span></p>
1614
1615 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1616 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1617 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1618 kumpf 1.1 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes"> </span><span
1619 style="mso-spacerun: yes"> </span>* keyStore object.<o:p></o:p></span></p>
1620
1621 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1622 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1623 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1624 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1625 </span>*/<o:p></o:p></span></p>
1626
1627 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1628 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1629 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1630 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1631 </span>public void checkServerTrusted(X509Certificate[] chain, <o:p></o:p></span></p>
1632
1633 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1634 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1635 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1636 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
1637 yes"> </span>String authType) throws
1638 CertificateException<span style="mso-spacerun: yes"> </span><o:p></o:p></span></p>
1639 kumpf 1.1
1640 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1641 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1642 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1643 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1644 </span>{ <o:p></o:p></span></p>
1645
1646 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1647 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1648 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1649 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1650 </span>}<o:p></o:p></span></p>
1651
1652 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1653 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1654 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1655 12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1656
1657 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1658 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1659 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1660 kumpf 1.1 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1661 </span>/**<o:p></o:p></span></p>
1662
1663 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1664 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1665 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1666 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1667 </span>* This method retrieves all of the certificates in the keyStore <o:p></o:p></span></p>
1668
1669 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1670 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1671 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1672 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1673 </span>* and returns them in an X509Certificate array. We return null <o:p></o:p></span></p>
1674
1675 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1676 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1677 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1678 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1679 </span>* as we are accepting any certificates. We should only return null if we
1680 are using this trust manager <o:p></o:p></span></p>
1681 kumpf 1.1
1682 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1683 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1684 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1685 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1686 </span>* with CIMClient applications. However, we must return an empty
1687 X509Certificate[] is used with<o:p></o:p></span></p>
1688
1689 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1690 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1691 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1692 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1693 </span>* CIM Listener (which is SSL Server) interface. <o:p></o:p></span></p>
1694
1695 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1696 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1697 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1698 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1699 </span>*/<o:p></o:p></span></p>
1700
1701 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1702 kumpf 1.1 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1703 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1704 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1705 </span>public X509Certificate[] getAcceptedIssuers()<o:p></o:p></span></p>
1706
1707 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1708 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1709 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1710 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1711 </span>{<o:p></o:p></span></p>
1712
1713 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1714 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1715 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1716 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1717 </span>return null;<o:p></o:p></span></p>
1718
1719 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1720 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1721 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1722 12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun: yes">
1723 kumpf 1.1 </span>}<o:p></o:p></span></p>
1724
1725 <p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;
1726 margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
1727 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1728 12.0pt;mso-bidi-font-size:10.0pt'>}<o:p></o:p></span></p>
1729
1730 </div>
1731
1732 <span style='font-size:12.0pt;font-family:"Times New Roman";mso-fareast-font-family:
1733 "Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:EN-US;
1734 mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1735 </span>
1736
1737 <p style='margin-right:.4in;text-align:justify'>The Client SDK includes the
1738 following two simple trust managers.</p>
1739
1740 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'><span
1741 style='mso-tab-count:1'> </span>org.snia.wbemcmd.xml.CertificateManager</p>
1742
1743 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'><span
1744 kumpf 1.1 style='mso-tab-count:1'> </span>org.snia.wbemcmd.xml.DontValidateCertificate</p>
1745
1746 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'><span
1747 style='mso-tab-count:1'> </span>org.snia.wbem.listener.DoNotValidateClientCert<span
1748 style="mso-spacerun: yes"> </span>( Note: Use this with CIM Listener
1749 interface)</p>
1750
1751 <p style='margin-right:.4in;text-align:justify'>Client API uses JSSE trust
1752 manager by default. If you want the API to use your own trust manager then you
1753 need to explicitly specify. </p>
1754
1755 <p style='margin-right:.4in'>Refer to JSSE reference guide <span
1756 style='color:blue'><a
1757 href="http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html">http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html</a>
1758 </span>for more information about writing trust managers.</p>
1759
1760 <p class=MsoNormal> </p>
1761
1762 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
1763 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo12;tab-stops:
1764 list .5in'><![if !supportLists]><span style='font-style:normal;mso-bidi-font-style:
1765 kumpf 1.1 italic'>7.<span style='font:7.0pt "Times New Roman"'>
1766 </span></span><![endif]><span style='font-style:normal;mso-bidi-font-style:
1767 italic'>Configuration<o:p></o:p></span></h2>
1768
1769 <p style='margin-right:.4in;text-align:justify'>The Client SDK allows the
1770 client applications to specify the following configuration properties in a
1771 property file. If no property file is specified then the SDK will use default
1772 values for all the properties. If the property file is specified but one or
1773 more properties are not set in the property file, then SDK will use the default
1774 values for those properties.</p>
1775
1776 <div align=center>
1777
1778 <table border=1 cellspacing=0 cellpadding=0 style='margin-left:54.9pt;
1779 border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
1780 mso-padding-alt:0in 5.4pt 0in 5.4pt'>
1781 <tr>
1782 <td width=252 valign=top style='width:189.0pt;border:solid windowtext .5pt;
1783 padding:0in 5.4pt 0in 5.4pt'>
1784 <p style='margin-right:.4in;text-align:justify'><b><span style="mso-spacerun:
1785 yes"> </span>Property Name<o:p></o:p></b></p>
1786 kumpf 1.1 </td>
1787 <td width=348 valign=top style='width:261.0pt;border:solid windowtext .5pt;
1788 border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
1789 <p style='margin-right:.4in;text-align:justify'><b>Default Value<o:p></o:p></b></p>
1790 </td>
1791 </tr>
1792 <tr>
1793 <td width=252 valign=top style='width:189.0pt;border:solid windowtext .5pt;
1794 border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
1795 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'>DEBUG_XML </p>
1796 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'>DEBUG_XMLDECODE</p>
1797 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'>clientLogFilePath</p>
1798 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'>TrustManager</p>
1799 </td>
1800 <td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
1801 none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
1802 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
1803 padding:0in 5.4pt 0in 5.4pt'>
1804 <p style='margin-right:.4in;text-align:justify'>False</p>
1805 <p style='margin-right:.4in;text-align:justify'>False</p>
1806 <p style='margin-right:.4in;text-align:justify'>"/logs/clientout.txt"</p>
1807 kumpf 1.1 <p style='margin-right:.4in;text-align:justify'>Do not define this in
1808 properties file unless you have your own Trust Manager. Do not set it to NULL
1809 either. JSSE uses its default Trust<span style="mso-spacerun: yes">
1810 </span>Manager only if this property is not defined.</p>
1811 </td>
1812 </tr>
1813 </table>
1814
1815 </div>
1816
1817 <p style='margin-right:.4in;text-align:justify'>The DEBUG_XML, DEBUG_XMLDECODE,
1818 and clientLogFilePath properties are only for developmental debug purposes and
1819 they should not be set in the release product and should not be exposed to the
1820 client application users.</p>
1821
1822 <p style='margin-right:.4in;text-align:justify'>Note: The debug trace or
1823 logging in the client API is not thread safe, it is recommended that clients do
1824 not use debug logging in a multi-threaded application. </p>
1825
1826 <p style='margin-right:.4in;text-align:justify'>The client applications can
1827 only use the set methods in “GlobalConfig” class to set the following
1828 kumpf 1.1 configuration properties if needed. The above four properties can also be set
1829 using the set methods.</p>
1830
1831 <p style='margin-right:.4in;text-align:justify'> </p>
1832
1833 <div align=center>
1834
1835 <table border=1 cellspacing=0 cellpadding=0 width=547 style='width:409.9pt;
1836 margin-left:54.9pt;border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
1837 mso-padding-alt:0in 5.4pt 0in 5.4pt'>
1838 <tr>
1839 <td width=207 valign=top style='width:154.95pt;border:solid windowtext .5pt;
1840 padding:0in 5.4pt 0in 5.4pt'>
1841 <p style='margin-right:.4in;text-align:justify'><b><span style="mso-spacerun:
1842 yes"> </span>Property Name<o:p></o:p></b></p>
1843 </td>
1844 <td width=340 valign=top style='width:254.95pt;border:solid windowtext .5pt;
1845 border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
1846 <p style='margin-right:.4in;text-align:justify'><b>Default Value<o:p></o:p></b></p>
1847 </td>
1848 </tr>
1849 kumpf 1.1 <tr>
1850 <td width=207 valign=top style='width:154.95pt;border:solid windowtext .5pt;
1851 border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
1852 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'>httpSocketProvider</p>
1853 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'>httpsSocketProvider</p>
1854 </td>
1855 <td width=340 valign=top style='width:254.95pt;border-top:none;border-left:
1856 none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
1857 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
1858 padding:0in 5.4pt 0in 5.4pt'>
1859 <p style='margin-right:.4in;text-align:justify'>org.snia.wbemcmd.xml.PlainSocketProvider</p>
1860 <p style='margin-right:.4in;text-align:justify'>org.snia.wbemcmd.xml.JSSESocketProvider</p>
1861 </td>
1862 </tr>
1863 </table>
1864
1865 </div>
1866
1867 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'> </p>
1868
1869 <p style='margin-right:.4in;text-align:justify'>The client applications can
1870 kumpf 1.1 specify the properties file in the following ways:</p>
1871
1872 <p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:
1873 -.25in;tab-stops:list .5in'>1.<span style='font-size:7.0pt'>
1874 </span>Specify the property file on the command line by setting “–D
1875 org.snia.wbem.cimom.properties”</p>
1876
1877 <p style='margin-right:.4in;margin-left:.25in;text-align:justify;text-indent:
1878 .25in'>For example,</p>
1879
1880 <p style='margin-right:.4in;margin-left:.25in;text-align:justify'><span
1881 style='mso-tab-count:1'> </span># java
1882 -Dorg.snia.wbem.cimom.properties=./cim.properties <myAapp></p>
1883
1884 <p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:
1885 -.25in;tab-stops:list .5in'>2.<span style='font-size:7.0pt'>
1886 </span>Specify the property file programmatically using the
1887 System.setProperty() before creating the CIMClient object.</p>
1888
1889 <p style='margin-right:.4in;margin-left:.5in;text-align:justify'>For example,</p>
1890
1891 kumpf 1.1 <p style='margin-right:.4in;margin-left:.5in;text-align:justify'>System.setProperty("org.snia.wbem.cimom.properties",
1892 “./cim.properties”);</p>
1893
1894 <pre style='tab-stops:.5in'><span style='font-family:"Times New Roman";
1895 mso-fareast-font-family:"Times New Roman"'> <o:p></o:p></span></pre>
1896
1897 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;
1898 tab-stops:list .5in'><![if !supportLists]>8.<span style='font:7.0pt "Times New Roman"'>
1899 </span><![endif]>CIM-XML Listener</h2>
1900
1901 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:8.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
1902
1903 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:8.0pt'>A <b>CIM-xml
1904 Listener </b>is an HTTP server that receives and processes CIM Export Requests
1905 and issues CIM Export Responses. An CIM Export Message is used to transfer data
1906 from a CIM entity into a non-CIM entity.</span><span style='font-size:12.0pt;
1907 display:none;mso-hide:all'><o:p></o:p></span></p>
1908
1909 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
1910 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:
1911 yes"> </span><o:p></o:p></span></p>
1912 kumpf 1.1
1913 <p class=MsoNormal><b><span style='font-size:12.0pt;mso-bidi-font-size:9.0pt'>What
1914 are the components of a CIM-xml Listener?<o:p></o:p></span></b></p>
1915
1916 <ul style='margin-top:0in' type=disc>
1917 <li class=MsoNormal style='mso-list:l3 level1 lfo9;tab-stops:list .5in'><b><span
1918 style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>CIM-xml Listener
1919 Protocol “module”. </span></b><span style='font-size:12.0pt;mso-bidi-font-size:
1920 7.0pt'>The CIM-xml Listener Protocol “module” receives indications from
1921 (and generates responses to) the CIM-xml Indication Handler. </span><span
1922 style='font-size:12.0pt;mso-bidi-font-size:7.5pt;display:none;mso-hide:
1923 all'><o:p></o:p></span></li>
1924 </ul>
1925
1926 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:7.5pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
1927
1928 <ul style='margin-top:0in' type=disc>
1929 <li class=MsoNormal style='mso-list:l3 level1 lfo9;tab-stops:list .5in'><b><span
1930 style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>Indication Consumer.</span></b><span
1931 style='font-size:12.0pt;mso-bidi-font-size:7.5pt'><span
1932 style="mso-spacerun: yes"> </span>A management application that
1933 kumpf 1.1 processes, displays, stores, analyzes, etc indications. <o:p></o:p></span></li>
1934 <li class=MsoNormal style='color:black;mso-list:l3 level1 lfo9;tab-stops:list .5in'><b><span
1935 style='font-size:12.0pt;mso-bidi-font-size:7.5pt;color:windowtext'>CIM_Indication
1936 Schema.</span></b><span style='font-size:12.0pt;mso-bidi-font-size:7.5pt;
1937 color:windowtext'> The schema definition for indication objects of
1938 interest to the CIM-xml Listener.</span><span style='font-size:11.0pt;
1939 mso-bidi-font-size:7.5pt'><o:p></o:p></span></li>
1940 </ul>
1941
1942 <p class=MsoNormal><span style='font-size:7.5pt;font-family:"Futura Bk";
1943 color:black'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
1944
1945 <p class=MsoNormal><span style='font-size:7.5pt;font-family:"Futura Bk";
1946 color:black'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
1947
1948 <p class=MsoNormal><span style='font-size:7.5pt;font-family:"Futura Bk";
1949 color:black'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
1950
1951 <h3><b><span style='font-size:11.0pt;mso-bidi-font-size:10.0pt'>Writing CIM-XML
1952 Consumer<o:p></o:p></span></b></h3>
1953
1954 kumpf 1.1 <p class=MsoNormal> </p>
1955
1956 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
1957 mso-bidi-font-size:10.0pt'>CIM-XML consumer applications use the </span><tt><span
1958 style='font-size:12.0pt;mso-bidi-font-size:10.0pt;mso-ascii-font-family:"Times New Roman";
1959 mso-hansi-font-family:"Times New Roman"'>org.snia.wbem.listner</span></tt><span
1960 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> APIs to handle CIM-XML
1961 indications that are delivered by the client Applications.<span
1962 style="mso-spacerun: yes"> </span>Please follow some of examples that are
1963 provided with the SDK. <o:p></o:p></span></p>
1964
1965 <p>CIM-XML Listener Consumers typically follow this sequence:</p>
1966
1967 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;
1968 tab-stops:list .5in'><![if !supportLists]>1.<span style='font:7.0pt "Times New Roman"'>
1969 </span><![endif]>Identify the port number they want to listen for indications.</p>
1970
1971 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;
1972 tab-stops:list .5in'><![if !supportLists]>2.<span style='font:7.0pt "Times New Roman"'>
1973 </span><![endif]>Use the CIM Listener APIs to start listening on a particular
1974 port.</p>
1975 kumpf 1.1
1976 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;
1977 tab-stops:list .5in'><![if !supportLists]>3.<span style='font:7.0pt "Times New Roman"'>
1978 </span><![endif]>Write it’s own ‘indicationOccurred()’ method to process
1979 indication when received.</p>
1980
1981 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;
1982 tab-stops:list .5in'><![if !supportLists]>4.<span style='font:7.0pt "Times New Roman"'>
1983 </span><![endif]>Start running as a process.</p>
1984
1985 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <b>Import
1986 CIMHTTP Listener</b><o:p></o:p></span></p>
1987
1988 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p></span></p>
1989
1990 <div style='border:solid windowtext .5pt;padding:1.0pt 0in 1.0pt 31.0pt'>
1991
1992 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1993 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
1994 12.0pt;mso-bidi-font-size:10.0pt'>import
1995 org.snia.wbem.listener.CIMHTTPListener;<o:p></o:p></span></p>
1996 kumpf 1.1
1997 <p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;
1998 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:
1999 12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2000
2001 </div>
2002
2003 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
2004 style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2005
2006 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
2007 style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2008
2009 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
2010 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <b>Initialize and
2011 extend CIMHTTPListener<o:p></o:p></b></span></p>
2012
2013 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
2014 style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2015
2016 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2017 kumpf 1.1
2018 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2019 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2020 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2021 style="mso-spacerun: yes"> </span>CIMHTTPListener myCIML=null;<o:p></o:p></span></p>
2022
2023 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2024 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2025 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2026 style="mso-spacerun: yes"> </span>try <o:p></o:p></span></p>
2027
2028 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2029 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2030 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2031 style="mso-spacerun: yes"> </span><span style="mso-spacerun:
2032 yes"> </span>{<o:p></o:p></span></p>
2033
2034 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2035 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2036 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2037 style="mso-spacerun: yes"> </span>CIMHTTPListener ccl = new
2038 kumpf 1.1 CIMHTTPListener(listenerPortNo, isSSL) <o:p></o:p></span></p>
2039
2040 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2041 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2042 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2043 style='mso-tab-count:1'> </span><span style="mso-spacerun: yes">
2044 </span>{ <o:p></o:p></span></p>
2045
2046 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2047 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2048 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2049 style="mso-spacerun: yes"> </span>public void
2050 indicationOccured(CIMIndication e, String indURL) <o:p></o:p></span></p>
2051
2052 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2053 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2054 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2055 style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
2056
2057 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2058 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2059 kumpf 1.1 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2060 style="mso-spacerun: yes"> </span><i>handleIndication</i>(e.getIndication(),
2061 indURL);<o:p></o:p></span></p>
2062
2063 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2064 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2065 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2066 style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
2067
2068 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2069 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2070 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2071 style="mso-spacerun: yes"> </span>};<o:p></o:p></span></p>
2072
2073 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2074 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2075 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2076 style="mso-spacerun: yes"> </span>ccl.startCIMHTTPListener();<o:p></o:p></span></p>
2077
2078 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2079 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2080 kumpf 1.1 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2081
2082 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2083 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2084 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2085 style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
2086
2087 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2088 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2089 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2090 style="mso-spacerun: yes"> </span>catch (Exception e) {<o:p></o:p></span></p>
2091
2092 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2093 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2094 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2095 style="mso-spacerun: yes"> </span>System.out.println(e);<o:p></o:p></span></p>
2096
2097 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2098 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2099 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2100 style="mso-spacerun: yes"> </span>e.printStackTrace();<o:p></o:p></span></p>
2101 kumpf 1.1
2102 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2103 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2104 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2105 style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
2106
2107 </div>
2108
2109 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
2110 style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2111
2112 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
2113 style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2114
2115 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
2116 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <b>Indication
2117 Processor method<o:p></o:p></b></span></p>
2118
2119 <p class=MsoBodyText2 style='mso-layout-grid-align:none;text-autospace:none'>Once
2120 the indication is received you can have your own handleIndication method that
2121 can process the CIMInstance which is passed by the CIMListener. Here is an
2122 kumpf 1.1 example:</p>
2123
2124 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
2125 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2126
2127 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2128
2129 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2130 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2131 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2132 style="mso-spacerun: yes"> </span>void handleIndication(CIMInstance ind,
2133 String indURL) <o:p></o:p></span></p>
2134
2135 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2136 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2137 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2138 style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
2139
2140 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2141 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2142 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2143 kumpf 1.1 style="mso-spacerun: yes"> </span>System.out.println("----------
2144 Begin of event data ----------");<o:p></o:p></span></p>
2145
2146 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2147 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2148 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2149 style="mso-spacerun: yes"> </span>System.out.println("--- Indication
2150 URL : "+indURL);<o:p></o:p></span></p>
2151
2152 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2153 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2154 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2155 style="mso-spacerun: yes"> </span>System.out.println("--- Indication
2156 : "+ind.toString());<o:p></o:p></span></p>
2157
2158 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2159 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2160 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2161 style="mso-spacerun: yes"> </span>try <o:p></o:p></span></p>
2162
2163 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2164 kumpf 1.1 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2165 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2166 style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
2167
2168 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2169 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2170 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2171 style="mso-spacerun: yes"> </span>Object o=null;<o:p></o:p></span></p>
2172
2173 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2174 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2175 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2176 style="mso-spacerun: yes"> </span>if
2177 (ind.getClassName().startsWith("CIM_Class"))<o:p></o:p></span></p>
2178
2179 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2180 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2181 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2182 style="mso-spacerun: yes"> </span><span style="mso-spacerun:
2183 yes"> </span>o=(Object)ind.getProperty("classdefinition").getValue().getValue();<o:p></o:p></span></p>
2184
2185 kumpf 1.1 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2186 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2187 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2188 style="mso-spacerun: yes"> </span>if
2189 (ind.getClassName().startsWith("CIM_Inst"))<o:p></o:p></span></p>
2190
2191 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2192 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2193 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2194 style="mso-spacerun: yes"> </span>o=(Object)
2195 ind.getProperty("sourceinstance").getValue().getValue();<o:p></o:p></span></p>
2196
2197 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2198 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2199 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
2200
2201 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2202 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2203 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2204 style="mso-spacerun: yes"> </span>if (o instanceof CIMInstance) <o:p></o:p></span></p>
2205
2206 kumpf 1.1 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2207 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2208 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2209 style='mso-tab-count:1'> </span><span style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
2210
2211 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2212 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2213 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2214 style="mso-spacerun: yes"> </span><span style="mso-spacerun:
2215 yes"> </span>CIMInstance eo=(CIMInstance)o;<o:p></o:p></span></p>
2216
2217 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2218 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2219 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2220 style="mso-spacerun: yes"> </span>System.out.println("---
2221 Embedded Instance: "+eo);<o:p></o:p></span></p>
2222
2223 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2224 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2225 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2226 style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
2227 kumpf 1.1
2228 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2229 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2230 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2231 style="mso-spacerun: yes"> </span>else if (o instanceof CIMClass) {<o:p></o:p></span></p>
2232
2233 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2234 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2235 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2236 style="mso-spacerun: yes"> </span>CIMClass eo=(CIMClass)o;<o:p></o:p></span></p>
2237
2238 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2239 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2240 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2241 style="mso-spacerun: yes"> </span>System.out.println("---
2242 Embedded Class: "+eo);<o:p></o:p></span></p>
2243
2244 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2245 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2246 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2247 style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
2248 kumpf 1.1
2249 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2250 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2251 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2252 style="mso-spacerun: yes"> </span>System.out.println("-----------
2253 End of event data -----------\n");<o:p></o:p></span></p>
2254
2255 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2256 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2257 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2258 style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
2259
2260 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2261 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2262 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2263 style="mso-spacerun: yes"> </span>catch (Exception ee) <o:p></o:p></span></p>
2264
2265 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2266 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2267 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2268 style="mso-spacerun: yes"> </span>{<o:p></o:p></span></p>
2269 kumpf 1.1
2270 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2271 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2272 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2273 style="mso-spacerun: yes"> </span>ee.printStackTrace();<o:p></o:p></span></p>
2274
2275 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2276 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2277 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2278 style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
2279
2280 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;
2281 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2282 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2283 style="mso-spacerun: yes"> </span>}<o:p></o:p></span></p>
2284
2285 </div>
2286
2287 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
2288 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></b></p>
2289
2290 kumpf 1.1 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
2291 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>SSL Support with CIM
2292 Listener<o:p></o:p></span></b></p>
2293
2294 <p>The CIM Listener interface supports SSL for secure communication. The CIM
2295 Listener (a Server) can accept either http or https connections from the system
2296 delivering indications (an Indication Client). The Listener applications
2297 (Indication Consumers) using the CIM Listener API would require to have a
2298 server certificate and private key in order to support SSL enabled
2299 communication with the Indication clients. The Listener applications can write
2300 their own X509 Trust Manager where they can do additional validations like host
2301 name verification. However the CIM Listener API provides a default X509 Trust
2302 Manager that does not do any additional validations.</p>
2303
2304 <p>The CIM Listener running as server, does client authentication by requesting
2305 the Indication Client to send its certificate for authentication. Hence the
2306 Indication Client (e.g., CIM Server) trying to connect to the CIM Listener
2307 using https connection must have its own certificate. </p>
2308
2309 <p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
2310 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></b></p>
2311 kumpf 1.1
2312 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;
2313 tab-stops:list .5in'><![if !supportLists]><span style='font-family:"Courier New"'>9.<span
2314 style='font:7.0pt "Times New Roman"'> </span></span><![endif]>Troubleshooting
2315 and CIM Exceptions<span style='font-family:"Courier New"'><o:p></o:p></span></h2>
2316
2317 <p style='text-align:justify'>In addition to the standard CIM Exceptions sent
2318 by the CIM Server to the client, the CIM Client library generates the following
2319 exceptions. The exception generated by the client library along with the reason
2320 and solution is explained below:</p>
2321
2322 <p><b>Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED (Unable to Initialize
2323 Specified TrustManager: <a
2324 href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span
2325 style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</span></a>)<o:p></o:p></b></p>
2326
2327 <p style='text-align:justify'>Problem: </p>
2328
2329 <p style='margin-left:.5in;text-align:justify'>This exception indicates that
2330 the specified TrustManager may not exist, may contain invalid path, or it may
2331 not have required permission to load.</p>
2332 kumpf 1.1
2333 <p style='text-align:justify'>Solution: </p>
2334
2335 <p style='margin-left:.5in;text-align:justify'>Make sure that the TrustManager
2336 you have specified exist and has correct path and right permissions. Also make
2337 sure that the TrustManager is not set to “null”. </p>
2338
2339 <p><b>Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED(SSL Factory Initialization
2340 failed: <a href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span
2341 style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</span></a>)<o:p></o:p></b></p>
2342
2343 <p style='text-align:justify'>Problem: </p>
2344
2345 <p style='margin-left:.5in;text-align:justify'>This exception may happen in
2346 number different scenarios. Such as, unable to find JSSE providers, unable to
2347 generate random seed, unable to connect to correct server, server had problem
2348 with SSL handshake, or policy permissions are incorrect.</p>
2349
2350 <p style='text-align:justify'>Solution: </p>
2351
2352 <p style='margin-left:.5in;text-align:justify'>Follow JSSE specification and
2353 kumpf 1.1 make sure the system java configurations are setup correctly.</p>
2354
2355 <p style='text-align:justify'><b>Exception: CIMCLIENT_ERR_HTTP_ERROR(Couldn't
2356 find trusted certificate, response=500)<o:p></o:p></b></p>
2357
2358 <p style='text-align:justify'>Problem: </p>
2359
2360 <p style='margin-left:.5in;text-align:justify'>This exception may happen
2361 because of SSL handshake failure. SSL handshake may fail because the
2362 certificate sent by the server was an invalid certificate or the certificate is
2363 not in clients Trust store.</p>
2364
2365 <p style='text-align:justify'>Solution: </p>
2366
2367 <p style='margin-left:.5in;text-align:justify'>Either add this certificate to
2368 client Trust store or handle the certificate appropriately in the Certificate
2369 Manager.</p>
2370
2371 <p style='text-align:justify'><b>Exception: CIMCLIENT_ERR_TIMED_OUT (Request
2372 Timeout)<o:p></o:p></b></p>
2373
2374 kumpf 1.1 <p style='text-align:justify'>Problem: </p>
2375
2376 <p style='margin-left:.5in;text-align:justify'>This exception indicates that a
2377 timeout has occurred on a socket read. This could mean the server or provider
2378 may be slow in responding to client request, or the client time out is small.</p>
2379
2380 <p style='text-align:justify'>Solution: </p>
2381
2382 <p style='margin-left:.5in;text-align:justify'>Consider trying this operation
2383 at some other time or might want to set client timeout or increase the client
2384 timeout. Refer to CIMClient API java documentation for how to set client
2385 timeout.</p>
2386
2387 <p style='text-align:justify'><b>Exception:
2388 CIMCLIENT_ERR_CONNECTION_FAILED(Connection refused) <o:p></o:p></b></p>
2389
2390 <p style='text-align:justify'>Problem: </p>
2391
2392 <p style='margin-left:.5in;text-align:justify'>This exception indicates that an
2393 error occurred while attempting to connect to CIMServer on a port. The CIMServer
2394 may not be running on the specified address or it may not be listening on the
2395 kumpf 1.1 specified port.</p>
2396
2397 <p style='text-align:justify'>Solution: </p>
2398
2399 <p style='margin-left:.5in;text-align:justify'>Check to make sure that the
2400 server address is correct and the port number specified is the correct port
2401 number for an SSL or non-SSL communication. (e.g., This exception may be thrown
2402 if the CIMServer is SSL enabled and listening on port 5989, the client trying
2403 to connect to non-SSL port 5988.)</p>
2404
2405 <p style='text-align:justify'><b>Exception:
2406 CIMCLIENT_ERR_CONNECTION_FAILED(sequoia Unknown host) <o:p></o:p></b></p>
2407
2408 <p style='text-align:justify'>Problem: This exception indicates that the CIMServer
2409 address specified may contain an invalid system name or the system is not
2410 reachable.</p>
2411
2412 <p style='text-align:justify'>Solution:<span style="mso-spacerun: yes">
2413 </span>Make sure the specified CIMServer address is correct and the remote
2414 system is reachable.</p>
2415
2416 kumpf 1.1 <h2><span style='font-style:normal;mso-bidi-font-style:italic'> <o:p></o:p></span></h2>
2417
2418 <b style='mso-bidi-font-weight:normal'><i style='mso-bidi-font-style:normal'><span
2419 style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:Arial;mso-fareast-font-family:
2420 "Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:EN-US;
2421 mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
2422 </span></i></b>
2423
2424 <h2><span style='font-style:normal;mso-bidi-font-style:italic'>Appendix A: FAQ<o:p></o:p></span></h2>
2425
2426 <p style='text-align:justify'>The cimclient library performs the SSL handshaking
2427 and receives the certificate/key</p>
2428
2429 <p style='text-align:justify'><b>What environment settings must be in place for
2430 certificates to be passed?<o:p></o:p></b></p>
2431
2432 <p style='text-align:justify'>Clients must create a trust store, import
2433 certificates from the server they trust in to the trust store, provide the
2434 trust store path to the JSSE either on the command line ( java
2435 -Djavax.net.ssl.trustStore=mytruststore <MyClient><span
2436 style="mso-spacerun: yes"> </span>) or through</p>
2437 kumpf 1.1
2438 <p style='text-align:justify'>System.setProperty("javax.net.trustStore",
2439 "mytruststore");</p>
2440
2441 <p style='text-align:justify'><b>Does the cimclient library accept the
2442 certificate and place it in the trust store?<span style="mso-spacerun: yes">
2443 </span>How would the application specify to the cimclient library where the
2444 trust store is<o:p></o:p></b></p>
2445
2446 <p style='text-align:justify'>Client library using JSSE will only validate the
2447 server certificate using the trust store. It accepts only trusted certificates
2448 from the server. In case of non-trusted certificate the client library will
2449 call the trust manager if there is one specified. It is the job of trust
2450 manager to either accept the server certificate (possibly add that to the trust
2451 store) or reject the certificate.</p>
2452
2453 <p style='text-align:justify'><b>How is the client application notified that the
2454 certificate or key was placed in the trust store?<span style="mso-spacerun:
2455 yes"> </span>Is this assumed?<o:p></o:p></b></p>
2456
2457 <p style='text-align:justify'>Same as above</p>
2458 kumpf 1.1
2459 <p style='text-align:justify'><b>Can the client application set the environment
2460 so that certificates or keys are required from some target systems but other
2461 target systems are not validated or authenticated?<o:p></o:p></b></p>
2462
2463 <p style='text-align:justify'>Yes, trust manager can do this.</p>
2464
2465 <p style='text-align:justify'><b>Where can I find more information on Trust
2466 Manager and Trust Stores?<o:p></o:p></b></p>
2467
2468 <p style='text-align:justify'>More information can be found at J2SE web
2469 site.<span style="mso-spacerun: yes"> </span>- ----</p>
2470
2471 <p style='text-align:justify'><span style='mso-bidi-font-family:"Courier New"'>http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html<o:p></o:p></span></p>
2472
2473 <p style='text-align:justify'>http://java.sun.com/j2se/1.4/docs/api/javax/net/ssl/X509TrustManager.html
2474 </p>
2475
2476 <p style='text-align:justify'><b>I am unable use/initialize SSL connection,
2477 what do I do?<o:p></o:p></b></p>
2478
2479 kumpf 1.1 <p style='text-align:justify'><span style='mso-bidi-font-family:"Courier New"'>Some
2480 applications have their own version of Java included in it and they use the
2481 included Java, not the one you installed on the systems (such as the one from
2482 /opt/java). In such cases make sure that java security configuration files are
2483 not modified.</span></p>
2484
2485 <p style='text-align:justify'><b>How can I find out cimclient.jar version ?<o:p></o:p></b></p>
2486
2487 <pre><span style="mso-spacerun: yes"> </span>1. Extract MANIFEST file</pre><pre><span style="mso-spacerun: yes"> </span>jar xf cimclient.jar META-INF/MANIFEST.MF</pre><pre><![if !supportEmptyParas]> <![endif]><o:p></o:p></pre><pre> 2. You can then look at MANIFEST file to fin</pre><pre><span style="mso-spacerun: yes"> </span>a] type META-INF/MANIFEST.MF</pre><pre><span style="mso-spacerun: yes"> </span>or</pre><pre><span style="mso-spacerun: yes"> </span>b] grep "Name:" META-INF/MANIFEST.MF</pre><pre><span style="mso-spacerun: yes"> </span></pre>
2488
2489 <p style='text-align:justify'><b>My GUI application doesn’t work properly on HP-UX?</b></p>
2490
2491 <p style='text-align:justify'>There is a bug in Java 1.4 HP-UX version (and
2492 1.3) AWT libraries. For this you will need to install PHSS_24303 patch. I also
2493 found that Patch PHSS_24303 replaced by PHSS_26262. So we will need PHSS_26262.</p>
2494
2495 <p style='text-align:justify'> </p>
2496
2497 <h2><span style='font-style:normal;mso-bidi-font-style:italic'>Appendix E:
2498 Example cim.properties configuration file<o:p></o:p></span></h2>
2499
2500 kumpf 1.1 <p class=MsoNormal> </p>
2501
2502 <div style='border:solid windowtext .5pt;padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2503
2504 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2505 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2506 "Courier New"'><span style="mso-spacerun: yes"> </span>// <o:p></o:p></span></p>
2507
2508 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2509 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2510 "Courier New"'><span style="mso-spacerun: yes"> </span>// Example
2511 cim.properties<o:p></o:p></span></p>
2512
2513 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2514 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2515 "Courier New"'><span style="mso-spacerun: yes"> </span>//<o:p></o:p></span></p>
2516
2517 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2518 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2519 "Courier New"'><span style="mso-spacerun: yes"> </span>DEBUG_XML=false <o:p></o:p></span></p>
2520
2521 kumpf 1.1 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2522 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2523 "Courier New"'><span style="mso-spacerun: yes"> </span>DEBUG_XMLDECODE=false<o:p></o:p></span></p>
2524
2525 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2526 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2527 "Courier New"'><span style="mso-spacerun: yes"> </span>clientLogFilePath=cimclient.txt<o:p></o:p></span></p>
2528
2529 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2530 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2531 "Courier New"'> <o:p></o:p></span></p>
2532
2533 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2534 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2535 "Courier New"'><span style="mso-spacerun: yes"> </span>// CIM Clients may
2536 specify their own Trust Manager to use <o:p></o:p></span></p>
2537
2538 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2539 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2540 "Courier New"'><span style="mso-spacerun: yes"> </span>// instead of the
2541 default JSSE TrustManager.<o:p></o:p></span></p>
2542 kumpf 1.1
2543 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
2544 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2545 "Courier New"'><span style="mso-spacerun: yes">
2546 </span>TrustManager=org.mycompany.myapp.MyCertificateManager<o:p></o:p></span></p>
2547
2548 </div>
2549
2550 <p class=MsoNormal><span style='font-family:"Courier New"'> <o:p></o:p></span></p>
2551
2552 </div>
2553
2554 </body>
2555
2556 </html>
|
Return to
ReleaseNotes.htm
CVS log
Up to [Pegasus] / pegasus-JavaCIMClient / docs