(file) Return to ReleaseNotes.htm CVS log (file) (dir) Up to [Pegasus] / pegasus-JavaCIMClient / docs

   1 kumpf 1.2 <html xmlns:v="urn:schemas-microsoft-com:vml"
   2           xmlns:o="urn:schemas-microsoft-com:office:office"
   3 kumpf 1.1 xmlns:w="urn:schemas-microsoft-com:office:word"
   4 kumpf 1.3 xmlns:st1="urn:schemas-microsoft-com:office:smarttags"
   5 kumpf 1.1 xmlns="http://www.w3.org/TR/REC-html40">
   6           
   7           <head>
   8           <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
   9           <meta name=ProgId content=Word.Document>
  10 kumpf 1.3 <meta name=Generator content="Microsoft Word 10">
  11           <meta name=Originator content="Microsoft Word 10">
  12           <link rel=File-List href="ReleaseNotes_files/filelist.xml">
  13 kumpf 1.1 <title>WBEM Java Client Release Notes</title>
  14 kumpf 1.3 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  15            name="City"/>
  16           <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  17            name="State"/>
  18           <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  19            name="place"/>
  20 kumpf 1.1 <!--[if gte mso 9]><xml>
  21            <o:DocumentProperties>
  22             <o:Subject>WBEM Java Client Release Notes </o:Subject>
  23             <o:Author>Bapu Patil</o:Author>
  24             <o:Template>normal</o:Template>
  25 kumpf 1.3   <o:LastAuthor>bapugoud</o:LastAuthor>
  26             <o:Revision>4</o:Revision>
  27             <o:TotalTime>1876</o:TotalTime>
  28 kumpf 1.2   <o:LastPrinted>2003-05-14T19:27:00Z</o:LastPrinted>
  29             <o:Created>2003-11-19T23:06:00Z</o:Created>
  30 kumpf 1.3   <o:LastSaved>2004-04-15T17:06:00Z</o:LastSaved>
  31             <o:Pages>1</o:Pages>
  32             <o:Words>5843</o:Words>
  33             <o:Characters>33307</o:Characters>
  34             <o:Company>Company</o:Company>
  35             <o:Lines>277</o:Lines>
  36             <o:Paragraphs>78</o:Paragraphs>
  37             <o:CharactersWithSpaces>39072</o:CharactersWithSpaces>
  38             <o:Version>10.4219</o:Version>
  39 kumpf 1.1  </o:DocumentProperties>
  40           </xml><![endif]--><!--[if gte mso 9]><xml>
  41            <w:WordDocument>
  42 kumpf 1.3   <w:Zoom>75</w:Zoom>
  43             <w:SpellingState>Clean</w:SpellingState>
  44             <w:GrammarState>Clean</w:GrammarState>
  45 kumpf 1.1   <w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>
  46             <w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>
  47             <w:UseMarginsForDrawingGridOrigin/>
  48             <w:Compatibility>
  49              <w:FootnoteLayoutLikeWW8/>
  50              <w:ShapeLayoutLikeWW8/>
  51              <w:AlignTablesRowByRow/>
  52              <w:ForgetLastTabAlignment/>
  53              <w:LayoutRawTableWidth/>
  54              <w:LayoutTableRowsApart/>
  55             </w:Compatibility>
  56 kumpf 1.3   <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
  57 kumpf 1.1  </w:WordDocument>
  58 kumpf 1.3 </xml><![endif]--><!--[if !mso]><object
  59            classid="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D" id=ieooui></object>
  60           <style>
  61           st1\:*{behavior:url(#ieooui) }
  62           </style>
  63           <![endif]-->
  64 kumpf 1.1 <style>
  65           <!--
  66            /* Font Definitions */
  67 kumpf 1.3  @font-face
  68 kumpf 1.1 	{font-family:"Futura Bk";
  69           	panose-1:0 0 0 0 0 0 0 0 0 0;
  70           	mso-font-alt:"Times New Roman";
  71           	mso-font-charset:0;
  72           	mso-generic-font-family:roman;
  73           	mso-font-format:other;
  74           	mso-font-pitch:auto;
  75           	mso-font-signature:0 0 0 0 0 0;}
  76           @font-face
  77           	{font-family:"Comic Sans MS";
  78           	panose-1:3 15 7 2 3 3 2 2 2 4;
  79           	mso-font-charset:0;
  80           	mso-generic-font-family:script;
  81           	mso-font-pitch:variable;
  82           	mso-font-signature:647 0 0 0 159 0;}
  83            /* Style Definitions */
  84 kumpf 1.3  p.MsoNormal, li.MsoNormal, div.MsoNormal
  85 kumpf 1.1 	{mso-style-parent:"";
  86           	margin:0in;
  87           	margin-bottom:.0001pt;
  88           	mso-pagination:widow-orphan;
  89           	font-size:10.0pt;
  90           	font-family:"Times New Roman";
  91           	mso-fareast-font-family:"Times New Roman";}
  92           h1
  93           	{mso-style-next:Normal;
  94           	margin-top:12.0pt;
  95           	margin-right:0in;
  96           	margin-bottom:3.0pt;
  97           	margin-left:0in;
  98           	mso-pagination:widow-orphan;
  99           	mso-outline-level:1;
 100           	font-size:14.0pt;
 101           	mso-bidi-font-size:10.0pt;
 102           	font-family:Arial;
 103           	mso-font-kerning:14.0pt;
 104           	font-weight:bold;
 105           	mso-bidi-font-weight:normal;}
 106 kumpf 1.1 h2
 107           	{mso-style-next:Normal;
 108           	margin-top:12.0pt;
 109           	margin-right:0in;
 110           	margin-bottom:3.0pt;
 111           	margin-left:0in;
 112           	mso-pagination:widow-orphan;
 113           	mso-outline-level:2;
 114           	font-size:12.0pt;
 115           	mso-bidi-font-size:10.0pt;
 116           	font-family:Arial;
 117           	font-weight:bold;
 118           	mso-bidi-font-weight:normal;
 119           	font-style:italic;
 120           	mso-bidi-font-style:normal;}
 121           h3
 122           	{mso-style-next:Normal;
 123           	margin-top:12.0pt;
 124           	margin-right:0in;
 125           	margin-bottom:3.0pt;
 126           	margin-left:0in;
 127 kumpf 1.1 	mso-pagination:widow-orphan;
 128           	mso-outline-level:3;
 129           	font-size:12.0pt;
 130           	mso-bidi-font-size:10.0pt;
 131           	font-family:Arial;
 132           	font-weight:normal;}
 133           h4
 134           	{mso-style-next:Normal;
 135           	margin:0in;
 136           	margin-bottom:.0001pt;
 137           	mso-pagination:widow-orphan;
 138           	mso-outline-level:4;
 139           	font-size:12.0pt;
 140           	mso-bidi-font-size:10.0pt;
 141           	font-family:"Times New Roman";
 142           	font-weight:bold;}
 143           h5
 144           	{mso-style-next:Normal;
 145           	margin:0in;
 146           	margin-bottom:.0001pt;
 147           	mso-pagination:widow-orphan;
 148 kumpf 1.1 	mso-outline-level:5;
 149           	font-size:14.0pt;
 150           	mso-bidi-font-size:10.0pt;
 151           	font-family:"Times New Roman";
 152           	font-weight:normal;}
 153 kumpf 1.2 h6
 154           	{mso-style-next:Normal;
 155           	margin:0in;
 156           	margin-bottom:.0001pt;
 157           	mso-pagination:widow-orphan;
 158           	page-break-after:avoid;
 159           	mso-outline-level:6;
 160           	tab-stops:.5in;
 161           	mso-layout-grid-align:none;
 162           	text-autospace:none;
 163           	font-size:10.0pt;
 164           	font-family:"Courier New";
 165           	font-weight:bold;}
 166 kumpf 1.1 p.MsoNormalIndent, li.MsoNormalIndent, div.MsoNormalIndent
 167           	{margin-top:0in;
 168           	margin-right:0in;
 169           	margin-bottom:0in;
 170           	margin-left:.5in;
 171           	margin-bottom:.0001pt;
 172           	mso-pagination:widow-orphan;
 173           	font-size:10.0pt;
 174           	font-family:"Times New Roman";
 175           	mso-fareast-font-family:"Times New Roman";}
 176           p.MsoList2, li.MsoList2, div.MsoList2
 177           	{margin-top:0in;
 178           	margin-right:0in;
 179           	margin-bottom:0in;
 180           	margin-left:.5in;
 181           	margin-bottom:.0001pt;
 182           	text-indent:-.25in;
 183           	mso-pagination:widow-orphan;
 184           	font-size:10.0pt;
 185           	font-family:"Times New Roman";
 186           	mso-fareast-font-family:"Times New Roman";}
 187 kumpf 1.1 p.MsoListBullet2, li.MsoListBullet2, div.MsoListBullet2
 188           	{mso-style-update:auto;
 189           	margin-top:0in;
 190           	margin-right:0in;
 191           	margin-bottom:0in;
 192           	margin-left:.5in;
 193           	margin-bottom:.0001pt;
 194           	text-indent:-.25in;
 195           	mso-pagination:widow-orphan;
 196 kumpf 1.2 	mso-list:l0 level1 lfo3;
 197 kumpf 1.1 	tab-stops:list .5in;
 198           	font-size:10.0pt;
 199           	font-family:"Times New Roman";
 200           	mso-fareast-font-family:"Times New Roman";}
 201           p.MsoSignature, li.MsoSignature, div.MsoSignature
 202           	{margin-top:0in;
 203           	margin-right:0in;
 204           	margin-bottom:0in;
 205           	margin-left:3.0in;
 206           	margin-bottom:.0001pt;
 207           	mso-pagination:widow-orphan;
 208           	font-size:10.0pt;
 209           	font-family:"Times New Roman";
 210           	mso-fareast-font-family:"Times New Roman";}
 211           p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
 212           	{margin:0in;
 213           	margin-bottom:.0001pt;
 214           	mso-pagination:widow-orphan;
 215           	mso-layout-grid-align:none;
 216           	font-size:10.0pt;
 217           	font-family:"Comic Sans MS";
 218 kumpf 1.1 	mso-fareast-font-family:"Times New Roman";
 219           	mso-bidi-font-family:"Times New Roman";
 220           	font-weight:bold;}
 221           p.MsoBodyTextIndent, li.MsoBodyTextIndent, div.MsoBodyTextIndent
 222           	{margin-top:0in;
 223           	margin-right:0in;
 224           	margin-bottom:6.0pt;
 225           	margin-left:.25in;
 226           	mso-pagination:widow-orphan;
 227           	font-size:10.0pt;
 228           	font-family:"Times New Roman";
 229           	mso-fareast-font-family:"Times New Roman";}
 230           p.MsoListContinue2, li.MsoListContinue2, div.MsoListContinue2
 231           	{margin-top:0in;
 232           	margin-right:0in;
 233           	margin-bottom:6.0pt;
 234           	margin-left:.5in;
 235           	mso-pagination:widow-orphan;
 236           	font-size:10.0pt;
 237           	font-family:"Times New Roman";
 238           	mso-fareast-font-family:"Times New Roman";}
 239 kumpf 1.1 p.MsoBodyText2, li.MsoBodyText2, div.MsoBodyText2
 240           	{margin:0in;
 241           	margin-bottom:.0001pt;
 242           	mso-pagination:widow-orphan;
 243           	font-size:12.0pt;
 244           	mso-bidi-font-size:10.0pt;
 245           	font-family:"Times New Roman";
 246           	mso-fareast-font-family:"Times New Roman";}
 247           a:link, span.MsoHyperlink
 248           	{color:blue;
 249           	text-decoration:underline;
 250           	text-underline:single;}
 251           a:visited, span.MsoHyperlinkFollowed
 252           	{color:purple;
 253           	text-decoration:underline;
 254           	text-underline:single;}
 255           p
 256 kumpf 1.3 	{mso-margin-top-alt:auto;
 257           	margin-right:0in;
 258 kumpf 1.1 	mso-margin-bottom-alt:auto;
 259           	margin-left:0in;
 260           	mso-pagination:widow-orphan;
 261           	font-size:12.0pt;
 262           	font-family:"Times New Roman";
 263           	mso-fareast-font-family:"Times New Roman";}
 264 kumpf 1.2 code
 265 kumpf 1.3 	{font-family:"Courier New";
 266           	mso-ascii-font-family:"Courier New";
 267 kumpf 1.2 	mso-fareast-font-family:"Courier New";
 268           	mso-hansi-font-family:"Courier New";
 269           	mso-bidi-font-family:"Courier New";}
 270 kumpf 1.1 pre
 271           	{margin:0in;
 272           	margin-bottom:.0001pt;
 273           	mso-pagination:widow-orphan;
 274           	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;
 275           	font-size:10.0pt;
 276           	font-family:"Courier New";
 277           	mso-fareast-font-family:"Courier New";}
 278           tt
 279 kumpf 1.3 	{font-family:"Courier New";
 280           	mso-ascii-font-family:"Courier New";
 281 kumpf 1.1 	mso-fareast-font-family:"Courier New";
 282           	mso-hansi-font-family:"Courier New";
 283           	mso-bidi-font-family:"Courier New";}
 284           p.CcList, li.CcList, div.CcList
 285           	{mso-style-name:"Cc List";
 286           	margin:0in;
 287           	margin-bottom:.0001pt;
 288           	mso-pagination:widow-orphan;
 289           	font-size:10.0pt;
 290           	font-family:"Times New Roman";
 291           	mso-fareast-font-family:"Times New Roman";}
 292           p.ShortReturnAddress, li.ShortReturnAddress, div.ShortReturnAddress
 293           	{mso-style-name:"Short Return Address";
 294           	margin:0in;
 295           	margin-bottom:.0001pt;
 296           	mso-pagination:widow-orphan;
 297           	font-size:10.0pt;
 298           	font-family:"Times New Roman";
 299           	mso-fareast-font-family:"Times New Roman";}
 300           p.PPLine, li.PPLine, div.PPLine
 301           	{mso-style-name:"PP Line";
 302 kumpf 1.1 	mso-style-parent:Signature;
 303           	margin-top:0in;
 304           	margin-right:0in;
 305           	margin-bottom:0in;
 306           	margin-left:3.0in;
 307           	margin-bottom:.0001pt;
 308           	mso-pagination:widow-orphan;
 309           	font-size:10.0pt;
 310           	font-family:"Times New Roman";
 311           	mso-fareast-font-family:"Times New Roman";}
 312           p.InsideAddressName, li.InsideAddressName, div.InsideAddressName
 313           	{mso-style-name:"Inside Address Name";
 314           	margin:0in;
 315           	margin-bottom:.0001pt;
 316           	mso-pagination:widow-orphan;
 317           	font-size:10.0pt;
 318           	font-family:"Times New Roman";
 319           	mso-fareast-font-family:"Times New Roman";}
 320 kumpf 1.3 span.SpellE
 321           	{mso-style-name:"";
 322           	mso-spl-e:yes;}
 323           span.GramE
 324           	{mso-style-name:"";
 325           	mso-gram-e:yes;}
 326 kumpf 1.1 @page Section1
 327           	{size:8.5in 11.0in;
 328           	margin:1.0in 1.25in 1.0in 1.25in;
 329           	mso-header-margin:.5in;
 330           	mso-footer-margin:.5in;
 331           	mso-paper-source:0;}
 332           div.Section1
 333           	{page:Section1;}
 334            /* List Definitions */
 335 kumpf 1.3  @list l0
 336 kumpf 1.1 	{mso-list-id:-125;
 337           	mso-list-type:simple;
 338           	mso-list-template-ids:-218198392;}
 339           @list l0:level1
 340           	{mso-level-number-format:bullet;
 341           	mso-level-style-link:"List Bullet 2";
 342           	mso-level-text:\F0B7;
 343           	mso-level-tab-stop:.5in;
 344           	mso-level-number-position:left;
 345           	text-indent:-.25in;
 346           	font-family:Symbol;}
 347           @list l1
 348           	{mso-list-id:247084106;
 349           	mso-list-type:hybrid;
 350           	mso-list-template-ids:1643154800 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
 351           @list l1:level1
 352           	{mso-level-tab-stop:.5in;
 353           	mso-level-number-position:left;
 354           	text-indent:-.25in;}
 355 kumpf 1.2 @list l1:level2
 356           	{mso-level-tab-stop:1.0in;
 357           	mso-level-number-position:left;
 358           	text-indent:-.25in;}
 359           @list l1:level3
 360           	{mso-level-tab-stop:1.5in;
 361           	mso-level-number-position:left;
 362           	text-indent:-.25in;}
 363           @list l1:level4
 364           	{mso-level-tab-stop:2.0in;
 365           	mso-level-number-position:left;
 366           	text-indent:-.25in;}
 367           @list l1:level5
 368           	{mso-level-tab-stop:2.5in;
 369           	mso-level-number-position:left;
 370           	text-indent:-.25in;}
 371           @list l1:level6
 372           	{mso-level-tab-stop:3.0in;
 373           	mso-level-number-position:left;
 374           	text-indent:-.25in;}
 375           @list l1:level7
 376 kumpf 1.2 	{mso-level-tab-stop:3.5in;
 377           	mso-level-number-position:left;
 378           	text-indent:-.25in;}
 379           @list l1:level8
 380           	{mso-level-tab-stop:4.0in;
 381           	mso-level-number-position:left;
 382           	text-indent:-.25in;}
 383           @list l1:level9
 384           	{mso-level-tab-stop:4.5in;
 385           	mso-level-number-position:left;
 386           	text-indent:-.25in;}
 387 kumpf 1.1 @list l2
 388           	{mso-list-id:252513578;
 389           	mso-list-type:hybrid;
 390           	mso-list-template-ids:811916116 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
 391           @list l2:level1
 392           	{mso-level-tab-stop:.5in;
 393           	mso-level-number-position:left;
 394           	text-indent:-.25in;}
 395 kumpf 1.2 @list l2:level2
 396           	{mso-level-tab-stop:1.0in;
 397           	mso-level-number-position:left;
 398           	text-indent:-.25in;}
 399           @list l2:level3
 400           	{mso-level-tab-stop:1.5in;
 401           	mso-level-number-position:left;
 402           	text-indent:-.25in;}
 403           @list l2:level4
 404           	{mso-level-tab-stop:2.0in;
 405           	mso-level-number-position:left;
 406           	text-indent:-.25in;}
 407           @list l2:level5
 408           	{mso-level-tab-stop:2.5in;
 409           	mso-level-number-position:left;
 410           	text-indent:-.25in;}
 411           @list l2:level6
 412           	{mso-level-tab-stop:3.0in;
 413           	mso-level-number-position:left;
 414           	text-indent:-.25in;}
 415           @list l2:level7
 416 kumpf 1.2 	{mso-level-tab-stop:3.5in;
 417           	mso-level-number-position:left;
 418           	text-indent:-.25in;}
 419           @list l2:level8
 420           	{mso-level-tab-stop:4.0in;
 421           	mso-level-number-position:left;
 422           	text-indent:-.25in;}
 423           @list l2:level9
 424           	{mso-level-tab-stop:4.5in;
 425           	mso-level-number-position:left;
 426           	text-indent:-.25in;}
 427 kumpf 1.1 @list l3
 428           	{mso-list-id:524485251;
 429           	mso-list-type:hybrid;
 430           	mso-list-template-ids:-175104624 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
 431           @list l3:level1
 432           	{mso-level-number-format:bullet;
 433           	mso-level-text:\F0B7;
 434           	mso-level-tab-stop:.5in;
 435           	mso-level-number-position:left;
 436           	text-indent:-.25in;
 437           	font-family:Symbol;}
 438 kumpf 1.2 @list l3:level2
 439           	{mso-level-tab-stop:1.0in;
 440           	mso-level-number-position:left;
 441           	text-indent:-.25in;}
 442           @list l3:level3
 443           	{mso-level-tab-stop:1.5in;
 444           	mso-level-number-position:left;
 445           	text-indent:-.25in;}
 446           @list l3:level4
 447           	{mso-level-tab-stop:2.0in;
 448           	mso-level-number-position:left;
 449           	text-indent:-.25in;}
 450           @list l3:level5
 451           	{mso-level-tab-stop:2.5in;
 452           	mso-level-number-position:left;
 453           	text-indent:-.25in;}
 454           @list l3:level6
 455           	{mso-level-tab-stop:3.0in;
 456 kumpf 1.1 	mso-level-number-position:left;
 457 kumpf 1.2 	text-indent:-.25in;}
 458           @list l3:level7
 459           	{mso-level-tab-stop:3.5in;
 460 kumpf 1.1 	mso-level-number-position:left;
 461           	text-indent:-.25in;}
 462 kumpf 1.2 @list l3:level8
 463           	{mso-level-tab-stop:4.0in;
 464 kumpf 1.1 	mso-level-number-position:left;
 465           	text-indent:-.25in;}
 466 kumpf 1.2 @list l3:level9
 467           	{mso-level-tab-stop:4.5in;
 468 kumpf 1.1 	mso-level-number-position:left;
 469           	text-indent:-.25in;}
 470 kumpf 1.2 @list l4
 471 kumpf 1.3 	{mso-list-id:856769335;
 472           	mso-list-template-ids:-958241750;}
 473           @list l4:level1
 474           	{mso-level-number-format:bullet;
 475           	mso-level-text:\F0B7;
 476           	mso-level-tab-stop:.5in;
 477           	mso-level-number-position:left;
 478           	text-indent:-.25in;
 479           	mso-ansi-font-size:10.0pt;
 480           	font-family:Symbol;}
 481           @list l5
 482           	{mso-list-id:1052342615;
 483           	mso-list-template-ids:-1504563160;}
 484           @list l5:level1
 485           	{mso-level-number-format:bullet;
 486           	mso-level-text:\F0B7;
 487           	mso-level-tab-stop:.5in;
 488           	mso-level-number-position:left;
 489           	text-indent:-.25in;
 490           	mso-ansi-font-size:10.0pt;
 491           	font-family:Symbol;}
 492 kumpf 1.3 @list l6
 493 kumpf 1.1 	{mso-list-id:1505632988;
 494           	mso-list-type:hybrid;
 495           	mso-list-template-ids:904969346 1896489038 -1021140422 616970556 753855378 -307702454 337287590 -362651142 1385077412 129915254;}
 496 kumpf 1.3 @list l6:level1
 497 kumpf 1.1 	{mso-level-number-format:bullet;
 498           	mso-level-text:\F0B7;
 499           	mso-level-tab-stop:.5in;
 500           	mso-level-number-position:left;
 501           	text-indent:-.25in;
 502           	mso-ansi-font-size:10.0pt;
 503           	font-family:Symbol;}
 504 kumpf 1.3 @list l6:level2
 505 kumpf 1.1 	{mso-level-tab-stop:1.0in;
 506           	mso-level-number-position:left;
 507           	text-indent:-.25in;}
 508 kumpf 1.3 @list l6:level3
 509 kumpf 1.1 	{mso-level-tab-stop:1.5in;
 510           	mso-level-number-position:left;
 511           	text-indent:-.25in;}
 512 kumpf 1.3 @list l6:level4
 513 kumpf 1.1 	{mso-level-tab-stop:2.0in;
 514           	mso-level-number-position:left;
 515           	text-indent:-.25in;}
 516 kumpf 1.3 @list l6:level5
 517 kumpf 1.1 	{mso-level-tab-stop:2.5in;
 518           	mso-level-number-position:left;
 519           	text-indent:-.25in;}
 520 kumpf 1.3 @list l6:level6
 521 kumpf 1.1 	{mso-level-tab-stop:3.0in;
 522           	mso-level-number-position:left;
 523           	text-indent:-.25in;}
 524 kumpf 1.3 @list l6:level7
 525 kumpf 1.1 	{mso-level-tab-stop:3.5in;
 526           	mso-level-number-position:left;
 527           	text-indent:-.25in;}
 528 kumpf 1.3 @list l6:level8
 529 kumpf 1.1 	{mso-level-tab-stop:4.0in;
 530           	mso-level-number-position:left;
 531           	text-indent:-.25in;}
 532 kumpf 1.3 @list l6:level9
 533 kumpf 1.1 	{mso-level-tab-stop:4.5in;
 534           	mso-level-number-position:left;
 535           	text-indent:-.25in;}
 536 kumpf 1.3 @list l7
 537           	{mso-list-id:1816099078;
 538           	mso-list-template-ids:1218716582;}
 539           @list l7:level1
 540           	{mso-level-number-format:bullet;
 541           	mso-level-text:\F0B7;
 542           	mso-level-tab-stop:.5in;
 543           	mso-level-number-position:left;
 544           	text-indent:-.25in;
 545           	mso-ansi-font-size:10.0pt;
 546           	font-family:Symbol;}
 547           @list l8
 548           	{mso-list-id:1842894525;
 549           	mso-list-template-ids:-1532178110;}
 550           @list l8:level1
 551           	{mso-level-number-format:bullet;
 552           	mso-level-text:\F0B7;
 553           	mso-level-tab-stop:.5in;
 554           	mso-level-number-position:left;
 555           	text-indent:-.25in;
 556           	mso-ansi-font-size:10.0pt;
 557 kumpf 1.3 	font-family:Symbol;}
 558           @list l9
 559 kumpf 1.1 	{mso-list-id:2007662374;
 560           	mso-list-type:hybrid;
 561           	mso-list-template-ids:1413667294 -1837347444 1447836560 -2085591486 1525986426 420924086 1411915016 220890626 1754024258 -168013522;}
 562 kumpf 1.3 @list l9:level1
 563 kumpf 1.1 	{mso-level-number-format:bullet;
 564           	mso-level-text:\F0B7;
 565           	mso-level-tab-stop:.5in;
 566           	mso-level-number-position:left;
 567           	text-indent:-.25in;
 568           	mso-ansi-font-size:10.0pt;
 569           	font-family:Symbol;}
 570 kumpf 1.3 @list l9:level2
 571 kumpf 1.1 	{mso-level-tab-stop:1.0in;
 572           	mso-level-number-position:left;
 573           	text-indent:-.25in;}
 574 kumpf 1.3 @list l9:level3
 575 kumpf 1.1 	{mso-level-tab-stop:1.5in;
 576           	mso-level-number-position:left;
 577           	text-indent:-.25in;}
 578 kumpf 1.3 @list l9:level4
 579 kumpf 1.1 	{mso-level-tab-stop:2.0in;
 580           	mso-level-number-position:left;
 581           	text-indent:-.25in;}
 582 kumpf 1.3 @list l9:level5
 583 kumpf 1.1 	{mso-level-tab-stop:2.5in;
 584           	mso-level-number-position:left;
 585           	text-indent:-.25in;}
 586 kumpf 1.3 @list l9:level6
 587 kumpf 1.1 	{mso-level-tab-stop:3.0in;
 588           	mso-level-number-position:left;
 589           	text-indent:-.25in;}
 590 kumpf 1.3 @list l9:level7
 591 kumpf 1.1 	{mso-level-tab-stop:3.5in;
 592           	mso-level-number-position:left;
 593           	text-indent:-.25in;}
 594 kumpf 1.3 @list l9:level8
 595 kumpf 1.1 	{mso-level-tab-stop:4.0in;
 596           	mso-level-number-position:left;
 597           	text-indent:-.25in;}
 598 kumpf 1.3 @list l9:level9
 599 kumpf 1.1 	{mso-level-tab-stop:4.5in;
 600           	mso-level-number-position:left;
 601           	text-indent:-.25in;}
 602           ol
 603           	{margin-bottom:0in;}
 604           ul
 605           	{margin-bottom:0in;}
 606           -->
 607           </style>
 608 kumpf 1.3 <!--[if gte mso 10]>
 609           <style>
 610            /* Style Definitions */
 611            table.MsoNormalTable
 612           	{mso-style-name:"Table Normal";
 613           	mso-tstyle-rowband-size:0;
 614           	mso-tstyle-colband-size:0;
 615           	mso-style-noshow:yes;
 616           	mso-style-parent:"";
 617           	mso-padding-alt:0in 5.4pt 0in 5.4pt;
 618           	mso-para-margin:0in;
 619           	mso-para-margin-bottom:.0001pt;
 620           	mso-pagination:widow-orphan;
 621           	font-size:10.0pt;
 622           	font-family:"Times New Roman";}
 623           </style>
 624           <![endif]--><!--[if gte mso 9]><xml>
 625            <o:shapedefaults v:ext="edit" spidmax="4098"/>
 626 kumpf 1.2 </xml><![endif]--><!--[if gte mso 9]><xml>
 627            <o:shapelayout v:ext="edit">
 628             <o:idmap v:ext="edit" data="1"/>
 629            </o:shapelayout></xml><![endif]-->
 630 kumpf 1.1 </head>
 631           
 632           <body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
 633           
 634           <div class=Section1>
 635           
 636 kumpf 1.3 <h1 align=center style='text-align:center'>WBEM </h1>
 637 kumpf 1.1 
 638 mateus.baur 1.5 <h1 align=center style='text-align:center'>Java Client SDK Version 2.5.1 </h1>
 639 kumpf       1.1 
 640 kumpf       1.3 <h1 align=center style='text-align:center'><span
 641                 style='mso-spacerun:yes'> </span>Release Notes</h1>
 642 kumpf       1.1 
 643 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
 644 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:
 645                 Arial;font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>1.<span
 646                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
 647                 style='font-style:normal;mso-bidi-font-style:italic'>Overview<o:p></o:p></span></h2>
 648 kumpf       1.1 
 649                 <p style='margin-right:.4in;text-align:justify'>The WBEM Java Client SDK is a
 650                 set of APIs that contain the components necessary to write management
 651 kumpf       1.2 applications that communicate with WBEM-enabled management devices using XML
 652                 and HTTP communication standards. </p>
 653 kumpf       1.1 
 654                 <p style='margin-right:.4in;text-align:justify'>WBEM applications request
 655                 information or services from the Common Information Model (CIM) Object Manager
 656                 through the WBEM APIs. These APIs represent CIM objects as Java classes. These
 657                 APIs can be used to describe managed objects and retrieve information about
 658                 managed objects on a system. </p>
 659                 
 660                 <p style='margin-right:.4in;text-align:justify'>WBEM client applications use
 661 kumpf       1.3 the <span class=SpellE><tt><span style='font-size:10.0pt'>org.snia.wbem.client</span></tt></span>
 662 kumpf       1.1 APIs to manipulate CIM objects. A client application uses the CIM API to
 663                 construct an object (for example, a class, instance, or namespace) and then
 664                 initializes, or instantiates that object. The application uses the client APIs
 665                 to pass the object to the CIM Object Manager (CIMOM) and request an operation,
 666                 such as creating a CIM class, instance, or deleting an instance.</p>
 667                 
 668 kumpf       1.3 <p style='margin-right:.4in;text-align:justify'>CIM Listener (<span
 669                 class=SpellE>org.snia.wbem.listener</span>) provides interfaces to process
 670                 CIM/XML Indications.</p>
 671                 
 672                 <p style='margin-right:.4in;text-align:justify'>The <span class=SpellE>javadoc</span>
 673                 documentation includes the following packages that the client applications
 674                 require to make CIM operation requests to a CIM Object Manager. </p>
 675                 
 676                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
 677                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
 678                 class=SpellE>org.snia.wbem.client</span></p>
 679                 
 680                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
 681                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
 682                 class=SpellE>org.snia.wbem.cim</span></p>
 683                 
 684                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
 685                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
 686                 class=SpellE>org.snia.wbemcfg</span></p>
 687 kumpf       1.1 
 688 kumpf       1.3 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
 689                 .5in;text-align:justify'><span class=SpellE>org.snia.wbem.listener</span></p>
 690 kumpf       1.1 
 691 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
 692 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:
 693                 Arial;font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>2.<span
 694                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
 695                 style='font-style:normal;mso-bidi-font-style:italic'>Requirements<o:p></o:p></span></h2>
 696 kumpf       1.1 
 697                 <p class=MsoNormal><span style='font-family:"Courier New"'>&nbsp;<o:p></o:p></span></p>
 698                 
 699                 <ul style='margin-top:0in' type=disc>
 700 kumpf       1.3  <li class=MsoNormal style='mso-list:l9 level1 lfo8;tab-stops:list .5in'><span
 701                      style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The apache <span
 702                      class=SpellE>xerces</span> XML parser 1.4.4. <o:p></o:p></span></li>
 703 kumpf       1.1 </ul>
 704                 
 705                 <p class=MsoNormal style='text-indent:.5in'><span style='font-size:12.0pt;
 706 kumpf       1.3 mso-bidi-font-size:10.0pt'>You must use <span class=SpellE>Xerces</span> 1.4.4
 707                 version. It can be downloaded from<o:p></o:p></span></p>
 708 kumpf       1.1 
 709                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
 710 kumpf       1.3 style='mso-spacerun:yes'>      </span><span style='mso-tab-count:1'>      </span><a
 711 kumpf       1.1 href="http://xml.apache.org/dist/xerces-j/">http://xml.apache.org/dist/xerces-j/</a><o:p></o:p></span></p>
 712                 
 713                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 714                 
 715                 <ul style='margin-top:0in' type=disc>
 716 kumpf       1.3  <li class=MsoNormal style='mso-list:l6 level1 lfo11;tab-stops:list .5in'><span
 717 kumpf       1.1      style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Java 1.4 version ( JRE
 718                      1.4 )</span> <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p></o:p></span></li>
 719                 </ul>
 720                 
 721                 <p class=MsoNormal style='margin-left:.5in'><span style='font-size:12.0pt;
 722                 mso-bidi-font-size:10.0pt'>Java 1.4 version is used because it includes JSSE
 723 kumpf       1.3 (for SSL). Note JSEE is not part of earlier versions of Java. <span
 724                 style='mso-spacerun:yes'> </span>For HP-UX, you may download Java 1.4 from http://www.hp.com/go/java/.<o:p></o:p></span></p>
 725 kumpf       1.1 
 726                 <p class=MsoNormal style='margin-left:.25in'><span style='font-size:12.0pt;
 727                 mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 728                 
 729                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
 730                 Java CLASSPATH must include the following:<o:p></o:p></span></p>
 731                 
 732                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 733                 
 734 kumpf       1.3 <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<span
 735                 class=GramE>:.</span><o:p></o:p></span></p>
 736 kumpf       1.1 
 737                 <p class=MsoNormal><span style='font-family:"Courier New"'>&nbsp;<o:p></o:p></span></p>
 738                 
 739 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
 740 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:
 741                 Arial;font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>1.<span
 742                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
 743 mateus.baur 1.5 style='font-style:normal;mso-bidi-font-style:italic'>What's new in 2.5.1 Release?<o:p></o:p></span></h2>
 744 kumpf       1.1 
 745 mateus.baur 1.4 <p class=MsoBodyText2>
 746                 Several defects have been fixed. For further information, please, see the following Bugzillas: 
 747                 <ol>
 748                 <li>
 749 mateus.baur 1.5 <a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=3967">Bugzilla #3967 - Java Client should honor the "useHTTP11=false"</a>
 750 mateus.baur 1.4 </li>
 751                 <li>
 752 mateus.baur 1.5 <a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4147">Bugzilla #4147 - Java Client is sometimes causing HTTP errors</a>
 753 mateus.baur 1.4 </li>
 754                 <li>
 755 mateus.baur 1.5 <a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4258">Bugzilla #4258 - setTimeout is failing on Java Client API</a>
 756 mateus.baur 1.4 </li>
 757                 <li>
 758 mateus.baur 1.5 <a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4259">Bugzilla #4259 - NullPointerException is being generated in Java indication listener</a>
 759 mateus.baur 1.4 </li>
 760 mateus.baur 1.6 <li>
 761                 <a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4375">Bugzilla #4375 - Java CIMDateTime String constructor overflow microseconds into minutes</a>
 762                 </li>
 763 mateus.baur 1.4 </ol>
 764                 </p>
 765 kumpf       1.2 
 766 kumpf       1.3 <p class=MsoBodyText2><o:p>&nbsp;</o:p></p>
 767 kumpf       1.2 
 768                 <p style='margin:0in;margin-bottom:.0001pt'><span style='mso-bidi-font-size:
 769 kumpf       1.3 10.0pt'><o:p>&nbsp;</o:p></span></p>
 770 kumpf       1.1 
 771                 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
 772 kumpf       1.2 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:
 773 kumpf       1.3 list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;
 774                 font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>2.<span
 775                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
 776                 style='font-style:normal;mso-bidi-font-style:italic'>Writing WBEM Clients<o:p></o:p></span></h2>
 777 kumpf       1.1 
 778                 <p class=MsoNormal>&nbsp;</p>
 779                 
 780                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 781 kumpf       1.3 mso-bidi-font-size:10.0pt'>WBEM client applications use the </span><span
 782                 class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
 783                 font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>org.snia.wbem.client</span></tt></span><span
 784 kumpf       1.1 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> APIs to manipulate CIM
 785 kumpf       1.3 objects on the CIM Object Manager. A client application uses classes in </span><span
 786                 class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
 787                 font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>org.snia.wbem.cim</span></tt></span><tt><span
 788                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";
 789                 mso-bidi-font-family:"Courier New"'> package </span></tt><span
 790 kumpf       1.1 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>to construct an object (for
 791                 example, a class, instance, or namespace) and initializes that object. Then
 792                 uses the client APIs to pass the object to the CIMOM and request a CIM
 793                 operation, such as creating a CIM class, instance, or namespace.<o:p></o:p></span></p>
 794                 
 795                 <p>Client applications typically follow this sequence:</p>
 796                 
 797                 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>1.<span
 798 kumpf       1.3 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Connect to the
 799                 CIMOM using <span class=SpellE><tt><span style='font-size:10.0pt'>CIMClient</span></tt></span>.
 800 kumpf       1.1 A client application connects to the CIMOM before performing a CIM operation,
 801                 such as creating a CIM class or updating a CIM instance. </p>
 802                 
 803                 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>2.<span
 804                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Use the client
 805                 APIs to request CIM operations. Most of the client programs perform tasks such
 806                 as creating, deleting and modifying classes and instances; enumerating
 807                 instances; invoking provider methods; and handling errors and exceptions. </p>
 808                 
 809                 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>3.<span
 810                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Close the client
 811 kumpf       1.3 connection to the CIM Object Manager using <span class=SpellE><tt><span
 812                 style='font-size:10.0pt'>CIMClient</span></tt></span>, to free the server
 813                 resources used by the client session. </p>
 814 kumpf       1.1 
 815                 <p class=MsoNormal>&nbsp;</p>
 816                 
 817                 <h3><b>Opening a Client Connection<o:p></o:p></b></h3>
 818                 
 819                 <p class=MsoNormal>&nbsp;</p>
 820                 
 821                 <p class=MsoBodyText2>Client applications typically import the required CIM
 822                 classes and create CIM objects and then open client connection.<span
 823 kumpf       1.3 style='mso-spacerun:yes'>  </span>Some of the common imports and CIM object creations
 824                 are show below.</p>
 825 kumpf       1.1 
 826                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 827                 
 828 kumpf       1.3 <div style='margin-left:.5in'>
 829 kumpf       1.1 
 830 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
 831                 padding:1.0pt 0in 1.0pt 31.0pt'>
 832                 
 833                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 834                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 835                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 836                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.client.CIMClient</span>;<o:p></o:p></span></p>
 837                 
 838                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 839                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 840                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 841                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.cim.CIMNameSpace</span>;<o:p></o:p></span></p>
 842                 
 843                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 844                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 845                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 846                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.cim.CIMObjectPath</span>;<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 0in 1.0pt 31.0pt'><span class=GramE><span
 850                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 851 kumpf       1.3 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.cim.CIMClass</span>;<o:p></o:p></span></p>
 852                 
 853                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 854                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 855                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 856                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.cim.CIMProperty</span>;<o:p></o:p></span></p>
 857                 
 858                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 859                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 860                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 861                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.cim.CIMInstance</span>;<o:p></o:p></span></p>
 862                 
 863                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 864                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 865                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 866                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.cim.CIMValue</span>;<o:p></o:p></span></p>
 867                 
 868                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 869                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 870                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 871                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.cim.CIMQualifierType</span>;<o:p></o:p></span></p>
 872 kumpf       1.3 
 873                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 874                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 875                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 876                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.cim.CIMException</span>;<o:p></o:p></span></p>
 877                 
 878                 </div>
 879 kumpf       1.1 
 880                 </div>
 881                 
 882                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 883                 
 884                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 885                 
 886 kumpf       1.3 <div style='margin-left:.5in'>
 887                 
 888                 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
 889                 padding:1.0pt 4.0pt 1.0pt 31.0pt'>
 890 kumpf       1.1 
 891 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 892                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span class=SpellE><span
 893                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIMNameSpace</span></span><span
 894                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>clientNameSpace</span>
 895                 = null;<o:p></o:p></span></p>
 896 kumpf       1.1 
 897 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 898                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span class=SpellE><span
 899                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIMClient</span></span><span
 900                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> cc = null;<o:p></o:p></span></p>
 901 kumpf       1.1 
 902 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 903 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
 904                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 905                 
 906 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 907                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span class=SpellE><span
 908                 class=GramE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>int</span></span></span><span
 909                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>portNo</span>
 910                 = <span class=SpellE>CIMNameSpace.DEFAULT_PORT</span>;<o:p></o:p></span></p>
 911                 
 912                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 913 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
 914 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'>String <span class=SpellE>nameSpace</span> =
 915                 &quot;root/cimv2&quot;;<span style='mso-spacerun:yes'>  </span><span
 916                 style='mso-spacerun:yes'>      </span>// namespace<o:p></o:p></span></p>
 917 kumpf       1.1 
 918 kumpf       1.3 </div>
 919 kumpf       1.1 
 920                 </div>
 921                 
 922                 <p class=MsoNormal>&nbsp;</p>
 923                 
 924                 <p class=MsoNormal><span style='font-family:"Courier New"'>&nbsp;<o:p></o:p></span></p>
 925                 
 926                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 927 kumpf       1.3 mso-bidi-font-size:10.0pt'>To open a client connection, you use the </span><span
 928                 class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
 929                 font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>CIMClient</span></tt></span><span
 930 kumpf       1.1 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class to connect to the CIM
 931                 Object Manager. You must specify the required type of connection (HTTP or
 932 kumpf       1.3 HTTPS) in the <span class=SpellE>CIMNameSpace</span> constructor. If connection
 933                 type is not specified the HTTP is used as the default. You must also specify
 934                 the user name and password for the connection to the specified CIM server.<o:p></o:p></span></p>
 935 kumpf       1.1 
 936                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 937                 mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 938                 
 939                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 940                 mso-bidi-font-size:10.0pt'>Example HTTP connection:<o:p></o:p></span></p>
 941                 
 942                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 943                 mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 944                 
 945 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
 946                 padding:1.0pt 4.0pt 1.0pt 0in'>
 947 kumpf       1.1 
 948                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 949                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 950                 mso-bidi-font-size:10.0pt;mso-bidi-font-weight:bold;mso-bidi-font-style:italic'><span
 951 kumpf       1.3 style='mso-spacerun:yes'>          </span></span><span style='font-size:12.0pt;
 952                 mso-bidi-font-size:10.0pt'>String <span class=SpellE>hostURL</span> = &quot;<b>http</b>://&quot;
 953                 + hostname + &quot;:&quot; + <span class=SpellE>portNo</span>;<o:p></o:p></span></p>
 954 kumpf       1.1 
 955                 <p style='margin:0in;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
 956                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='mso-bidi-font-size:
 957 kumpf       1.3 10.0pt'><span style='mso-spacerun:yes'>          </span><span class=GramE>try</span>
 958                 <o:p></o:p></span></p>
 959 kumpf       1.1 
 960                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 961                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 962 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
 963 kumpf       1.1 
 964                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 965                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 966 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           </span><span
 967                 style='mso-spacerun:yes'>   </span><span class=SpellE><span class=GramE>clientNameSpace</span></span>
 968                 = new <span class=SpellE>CIMNameSpace</span>(<span class=SpellE>hostURL</span>,
 969                 <span class=SpellE>nameSpace</span>);<o:p></o:p></span></p>
 970 kumpf       1.1 
 971                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 972                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 973 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>             
 974                 </span>cc = new <span class=SpellE><span class=GramE>CIMClient</span></span><span
 975                 class=GramE>(</span><span class=SpellE>clientNameSpace</span>,
 976                 &quot;guest&quot;, &quot;guest&quot;, <span class=SpellE>CIMClient.HTTP</span>);<o:p></o:p></span></p>
 977 kumpf       1.1 
 978                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 979                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 980 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>} <o:p></o:p></span></p>
 981 kumpf       1.1 
 982                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 983                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 984 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
 985                 class=GramE>catch</span> (<span class=SpellE>CIMException</span> e) <o:p></o:p></span></p>
 986 kumpf       1.1 
 987                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 988                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 989 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
 990 kumpf       1.1 
 991                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 992                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 993 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>            </span><span
 994                 class=SpellE><span class=GramE>System.err.println</span></span><span
 995                 class=GramE>(</span>&quot;Failed to access CIMOM: &quot; + e);<o:p></o:p></span></p>
 996 kumpf       1.1 
 997                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 998                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 999 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>}<o:p></o:p></span></p>
1000 kumpf       1.1 
1001                 </div>
1002                 
1003                 <p class=MsoNormal>&nbsp;</p>
1004                 
1005                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1006                 
1007                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Example
1008                 HTTPS connection:<o:p></o:p></span></p>
1009                 
1010                 <p class=MsoNormal>&nbsp;</p>
1011                 
1012 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1013                 padding:1.0pt 4.0pt 1.0pt 0in'>
1014 kumpf       1.1 
1015                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1016                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1017                 mso-bidi-font-size:10.0pt;mso-bidi-font-weight:bold;mso-bidi-font-style:italic'><span
1018 kumpf       1.3 style='mso-spacerun:yes'>          </span></span><span style='font-size:12.0pt;
1019                 mso-bidi-font-size:10.0pt'>String <span class=SpellE>hostURL</span> = &quot;<b>https</b>://&quot;
1020                 + hostname + &quot;:&quot; + <span class=SpellE>portNo</span>;<o:p></o:p></span></p>
1021 kumpf       1.1 
1022                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1023                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1024 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
1025                 class=GramE>try</span> <o:p></o:p></span></p>
1026 kumpf       1.1 
1027                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1028                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1029 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
1030 kumpf       1.1 
1031                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1032                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1033 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>              </span><span
1034                 class=SpellE><span class=GramE>clientNameSpace</span></span> = new <span
1035                 class=SpellE>CIMNameSpace</span>(<span class=SpellE>hostURL</span>, <span
1036                 class=SpellE>nameSpace</span>);<o:p></o:p></span></p>
1037 kumpf       1.1 
1038                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1039                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1040 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>             
1041                 </span>cc = new <span class=SpellE><span class=GramE>CIMClient</span></span><span
1042                 class=GramE>(</span><span class=SpellE>clientNameSpace</span>,
1043                 &quot;guest&quot;, &quot;guest&quot;, <span class=SpellE>CIMClient.HTTP</span>);<o:p></o:p></span></p>
1044 kumpf       1.1 
1045                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1046                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1047 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>} <o:p></o:p></span></p>
1048 kumpf       1.1 
1049                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1050                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1051 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
1052                 class=GramE>catch</span> (<span class=SpellE>CIMException</span> e) <o:p></o:p></span></p>
1053 kumpf       1.1 
1054                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1055                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1056 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
1057 kumpf       1.1 
1058                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1059                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1060 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>            </span><span
1061                 class=SpellE><span class=GramE>System.err.println</span></span><span
1062                 class=GramE>(</span>&quot;Failed to access CIMOM: &quot; + e);<o:p></o:p></span></p>
1063 kumpf       1.1 
1064                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1065                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1066 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>}<o:p></o:p></span></p>
1067 kumpf       1.1 
1068                 </div>
1069                 
1070                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1071                 
1072                 <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:Arial;
1073                 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
1074                 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1075                 </span>
1076                 
1077                 <h3><b>Performing CIM Operations <o:p></o:p></b></h3>
1078                 
1079                 <p class=MsoNormal>&nbsp;</p>
1080                 
1081                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
1082 kumpf       1.3 following examples show how to do CIM operations using <span class=SpellE>org.snia.wbem.client</span>
1083                 APIs.<o:p></o:p></span></p>
1084 kumpf       1.1 
1085                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1086                 
1087                 <h4>&nbsp;</h4>
1088                 
1089                 <h4>Enumerating classes</h4>
1090                 
1091                 <p class=MsoNormal>&nbsp;</p>
1092                 
1093                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
1094 kumpf       1.3 following example shows how to do <span class=SpellE><i>enumerateClasses</i></span><i>
1095                 </i>of <span class=SpellE><i>CIM_ComputerSystem</i></span><o:p></o:p></span></p>
1096 kumpf       1.1 
1097                 <p class=MsoNormal>&nbsp;</p>
1098                 
1099 kumpf       1.3 <div style='margin-left:.5in'>
1100 kumpf       1.1 
1101 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1102                 padding:1.0pt 4.0pt 1.0pt 31.0pt'>
1103                 
1104                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1105 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1106 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     </span><span
1107                 class=GramE>try</span><o:p></o:p></span></p>
1108 kumpf       1.1 
1109 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1110 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1111 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1112 kumpf       1.1 </span>{<o:p></o:p></span></p>
1113                 
1114 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1115 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1116 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1117                 </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
1118                 class=GramE>(</span>&quot;\n*** Enumerate classes - No DEEP&quot;);<o:p></o:p></span></p>
1119 kumpf       1.1 
1120 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1121 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1122 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1123                 </span><span class=SpellE>CIMObjectPath</span> path = new <span class=SpellE><span
1124                 class=GramE>CIMObjectPath</span></span><span class=GramE>(</span>&quot;<span
1125                 class=SpellE>CIM_ComputerSystem</span>&quot;);<o:p></o:p></span></p>
1126 kumpf       1.1 
1127 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1128 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1129                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1130                 
1131 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1132 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1133 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1134                 </span>Boolean <span class=SpellE>deepInheritance</span> = false;<o:p></o:p></span></p>
1135 kumpf       1.1 
1136 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1137 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1138 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1139                 </span>Boolean <span class=SpellE>localOnly</span> = true;<o:p></o:p></span></p>
1140 kumpf       1.1 
1141 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1142 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1143 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1144                 </span>Boolean <span class=SpellE>includeQualifiers</span> = true;<o:p></o:p></span></p>
1145 kumpf       1.1 
1146 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1147 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1148 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1149                 </span>Boolean <span class=SpellE>includeClassOrigin</span> = true;<o:p></o:p></span></p>
1150 kumpf       1.1 
1151 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1152 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1153                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1154                 
1155 kumpf       1.3 <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 31.0pt'><span style='font-size:
1157 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>  </span><span
1158                 style='mso-spacerun:yes'>          </span>Enumeration en = <span class=SpellE><span
1159                 class=GramE>cc.enumerateClasses</span></span><span class=GramE>(</span>path, <span
1160                 class=SpellE>deepInheritance</span>,<o:p></o:p></span></p>
1161 kumpf       1.1 
1162 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1163 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1164 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1165                 style='mso-spacerun:yes'>                                               
1166                 </span><span class=SpellE><span class=GramE>localOnly</span></span>, <span
1167                 class=SpellE>includeQualifiers</span>,<o:p></o:p></span></p>
1168 kumpf       1.1 
1169 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1170 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1171 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1172                 style='mso-spacerun:yes'>                                               
1173                 </span><span class=SpellE><span class=GramE>includeClassOrigin</span></span>);<o:p></o:p></span></p>
1174 kumpf       1.1 
1175 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1176 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1177 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1178                 </span><span class=GramE>if</span> (en != null)<o:p></o:p></span></p>
1179 kumpf       1.1 
1180 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1181 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1182 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          
1183                 </span><span style='mso-spacerun:yes'> </span>{<o:p></o:p></span></p>
1184 kumpf       1.1 
1185 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1186 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1187 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1188                 style='mso-spacerun:yes'>                </span><span class=GramE>while</span>
1189                 ( <span class=SpellE>en.hasMoreElements</span>() )<o:p></o:p></span></p>
1190 kumpf       1.1 
1191 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1192 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1193 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1194                 style='mso-spacerun:yes'>                </span>{<o:p></o:p></span></p>
1195 kumpf       1.1 
1196 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1197 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1198 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1199                 style='mso-spacerun:yes'>                    </span><span class=SpellE>CIMClass</span>
1200                 <span class=SpellE>cimclass</span> = (<span class=SpellE>CIMClass</span>) <span
1201                 class=SpellE><span class=GramE>en.nextElement</span></span><span class=GramE>(</span>);<o:p></o:p></span></p>
1202 kumpf       1.1 
1203 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1204 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1205 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1206                 style='mso-spacerun:yes'>                    </span><span class=SpellE><span
1207                 class=GramE>System.out.println</span></span><span class=GramE>(</span>&quot;Class
1208                 name: &quot; + <span class=SpellE>cimclass.getName</span>());<o:p></o:p></span></p>
1209 kumpf       1.1 
1210 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1211 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1212 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1213                 style='mso-spacerun:yes'>                </span>}<o:p></o:p></span></p>
1214 kumpf       1.1 
1215 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1216 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1217 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1218 kumpf       1.1 </span>}<o:p></o:p></span></p>
1219                 
1220 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1221 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1222 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1223 kumpf       1.1 </span>}<o:p></o:p></span></p>
1224                 
1225 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1226 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1227 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1228                 </span><span class=GramE>catch</span> (<span class=SpellE>CIMException</span> <span
1229                 class=SpellE>ce</span>)<o:p></o:p></span></p>
1230 kumpf       1.1 
1231 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1232 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1233 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1234 kumpf       1.1 </span>{<o:p></o:p></span></p>
1235                 
1236 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1237 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1238 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1239                 </span><span class=SpellE><span class=GramE>System.err.println</span></span><span
1240                 class=GramE>(</span>&quot;Failed to enumerate classes: &quot; + <span
1241                 class=SpellE>ce</span>);<o:p></o:p></span></p>
1242 kumpf       1.1 
1243 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1244 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1245 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1246 kumpf       1.1 </span>}<o:p></o:p></span></p>
1247                 
1248                 </div>
1249                 
1250 kumpf       1.3 </div>
1251                 
1252 kumpf       1.1 <p class=MsoNormal style='margin-left:.5in'><span style='font-size:12.0pt;
1253                 mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1254                 
1255                 <h4>&nbsp;</h4>
1256                 
1257 kumpf       1.2 <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";
1258 kumpf       1.1 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
1259                 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1260 kumpf       1.2 </span>
1261 kumpf       1.1 
1262 kumpf       1.3 <h4><span class=SpellE>InvokeMethod</span> Operation</h4>
1263 kumpf       1.1 
1264                 <p class=MsoNormal>&nbsp;</p>
1265                 
1266                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
1267 kumpf       1.3 following example shows how to do <span class=SpellE><i>invokeMethod</i></span><i>
1268                 </i>on a <span class=SpellE><i>Sample_MethodProvider</i></span><i>.</i><o:p></o:p></span></p>
1269 kumpf       1.1 
1270                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1271                 
1272 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1273                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
1274 kumpf       1.1 
1275                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1276                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1277 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     </span>//
1278                 NOTE: The following test requires the <span class=SpellE>Sample_MethodProviderClass</span><o:p></o:p></span></p>
1279 kumpf       1.1 
1280                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1281                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1282 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     </span>//
1283                 and a sample method provider for <span class=SpellE>Sample_MethodProviderClass</span>.<o:p></o:p></span></p>
1284 kumpf       1.1 
1285                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1286                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1287 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     </span>//<o:p></o:p></span></p>
1288 kumpf       1.1 
1289                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1290                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1291 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1292                 </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
1293                 class=GramE>(</span>&quot;\n*** Invoke Method.&quot;);<o:p></o:p></span></p>
1294 kumpf       1.1 
1295                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1296                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1297 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1298                 </span>String <span class=SpellE>testNameSpace</span> = &quot;root/<span
1299                 class=SpellE>SampleProvider</span>&quot;;<o:p></o:p></span></p>
1300 kumpf       1.1 
1301                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1302                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1303 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1304                 </span>String <span class=SpellE>testClassName</span> = &quot;<span
1305                 class=SpellE>Sample_MethodProviderClass</span>&quot;;<o:p></o:p></span></p>
1306 kumpf       1.1 
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 4.0pt'><span style='font-size:
1309 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1310                 </span>String <span class=SpellE>methodName</span> = &quot;<span class=SpellE>SayHello</span>&quot;;<o:p></o:p></span></p>
1311 kumpf       1.1 
1312                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1313                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1314 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1315                 </span>String <span class=SpellE>inParamValue</span> = &quot;Yoda&quot;;<o:p></o:p></span></p>
1316 kumpf       1.1 
1317                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1318                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1319 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1320                 </span>String <span class=SpellE>goodReply</span> = &quot;Hello<span
1321                 class=GramE>, &quot;</span> + <span class=SpellE>inParamValue</span> +
1322                 &quot;!&quot;;<o:p></o:p></span></p>
1323 kumpf       1.1 
1324                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1325                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1326 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1327                 </span>String <span class=SpellE>goodParam</span> = &quot;From <span
1328                 class=SpellE>Neverland</span>&quot;;<o:p></o:p></span></p>
1329 kumpf       1.1 
1330                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1331                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1332                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1333                 
1334                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1335                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1336 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1337                 </span><span class=SpellE>CIMObjectPath</span> <span class=SpellE>currentPath</span>;<o:p></o:p></span></p>
1338 kumpf       1.1 
1339                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1340                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1341 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1342                 </span>Vector <span class=SpellE>inParams</span> = new <span class=GramE>Vector(</span>);<o:p></o:p></span></p>
1343 kumpf       1.1 
1344                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1345                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1346 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1347                 </span>Vector <span class=SpellE>outParams</span> = new <span class=GramE>Vector(</span>);<o:p></o:p></span></p>
1348 kumpf       1.1 
1349                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1350                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1351 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1352                 </span><span class=SpellE>CIMValue</span> <span class=SpellE>retValue</span>;<o:p></o:p></span></p>
1353 kumpf       1.1 
1354                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1355                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1356                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1357                 
1358                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1359                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1360 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1361                 </span><span class=GramE>try</span><o:p></o:p></span></p>
1362 kumpf       1.1 
1363                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1364                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1365 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1366 kumpf       1.1 </span>{<o:p></o:p></span></p>
1367                 
1368                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1369                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1370 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1371                 </span>// construct <span class=SpellE>CIMObjectPath</span><o:p></o:p></span></p>
1372 kumpf       1.1 
1373                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1374                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1375 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1376 kumpf       1.1 </span>//<o:p></o:p></span></p>
1377                 
1378                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1379                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1380 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1381                 </span><span class=SpellE><span class=GramE>currentPath</span></span> = new <span
1382                 class=SpellE>CIMObjectPath</span>(<span class=SpellE>testClassName</span>);<o:p></o:p></span></p>
1383 kumpf       1.1 
1384                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1385                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1386                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1387                 
1388                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1389                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1390 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1391 kumpf       1.1 </span>// set the namespace<o:p></o:p></span></p>
1392                 
1393                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1394                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1395 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1396 kumpf       1.1 </span>//<o:p></o:p></span></p>
1397                 
1398                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1399                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1400 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1401                 </span><span class=SpellE><span class=GramE>currentPath.setNameSpace</span></span><span
1402                 class=GramE>(</span><span class=SpellE>testNameSpace</span>);<o:p></o:p></span></p>
1403 kumpf       1.1 
1404                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1405                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1406                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1407                 
1408                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1409                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1410 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1411 kumpf       1.1 </span>// create parameter vectors<o:p></o:p></span></p>
1412                 
1413                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1414                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1415 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1416 kumpf       1.1 </span>//<o:p></o:p></span></p>
1417                 
1418                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1419                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1420 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1421                 </span><span class=SpellE><span class=GramE>inParams.addElement</span></span><span
1422                 class=GramE>(</span> new <span class=SpellE>CIMProperty</span>(&quot;dummy&quot;,<o:p></o:p></span></p>
1423 kumpf       1.1 
1424                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1425                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1426 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1427                 </span><span style='mso-tab-count:2'>                </span><span class=GramE>new</span>
1428                 <span class=SpellE>CIMValue</span>(<span class=SpellE>inParamValue</span>, <span
1429                 class=SpellE>CIMDataType.getPredefinedType</span>(<o:p></o:p></span></p>
1430 kumpf       1.1 
1431                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1432                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1433 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1434                 style='mso-spacerun:yes'>                                </span><span
1435                 class=SpellE>CIMDataType.STRING</span>))));<o:p></o:p></span></p>
1436 kumpf       1.1 
1437                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1438                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1439                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1440                 
1441                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1442                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1443 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1444                 </span>// call <span class=SpellE>invokeMethod</span><o:p></o:p></span></p>
1445 kumpf       1.1 
1446                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1447                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1448 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1449 kumpf       1.1 </span>//<o:p></o:p></span></p>
1450                 
1451                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1452                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1453 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1454                 </span><span class=SpellE><span class=GramE>retValue</span></span><span
1455                 class=GramE>=</span><span class=SpellE>cc.invokeMethod</span>(<span
1456                 class=SpellE>currentPath</span>, <span class=SpellE>methodName</span>, <span
1457                 class=SpellE>inParams</span>,<o:p></o:p></span></p>
1458 kumpf       1.1 
1459                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1460                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1461 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1462                 style='mso-spacerun:yes'>                                     </span><span
1463                 class=SpellE><span class=GramE>outParams</span></span>);<o:p></o:p></span></p>
1464 kumpf       1.1 
1465                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1466                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1467 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1468                 </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
1469                 class=GramE>(</span>&quot;<span class=SpellE>InvokeMethod</span> response =
1470                 &quot; + <span class=SpellE>retValue.toString</span>());<o:p></o:p></span></p>
1471 kumpf       1.1 
1472                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1473                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1474 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1475 kumpf       1.1 </span>}<o:p></o:p></span></p>
1476                 
1477                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1478                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1479 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1480                 </span><span class=GramE>catch</span> (<span class=SpellE>CIMException</span> <span
1481                 class=SpellE>ce</span>)<o:p></o:p></span></p>
1482 kumpf       1.1 
1483                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1484                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1485 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1486 kumpf       1.1 </span>{<o:p></o:p></span></p>
1487                 
1488                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1489                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1490 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>            
1491                 </span><span class=SpellE><span class=GramE>System.err.println</span></span><span
1492                 class=GramE>(</span>&quot;<span class=SpellE>invokeMethod</span> Failed: &quot;
1493                 + <span class=SpellE>ce</span>);<o:p></o:p></span></p>
1494 kumpf       1.1 
1495                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1496 kumpf       1.3 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span
1497                 style='mso-spacerun:yes'>        </span>}<span style='mso-spacerun:yes'>  
1498                 </span></p>
1499 kumpf       1.1 
1500                 </div>
1501                 
1502                 <h3><b>&nbsp;<o:p></o:p></b></h3>
1503                 
1504                 <h3><b>Closing Client Connection<o:p></o:p></b></h3>
1505                 
1506                 <p class=MsoNormal><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></b></p>
1507                 
1508 kumpf       1.3 <p class=MsoBodyText2>Clients may close the connection by calling the <span
1509                 class=SpellE><span class=GramE>CIMClient.close</span></span><span class=GramE>(</span>)
1510                 method. Client connection will also be closed when the <span class=SpellE>CIMClient</span>
1511                 object goes out of scope. </p>
1512 kumpf       1.1 
1513                 <p class=MsoNormal>&nbsp;</p>
1514                 
1515 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1516                 padding:1.0pt 4.0pt 1.0pt 0in'>
1517 kumpf       1.1 
1518                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1519                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1520 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
1521                 class=GramE>try</span><o:p></o:p></span></p>
1522 kumpf       1.1 
1523                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1524                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1525 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>{<o:p></o:p></span></p>
1526 kumpf       1.1 
1527                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1528                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1529 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>                   
1530                 </span><span class=GramE>if(</span> cc != null ) <o:p></o:p></span></p>
1531 kumpf       1.1 
1532                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1533                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1534 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>                   
1535 kumpf       1.1 </span>{<o:p></o:p></span></p>
1536                 
1537                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1538                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1539 kumpf       1.3 mso-bidi-font-size:10.0pt'><span
1540                 style='mso-spacerun:yes'>                              </span><span
1541                 class=SpellE><span class=GramE>cc.close</span></span><span class=GramE>(</span>);<o:p></o:p></span></p>
1542 kumpf       1.1 
1543                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1544                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1545 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>                   
1546 kumpf       1.1 </span>}<o:p></o:p></span></p>
1547                 
1548                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1549                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1550 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>}<o:p></o:p></span></p>
1551 kumpf       1.1 
1552                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1553                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1554 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
1555                 class=GramE>catch</span> (<span class=SpellE>CIMException</span> <span
1556                 class=SpellE>ce</span>)<o:p></o:p></span></p>
1557 kumpf       1.1 
1558                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1559                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1560 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>{<o:p></o:p></span></p>
1561 kumpf       1.1 
1562                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1563                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1564 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>                   
1565                 </span><span class=SpellE><span class=GramE>System.err.println</span></span><span
1566                 class=GramE>(</span>&quot;Failed to close connection: &quot; + <span
1567                 class=SpellE>ce</span>);<o:p></o:p></span></p>
1568 kumpf       1.1 
1569                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1570                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1571 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>}<o:p></o:p></span></p>
1572 kumpf       1.1 
1573                 </div>
1574                 
1575                 <p class=MsoNormal><b style='mso-bidi-font-weight:normal'><i style='mso-bidi-font-style:
1576 kumpf       1.3 normal'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></i></b></p>
1577 kumpf       1.2 
1578                 <h3><b>Java CIM Client Local connection<o:p></o:p></b></h3>
1579                 
1580                 <p class=MsoBodyText2>This version support supports Local connection in Java
1581                 CIM Client interface. I.E. Java CIM Clients that wish to do local connection to
1582 kumpf       1.3 <span class=SpellE>CIMServer</span> can now use this feature. To do local
1583                 connection clients create <span class=SpellE><span class=GramE><code><span
1584                 style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>CIMClient</span></code></span></span><span
1585                 class=GramE><code><span style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>(</span></code></span><span
1586                 class=SpellE><code><span style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>CIMNameSpace</span></code></span><code><span
1587                 style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>&nbsp;namespace)</span></code><span
1588                 style='mso-spacerun:yes'>   </span>and this creates local connection to the CIM
1589                 Server running on the local system for the specified namespace. Clients do not
1590                 have to specify the username and/or password as the authentication is done
1591 kumpf       1.2 based the user logged in.</p>
1592                 
1593                 <p class=MsoBodyText2><i style='mso-bidi-font-style:normal'><span
1594 kumpf       1.3 style='mso-bidi-font-weight:bold'><o:p>&nbsp;</o:p></span></i></p>
1595 kumpf       1.1 
1596                 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
1597 kumpf       1.2 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:
1598 kumpf       1.3 list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;
1599                 font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>3.<span
1600                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
1601                 style='font-style:normal;mso-bidi-font-style:italic'>SSL Certificate Management<o:p></o:p></span></h2>
1602 kumpf       1.1 
1603                 <p class=MsoNormal style='margin-right:.4in;text-align:justify'>&nbsp;</p>
1604                 
1605                 <p style='margin-right:.4in;text-align:justify'><b>Importing Certificates into
1606                 Java Trust Store<o:p></o:p></b></p>
1607                 
1608                 <p style='margin-right:.4in;text-align:justify'>1. Export the server
1609 kumpf       1.3 certificate from the .<span class=SpellE>pem</span> file. </p>
1610 kumpf       1.1 
1611                 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'>Use <span
1612 kumpf       1.3 class=SpellE><span style='font-family:"Courier New"'>openssl</span></span>
1613                 command to export Pegasus <span class=SpellE>CIMServer</span> certificate file.
1614                 <span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'><o:p></o:p></span></p>
1615 kumpf       1.1 
1616                 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'><span
1617 kumpf       1.3 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'># /opt/<span
1618                 class=SpellE>wbem/sbin/openssl</span> x509 -in /<span class=SpellE>var/opt/wbem/server.pem</span>
1619                 -out <span class=SpellE>server.cer</span><o:p></o:p></span></p>
1620 kumpf       1.1 
1621                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1622                 10.0pt;mso-bidi-font-family:"Courier New"'>2. Import the server certificate in
1623                 to the client trust store.<o:p></o:p></span></p>
1624                 
1625                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1626 kumpf       1.3 10.0pt;mso-bidi-font-family:"Courier New"'><span style='mso-spacerun:yes'>     
1627                 </span>- Copy the server certificate on to the client system.<o:p></o:p></span></p>
1628 kumpf       1.1 
1629                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1630 kumpf       1.3 10.0pt;mso-bidi-font-family:"Courier New"'><span style='mso-spacerun:yes'>     
1631                 </span>- Use Java </span><span class=SpellE><span style='mso-bidi-font-size:
1632                 10.0pt;font-family:"Courier New"'>keytool</span></span><span style='mso-bidi-font-size:
1633                 10.0pt;mso-bidi-font-family:"Courier New"'> to import the certificate into the
1634                 client trust store.<o:p></o:p></span></p>
1635                 
1636                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1637                 .5in;text-align:justify'><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:
1638                 "Courier New"'># <span class=SpellE><span class=GramE>keytool</span></span>
1639                 -import -alias sequoia1 -file <span class=SpellE>server.cer</span> -<span
1640                 class=SpellE>keystore</span> <span class=SpellE>mytruststore</span><o:p></o:p></span></p>
1641 kumpf       1.1 
1642                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1643                 10.0pt;mso-bidi-font-family:"Courier New"'>You will be asked to enter a
1644 kumpf       1.3 password. The password is required only for modifying <span class=SpellE>mytruststore</span>
1645                 in the future. The <span class=SpellE>keytool</span> creates the trust store if
1646                 it is not already exists and then import the specified certificate. (For example
1647                 we entered the password as “wbem01”)<o:p></o:p></span></p>
1648 kumpf       1.1 
1649                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1650 kumpf       1.3 10.0pt;mso-bidi-font-family:"Courier New"'>3. Specify the <span class=SpellE>truststore</span>
1651                 in the command line of the client application using “-<span class=SpellE>Djavax.net.ssl.trustStore</span>”.<o:p></o:p></span></p>
1652 kumpf       1.1 
1653                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1654                 10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p></span></p>
1655                 
1656 kumpf       1.3 <p style='margin-right:.4in;text-align:justify'><span class=GramE><span
1657                 style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java</span></span><span
1658                 style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>
1659                 -<span class=SpellE>Djavax.net.ssl.trustStore</span>=<span class=SpellE>mytruststore</span>
1660                 &lt;<span class=SpellE>MyClient</span>&gt; &lt;system&gt; root/cimv2 5989 <span
1661                 class=SpellE>ssl</span><o:p></o:p></span></p>
1662 kumpf       1.1 
1663                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1664                 10.0pt;mso-bidi-font-family:"Courier New"'>4. If your client application is
1665 kumpf       1.3 written to update the <span class=SpellE>truststore</span> file
1666                 programmatically then you must also specify the password that was used to
1667                 create the <span class=SpellE>truststore</span> <span class=GramE>using<span
1668                 style='mso-spacerun:yes'>  </span>“</span>-<span class=SpellE>Djavax.net.ssl.trustStorePassword</span>”.<o:p></o:p></span></p>
1669 kumpf       1.1 
1670                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1671                 10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p></span></p>
1672                 
1673 kumpf       1.3 <p style='margin-right:.4in'><span class=GramE><span style='font-size:11.0pt;
1674                 mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java</span></span><span
1675                 style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>
1676                 -<span class=SpellE>Djavax.net.ssl.trustStore</span>=<span class=SpellE>mytruststore</span><span
1677                 style='mso-spacerun:yes'>  </span>-<span class=SpellE>Djavax.net.ssl.trustStorePassword</span>=wbem01
1678                 &lt;<span class=SpellE>MyClient</span>&gt;<span style='mso-spacerun:yes'> 
1679                 </span>&lt;system&gt; root/cimv2 5989 <span class=SpellE>ssl</span><span
1680                 style='mso-spacerun:yes'>    </span><o:p></o:p></span></p>
1681 kumpf       1.1 
1682                 <p style='margin-right:.4in;text-align:justify'><b>&nbsp;<o:p></o:p></b></p>
1683                 
1684                 <p style='margin-right:.4in;text-align:justify'><b>Viewing Certificates and
1685                 Trust Store files</b><b><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:
1686                 "Courier New"'><o:p></o:p></span></b></p>
1687                 
1688                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1689 kumpf       1.3 10.0pt;mso-bidi-font-family:"Courier New"'><span style='mso-spacerun:yes'>     
1690                 </span><span class=GramE>1.You</span> view certificates in a certificate file
1691                 using <span class=SpellE>keytool</span> command.<o:p></o:p></span></p>
1692                 
1693                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1694                 .5in;text-align:justify;text-indent:.25in'><span class=SpellE><span
1695                 class=GramE><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>keytool</span></span></span><span
1696                 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'> -<span
1697                 class=SpellE>printcert</span> -file <span class=SpellE>server.cer</span><o:p></o:p></span></p>
1698                 
1699                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1700                 .5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'><span
1701                 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>1.</span><span
1702                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span
1703                 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>You can
1704                 view all the certificates in a <span class=SpellE>truststore</span> using the <span
1705                 class=SpellE>keytool</span> command.<o:p></o:p></span></p>
1706                 
1707                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1708                 .5in;text-align:justify;text-indent:.25in'><span class=SpellE><span
1709                 class=GramE><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>keytool</span></span></span><span
1710 kumpf       1.3 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'> -list -v
1711                 -<span class=SpellE>keystore</span> <span class=SpellE>mytruststore</span></span><b><o:p></o:p></b></p>
1712 kumpf       1.1 
1713                 <h2><span style='font-style:normal;mso-bidi-font-style:italic'>&nbsp;<o:p></o:p></span></h2>
1714                 
1715 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
1716 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:
1717                 Arial;font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>4.<span
1718                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
1719                 style='font-style:normal;mso-bidi-font-style:italic'>Writing <span class=GramE>A</span>
1720                 Trust Manager<o:p></o:p></span></h2>
1721 kumpf       1.1 
1722                 <p style='margin-right:.4in;text-align:justify'>The primary responsibility of
1723 kumpf       1.3 the <span class=SpellE>TrustManager</span> is to determine whether the
1724                 presented authentication credentials should be trusted or not. If the
1725                 credentials are not trusted, the connection will be terminated. If no trust
1726                 manager is specified by the client application then JSSE will use its own trust
1727                 manager that supports authentication based on X.509 public key certificates. </p>
1728 kumpf       1.1 
1729                 <p style='margin-right:.4in;text-align:justify'>If the default X509TrustManager
1730                 behavior isn't suitable for your situation, you can implement your own
1731                 X509TrustManager. JSSE interface allows you to override certification
1732                 validation and continue the SSL handshake. You can also use the interface to
1733                 discontinue an SSL handshake by performing additional validation on a server's
1734                 digital certificate chain.</p>
1735                 
1736                 <p style='margin-right:.4in;text-align:justify'>When an SSL client connects to
1737                 an SSL server, the SSL server presents its digital certificate chain to the
1738                 client for authentication. This certificate chain can contain invalid digital
1739                 certificates. As per the SSL specification, the client should drop the SSL
1740                 connection once it discovers an invalid certificate. However, some applications
1741                 such as Web Browsers ask the user whether to accept the invalid certificate.
1742                 The Trust Manager eliminates this inconsistent practice by enabling you to
1743                 control when to continue or discontinue an SSL connection. Using a Trust
1744                 Manager you can perform custom checks before continuing an SSL connection. For
1745                 example, you can use the Trust Manager to specify that only users from specific
1746                 localities, such as towns, states, or countries, or users with other special
1747                 attributes, to gain access via the SSL connection. </p>
1748                 
1749 kumpf       1.1 <p style='margin-right:.4in;text-align:justify'>Here is an example of a Trust
1750                 Manager that basically ignores the server certificates chain by not validating
1751                 the certificate chain. It accepts any certificates from any server and goes
1752                 ahead with SSL handshake.<b> <o:p></o:p></b></p>
1753                 
1754                 <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";
1755                 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
1756                 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1757                 </span>
1758                 
1759 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1760                 padding:1.0pt 31.0pt 1.0pt 4.0pt'>
1761 kumpf       1.1 
1762 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1763                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1764                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
1765                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>java.security.cert</span>.*;<o:p></o:p></span></p>
1766 kumpf       1.1 
1767 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1768                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1769                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
1770                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>java.security.KeyStore</span>;<o:p></o:p></span></p>
1771 kumpf       1.1 
1772 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1773                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1774                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
1775                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> javax.net.*;<o:p></o:p></span></p>
1776 kumpf       1.1 
1777 kumpf       1.3 <p class=MsoNormal style='tab-stops:400.5pt;border:none;mso-border-alt:solid windowtext .5pt;
1778                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1779                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
1780                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>javax.net.ssl</span>.*;<o:p></o:p></span></p>
1781 kumpf       1.1 
1782 kumpf       1.3 <p class=MsoNormal style='tab-stops:400.5pt;border:none;mso-border-alt:solid windowtext .5pt;
1783                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1784                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1785 kumpf       1.1 
1786 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1787 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1788                 12.0pt;mso-bidi-font-size:10.0pt'>/**<o:p></o:p></span></p>
1789                 
1790 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1791 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1792                 12.0pt;mso-bidi-font-size:10.0pt'>This class implements the X509TrustManager
1793 kumpf       1.3 interface.<span style='mso-spacerun:yes'>  </span>It does not validate the
1794                 certificate chain sent by the <span class=GramE>server,</span> it basically
1795                 ignores the certificate chain and goes ahead with the SSL hand shake. <o:p></o:p></span></p>
1796 kumpf       1.1 
1797 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1798 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1799                 12.0pt;mso-bidi-font-size:10.0pt'>*/<o:p></o:p></span></p>
1800                 
1801 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1802                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1803                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>public</span></span><span
1804                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class <span class=SpellE>DontValidateCertificate</span>
1805 kumpf       1.1 implements X509TrustManager<o:p></o:p></span></p>
1806                 
1807 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1808 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1809                 12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p></span></p>
1810                 
1811 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1812 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1813 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1814                 </span><span class=GramE>X509TrustManager<span style='mso-spacerun:yes'> 
1815                 </span>myX509TrustManager</span>;<o:p></o:p></span></p>
1816 kumpf       1.1 
1817 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1818 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1819                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1820                 
1821 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1822 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1823 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1824 kumpf       1.1 </span>/**<o:p></o:p></span></p>
1825                 
1826 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1827 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1828 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1829                 </span>* <span class=SpellE><span class=GramE>checkClientTrusted</span></span>
1830                 checks to see if the chain is in the <o:p></o:p></span></p>
1831 kumpf       1.1 
1832 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1833 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1834 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1835                 </span>* <span class=SpellE><span class=GramE>keyStore</span></span> object.<o:p></o:p></span></p>
1836 kumpf       1.1 
1837 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1838 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1839 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1840 kumpf       1.1 </span>*/<o:p></o:p></span></p>
1841                 
1842 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1843 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1844 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1845                 </span><span class=GramE>public</span> void <span class=SpellE>checkClientTrusted</span>(X509Certificate[]
1846                 chain, <o:p></o:p></span></p>
1847 kumpf       1.1 
1848 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1849 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1850 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'> </span><span
1851                 style='mso-spacerun:yes'>                   </span>String <span class=SpellE>authType</span>)
1852                 throws <span class=SpellE>CertificateException</span><span
1853                 style='mso-spacerun:yes'>  </span><o:p></o:p></span></p>
1854 kumpf       1.1 
1855 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1856 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1857 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1858 kumpf       1.1 </span>{ <o:p></o:p></span></p>
1859                 
1860 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1861 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1862 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1863 kumpf       1.1 </span>}<o:p></o:p></span></p>
1864                 
1865 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1866 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1867                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1868                 
1869 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1870 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1871 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1872 kumpf       1.1 </span>/**<o:p></o:p></span></p>
1873                 
1874 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1875 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1876 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1877                 </span>* <span class=SpellE><span class=GramE>checkServerTrusted</span></span>
1878                 verifies to see if the chain is in the <o:p></o:p></span></p>
1879 kumpf       1.1 
1880 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1881 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1882 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1883                 </span>* <span class=SpellE><span class=GramE>keyStore</span></span> object.<o:p></o:p></span></p>
1884 kumpf       1.1 
1885 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1886 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1887 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1888 kumpf       1.1 </span>*/<o:p></o:p></span></p>
1889                 
1890 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1891 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1892 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1893                 </span><span class=GramE>public</span> void <span class=SpellE>checkServerTrusted</span>(X509Certificate[]
1894                 chain, <o:p></o:p></span></p>
1895 kumpf       1.1 
1896 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1897 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1898 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1899                 style='mso-spacerun:yes'>                   </span>String <span class=SpellE>authType</span>)
1900                 throws <span class=SpellE>CertificateException</span><span
1901                 style='mso-spacerun:yes'>  </span><o:p></o:p></span></p>
1902 kumpf       1.1 
1903 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1904 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1905 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1906 kumpf       1.1 </span>{ <o:p></o:p></span></p>
1907                 
1908 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1909 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1910 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1911 kumpf       1.1 </span>}<o:p></o:p></span></p>
1912                 
1913 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1914 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1915                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1916                 
1917 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1918 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1919 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1920 kumpf       1.1 </span>/**<o:p></o:p></span></p>
1921                 
1922 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1923 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1924 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1925                 </span>* This method retrieves all of the certificates in the <span
1926                 class=SpellE>keyStore</span> <o:p></o:p></span></p>
1927 kumpf       1.1 
1928 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1929 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1930 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1931                 </span>* <span class=GramE>and</span> returns them in an X509Certificate array.
1932                 We return null <o:p></o:p></span></p>
1933 kumpf       1.1 
1934 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1935 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1936 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1937                 </span>* <span class=GramE>as</span> we are accepting any certificates. We
1938                 should only return null if we are using this trust manager <o:p></o:p></span></p>
1939 kumpf       1.1 
1940 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1941 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1942 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1943                 </span>* <span class=GramE>with</span> <span class=SpellE>CIMClient</span>
1944                 applications. However, we must return an empty <span class=GramE>X509Certificate[</span>]
1945                 is used with<o:p></o:p></span></p>
1946 kumpf       1.1 
1947 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1948 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1949 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1950 kumpf       1.1 </span>* CIM Listener (which is SSL Server) interface. <o:p></o:p></span></p>
1951                 
1952 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1953 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1954 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1955 kumpf       1.1 </span>*/<o:p></o:p></span></p>
1956                 
1957 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1958 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1959 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1960                 </span><span class=GramE>public</span> X509Certificate[] <span class=SpellE>getAcceptedIssuers</span>()<o:p></o:p></span></p>
1961 kumpf       1.1 
1962 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1963 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1964 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1965 kumpf       1.1 </span>{<o:p></o:p></span></p>
1966                 
1967 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1968 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1969 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1970                 </span><span class=GramE>return</span> null;<o:p></o:p></span></p>
1971 kumpf       1.1 
1972 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1973 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1974 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1975                 </span>}<o:p></o:p></span></p>
1976 kumpf       1.1 
1977 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1978 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1979                 12.0pt;mso-bidi-font-size:10.0pt'>}<o:p></o:p></span></p>
1980                 
1981                 </div>
1982                 
1983                 <span style='font-size:12.0pt;font-family:"Times New Roman";mso-fareast-font-family:
1984                 "Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:EN-US;
1985                 mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1986                 </span>
1987                 
1988                 <p style='margin-right:.4in;text-align:justify'>The Client SDK includes the
1989                 following two simple trust managers.</p>
1990                 
1991 kumpf       1.3 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1992                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
1993                 class=SpellE>org.snia.wbemcmd.xml.CertificateManager</span></p>
1994                 
1995                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1996                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
1997                 class=SpellE>org.snia.wbemcmd.xml.DontValidateCertificate</span></p>
1998                 
1999                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2000                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
2001                 class=SpellE><span class=GramE>org.snia.wbem.listener.DoNotValidateClientCert</span></span><span
2002                 class=GramE><span style='mso-spacerun:yes'>  </span>(</span> Note: Use this
2003                 with CIM Listener interface)</p>
2004                 
2005                 <p style='margin-right:.4in;text-align:justify'>Client API uses JSSE trust manager
2006                 by default. If you want the API to use your own trust manager then you need to
2007                 explicitly specify. </p>
2008 kumpf       1.1 
2009                 <p style='margin-right:.4in'>Refer to JSSE reference guide <span
2010                 style='color:blue'><a
2011                 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>
2012                 </span>for more information about writing trust managers.</p>
2013                 
2014                 <p class=MsoNormal>&nbsp;</p>
2015                 
2016                 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
2017 kumpf       1.2 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:
2018 kumpf       1.3 list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;
2019                 font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>5.<span
2020                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2021                 style='font-style:normal;mso-bidi-font-style:italic'>Configuration<o:p></o:p></span></h2>
2022 kumpf       1.1 
2023                 <p style='margin-right:.4in;text-align:justify'>The Client SDK allows the
2024                 client applications to specify the following configuration properties in a
2025                 property file. If no property file is specified then the SDK will use default
2026                 values for all the properties. If the property file is specified but one or
2027                 more properties are not set in the property file, then SDK will use the default
2028                 values for those properties.</p>
2029                 
2030                 <div align=center>
2031                 
2032 kumpf       1.3 <table class=MsoNormalTable border=1 cellspacing=0 cellpadding=0
2033                  style='margin-left:54.9pt;border-collapse:collapse;border:none;mso-border-alt:
2034                  solid windowtext .5pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>
2035                  <tr style='mso-yfti-irow:0'>
2036                   <td width=252 valign=top style='width:189.0pt;border:solid windowtext 1.0pt;
2037                   mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2038                   <p style='margin-right:.4in;text-align:justify'><b><span
2039                   style='mso-spacerun:yes'>     </span>Property Name<o:p></o:p></b></p>
2040 kumpf       1.1   </td>
2041 kumpf       1.3   <td width=348 valign=top style='width:261.0pt;border:solid windowtext 1.0pt;
2042                   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
2043                   solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2044 kumpf       1.1   <p style='margin-right:.4in;text-align:justify'><b>Default Value<o:p></o:p></b></p>
2045                   </td>
2046                  </tr>
2047 kumpf       1.3  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
2048                   <td width=252 valign=top style='width:189.0pt;border:solid windowtext 1.0pt;
2049                   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
2050                   padding:0in 5.4pt 0in 5.4pt'>
2051                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2052                   .25in;text-align:justify'>DEBUG_XML </p>
2053                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2054                   .25in;text-align:justify'>DEBUG_XMLDECODE</p>
2055                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2056                   .25in;text-align:justify'><span class=SpellE>clientLogFilePath</span></p>
2057                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2058                   .25in;text-align:justify'><span class=SpellE>TrustManager</span></p>
2059 kumpf       1.1   </td>
2060                   <td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
2061 kumpf       1.3   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
2062 kumpf       1.1   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
2063 kumpf       1.3   mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2064 kumpf       1.1   <p style='margin-right:.4in;text-align:justify'>False</p>
2065                   <p style='margin-right:.4in;text-align:justify'>False</p>
2066                   <p style='margin-right:.4in;text-align:justify'>&quot;/logs/clientout.txt&quot;</p>
2067                   <p style='margin-right:.4in;text-align:justify'>Do not define this in
2068                   properties file unless you have your own Trust Manager. Do not set it to NULL
2069 kumpf       1.3   either. JSSE uses its default <span class=GramE>Trust<span
2070                   style='mso-spacerun:yes'>  </span>Manager</span> only if this property is not
2071                   defined.</p>
2072 kumpf       1.1   </td>
2073                  </tr>
2074                 </table>
2075                 
2076                 </div>
2077                 
2078                 <p style='margin-right:.4in;text-align:justify'>The DEBUG_XML, DEBUG_XMLDECODE,
2079 kumpf       1.3 and <span class=SpellE>clientLogFilePath</span> properties are only for
2080                 developmental debug purposes and they should not be set in the release product
2081                 and should not be exposed to the client application users.</p>
2082 kumpf       1.1 
2083                 <p style='margin-right:.4in;text-align:justify'>Note: The debug trace or
2084                 logging in the client API is not thread safe, it is recommended that clients do
2085                 not use debug logging in a multi-threaded application. </p>
2086                 
2087                 <p style='margin-right:.4in;text-align:justify'>The client applications can
2088 kumpf       1.3 only use the set methods in “<span class=SpellE>GlobalConfig</span>” class to
2089                 set the following configuration properties if needed. The above four properties
2090                 can also be set using the set methods.</p>
2091 kumpf       1.1 
2092                 <p style='margin-right:.4in;text-align:justify'>&nbsp;</p>
2093                 
2094                 <div align=center>
2095                 
2096 kumpf       1.3 <table class=MsoNormalTable border=1 cellspacing=0 cellpadding=0 width=547
2097                  style='width:409.9pt;margin-left:54.9pt;border-collapse:collapse;border:none;
2098                  mso-border-alt:solid windowtext .5pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>
2099                  <tr style='mso-yfti-irow:0'>
2100                   <td width=207 valign=top style='width:154.95pt;border:solid windowtext 1.0pt;
2101                   mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2102                   <p style='margin-right:.4in;text-align:justify'><b><span
2103                   style='mso-spacerun:yes'>     </span>Property Name<o:p></o:p></b></p>
2104 kumpf       1.1   </td>
2105 kumpf       1.3   <td width=340 valign=top style='width:254.95pt;border:solid windowtext 1.0pt;
2106                   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
2107                   solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2108 kumpf       1.1   <p style='margin-right:.4in;text-align:justify'><b>Default Value<o:p></o:p></b></p>
2109                   </td>
2110                  </tr>
2111 kumpf       1.3  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
2112                   <td width=207 valign=top style='width:154.95pt;border:solid windowtext 1.0pt;
2113                   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
2114                   padding:0in 5.4pt 0in 5.4pt'>
2115                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2116                   .25in;text-align:justify'><span class=SpellE>httpSocketProvider</span></p>
2117                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2118                   .25in;text-align:justify'><span class=SpellE>httpsSocketProvider</span></p>
2119 kumpf       1.1   </td>
2120                   <td width=340 valign=top style='width:254.95pt;border-top:none;border-left:
2121 kumpf       1.3   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
2122 kumpf       1.1   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
2123 kumpf       1.3   mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2124                   <p style='margin-right:.4in;text-align:justify'><span class=SpellE>org.snia.wbemcmd.xml.PlainSocketProvider</span></p>
2125                   <p style='margin-right:.4in;text-align:justify'><span class=SpellE>org.snia.wbemcmd.xml.JSSESocketProvider</span></p>
2126 kumpf       1.1   </td>
2127                  </tr>
2128                 </table>
2129                 
2130                 </div>
2131                 
2132                 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'>&nbsp;</p>
2133                 
2134                 <p style='margin-right:.4in;text-align:justify'>The client applications can
2135                 specify the properties file in the following ways:</p>
2136                 
2137 kumpf       1.3 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2138                 .5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'>1.<span
2139                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Specify the
2140                 property file on the command line by setting “–D <span class=SpellE>org.snia.wbem.cimom.properties</span>”</p>
2141                 
2142                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2143                 .25in;text-align:justify;text-indent:.25in'>For example,</p>
2144                 
2145                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2146                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span># <span
2147                 class=GramE>java</span> -<span class=SpellE>Dorg.snia.wbem.cimom.properties</span>=./<span
2148                 class=SpellE>cim.properties</span> &lt;<span class=SpellE>myAapp</span>&gt;</p>
2149                 
2150                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2151                 .5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'>2.<span
2152                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Specify the
2153                 property file programmatically using the <span class=SpellE><span class=GramE>System.setProperty</span></span><span
2154                 class=GramE>(</span>) before creating the <span class=SpellE>CIMClient</span>
2155                 object.</p>
2156                 
2157                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2158 kumpf       1.3 .5in;text-align:justify'>For example,</p>
2159                 
2160                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2161                 .5in;text-align:justify'><span class=SpellE><span class=GramE>System.setProperty</span></span><span
2162                 class=GramE>(</span>&quot;<span class=SpellE>org.snia.wbem.cimom.properties</span>&quot;,
2163                 “./<span class=SpellE>cim.properties</span>”);</p>
2164 kumpf       1.1 
2165 kumpf       1.2 <pre><span style='font-family:"Times New Roman";mso-fareast-font-family:"Times New Roman"'>&nbsp;<o:p></o:p></span></pre>
2166 kumpf       1.1 
2167 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
2168 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:
2169                 Arial'><span style='mso-list:Ignore'>6.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2170                 </span></span></span><![endif]>CIM-<span class=GramE>HTTP<span
2171                 style='mso-spacerun:yes'>  </span>Listener</span></h2>
2172 kumpf       1.1 
2173 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
2174 kumpf       1.3 mso-bidi-font-size:8.0pt'><o:p>&nbsp;</o:p></span></p>
2175 kumpf       1.1 
2176 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
2177                 mso-bidi-font-size:8.0pt'>A <b>CIM-HTTP Listener </b>is an HTTP server that
2178 kumpf       1.3 receives and processes CIM Export Requests and issues CIM Export Responses. <span
2179                 class=GramE>An</span> CIM Export Message is used to transfer data from a CIM
2180                 entity into a non-CIM entity.</span><span style='font-size:12.0pt;display:none;
2181                 mso-hide:all'><o:p></o:p></span></p>
2182 kumpf       1.2 
2183                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2184                 none'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2185 kumpf       1.3 style='mso-spacerun:yes'> </span><o:p></o:p></span></p>
2186 kumpf       1.1 
2187 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><b><span style='font-size:12.0pt;
2188                 mso-bidi-font-size:9.0pt'>What are the components of a CIM-HTTP Listener?<o:p></o:p></span></b></p>
2189 kumpf       1.1 
2190                 <ul style='margin-top:0in' type=disc>
2191 kumpf       1.2  <li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><b><span
2192                      style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>CIM-HTTP Listener
2193 kumpf       1.1      Protocol “module”. </span></b><span style='font-size:12.0pt;mso-bidi-font-size:
2194 kumpf       1.2      7.0pt'>The CIM-HTTP Listener Protocol “module” receives indications from
2195                      (and generates responses to) the CIM/XML Indication Handler. </span><span
2196 kumpf       1.1      style='font-size:12.0pt;mso-bidi-font-size:7.5pt;display:none;mso-hide:
2197                      all'><o:p></o:p></span></li>
2198                 </ul>
2199                 
2200 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
2201 kumpf       1.3 mso-bidi-font-size:7.5pt'><o:p>&nbsp;</o:p></span></p>
2202 kumpf       1.1 
2203                 <ul style='margin-top:0in' type=disc>
2204 kumpf       1.2  <li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><b><span
2205 kumpf       1.1      style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>Indication Consumer.</span></b><span
2206                      style='font-size:12.0pt;mso-bidi-font-size:7.5pt'><span
2207 kumpf       1.3      style='mso-spacerun:yes'>  </span>A management application that processes,
2208                      displays, stores, analyzes, etc indications. <o:p></o:p></span></li>
2209 kumpf       1.2  <li class=MsoNormal style='color:black;mso-list:l3 level1 lfo14;tab-stops:
2210 kumpf       1.3      list .5in'><span class=SpellE><b><span style='font-size:12.0pt;mso-bidi-font-size:
2211                      7.5pt;color:windowtext'>CIM_Indication</span></b></span><b><span
2212                      style='font-size:12.0pt;mso-bidi-font-size:7.5pt;color:windowtext'>
2213                      Schema.</span></b><span style='font-size:12.0pt;mso-bidi-font-size:7.5pt;
2214                      color:windowtext'> The schema definition for indication objects of
2215                      interest to the CIM-XML Listener.</span><span style='font-size:11.0pt;
2216                      mso-bidi-font-size:7.5pt'><o:p></o:p></span></li>
2217 kumpf       1.1 </ul>
2218                 
2219 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:7.5pt;
2220 kumpf       1.3 font-family:"Futura Bk";color:black'><o:p>&nbsp;</o:p></span></p>
2221 kumpf       1.2 
2222                 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:7.5pt;
2223 kumpf       1.3 font-family:"Futura Bk";color:black'><o:p>&nbsp;</o:p></span></p>
2224 kumpf       1.2 
2225 kumpf       1.3 <p class=MsoBodyText2 style='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'>The
2226                 listener is associated with the subscription through the destination property
2227                 of the handler instance. Multiple subscriptions can refer to the same handler
2228                 instance; so one listener can listen to multiple subscriptions.</p>
2229 kumpf       1.2 
2230 kumpf       1.3 <p class=MsoNormal style='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'><span
2231                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2232 kumpf       1.2 
2233 kumpf       1.3 <p class=MsoNormal style='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'><span
2234                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>With subscription you will
2235                 specify the destination where the Listener is running. <o:p></o:p></span></p>
2236 kumpf       1.2 
2237 kumpf       1.3 <p class=MsoNormal style='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'><span
2238                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>For example,<o:p></o:p></span></p>
2239 kumpf       1.2 
2240 kumpf       1.3 <p class=MsoNormal style='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'><span
2241                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2242                 style='mso-spacerun:yes'>  </span>1. SSL enable consumer<o:p></o:p></span></p>
2243 kumpf       1.2 
2244 kumpf       1.3 <p class=MsoNormal style='text-indent:.5in;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'><span
2245                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;PROPERTY
2246                 NAME=&quot;Destination&quot; TYPE=&quot;string&quot;&gt;<o:p></o:p></span></p>
2247 kumpf       1.2 
2248 kumpf       1.3 <p class=MsoNormal style='text-indent:.5in;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'><span
2249                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;VALUE&gt;<b>https</b>://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer&lt;/VALUE&gt;<o:p></o:p></span></p>
2250 kumpf       1.2 
2251 kumpf       1.3 <p class=MsoNormal style='text-indent:.5in;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'><span
2252                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;/PROPERTY&gt;<o:p></o:p></span></p>
2253 kumpf       1.2 
2254 kumpf       1.3 <p style='margin:0in;margin-bottom:.0001pt;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'><span
2255                 style='mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2256 kumpf       1.2 
2257 kumpf       1.3 <p class=MsoNormal style='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'><span
2258                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2259                 style='mso-spacerun:yes'>  </span>1. Non-SSL enable consumer<o:p></o:p></span></p>
2260 kumpf       1.2 
2261 kumpf       1.3 <p class=MsoNormal style='text-indent:.5in;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'><span
2262                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;PROPERTY
2263                 NAME=&quot;Destination&quot; TYPE=&quot;string&quot;&gt;<o:p></o:p></span></p>
2264 kumpf       1.2 
2265 kumpf       1.3 <p class=MsoNormal style='text-indent:.5in;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'><span
2266                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;VALUE&gt;<b>http</b>://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer&lt;/VALUE&gt;<o:p></o:p></span></p>
2267 kumpf       1.1 
2268 kumpf       1.3 <p class=MsoNormal style='text-indent:.5in;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'><span
2269                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;/PROPERTY&gt;<o:p></o:p></span></p>
2270 kumpf       1.2 
2271 kumpf       1.3 <p class=MsoNormal style='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'><span
2272                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2273 kumpf       1.2 
2274 kumpf       1.3 <p class=MsoNormal style='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'><span
2275                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>In the above case, Listener
2276                 would be running on mysystem.cup.hp.com at port 8189 with SSL enabled.</span><span
2277                 style='font-family:"Courier New"'> <o:p></o:p></span></p>
2278 kumpf       1.1 
2279 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:7.5pt;
2280 kumpf       1.3 font-family:"Futura Bk";color:black'><o:p>&nbsp;</o:p></span></p>
2281 kumpf       1.1 
2282 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:7.5pt;
2283 kumpf       1.3 font-family:"Futura Bk";color:black'><o:p>&nbsp;</o:p></span></p>
2284 kumpf       1.1 
2285 kumpf       1.2 <h3 style='tab-stops:.5in'><b><span style='font-size:11.0pt;mso-bidi-font-size:
2286                 10.0pt'>Writing CIM-XML Consumer<o:p></o:p></span></b></h3>
2287                 
2288                 <p class=MsoNormal style='tab-stops:.5in'>&nbsp;</p>
2289 kumpf       1.1 
2290 kumpf       1.2 <p class=MsoNormal style='text-align:justify;tab-stops:.5in'><span
2291                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIM-XML consumer
2292 kumpf       1.3 applications use the </span><span class=SpellE><tt><span style='font-size:12.0pt;
2293                 mso-bidi-font-size:10.0pt;font-family:"Times New Roman";mso-bidi-font-family:
2294                 "Courier New"'>org.snia.wbem.listner</span></tt></span><span style='font-size:
2295                 12.0pt;mso-bidi-font-size:10.0pt'> APIs to handle CIM-XML indications that are
2296                 delivered by the client Applications.<span style='mso-spacerun:yes'> 
2297                 </span>Please follow some of examples that are provided with the SDK. <o:p></o:p></span></p>
2298 kumpf       1.1 
2299 kumpf       1.2 <p class=MsoNormal style='text-align:justify;tab-stops:.5in'><span
2300 kumpf       1.3 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2301 kumpf       1.2 
2302 kumpf       1.3 <p class=MsoBodyText2 style='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'>First
2303                 implement a consumer using <span class=SpellE>CIMIndicationConsumer</span>
2304                 interface. Then create a <span class=SpellE>CIMListener</span> object, add the
2305                 list of consumers that are interested in consuming Indications. </p>
2306 kumpf       1.1 
2307 kumpf       1.2 <p style='tab-stops:.5in'>CIM-XML Listener Consumers typically follow this
2308                 sequence:</p>
2309                 
2310                 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2311 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>1.<span
2312                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Identify
2313                 the port number they want to listen for indications.</p>
2314 kumpf       1.1 
2315 kumpf       1.2 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2316 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>2.<span
2317                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Implement
2318                 a consumer using <span class=SpellE>CIMIndicationConsumer</span> interface.</p>
2319 kumpf       1.1 
2320 kumpf       1.2 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2321 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>3.<span
2322                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Write
2323                 it’s own <span class=GramE>‘<span class=SpellE>consumerIndication</span>(</span>);
2324                 method to process indication when received.</p>
2325 kumpf       1.1 
2326 kumpf       1.2 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2327 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>4.<span
2328                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Use
2329                 the CIM HTTP Listener APIs to start listening on a particular port.</p>
2330 kumpf       1.1 
2331 kumpf       1.2 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2332 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>5.<span
2333                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Start
2334                 running as a process</p>
2335 kumpf       1.1 
2336 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
2337                 mso-bidi-font-size:10.0pt'>&nbsp;<b>Import classes<o:p></o:p></b></span></p>
2338 kumpf       1.1 
2339 kumpf       1.3 <div style='margin-left:.5in'>
2340 kumpf       1.1 
2341 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2342                 padding:1.0pt 0in 1.0pt 31.0pt'>
2343                 
2344                 <p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;
2345                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
2346                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
2347                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.listener.CIMHTTPListener</span>;<o:p></o:p></span></p>
2348                 
2349                 <p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;
2350                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
2351                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
2352                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.listener.<span
2353                 style='font-size:10.0pt'>CIMIndicationConsumer</span></span></span>;</p>
2354                 
2355                 <p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;
2356                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
2357                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
2358                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.xml.<span
2359                 style='font-size:10.0pt'>OperationContext</span></span></span>;</p>
2360                 
2361                 </div>
2362 kumpf       1.1 
2363                 </div>
2364                 
2365 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2366 kumpf       1.3 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
2367 kumpf       1.1 
2368 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2369 kumpf       1.3 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
2370 kumpf       1.1 
2371 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2372 kumpf       1.3 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
2373 kumpf       1.1 
2374 kumpf       1.3 <h6>Implement <span class=SpellE>CIMIndicationConsumer</span> interface</h6>
2375 kumpf       1.1 
2376 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2377                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2378 kumpf       1.1 
2379 kumpf       1.3 <p class=MsoNormal style='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;
2380                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2381                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2382 kumpf       1.2 
2383 kumpf       1.3 <p class=MsoNormal style='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;
2384                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2385                 1.0pt 4.0pt 1.0pt 4.0pt'><span class=GramE><span style='font-size:12.0pt;
2386                 mso-bidi-font-size:10.0pt'>public</span></span><span style='font-size:12.0pt;
2387                 mso-bidi-font-size:10.0pt'> class <span class=SpellE>MyIndicationConsumer</span>
2388                 implements <span class=SpellE>CIMIndicationConsumer</span><o:p></o:p></span></p>
2389 kumpf       1.1 
2390 kumpf       1.3 <p class=MsoNormal style='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;
2391                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2392                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p></span></p>
2393 kumpf       1.1 
2394 kumpf       1.3 <p class=MsoNormal style='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;
2395                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2396                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2397                 style='mso-spacerun:yes'>    </span><span class=SpellE><span class=GramE>MyIndicationConsumer</span></span><span
2398                 class=GramE>(</span>String name) <o:p></o:p></span></p>
2399 kumpf       1.1 
2400 kumpf       1.3 <p class=MsoNormal style='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;
2401                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2402                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2403                 style='mso-spacerun:yes'>    </span>{ <o:p></o:p></span></p>
2404 kumpf       1.1 
2405 kumpf       1.3 <p class=MsoNormal style='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;
2406                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2407                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2408                 style='mso-spacerun:yes'>     </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2409                 class=GramE>(</span>&quot;I am a consumer&quot; + name);<o:p></o:p></span></p>
2410 kumpf       1.1 
2411 kumpf       1.3 <p class=MsoNormal style='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;
2412                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2413                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2414                 style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2415 kumpf       1.1 
2416 kumpf       1.3 <p class=MsoNormal style='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;
2417                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2418                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2419                 style='mso-spacerun:yes'>    </span><span class=GramE>public</span> void <span
2420                 class=SpellE>consumeIndication</span>(<span class=SpellE>OperationContext</span>
2421                 context,<o:p></o:p></span></p>
2422                 
2423                 <p class=MsoBodyText2 style='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;
2424                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2425                 1.0pt 4.0pt 1.0pt 4.0pt'><span
2426                 style='mso-spacerun:yes'>                                </span>String URL, <span
2427                 class=SpellE>CIMIndication</span> <span class=SpellE>cime</span>)</p>
2428 kumpf       1.1 
2429 kumpf       1.3 <p class=MsoNormal style='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;
2430                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2431                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2432                 style='mso-spacerun:yes'>    </span>{<o:p></o:p></span></p>
2433 kumpf       1.1 
2434 kumpf       1.3 <p class=MsoNormal style='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;
2435                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2436                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2437                 style='mso-spacerun:yes'>         </span>// do something with indications
2438                 received<o:p></o:p></span></p>
2439 kumpf       1.1 
2440 kumpf       1.3 <p class=MsoNormal style='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;
2441                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2442                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2443                 style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2444 kumpf       1.1 
2445 kumpf       1.3 <p class=MsoNormal style='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;
2446                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2447                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2448                 style='mso-spacerun:yes'> </span>}</span></p>
2449 kumpf       1.1 
2450 kumpf       1.2 </div>
2451 kumpf       1.1 
2452 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2453 kumpf       1.3 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
2454 kumpf       1.1 
2455 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2456                 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Indication
2457 kumpf       1.3 Processor (<span class=SpellE><span class=GramE>consumeIndicattion</span></span><span
2458                 class=GramE>(</span>)) method<o:p></o:p></span></b></p>
2459 kumpf       1.2 
2460                 <p class=MsoBodyText2 style='tab-stops:.5in;mso-layout-grid-align:none;
2461 kumpf       1.3 text-autospace:none'>Once the indication is received you can have your own <span
2462                 class=SpellE><span class=GramE>consumerIndication</span></span><span
2463                 class=GramE>(</span>) method that can process the <span class=SpellE>CIMInstance</span>
2464                 which is passed by the <span class=SpellE>CIMListener</span>. Here is an
2465                 example:</p>
2466 kumpf       1.2 
2467                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2468 kumpf       1.3 none'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2469 kumpf       1.2 
2470 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2471                 padding:2.0pt 4.0pt 1.0pt 4.0pt'>
2472 kumpf       1.2 
2473                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2474                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2475                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2476 kumpf       1.3 style='mso-spacerun:yes'>        </span><span class=GramE>public</span> void <span
2477                 class=SpellE><b>consumeIndication</b></span>(<span class=SpellE>XMLOperationContext</span>
2478 kumpf       1.2 context , <o:p></o:p></span></p>
2479                 
2480                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2481                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2482                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2483 kumpf       1.3 style='mso-spacerun:yes'>                                                                       
2484                 </span>String URL<span class=GramE>,<span style='mso-spacerun:yes'>  </span><span
2485                 class=SpellE>CIMIndication</span></span> </span><st1:State><st1:place><span
2486                   class=SpellE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>ind</span></span></st1:place></st1:State><span
2487                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>)<o:p></o:p></span></p>
2488 kumpf       1.2 
2489                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2490                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2491                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2492 kumpf       1.3 style='mso-spacerun:yes'>    </span>{<o:p></o:p></span></p>
2493 kumpf       1.1 
2494 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2495                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2496 kumpf       1.3 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
2497 kumpf       1.2 
2498                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2499                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2500                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2501 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2502                 class=GramE>(</span>&quot;---------- Begin of event data ----------&quot;);<o:p></o:p></span></p>
2503 kumpf       1.2 
2504                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2505                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2506                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2507 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2508                 class=GramE>(</span>&quot;--- Indication URL : &quot;+<span class=SpellE>indURL</span>);<o:p></o:p></span></p>
2509 kumpf       1.2 
2510                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2511                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2512                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2513 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2514                 class=GramE>(</span>&quot;--- Indication : &quot;+<span class=SpellE>ind.toString</span>());<o:p></o:p></span></p>
2515 kumpf       1.2 
2516                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2517                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2518                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2519 kumpf       1.3 style='mso-spacerun:yes'>       </span><o:p></o:p></span></p>
2520 kumpf       1.2 
2521                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2522                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2523                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2524 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=GramE>try</span> <o:p></o:p></span></p>
2525 kumpf       1.2 
2526                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2527                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2528                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2529 kumpf       1.3 style='mso-spacerun:yes'>       </span>{<o:p></o:p></span></p>
2530 kumpf       1.2 
2531                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2532                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2533                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2534 kumpf       1.3 style='mso-spacerun:yes'>          </span>Object o=null;<o:p></o:p></span></p>
2535 kumpf       1.2 
2536                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2537                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2538                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2539 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=GramE>if</span> (<span
2540                 class=SpellE>ind.getClassName</span>().<span class=SpellE>startsWith</span>(&quot;<span
2541                 class=SpellE>CIM_Class</span>&quot;))<o:p></o:p></span></p>
2542 kumpf       1.2 
2543                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2544                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2545                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2546 kumpf       1.3 style='mso-spacerun:yes'>             </span>o<span class=GramE>=(</span>Object)<span
2547                 class=SpellE>ind.getProperty</span>(&quot;<span class=SpellE>classdefinition</span>&quot;).<span
2548                 class=SpellE>getValue</span>().<span class=SpellE>getValue</span>();<o:p></o:p></span></p>
2549 kumpf       1.2 
2550                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2551                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2552                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2553 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=GramE>if</span> (<span
2554                 class=SpellE>ind.getClassName</span>().<span class=SpellE>startsWith</span>(&quot;<span
2555                 class=SpellE>CIM_Inst</span>&quot;))<o:p></o:p></span></p>
2556 kumpf       1.2 
2557                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2558                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2559                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2560 kumpf       1.3 style='mso-spacerun:yes'>            </span>o<span class=GramE>=(</span>Object)
2561                 <span class=SpellE>ind.getProperty</span>(&quot;<span class=SpellE>sourceinstance</span>&quot;).<span
2562                 class=SpellE>getValue</span>().<span class=SpellE>getValue</span>();<o:p></o:p></span></p>
2563 kumpf       1.2 
2564                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2565                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2566 kumpf       1.3 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
2567 kumpf       1.2 
2568                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2569                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2570                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2571 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=GramE>if</span> (o <span
2572                 class=SpellE>instanceof</span> <span class=SpellE>CIMInstance</span>) <o:p></o:p></span></p>
2573 kumpf       1.2 
2574                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2575                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2576                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2577 kumpf       1.3 style='mso-tab-count:1'>      </span><span style='mso-spacerun:yes'>  </span>{<o:p></o:p></span></p>
2578 kumpf       1.2 
2579                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2580                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2581                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2582 kumpf       1.3 style='mso-spacerun:yes'>             </span><span class=SpellE>CIMInstance</span>
2583                 <span class=SpellE>eo</span><span class=GramE>=(</span><span class=SpellE>CIMInstance</span>)o;<o:p></o:p></span></p>
2584 kumpf       1.2 
2585                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2586                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2587                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2588 kumpf       1.3 style='mso-spacerun:yes'>             </span><span class=SpellE><span
2589                 class=GramE>System.out.println</span></span><span class=GramE>(</span>&quot;---
2590                 Embedded Instance: &quot;+<span class=SpellE>eo</span>);<o:p></o:p></span></p>
2591 kumpf       1.2 
2592                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2593                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2594                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2595 kumpf       1.3 style='mso-spacerun:yes'>          </span>}<o:p></o:p></span></p>
2596 kumpf       1.2 
2597                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2598                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2599                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2600 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=GramE>else</span> if (o <span
2601                 class=SpellE>instanceof</span> <span class=SpellE>CIMClass</span>) {<o:p></o:p></span></p>
2602 kumpf       1.2 
2603                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2604                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2605                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2606 kumpf       1.3 style='mso-spacerun:yes'>             </span><span class=SpellE>CIMClass</span>
2607                 <span class=SpellE>eo</span><span class=GramE>=(</span><span class=SpellE>CIMClass</span>)o;<o:p></o:p></span></p>
2608 kumpf       1.2 
2609                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2610                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2611                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2612 kumpf       1.3 style='mso-spacerun:yes'>             </span><span class=SpellE><span
2613                 class=GramE>System.out.println</span></span><span class=GramE>(</span>&quot;---
2614                 Embedded Class: &quot;+<span class=SpellE>eo</span>);<o:p></o:p></span></p>
2615 kumpf       1.2 
2616                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2617                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2618                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2619 kumpf       1.3 style='mso-spacerun:yes'>          </span>}<o:p></o:p></span></p>
2620 kumpf       1.2 
2621                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2622                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2623                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2624 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2625                 class=GramE>(</span>&quot;----------- End of event data -----------\n&quot;);<o:p></o:p></span></p>
2626 kumpf       1.2 
2627                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2628                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2629                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2630 kumpf       1.3 style='mso-spacerun:yes'>       </span>}<o:p></o:p></span></p>
2631 kumpf       1.2 
2632                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2633                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2634                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2635 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=GramE>catch</span>
2636                 (Exception <span class=SpellE>ee</span>) <o:p></o:p></span></p>
2637 kumpf       1.2 
2638                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2639                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2640                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2641 kumpf       1.3 style='mso-spacerun:yes'>       </span>{<o:p></o:p></span></p>
2642 kumpf       1.2 
2643                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2644                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2645                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2646 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=SpellE><span class=GramE>ee.printStackTrace</span></span><span
2647                 class=GramE>(</span>);<o:p></o:p></span></p>
2648 kumpf       1.1 
2649 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2650                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2651                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2652 kumpf       1.3 style='mso-spacerun:yes'>       </span>}<o:p></o:p></span></p>
2653 kumpf       1.1 
2654 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2655                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2656                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2657 kumpf       1.3 style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2658 kumpf       1.2 
2659 kumpf       1.1 </div>
2660                 
2661 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2662 kumpf       1.3 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
2663 kumpf       1.2 
2664                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2665 kumpf       1.3 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
2666 kumpf       1.2 
2667                 <h4 style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:none'>Developing
2668                 CIM HTTP Listener</h4>
2669                 
2670 kumpf       1.3 <p class=MsoNormal style='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'><o:p>&nbsp;</o:p></p>
2671 kumpf       1.2 
2672 kumpf       1.3 <p class=MsoNormal style='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'><span
2673                 class=GramE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>public</span></span><span
2674                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class <span class=SpellE>SampleListener</span><o:p></o:p></span></p>
2675 kumpf       1.2 
2676 kumpf       1.3 <p class=MsoNormal style='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'><span
2677                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p></span></p>
2678 kumpf       1.2 
2679 kumpf       1.3 <p class=MsoNormal style='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'><span
2680                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2681                 style='mso-spacerun:yes'>      </span><o:p></o:p></span></p>
2682 kumpf       1.2 
2683 kumpf       1.3 <p class=MsoNormal style='margin-left:.5in;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'><span
2684                 class=SpellE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIMHTTPListener</span></span><span
2685                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>myListener</span>
2686                 <span class=GramE>=<span style='mso-spacerun:yes'>  </span>new</span> <span
2687                 class=SpellE>CIMHTTPListener</span>(<span class=SpellE>listenerPortNo</span>, <span
2688                 class=SpellE>isSSL</span>);<o:p></o:p></span></p>
2689                 
2690                 <p class=MsoNormal style='margin-left:.5in;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'><span
2691                 class=GramE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>try</span></span><span
2692                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> {<o:p></o:p></span></p>
2693                 
2694                 <p class=MsoNormal style='margin-left:1.0in;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'><span
2695                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>// <span class=GramE>Add</span>
2696                 consumer<o:p></o:p></span></p>
2697                 
2698                 <p class=MsoNormal style='margin-left:1.0in;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'><span
2699                 class=SpellE>MyIndicationConsumer</span> consumer1 = new <span class=SpellE><span
2700                 class=GramE>MyIndicationConsumer</span></span><span class=GramE>(</span>&quot;1&quot;);</p>
2701                 
2702                 <p class=MsoNormal style='margin-left:1.0in;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'><span
2703                 class=SpellE><span class=GramE>myListener.addConsumer</span></span><span
2704 kumpf       1.3 class=GramE>(</span>consumer1);</p>
2705                 
2706                 <p class=MsoNormal style='margin-left:1.0in;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'><span
2707                 class=SpellE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>myListener.start</span></span><span
2708                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> ();<o:p></o:p></span></p>
2709 kumpf       1.2 
2710 kumpf       1.3 <p class=MsoNormal style='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'><span
2711                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2712                 style='mso-spacerun:yes'>           </span>} <o:p></o:p></span></p>
2713 kumpf       1.2 
2714 kumpf       1.3 <p class=MsoNormal style='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'><span
2715                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2716                 style='mso-spacerun:yes'>          </span><span class=GramE>catch</span> (<span
2717                 class=SpellE>CIMExecption</span> <span class=SpellE>ce</span>) <o:p></o:p></span></p>
2718 kumpf       1.2 
2719 kumpf       1.3 <p class=MsoNormal style='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'><span
2720                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2721                 style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
2722 kumpf       1.2 
2723 kumpf       1.3 <p class=MsoNormal style='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'><span
2724                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2725                 style='mso-spacerun:yes'>      </span><span
2726                 style='mso-spacerun:yes'>         </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2727                 class=GramE>(</span>“Unable to add consumers: “ + <span class=SpellE>ce.getMessage</span>());<o:p></o:p></span></p>
2728 kumpf       1.2 
2729 kumpf       1.3 <p class=MsoNormal style='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'><span
2730                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2731                 style='mso-spacerun:yes'>         </span>}<span style='mso-spacerun:yes'> 
2732 kumpf       1.2 </span><o:p></o:p></span></p>
2733                 
2734 kumpf       1.3 <p class=MsoNormal style='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'><span
2735                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>}<o:p></o:p></span></p>
2736 kumpf       1.2 
2737                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2738 kumpf       1.3 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
2739 kumpf       1.2 
2740                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2741                 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Operation
2742                 Context Object<o:p></o:p></span></b></p>
2743                 
2744 kumpf       1.3 <p class=MsoNormal style='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;
2745                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2746                 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'> </span><span
2747                 class=SpellE>OperationContext</span> class holds the operation specific
2748                 additional information that will be passed to clients or consumers. It carries
2749                 the information about the context in which the client program issued the
2750                 request.<span style='mso-spacerun:yes'>  </span><span class=SpellE>OperationContext</span>
2751                 holds container objects.<o:p></o:p></span></p>
2752 kumpf       1.1 
2753 kumpf       1.3 <p class=MsoNormal style='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;
2754                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2755                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2756 kumpf       1.1 
2757 kumpf       1.3 <p class=MsoNormal style='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;
2758                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2759                 mso-bidi-font-size:10.0pt'>For example: Listener interface would want to pass
2760                 additional information, such as content language, to consumers. In such case Listener
2761                 would create an Operation Context and add Content Language container into the
2762                 context. The context is passed to consumers.<o:p></o:p></span></p>
2763 kumpf       1.1 
2764 kumpf       1.3 <p class=MsoNormal style='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;
2765                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2766                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2767 kumpf       1.1 
2768 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2769                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2770 kumpf       1.1 
2771 kumpf       1.3 <p class=MsoNormal style='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;
2772                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2773                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2774                 12.0pt;mso-bidi-font-size:10.0pt'>Consumers can then use Context get method to
2775                 the container object.<o:p></o:p></span></p>
2776 kumpf       1.2 
2777 kumpf       1.3 <p class=MsoNormal style='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;
2778                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2779                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2780                 12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p></span></p>
2781 kumpf       1.2 
2782 kumpf       1.3 <p class=MsoNormal style='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;
2783                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2784                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2785                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2786                 </span>// Create Context<o:p></o:p></span></p>
2787 kumpf       1.2 
2788 kumpf       1.3 <p class=MsoNormal style='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;
2789                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2790                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2791                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2792                 class=SpellE>OperationContext</span> <span class=SpellE>myContext</span> = new <span
2793                 class=SpellE><span class=GramE>OperationContext</span></span><span class=GramE>(</span>);<o:p></o:p></span></p>
2794 kumpf       1.2 
2795 kumpf       1.3 <p class=MsoNormal style='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;
2796                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2797                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2798                 12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2799 kumpf       1.2 
2800 kumpf       1.3 <p class=MsoNormal style='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;
2801                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2802                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2803                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2804                 </span>// <span class=GramE>Create</span> a <span class=SpellE>OperationContext</span>
2805                 Container object<o:p></o:p></span></p>
2806 kumpf       1.1 
2807 kumpf       1.3 <p class=MsoNormal style='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;
2808                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2809                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2810                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2811                 class=SpellE>ExampleContextContainer</span> <span class=SpellE>myContainer</span>
2812                 = new <span class=SpellE><span class=GramE>ExampleContextContainer</span></span><span
2813                 class=GramE>(</span>);<o:p></o:p></span></p>
2814 kumpf       1.1 
2815 kumpf       1.3 <p class=MsoNormal style='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;
2816                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2817                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2818                 12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2819 kumpf       1.1 
2820 kumpf       1.3 <p class=MsoNormal style='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;
2821                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2822                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2823                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2824                 </span>//<o:p></o:p></span></p>
2825 kumpf       1.1 
2826 kumpf       1.3 <p class=MsoNormal style='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;
2827                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2828                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2829                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2830                 </span>// insert objects into Context <o:p></o:p></span></p>
2831 kumpf       1.1 
2832 kumpf       1.3 <p class=MsoNormal style='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;
2833                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2834                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2835                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2836                 </span>//<o:p></o:p></span></p>
2837 kumpf       1.1 
2838 kumpf       1.3 <p class=MsoNormal style='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;
2839                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2840                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2841                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2842                 class=SpellE><span class=GramE>myContext.insert</span></span><span class=GramE>(</span>(<span
2843                 class=SpellE>OperationContext</span>)<span class=SpellE>myContainer</span>);<o:p></o:p></span></p>
2844 kumpf       1.1 
2845 kumpf       1.3 <p class=MsoNormal style='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;
2846                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2847                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2848                 12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2849 kumpf       1.1 
2850 kumpf       1.3 <p class=MsoNormal style='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;
2851                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2852                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2853                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2854                 </span>// <o:p></o:p></span></p>
2855 kumpf       1.1 
2856 kumpf       1.3 <p class=MsoNormal style='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;
2857                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2858                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2859                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2860                 </span>// get objects from the Context <o:p></o:p></span></p>
2861 kumpf       1.1 
2862 kumpf       1.3 <p class=MsoNormal style='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;
2863                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2864                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2865                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2866                 </span>//<o:p></o:p></span></p>
2867 kumpf       1.1 
2868 kumpf       1.3 <p class=MsoNormal style='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;
2869                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2870                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2871                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2872                 class=SpellE>ExampleContextContainer</span> <span class=SpellE>clCont</span> =<o:p></o:p></span></p>
2873 kumpf       1.1 
2874 kumpf       1.3 <p class=MsoNormal style='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;
2875                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2876                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2877                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          
2878                 </span>(<span class=SpellE>ExampleContextContainer</span><span class=GramE>)<span
2879                 class=SpellE>myContext.get</span></span>(<span class=SpellE>ExampleContextContainer.NAME</span>);<o:p></o:p></span></p>
2880 kumpf       1.1 
2881 kumpf       1.3 <p class=MsoNormal style='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;
2882                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2883                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2884                 12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2885 kumpf       1.1 
2886 kumpf       1.3 <p class=MsoNormal style='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;
2887                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2888                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2889                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2890                 class=SpellE><span class=GramE>System.out.println</span></span><span
2891                 class=GramE>(</span>&quot;Got back :&quot; + <span class=SpellE>clCont.getName</span>());<o:p></o:p></span></p>
2892 kumpf       1.2 
2893                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2894                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2895                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>}<o:p></o:p></span></p>
2896                 
2897                 </div>
2898                 
2899                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2900 kumpf       1.3 none'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2901 kumpf       1.2 
2902 kumpf       1.3 <h6><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman"'><o:p>&nbsp;</o:p></span></h6>
2903 kumpf       1.2 
2904                 <h6><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman"'>Example
2905 kumpf       1.3 <span class=SpellE>OperationContext</span> Container<o:p></o:p></span></h6>
2906 kumpf       1.2 
2907 kumpf       1.3 <p class=MsoNormal style='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;
2908                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2909                 mso-bidi-font-size:10.0pt'>The <span class=SpellE>ExampleContextContainer</span>
2910 kumpf       1.2 object carries the request context information that consumer may access. <o:p></o:p></span></p>
2911                 
2912 kumpf       1.3 <p class=MsoNormal style='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;
2913                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2914                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2915 kumpf       1.2 
2916 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2917                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2918 kumpf       1.1 
2919 kumpf       1.3 <p class=MsoNormal style='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;
2920                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2921                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span class=GramE><span
2922                 style='font-family:"Courier New"'>public</span></span><span style='font-family:
2923                 "Courier New"'> class <span class=SpellE>ExampleContextContainer</span>
2924                 implements <span class=SpellE>OperationContextContainer</span><o:p></o:p></span></p>
2925 kumpf       1.1 
2926 kumpf       1.3 <p class=MsoNormal style='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;
2927                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2928                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2929                 "Courier New"'>{<o:p></o:p></span></p>
2930 kumpf       1.1 
2931 kumpf       1.3 <p class=MsoNormal style='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;
2932                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2933                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2934                 "Courier New"'><span style='mso-spacerun:yes'>    </span>/** Container name of this
2935                 container */<o:p></o:p></span></p>
2936 kumpf       1.1 
2937 kumpf       1.3 <p class=MsoNormal style='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;
2938                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2939                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2940                 "Courier New"'><span style='mso-spacerun:yes'>    </span><span class=GramE>public</span>
2941                 static final String NAME=&quot;<span class=SpellE>ExampleContextContainer</span>&quot;;<o:p></o:p></span></p>
2942 kumpf       1.1 
2943 kumpf       1.3 <p class=MsoNormal style='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;
2944                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2945                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2946                 "Courier New"'><span style='mso-spacerun:yes'>    </span><span class=GramE>public</span>
2947                 <span class=SpellE>ExampleContextContainer</span>() { }<o:p></o:p></span></p>
2948 kumpf       1.1 
2949 kumpf       1.3 <p class=MsoNormal style='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;
2950                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2951                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2952                 "Courier New"'><o:p>&nbsp;</o:p></span></p>
2953 kumpf       1.1 
2954 kumpf       1.3 <p class=MsoNormal style='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;
2955                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2956                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2957                 "Courier New"'><span style='mso-spacerun:yes'>    </span><span class=GramE>public</span>
2958                 String <span class=SpellE>getName</span>()<o:p></o:p></span></p>
2959 kumpf       1.1 
2960 kumpf       1.3 <p class=MsoNormal style='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;
2961                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2962                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2963                 "Courier New"'><span style='mso-spacerun:yes'>    </span>{<o:p></o:p></span></p>
2964 kumpf       1.1 
2965 kumpf       1.3 <p class=MsoNormal style='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;
2966                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2967                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2968                 "Courier New"'><span style='mso-spacerun:yes'>        </span><span class=GramE>return(</span>NAME);<o:p></o:p></span></p>
2969 kumpf       1.1 
2970 kumpf       1.3 <p class=MsoNormal style='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;
2971                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2972                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2973                 "Courier New"'><span style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2974 kumpf       1.1 
2975 kumpf       1.3 <p class=MsoNormal style='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;
2976                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2977                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2978                 "Courier New"'><span style='mso-spacerun:yes'>    </span><span class=GramE>public</span>
2979                 Object clone()<o:p></o:p></span></p>
2980 kumpf       1.1 
2981 kumpf       1.3 <p class=MsoNormal style='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;
2982                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2983                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2984                 "Courier New"'><span style='mso-spacerun:yes'>    </span>{<o:p></o:p></span></p>
2985 kumpf       1.1 
2986 kumpf       1.3 <p class=MsoNormal style='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;
2987                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2988                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2989                 "Courier New"'><span style='mso-spacerun:yes'>       </span><span class=GramE>return</span>
2990                 ((Object)new <span class=SpellE>ExampleContextContainer</span>());<o:p></o:p></span></p>
2991 kumpf       1.1 
2992 kumpf       1.3 <p class=MsoNormal style='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;
2993                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2994                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2995                 "Courier New"'><span style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2996 kumpf       1.1 
2997 kumpf       1.3 <p class=MsoNormal style='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;
2998                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2999                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
3000                 "Courier New"'>};</span><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p></o:p></span></p>
3001 kumpf       1.2 
3002 kumpf       1.1 </div>
3003                 
3004 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3005 kumpf       1.3 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3006 kumpf       1.2 
3007                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3008 kumpf       1.3 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3009 kumpf       1.2 
3010                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3011 kumpf       1.3 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3012 kumpf       1.1 
3013 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3014                 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>SSL Support
3015                 with CIM Listener<o:p></o:p></span></b></p>
3016                 
3017                 <p style='tab-stops:.5in'>The CIM Listener interface supports SSL for secure
3018                 communication. The CIM Listener (a Server) can accept either http or https
3019                 connections from the system delivering indications (an Indication Client). The
3020                 Listener applications (Indication Consumers) using the CIM Listener API would
3021                 require to have a server certificate and private key in order to support SSL
3022                 enabled communication with the Indication clients. The Listener applications
3023                 can write their own X509 Trust Manager where they can do additional validations
3024 kumpf       1.3 like host name verification. However the CIM Listener API provides a default
3025                 X509 Trust Manager that does not do any additional validations.</p>
3026 kumpf       1.2 
3027 kumpf       1.3 <p style='tab-stops:.5in'>The CIM Listener running as <span class=GramE>server,</span>
3028                 does client authentication by requesting the Indication Client to send its
3029                 certificate for authentication. Hence the Indication Client (e.g., CIM Server)
3030                 trying to connect to the CIM Listener using https connection must have its own
3031 kumpf       1.2 certificate. </p>
3032                 
3033 kumpf       1.3 <h4 style='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'>Creating
3034                 subscription</h4>
3035 kumpf       1.2 
3036 kumpf       1.3 <p class=MsoNormal style='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'><b><span
3037                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
3038 kumpf       1.2 
3039 kumpf       1.3 <p class=MsoNormal style='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'><span
3040                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Creating subscription is
3041                 same as creating any CIM instance...you will use CIM Client interfaces to do
3042                 so. Currently WBEM (core <span class=SpellE>CIMServer</span>)<span class=GramE>&nbsp;
3043                 only</span> supports <span class=SpellE>CIM_IndicationSubscription</span>,&nbsp;<span
3044                 class=SpellE>CIM_IndicationFilter</span>, <span class=SpellE>CIM_IndicationHandlerCIMXML</span>
3045                 and <span class=SpellE>IndicationHandlerSNMPMapper</span> classes. </span><span
3046 kumpf       1.2 style='font-family:"Courier New"'><o:p></o:p></span></p>
3047 kumpf       1.1 
3048 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3049 kumpf       1.3 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
3050 kumpf       1.1 
3051 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3052 kumpf       1.3 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
3053 kumpf       1.1 
3054 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
3055 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='font-family:"Courier New";
3056                 mso-fareast-font-family:"Courier New"'><span style='mso-list:Ignore'>7.<span
3057                 style='font:7.0pt "Times New Roman"'>&nbsp; </span></span></span><![endif]>Troubleshooting
3058 kumpf       1.1 and CIM Exceptions<span style='font-family:"Courier New"'><o:p></o:p></span></h2>
3059                 
3060 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>In addition to the standard CIM
3061                 Exceptions sent by the CIM Server to the client, the CIM Client library
3062                 generates the following exceptions. The exception generated by the client
3063                 library along with the reason and solution is explained below:</p>
3064 kumpf       1.1 
3065 kumpf       1.2 <p style='tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED
3066 kumpf       1.3 (Unable to Initialize Specified <span class=SpellE>TrustManager</span>: <a
3067 kumpf       1.1 href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span
3068                 style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</span></a>)<o:p></o:p></b></p>
3069                 
3070 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3071 kumpf       1.1 
3072 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3073 kumpf       1.3 indicates that the specified <span class=SpellE>TrustManager</span> may not
3074                 exist, may contain invalid path, or it may not have required permission to
3075                 load.</p>
3076 kumpf       1.1 
3077 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3078 kumpf       1.1 
3079 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Make sure that
3080 kumpf       1.3 the <span class=SpellE>TrustManager</span> you have specified exist and has
3081                 correct path and right permissions. Also make sure that the <span class=SpellE>TrustManager</span>
3082                 is not set to “null”. </p>
3083 kumpf       1.1 
3084 kumpf       1.3 <p style='tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_<span
3085                 class=GramE>FAILED(</span>SSL Factory Initialization failed: <a
3086 kumpf       1.2 href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span
3087 kumpf       1.1 style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</span></a>)<o:p></o:p></b></p>
3088                 
3089 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3090 kumpf       1.1 
3091 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3092                 may happen in number different scenarios. Such as, unable to find JSSE
3093                 providers, unable to generate random seed, unable to connect to correct server,
3094                 server had problem with SSL handshake, or policy permissions are incorrect.</p>
3095 kumpf       1.1 
3096 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3097 kumpf       1.1 
3098 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Follow JSSE
3099                 specification and make sure the system java configurations are setup correctly.</p>
3100 kumpf       1.1 
3101 kumpf       1.3 <p style='text-align:justify;tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_HTTP_<span
3102                 class=GramE>ERROR(</span>Couldn't find trusted certificate, response=500)<o:p></o:p></b></p>
3103 kumpf       1.1 
3104 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3105 kumpf       1.1 
3106 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3107                 may happen because of SSL handshake failure. SSL handshake may fail because the
3108 kumpf       1.1 certificate sent by the server was an invalid certificate or the certificate is
3109                 not in clients Trust store.</p>
3110                 
3111 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3112 kumpf       1.1 
3113 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Either add this
3114                 certificate to client Trust store or handle the certificate appropriately in
3115                 the Certificate Manager.</p>
3116 kumpf       1.1 
3117 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><b>Exception:
3118                 CIMCLIENT_ERR_TIMED_OUT (Request Timeout)<o:p></o:p></b></p>
3119 kumpf       1.1 
3120 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3121 kumpf       1.1 
3122 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3123                 indicates that a timeout has occurred on a socket read. This could mean the
3124                 server or provider may be slow in responding to client request, or the client
3125                 time out is small.</p>
3126 kumpf       1.1 
3127 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3128 kumpf       1.1 
3129 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Consider trying
3130                 this operation at some other time or might want to set client timeout or
3131 kumpf       1.3 increase the client timeout. Refer to <span class=SpellE>CIMClient</span> API
3132                 java documentation for how to set client timeout.</p>
3133 kumpf       1.1 
3134 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><b>Exception:
3135 kumpf       1.3 CIMCLIENT_ERR_CONNECTION_<span class=GramE>FAILED(</span>Connection refused) <o:p></o:p></b></p>
3136 kumpf       1.1 
3137 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3138 kumpf       1.1 
3139 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3140 kumpf       1.3 indicates that an error occurred while attempting to connect to <span
3141                 class=SpellE>CIMServer</span> on a port. The <span class=SpellE>CIMServer</span>
3142                 may not be running on the specified address or it may not be listening on the
3143                 specified port.</p>
3144 kumpf       1.2 
3145                 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3146                 
3147                 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Check to make
3148                 sure that the server address is correct and the port number specified is the
3149 kumpf       1.3 correct port number for an SSL or non-SSL communication. (e.g., <span
3150                 class=GramE>This</span> exception may be thrown if the <span class=SpellE>CIMServer</span>
3151                 is SSL enabled and listening on port 5989, the client trying to connect to
3152                 non-SSL port 5988.)</p>
3153 kumpf       1.1 
3154 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><b>Exception:
3155 kumpf       1.3 CIMCLIENT_ERR_CONNECTION_<span class=GramE>FAILED(</span>sequoia Unknown host) <o:p></o:p></b></p>
3156 kumpf       1.1 
3157 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: This exception indicates
3158 kumpf       1.3 that the <span class=SpellE>CIMServer</span> address specified may contain an
3159                 invalid system name or the system is not reachable.</p>
3160 kumpf       1.2 
3161                 <p style='text-align:justify;tab-stops:.5in'>Solution:<span
3162 kumpf       1.3 style='mso-spacerun:yes'>  </span>Make sure the specified <span class=SpellE>CIMServer</span>
3163                 address is correct and the remote system is reachable.</p>
3164 kumpf       1.2 
3165                 <h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:
3166                 italic'>&nbsp;<o:p></o:p></span></h2>
3167                 
3168                 <i style='mso-bidi-font-style:normal'><span style='font-size:12.0pt;mso-bidi-font-size:
3169                 10.0pt;font-family:Arial;mso-fareast-font-family:"Times New Roman";mso-ansi-language:
3170                 EN-US;mso-fareast-language:EN-US;mso-bidi-language:AR-SA'><br clear=all
3171                 style='page-break-before:always'>
3172                 </span></i>
3173                 
3174                 <h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:
3175 kumpf       1.3 italic'>Appendix A:<span style='mso-spacerun:yes'>  </span>CIM Client FAQ<o:p></o:p></span></h2>
3176 kumpf       1.2 
3177 kumpf       1.3 <p class=MsoNormal style='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;
3178                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3179                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3180 kumpf       1.2 
3181 kumpf       1.3 <p class=MsoBodyText style='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;
3182                 text-autospace:none'><span class=SpellE><span class=GramE><span
3183                 style='font-family:"Courier New"'>CIMInstance.getKeyValuePairs</span></span></span><span
3184                 class=GramE><span style='font-family:"Courier New"'>(</span></span><span
3185                 style='font-family:"Courier New"'>) returns no keys although there are multiple
3186                 keys in my (<span class=SpellE>exaple</span> <span class=SpellE>PG_OperatingSystem</span>
3187                 has 4 keys) provider.<o:p></o:p></span></p>
3188 kumpf       1.2 
3189 kumpf       1.3 <p class=MsoNormal style='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;
3190                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3191 kumpf       1.2 
3192 kumpf       1.3 <p class=MsoNormal style='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;
3193                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>This
3194                 bug is fixed in 2.0 Final Release. <o:p></o:p></span></p>
3195 kumpf       1.2 
3196 kumpf       1.3 <p class=MsoNormal style='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;
3197                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3198 kumpf       1.2 
3199 kumpf       1.3 <p class=MsoNormal style='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'><b><span
3200                 style='font-family:"Courier New"'>I see my client hangs and does not return or
3201                 how to set timeouts in a Client?<o:p></o:p></span></b></p>
3202 kumpf       1.2 
3203 kumpf       1.3 <p class=MsoNormal style='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;
3204                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3205 kumpf       1.2 
3206 kumpf       1.3 <p class=MsoNormal style='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;
3207                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>When
3208                 you have a SSL enabled client trying to connect non-SSL <span class=SpellE>CIMServer</span>
3209                 and vice-versa. You may notice that the client does not return. In such case
3210                 you should make sure to set the proper timeouts.<o:p></o:p></span></p>
3211 kumpf       1.2 
3212 kumpf       1.3 <p class=MsoNormal style='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;
3213                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3214 kumpf       1.2 
3215 kumpf       1.3 <p class=MsoNormal style='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;
3216                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>Here
3217                 is how you can set the timeouts:<o:p></o:p></span></p>
3218 kumpf       1.2 
3219 kumpf       1.3 <p class=MsoNormal style='text-indent:.5in;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;
3220                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>1.
3221                 Set READ timeout, refer to <span class=SpellE>CIMClient</span> class<o:p></o:p></span></p>
3222 kumpf       1.2 
3223                 <h3 style='margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt;margin-left:
3224 kumpf       1.3 0in;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;
3225                 mso-layout-grid-align:none;text-autospace:none'><span style='mso-bidi-font-size:
3226                 12.0pt;font-family:"Times New Roman"'><span style='mso-spacerun:yes'>   </span><span
3227                 style='mso-tab-count:1'>            </span><span style='mso-tab-count:1'>               </span><span
3228                 class=SpellE><span class=GramE>CIMClient.setTimeout</span></span><span
3229                 class=GramE>(</span><span class=SpellE>int</span> timeout); //in milliseconds<o:p></o:p></span></h3>
3230 kumpf       1.2 
3231 kumpf       1.3 <p class=MsoNormal style='margin-left:.5in;text-indent:.5in;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'><span
3232 kumpf       1.2 style='font-family:"Courier New"'>This is a read timeout, i.e. the client has
3233                 found the server and connected to it, and the server is not responding to any
3234                 request. Basically the socket is blocked. This may happen in case of a Non-SSL
3235                 client connecting to SSL server and also vice versa. For your applications I
3236 kumpf       1.3 think <span class=SpellE><span class=GramE>setTimeout</span></span><span
3237                 class=GramE>(</span>) call is good enough.<o:p></o:p></span></p>
3238                 
3239                 <p class=MsoNormal style='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'><o:p>&nbsp;</o:p></p>
3240                 
3241                 <p class=MsoNormal style='text-indent:.5in;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;
3242                 mso-layout-grid-align:none;text-autospace:none'>2.<span style='font-family:
3243                 "Courier New"'> To set the connection timeout<o:p></o:p></span></p>
3244                 
3245                 <p class=MsoNormal style='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;
3246                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><span
3247                 style='mso-spacerun:yes'>    </span><span style='mso-tab-count:2'>           </span>//Assumption
3248                 timeout is in seconds<o:p></o:p></span></p>
3249                 
3250                 <pre style='text-indent:.5in;mso-layout-grid-align:none;text-autospace:none'><span
3251                 style='mso-fareast-font-family:"Times New Roman"'><span style='mso-spacerun:yes'> </span>Either you add the following line in your client program<o:p></o:p></span></pre>
3252                 
3253                 <p class=MsoNormal style='margin-left:.5in;text-indent:.5in;tab-stops:.5in;
3254                 mso-layout-grid-align:none;text-autospace:none'><span class=SpellE><span
3255                 class=GramE><span style='font-family:"Courier New"'>System.setProperty</span></span></span><span
3256                 class=GramE><span style='font-family:"Courier New"'>(</span></span><span
3257 kumpf       1.3 style='font-family:"Courier New"'>&quot;java.net.connectiontimeout&quot;,&quot;20&quot;)
3258                 <o:p></o:p></span></p>
3259                 
3260                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3261                 none'><span style='font-family:"Courier New"'><span
3262                 style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'>     </span>Or<o:p></o:p></span></p>
3263 kumpf       1.2 
3264 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3265                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'> 
3266                 </span><span style='mso-tab-count:1'>    </span>You can pass it at run time,
3267                 using<o:p></o:p></span></p>
3268 kumpf       1.2 
3269 kumpf       1.3 <p class=MsoNormal style='margin-left:.5in;tab-stops:.5in;mso-layout-grid-align:
3270                 none;text-autospace:none'><span style='font-family:"Courier New"'><span
3271                 style='mso-spacerun:yes'>     </span><span class=GramE>java</span> -<span
3272                 class=SpellE>Djava.net.connectiontimeout</span>=20<span
3273                 style='mso-spacerun:yes'>  </span><span class=SpellE>myclient</span><o:p></o:p></span></p>
3274 kumpf       1.2 
3275 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3276                 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3277 kumpf       1.2 
3278 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><o:p>&nbsp;</o:p></p>
3279 kumpf       1.2 
3280 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><b><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3281 kumpf       1.2 
3282 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><b><span style='font-family:"Courier New"'>How
3283                 </span></b><b><span style='font-family:Arial'>to decode a property that is an enumeration?
3284                 I.E. to decode the numeric value that is returned for the property.<span
3285                 style='mso-spacerun:yes'>  </span>Does WBEM provide methods to look up the
3286                 numeric value to retrieve a String value?<span style='mso-spacerun:yes'> 
3287 kumpf       1.2 </span>Or do I need to implement a look up table for every enumeration that I
3288                 am interested in?<o:p></o:p></span></b></p>
3289                 
3290 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><span style='font-family:Arial'>&nbsp;<o:p></o:p></span></p>
3291 kumpf       1.2 
3292 kumpf       1.3 <pre style='mso-layout-grid-align:none;text-autospace:none'><span
3293                 style='mso-fareast-font-family:"Times New Roman"'>The strings associated with enumeration property values are defined as </span>qualifiers on the class schema.<span style='mso-spacerun:yes'>  </span>A client does not get these strings from a provider directly.<span style='mso-spacerun:yes'>  </span>But rather than duplicate the string definitions on the client side, you can get them from the CIM server using a <span
3294                 class=SpellE>getClass</span> operation.</pre>
3295 kumpf       1.2 
3296 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3297                 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3298 kumpf       1.2 
3299 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3300                 none'><span style='font-family:"Courier New"'>For example, <span class=SpellE>PG_NISServerService</span><span
3301                 class=GramE>::</span> <span class=SpellE>ServerType</span> is an
3302                 enumeration.<span style='mso-spacerun:yes'>  </span>When I make the request I
3303                 get a numeric value between 0 and 4 (inclusive).<span
3304                 style='mso-spacerun:yes'>  </span>I then have to decode the numeric values as
3305 kumpf       1.2 such:<o:p></o:p></span></p>
3306                 
3307 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3308                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3309 kumpf       1.2 </span>&quot;0&quot; - Unknown<o:p></o:p></span></p>
3310                 
3311 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3312                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3313 kumpf       1.2 </span>&quot;1&quot; - Other<o:p></o:p></span></p>
3314 kumpf       1.1 
3315 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3316                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3317                 </span>&quot;2&quot; - Not an </span><st1:City><st1:place><span
3318                   style='font-family:"Courier New"'>NIS</span></st1:place></st1:City><span
3319                 style='font-family:"Courier New"'> Server<o:p></o:p></span></p>
3320 kumpf       1.1 
3321 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3322                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3323 kumpf       1.2 </span>&quot;3&quot; - NIS Master<o:p></o:p></span></p>
3324 kumpf       1.1 
3325 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3326                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3327                 </span>&quot;4&quot; - </span><st1:City><st1:place><span style='font-family:
3328                   "Courier New"'>NIS</span></st1:place></st1:City><span style='font-family:
3329                 "Courier New"'> Slave<o:p></o:p></span></p>
3330                 
3331                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3332                 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3333                 
3334                 <p style='text-align:justify;tab-stops:.5in'><b>The <span class=SpellE>cimclient</span>
3335                 library performs the SSL handshaking and receives the certificate/key, what
3336                 environment settings must be in place for certificates to be passed?<o:p></o:p></b></p>
3337 kumpf       1.2 
3338                 <p style='text-align:justify;tab-stops:.5in'>Clients must create a trust store,
3339                 import certificates from the server they trust in to the trust store, provide
3340 kumpf       1.3 the trust store path to the JSSE either on the command line ( java -<span
3341                 class=SpellE>Djavax.net.ssl.trustStore</span>=<span class=SpellE>mytruststore</span>
3342                 &lt;<span class=SpellE>MyClient</span>&gt;<span style='mso-spacerun:yes'> 
3343                 </span>) or through</p>
3344                 
3345                 <p style='text-align:justify;tab-stops:.5in'><span class=SpellE><span
3346                 class=GramE>System.setProperty</span></span><span class=GramE>(</span>&quot;<span
3347                 class=SpellE>javax.net.trustStore</span>&quot;, &quot;<span class=SpellE>mytruststore</span>&quot;);</p>
3348                 
3349                 <p style='text-align:justify;tab-stops:.5in'><b>How do set ‘<span class=SpellE>trustManager</span>’
3350                 property </b><b><span style='font-size:10.0pt;font-family:Arial'>programmatically?<o:p></o:p></span></b></p>
3351                 
3352                 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3353                 mso-bidi-font-size:10.0pt'><span style='mso-tab-count:1'>            </span>String
3354                 <span class=SpellE>myTrustManager</span>= &quot;<span class=SpellE>org.mycompany.cimapp.myCertManager</span>&quot;;<o:p></o:p></span></p>
3355                 
3356                 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3357                 mso-bidi-font-size:10.0pt'><span style='mso-tab-count:1'>            </span><span
3358                 class=SpellE><span class=GramE>GlobalConfig.setTrustManager</span></span><span
3359                 class=GramE>(</span><span class=SpellE>myTrustManager</span>);<o:p></o:p></span></p>
3360 kumpf       1.1 
3361 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3362                 mso-bidi-font-size:10.0pt'>Note that you can not set this property to ‘null’. If
3363                 you would like to use the default trust manager provided in JSSE, do not even
3364                 define the trust manager property in your program or in your properties file.<o:p></o:p></span></p>
3365 kumpf       1.1 
3366 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3367                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
3368 kumpf       1.1 
3369 kumpf       1.3 <h4 style='tab-stops:.5in'>Can I change the trust manager property in between
3370                 my program/process?</h4>
3371 kumpf       1.2 
3372 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><b><span style='font-size:12.0pt;
3373                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
3374 kumpf       1.1 
3375 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3376                 mso-bidi-font-size:10.0pt'>No, you cannot. If you define/set this property in
3377                 your Client application either using <span class=SpellE><span class=GramE>setTrustManager</span></span><span
3378                 class=GramE>(</span>) or through<span style='mso-spacerun:yes'>  </span>WBEM
3379                 Client configuration file (like <span class=SpellE>cim.properties</span>) it
3380                 will be set once per process, I.E you can not set/unset for every connection
3381                 being in the same process.<o:p></o:p></span></p>
3382                 
3383                 <p style='text-align:justify;tab-stops:.5in'><b>Does the <span class=SpellE>cimclient</span>
3384                 library accept the certificate and place it in the trust store?<span
3385                 style='mso-spacerun:yes'>  </span>How would the application specify to the <span
3386                 class=SpellE>cimclient</span> library where the trust store is<o:p></o:p></b></p>
3387 kumpf       1.1 
3388 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Client library using JSSE will
3389                 only validate the server certificate using the trust store. It accepts only
3390                 trusted certificates from the server. In case of non-trusted certificate the
3391                 client library will call the trust manager if there is one specified. It is the
3392                 job of trust manager to either accept the server certificate (possibly add that
3393                 to the trust store) or reject the certificate.</p>
3394 kumpf       1.1 
3395 kumpf       1.3 <p style='text-align:justify;tab-stops:.5in'><b>How <span class=GramE>is the
3396                 client application</span> notified that the certificate or key was placed in
3397                 the trust store?<span style='mso-spacerun:yes'>  </span>Is this assumed?<o:p></o:p></b></p>
3398 kumpf       1.1 
3399 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Same as above</p>
3400                 
3401                 <p style='text-align:justify;tab-stops:.5in'><b>Can the client application set
3402                 the environment so that certificates or keys are required from some target
3403                 systems but other target systems are not validated or authenticated?<o:p></o:p></b></p>
3404                 
3405                 <p style='text-align:justify;tab-stops:.5in'>Yes, trust manager can do this.</p>
3406                 
3407                 <p style='text-align:justify;tab-stops:.5in'><b>Where can I find more
3408                 information on Trust Manager and Trust Stores?<o:p></o:p></b></p>
3409                 
3410                 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>More information
3411 kumpf       1.3 can be found at J2SE web site.<span style='mso-spacerun:yes'>  </span>- ----</p>
3412 kumpf       1.2 
3413                 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'><span
3414                 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>
3415                 
3416                 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>http://java.sun.com/j2se/1.4/docs/api/javax/net/ssl/X509TrustManager.html
3417 kumpf       1.1 </p>
3418                 
3419 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><b>I am unable use/initialize SSL
3420                 connection, what do I do?<o:p></o:p></b></p>
3421 kumpf       1.1 
3422 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><span style='mso-bidi-font-family:
3423                 "Courier New"'>Some applications have their own version of Java included in it
3424                 and they use the included Java, not the one you installed on the systems (such
3425                 as the one from /opt/java). In such cases make sure that java security
3426                 configuration files are not modified.</span></p>
3427                 
3428 kumpf       1.3 <p style='text-align:justify;tab-stops:.5in'><b>How can I find out <span
3429                 class=SpellE>cimclient.jar</span> version?<o:p></o:p></b></p>
3430 kumpf       1.2 
3431 kumpf       1.3 <pre>You can run <span class=SpellE>PackageVersion</span> program to look at the version.</pre><pre><span style='mso-spacerun:yes'>     </span><span
3432                 class=GramE>java</span> <span class=SpellE>org.snia.wbem.PackageVersion</span></pre><pre><span style='mso-spacerun:yes'>   </span></pre>
3433 kumpf       1.2 
3434                 <p style='text-align:justify;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'><b>My
3435                 GUI application doesn’t work properly on HP-UX?</b></p>
3436                 
3437                 <p style='text-align:justify;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'>There
3438 kumpf       1.3 is a bug in Java 1.4 HP-UX version (and 1.3) AWT libraries. For this you will need
3439                 to install PHSS_24303 patch. I also found that Patch PHSS_24303 replaced by
3440                 PHSS_26262. So we will need PHSS_26262.</p>
3441                 
3442                 <p class=MsoBodyText style='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;
3443                 text-autospace:none'><span class=SpellE><span class=GramE><span
3444                 style='font-family:"Courier New"'>CIMInstance.getKeyValuePairs</span></span></span><span
3445                 class=GramE><span style='font-family:"Courier New"'>(</span></span><span
3446                 style='font-family:"Courier New"'>) returns no keys although there are multiple
3447                 keys in my (<span class=SpellE>exaple</span> <span class=SpellE>PG_OperatingSystem</span>
3448                 has 4 keys) provider.<o:p></o:p></span></p>
3449                 
3450                 <p class=MsoNormal style='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;
3451                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3452                 
3453                 <p class=MsoNormal style='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;
3454                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>This
3455                 bug is fixed in 2.0 Final Release.<span style='mso-spacerun:yes'>  </span>You
3456                 should not see this bug.<o:p></o:p></span></p>
3457 kumpf       1.1 
3458 kumpf       1.3 <p style='text-align:justify;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'><o:p>&nbsp;</o:p></p>
3459 kumpf       1.1 
3460 kumpf       1.2 <h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:
3461                 italic'>Appendix B: CIM Listener FAQ<o:p></o:p></span></h2>
3462 kumpf       1.1 
3463 kumpf       1.3 <p class=MsoNormal style='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;
3464                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3465                 "Courier New"'>Question 1: How to Create Subscriptions?</span></b><span
3466 kumpf       1.2 style='font-family:"Courier New"'><o:p></o:p></span></p>
3467 kumpf       1.1 
3468 kumpf       1.3 <p style='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'><span
3469                 style='font-size:10.0pt;font-family:"Courier New"'>Creating subscription is
3470                 same as creating any CIM instance...you will use CIM Client interfaces to do
3471                 so. Currently WBEM (core <span class=SpellE>CIMServer</span>)
3472                 only&nbsp;supports <span class=SpellE>CIM_IndicationSubscription</span>,&nbsp;<span
3473                 class=SpellE>CIM_IndicationFilter</span>, <span class=SpellE><span class=GramE>CIM</span>_IndicationHandlerCIMXML</span>
3474                 and </span><span class=SpellE>IndicationHandlerSNMPMapper</span><span
3475 kumpf       1.2 style='font-size:10.0pt;font-family:"Courier New"'> classes.<o:p></o:p></span></p>
3476                 
3477 kumpf       1.3 <p style='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'><b><span
3478                 style='font-size:10.0pt;font-family:"Courier New"'>Question 2:<span
3479                 style='mso-spacerun:yes'>  </span>When a listener is created, does it execute
3480 kumpf       1.2 in its own thread, separate from the code that created it</span></b><span
3481                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
3482                 
3483 kumpf       1.3 <p class=MsoNormal style='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'><span
3484                 style='font-family:"Courier New"'>Listener runs as&nbsp;server (either SSL or
3485                 non-SSL) and listens on the specified port. When&nbsp;Listener <span
3486                 class=SpellE><span class=GramE>startCIMHTTPListener</span></span><span
3487                 class=GramE>(</span>) is called, it will create a thread and starts listening.<br>
3488 kumpf       1.2 &nbsp;<o:p></o:p></span></p>
3489 kumpf       1.1 
3490 kumpf       1.3 <p style='margin:0in;margin-bottom:.0001pt;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'><span
3491                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3492                 
3493                 <p class=MsoNormal style='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;
3494                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3495                 "Courier New"'>Question 3:</span></b><span style='font-family:"Courier New"'> <b>I
3496                 am unable to modify instances of <span class=SpellE>CIM_IndicationHandlerCIMXML</span>
3497                 class.<span style='mso-spacerun:yes'>  </span>Client says - Unable to modify
3498                 instance: CIM_ERR_NOT_<span class=GramE>FOUND(</span>CIM_ERR_NOT_FOUND: The
3499                 requested object could not be found: &quot;<span class=SpellE>CIM_IndicationHandlerCIMXML</span>&quot;)<o:p></o:p></b></span></p>
3500                 
3501                 <p class=MsoNormal style='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;
3502                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3503                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3504                 
3505                 <p class=MsoNormal style='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;
3506                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>The
3507                 <span class=SpellE>modifyInstance</span> operation is not supported for the<o:p></o:p></span></p>
3508                 
3509                 <p class=MsoNormal style='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;
3510                 mso-layout-grid-align:none;text-autospace:none'><span class=SpellE><span
3511 kumpf       1.3 style='font-family:"Courier New"'>CIM_IndicationHandlerCIMXML</span></span><span
3512                 style='font-family:"Courier New"'> class or <span class=SpellE>CIM_IndicationFilter</span>
3513                 class, and <span class=GramE>for<span style='mso-spacerun:yes'>  </span><span
3514                 class=SpellE>CIM</span></span><span class=SpellE>_IndicationSubscription</span>,
3515                 only modification of the <span class=SpellE>SubscriptionState</span>
3516                 property<span style='mso-spacerun:yes'>  </span>is supported.<span
3517                 style='mso-spacerun:yes'>  </span>So, it's necessary to delete the old instance
3518                 and create a new instance with the desired change.<span
3519                 style='mso-spacerun:yes'>  </span>Also, deletion of a filter or handler that is
3520                 referenced by an existing subscription is not allowed, without first<o:p></o:p></span></p>
3521                 
3522                 <p class=MsoNormal style='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;
3523                 mso-layout-grid-align:none;text-autospace:none'><span class=GramE><span
3524                 style='font-family:"Courier New"'>deleting</span></span><span style='font-family:
3525                 "Courier New"'> the subscription.<o:p></o:p></span></p>
3526                 
3527                 <p class=MsoNormal style='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;
3528                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3529                 
3530                 <p class=MsoNormal style='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;
3531                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>However,
3532 kumpf       1.3 in the case you should see something like &quot;CIM_ERR_NOT_SUPPORTED: The requested
3533                 operation is not supported&quot;, rather than CIM_ERR_NOT_FOUND.<span
3534                 style='mso-spacerun:yes'>  </span>Make sure to check that your request
3535                 specifies <span class=GramE>the<span style='mso-spacerun:yes'>  </span>correct</span>
3536                 namespace, key values, etc.<span style='mso-spacerun:yes'>  </span>It looks
3537                 like perhaps the <span class=SpellE>instancename</span> parameter to the <span
3538                 class=SpellE>modifyInstance</span> operation included only the <span
3539                 class=SpellE>classname</span> and not the key values.<o:p></o:p></span></p>
3540                 
3541                 <p class=MsoNormal style='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;
3542                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3543                 
3544                 <p class=MsoNormal style='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;
3545                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3546                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3547                 
3548                 <p class=MsoBodyText2 style='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'><b>Question
3549                 4: If I create instances of <span class=SpellE>CIM_IndicationFilter</span>, and
3550                 corresponding instances of <span class=SpellE>CIM_IndicationSubscription</span>,
3551                 and <span class=SpellE>CIM_IndicationHandlerCIMXML</span> classes, does the
3552                 CIMOM check for the presence of the Indication provider? <span class=GramE>if</span>
3553 kumpf       1.3 '<span class=SpellE>RT_TestIndication</span>'(sample indication provider) is
3554                 not present, Will it give an error response?<o:p></o:p></b></p>
3555                 
3556                 <p class=MsoNormal style='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;
3557                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3558 kumpf       1.2 
3559 kumpf       1.3 <p class=MsoNormal style='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;
3560                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>When
3561                 you create an enabled Subscription, the <span class=SpellE>IndicationService</span>
3562                 will look for indication providers that can serve the subscription.<span
3563                 style='mso-spacerun:yes'>  </span>If none are found, you will get an error
3564                 response.<span style='mso-spacerun:yes'>  </span>The subscriber doesn't specify
3565                 an indication provider. The subscriber specifies the desired indication
3566                 subclass, properties and namespace in the Filter.<span
3567                 style='mso-spacerun:yes'>   </span>The <span class=SpellE>IndicationService</span>
3568                 looks for indication providers that have registered to serve the specified
3569                 indication class in the specified namespace.<span style='mso-spacerun:yes'> 
3570                 </span>Maybe your indication provider is not registered?<span
3571                 style='mso-spacerun:yes'>  </span>Let me know if you need help registering your
3572                 indication provider.<o:p></o:p></span></p>
3573 kumpf       1.2 
3574 kumpf       1.3 <p class=MsoNormal style='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;
3575                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3576 kumpf       1.2 
3577 kumpf       1.3 <p class=MsoBodyText2 style='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'><b>Question
3578                 5: If I create a disabled subscription (the property <span class=SpellE>SubscriptionState</span>
3579                 is set to 'Disabled'), will the <span class=SpellE>IndicationService</span>
3580 kumpf       1.2 still check for the presence of the indication provider?<o:p></o:p></b></p>
3581                 
3582 kumpf       1.3 <p class=MsoNormal style='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;
3583                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3584                 
3585                 <p class=MsoBodyText style='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'><span
3586                 style='font-weight:normal'>If you create the Subscription with <span
3587                 class=SpellE>SubscriptionState</span> property set to 'Disabled', the <span
3588                 class=SpellE>IndicationService</span> will NOT check whether there is an
3589                 indication provider to serve the subscription.<span style='mso-spacerun:yes'> 
3590                 </span>So maybe that's what you want to do for now, to get going.<o:p></o:p></span></p>
3591                 
3592                 <p class=MsoNormal style='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;
3593                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3594                 
3595                 <p class=MsoNormal style='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;
3596                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3597                 "Courier New"'>Question 6:<span style='mso-spacerun:yes'>  </span>Since the <span
3598                 class=SpellE>IndicationService</span> knows which indication subclass is served
3599                 by an indication provider, is it required that the instances of indication
3600                 classes be created before the provider is registered?<o:p></o:p></span></b></p>
3601                 
3602                 <p class=MsoNormal style='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;
3603 kumpf       1.3 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3604                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3605                 
3606                 <p class=MsoBodyText style='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'><span
3607                 style='font-weight:normal'>The <span class=SpellE>IndicationService</span>
3608                 checks that the class specified in the Filter is a subclass of <span
3609                 class=SpellE>CIM_Indication</span>, so you must define the indication subclass
3610                 you'll be using.<span style='mso-spacerun:yes'>  </span>(Instances of the
3611                 indication subclass don't get created until the indication provider generates
3612                 an indication.)<o:p></o:p></span></p>
3613                 
3614                 <p class=MsoNormal style='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;
3615                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3616 kumpf       1.2 
3617 kumpf       1.3 <p class=MsoNormal style='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;
3618                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3619                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3620                 
3621                 <p class=MsoNormal style='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;
3622                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3623                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3624                 
3625                 <p class=MsoNormal style='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'><b><span
3626                 style='font-family:"Courier New"'>Question 7:<span style='mso-spacerun:yes'> 
3627                 </span>How a particular listener is associated with a given subscription and
3628                 what goes into the Destination property&nbsp;CIM_ <span class=SpellE>IndicationHandlerCIMXML</span><o:p></o:p></span></b></p>
3629                 
3630                 <p style='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'><span
3631                 style='font-size:10.0pt;font-family:"Courier New"'>The listener is associated
3632                 with the subscription through the destination property of the handler instance.
3633                 Multiple subscriptions can refer to the same handler instance; so one listener
3634                 can listen to multiple subscriptions.</span><span style='font-size:10.0pt;
3635                 mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
3636 kumpf       1.2 
3637 kumpf       1.3 <p style='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'><span
3638                 style='font-size:10.0pt;font-family:"Courier New"'>With subscription you will
3639                 specify the destination where the Listener is running. An example,</span><span
3640 kumpf       1.2 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
3641                 
3642 kumpf       1.3 <p style='margin:0in;margin-bottom:.0001pt;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'><span
3643                 style='font-size:10.0pt;font-family:"Courier New"'>&lt;PROPERTY
3644                 NAME=&quot;Destination&quot; TYPE=&quot;string&quot;&gt;<o:p></o:p></span></p>
3645 kumpf       1.2 
3646 kumpf       1.3 <p style='margin:0in;margin-bottom:.0001pt;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'><span
3647                 style='font-size:10.0pt;font-family:"Courier New"'>&lt;VALUE&gt;https://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer&lt;/VALUE&gt;<o:p></o:p></span></p>
3648 kumpf       1.2 
3649 kumpf       1.3 <p style='margin:0in;margin-bottom:.0001pt;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'><span
3650                 style='font-size:10.0pt;font-family:"Courier New"'>&lt;/PROPERTY&gt;</span><span
3651                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
3652 kumpf       1.2 
3653 kumpf       1.3 <p style='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'><span
3654                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'>In
3655 kumpf       1.2 the above case, Listener would be running on mysystem.cup.hp.com at port 8189
3656                 with SSL enabled.</span><span style='font-family:"Courier New"'> <o:p></o:p></span></p>
3657                 
3658 kumpf       1.3 <p style='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'><b><span
3659                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'>Question
3660                 8:<span style='mso-spacerun:yes'>  </span></span></b><b><span style='font-size:
3661                 10.0pt;font-family:"Courier New"'>Can I specify/use any port number with my
3662                 Listener?<o:p></o:p></span></b></p>
3663                 
3664                 <p style='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'><span
3665                 style='font-size:10.0pt;font-family:"Courier New"'>It is not a good plan to
3666                 select any port&nbsp;and have the application use it.<span
3667                 style='mso-spacerun:yes'>  </span>It is recommended that a Listener application
3668                 to have&nbsp;its own port number and is registered with IANA so that no one
3669                 else uses that port number. And also if the application is going to be running
3670                 on HP-UX, you can request INET Team to have the IANA registered port number added
3671                 to /etc/services. This way no other HP-UX application uses your port numbers.<o:p></o:p></span></p>
3672 kumpf       1.2 
3673 kumpf       1.3 <p class=MsoNormal style='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'><b><span
3674                 style='font-family:"Courier New"'>Question 9: when the client creates the
3675                 indication listener, does it return an error if a listener already exists on
3676                 that system on the same port?&nbsp;<o:p></o:p></span></b></p>
3677 kumpf       1.2 
3678 kumpf       1.3 <p class=MsoNormal style='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'><span
3679                 style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3680 kumpf       1.2 
3681 kumpf       1.3 <p class=MsoNormal style='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'><span
3682                 style='font-family:"Courier New"'>Yes it does&nbsp;say - Address is in use.<o:p></o:p></span></p>
3683                 
3684                 <p class=MsoNormal style='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'><o:p>&nbsp;</o:p></p>
3685 kumpf       1.2 
3686                 <p class=MsoNormal style='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'><b><span
3687 kumpf       1.3 style='font-family:"Courier New"'>Question 10: Create Instance for <span
3688                 class=SpellE>CIM_IndicationSubscription</span> fails; However, I can create
3689                 Handler and Filter instances.<o:p></o:p></span></b></p>
3690                 
3691                 <p class=MsoNormal style='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;
3692                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>There
3693                 is a problem with Java Client API while creating instance with reference values
3694                 related to indication subscription class. This is mainly because of <span
3695                 class=GramE>Each</span> time the <span class=SpellE>ObjectPath</span> gets
3696                 passed to CIM Operations, Client API modifies the <span class=SpellE>CIMObjectPath</span>
3697                 after it gets the response from <span class=SpellE>cimserver</span>. The work
3698                 around is to store the <span class=SpellE>CIMObjectPath</span> that is passed
3699                 to <span class=SpellE><span class=GramE>createInstance</span></span><span
3700                 class=GramE>(</span>) while creating Filter and Handler instances. Then use
3701                 that stored paths in Subscription.<o:p></o:p></span></p>
3702 kumpf       1.2 
3703                 <p class=MsoNormal style='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'><span
3704 kumpf       1.3 style='font-family:"Courier New"'>Refer to the example (examples/Indication/<span
3705                 class=SpellE><span class=GramE>SubscribeIndTest.java</span></span><span
3706                 class=GramE> )</span> that is in WBEM Java Client SDK.<o:p></o:p></span></p>
3707 kumpf       1.2 
3708                 <h2 style='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'><span
3709 kumpf       1.3 style='font-style:normal;mso-bidi-font-style:italic'><o:p>&nbsp;</o:p></span></h2>
3710 kumpf       1.2 
3711                 <h2 style='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'><span
3712 kumpf       1.3 style='font-style:normal;mso-bidi-font-style:italic'>Appendix C: Example <span
3713                 class=SpellE>cim.properties</span> configuration file<o:p></o:p></span></h2>
3714 kumpf       1.2 
3715                 <p class=MsoNormal style='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'>&nbsp;</p>
3716 kumpf       1.1 
3717 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
3718                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
3719 kumpf       1.1 
3720 kumpf       1.2 <p class=MsoNormal style='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;
3721                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3722                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3723 kumpf       1.3 style='mso-spacerun:yes'>    </span>// <o:p></o:p></span></p>
3724 kumpf       1.1 
3725 kumpf       1.2 <p class=MsoNormal style='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;
3726                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3727                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3728 kumpf       1.3 style='mso-spacerun:yes'>    </span>// Example <span class=SpellE>cim.properties</span><o:p></o:p></span></p>
3729 kumpf       1.1 
3730 kumpf       1.2 <p class=MsoNormal style='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;
3731                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3732                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3733 kumpf       1.3 style='mso-spacerun:yes'>    </span>//<o:p></o:p></span></p>
3734 kumpf       1.1 
3735 kumpf       1.2 <p class=MsoNormal style='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;
3736                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3737                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3738 kumpf       1.3 style='mso-spacerun:yes'>    </span>DEBUG_XML=false <o:p></o:p></span></p>
3739 kumpf       1.1 
3740 kumpf       1.2 <p class=MsoNormal style='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;
3741                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3742                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3743 kumpf       1.3 style='mso-spacerun:yes'>    </span>DEBUG_XMLDECODE=false<o:p></o:p></span></p>
3744 kumpf       1.1 
3745 kumpf       1.2 <p class=MsoNormal style='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;
3746                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3747                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3748 kumpf       1.3 style='mso-spacerun:yes'>    </span><span class=SpellE><span class=GramE>clientLogFilePath</span></span><span
3749                 class=GramE>=</span>cimclient.txt<o:p></o:p></span></p>
3750 kumpf       1.1 
3751 kumpf       1.2 <p class=MsoNormal style='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;
3752                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3753                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'>&nbsp;<o:p></o:p></span></p>
3754 kumpf       1.1 
3755 kumpf       1.2 <p class=MsoNormal style='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;
3756                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3757                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3758 kumpf       1.3 style='mso-spacerun:yes'>    </span>// CIM Clients may specify their own Trust
3759 kumpf       1.2 Manager to use <o:p></o:p></span></p>
3760 kumpf       1.1 
3761 kumpf       1.2 <p class=MsoNormal style='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;
3762                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3763                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3764 kumpf       1.3 style='mso-spacerun:yes'>    </span>// instead of the default JSSE <span
3765                 class=SpellE>TrustManager</span>.<o:p></o:p></span></p>
3766 kumpf       1.1 
3767 kumpf       1.2 <p class=MsoNormal style='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;
3768                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3769                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3770 kumpf       1.3 style='mso-spacerun:yes'>    </span><span class=SpellE>TrustManager</span>=<span
3771                 class=SpellE>org.mycompany.myapp.MyCertificateManager</span><o:p></o:p></span></p>
3772 kumpf       1.1 
3773                 </div>
3774                 
3775 kumpf       1.2 <p class=MsoNormal style='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'><span
3776                 style='font-family:"Courier New"'>&nbsp;<o:p></o:p></span></p>
3777 kumpf       1.1 
3778                 </div>
3779                 
3780                 </body>
3781                 
3782                 </html>

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2