(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.7 <li>
 764                 <a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4461">Bugzilla #4461 - Unable to access attributes in CIMOMHandleXML and CIMClient</a>
 765                 </li>
 766 mateus.baur 1.4 </ol>
 767                 </p>
 768 kumpf       1.2 
 769 kumpf       1.3 <p class=MsoBodyText2><o:p>&nbsp;</o:p></p>
 770 kumpf       1.2 
 771                 <p style='margin:0in;margin-bottom:.0001pt'><span style='mso-bidi-font-size:
 772 kumpf       1.3 10.0pt'><o:p>&nbsp;</o:p></span></p>
 773 kumpf       1.1 
 774                 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
 775 kumpf       1.2 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:
 776 kumpf       1.3 list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;
 777                 font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>2.<span
 778                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
 779                 style='font-style:normal;mso-bidi-font-style:italic'>Writing WBEM Clients<o:p></o:p></span></h2>
 780 kumpf       1.1 
 781                 <p class=MsoNormal>&nbsp;</p>
 782                 
 783                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 784 kumpf       1.3 mso-bidi-font-size:10.0pt'>WBEM client applications use the </span><span
 785                 class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
 786                 font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>org.snia.wbem.client</span></tt></span><span
 787 kumpf       1.1 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> APIs to manipulate CIM
 788 kumpf       1.3 objects on the CIM Object Manager. A client application uses classes in </span><span
 789                 class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
 790                 font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>org.snia.wbem.cim</span></tt></span><tt><span
 791                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";
 792                 mso-bidi-font-family:"Courier New"'> package </span></tt><span
 793 kumpf       1.1 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>to construct an object (for
 794                 example, a class, instance, or namespace) and initializes that object. Then
 795                 uses the client APIs to pass the object to the CIMOM and request a CIM
 796                 operation, such as creating a CIM class, instance, or namespace.<o:p></o:p></span></p>
 797                 
 798                 <p>Client applications typically follow this sequence:</p>
 799                 
 800                 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>1.<span
 801 kumpf       1.3 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Connect to the
 802                 CIMOM using <span class=SpellE><tt><span style='font-size:10.0pt'>CIMClient</span></tt></span>.
 803 kumpf       1.1 A client application connects to the CIMOM before performing a CIM operation,
 804                 such as creating a CIM class or updating a CIM instance. </p>
 805                 
 806                 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>2.<span
 807                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Use the client
 808                 APIs to request CIM operations. Most of the client programs perform tasks such
 809                 as creating, deleting and modifying classes and instances; enumerating
 810                 instances; invoking provider methods; and handling errors and exceptions. </p>
 811                 
 812                 <p style='margin-left:.5in;text-indent:-.25in;tab-stops:list .5in'>3.<span
 813                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Close the client
 814 kumpf       1.3 connection to the CIM Object Manager using <span class=SpellE><tt><span
 815                 style='font-size:10.0pt'>CIMClient</span></tt></span>, to free the server
 816                 resources used by the client session. </p>
 817 kumpf       1.1 
 818                 <p class=MsoNormal>&nbsp;</p>
 819                 
 820                 <h3><b>Opening a Client Connection<o:p></o:p></b></h3>
 821                 
 822                 <p class=MsoNormal>&nbsp;</p>
 823                 
 824                 <p class=MsoBodyText2>Client applications typically import the required CIM
 825                 classes and create CIM objects and then open client connection.<span
 826 kumpf       1.3 style='mso-spacerun:yes'>  </span>Some of the common imports and CIM object creations
 827                 are show below.</p>
 828 kumpf       1.1 
 829                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 830                 
 831 kumpf       1.3 <div style='margin-left:.5in'>
 832 kumpf       1.1 
 833 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
 834                 padding:1.0pt 0in 1.0pt 31.0pt'>
 835                 
 836                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 837                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 838                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 839                 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>
 840                 
 841                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 842                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 843                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 844                 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>
 845                 
 846                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 847                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 848                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 849                 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>
 850                 
 851                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 852                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 853                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 854 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>
 855                 
 856                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 857                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 858                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 859                 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>
 860                 
 861                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 862                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 863                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 864                 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>
 865                 
 866                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 867                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 868                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 869                 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>
 870                 
 871                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 872                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 873                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 874                 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>
 875 kumpf       1.3 
 876                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 877                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
 878                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
 879                 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>
 880                 
 881                 </div>
 882 kumpf       1.1 
 883                 </div>
 884                 
 885                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 886                 
 887                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 888                 
 889 kumpf       1.3 <div style='margin-left:.5in'>
 890                 
 891                 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
 892                 padding:1.0pt 4.0pt 1.0pt 31.0pt'>
 893 kumpf       1.1 
 894 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 895                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span class=SpellE><span
 896                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIMNameSpace</span></span><span
 897                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>clientNameSpace</span>
 898                 = null;<o:p></o:p></span></p>
 899 kumpf       1.1 
 900 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 901                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span class=SpellE><span
 902                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIMClient</span></span><span
 903                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> cc = null;<o:p></o:p></span></p>
 904 kumpf       1.1 
 905 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 906 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
 907                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 908                 
 909 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 910                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span class=SpellE><span
 911                 class=GramE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>int</span></span></span><span
 912                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>portNo</span>
 913                 = <span class=SpellE>CIMNameSpace.DEFAULT_PORT</span>;<o:p></o:p></span></p>
 914                 
 915                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 916 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
 917 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'>String <span class=SpellE>nameSpace</span> =
 918                 &quot;root/cimv2&quot;;<span style='mso-spacerun:yes'>  </span><span
 919                 style='mso-spacerun:yes'>      </span>// namespace<o:p></o:p></span></p>
 920 kumpf       1.1 
 921 kumpf       1.3 </div>
 922 kumpf       1.1 
 923                 </div>
 924                 
 925                 <p class=MsoNormal>&nbsp;</p>
 926                 
 927                 <p class=MsoNormal><span style='font-family:"Courier New"'>&nbsp;<o:p></o:p></span></p>
 928                 
 929                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 930 kumpf       1.3 mso-bidi-font-size:10.0pt'>To open a client connection, you use the </span><span
 931                 class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
 932                 font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>CIMClient</span></tt></span><span
 933 kumpf       1.1 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class to connect to the CIM
 934                 Object Manager. You must specify the required type of connection (HTTP or
 935 kumpf       1.3 HTTPS) in the <span class=SpellE>CIMNameSpace</span> constructor. If connection
 936                 type is not specified the HTTP is used as the default. You must also specify
 937                 the user name and password for the connection to the specified CIM server.<o:p></o:p></span></p>
 938 kumpf       1.1 
 939                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 940                 mso-bidi-font-size:10.0pt'>&nbsp;<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'>Example HTTP connection:<o:p></o:p></span></p>
 944                 
 945                 <p class=MsoNormal style='text-align:justify'><span style='font-size:12.0pt;
 946                 mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
 947                 
 948 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
 949                 padding:1.0pt 4.0pt 1.0pt 0in'>
 950 kumpf       1.1 
 951                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 952                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 953                 mso-bidi-font-size:10.0pt;mso-bidi-font-weight:bold;mso-bidi-font-style:italic'><span
 954 kumpf       1.3 style='mso-spacerun:yes'>          </span></span><span style='font-size:12.0pt;
 955                 mso-bidi-font-size:10.0pt'>String <span class=SpellE>hostURL</span> = &quot;<b>http</b>://&quot;
 956                 + hostname + &quot;:&quot; + <span class=SpellE>portNo</span>;<o:p></o:p></span></p>
 957 kumpf       1.1 
 958                 <p style='margin:0in;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;
 959                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='mso-bidi-font-size:
 960 kumpf       1.3 10.0pt'><span style='mso-spacerun:yes'>          </span><span class=GramE>try</span>
 961                 <o:p></o:p></span></p>
 962 kumpf       1.1 
 963                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 964                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 965 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
 966 kumpf       1.1 
 967                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 968                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 969 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           </span><span
 970                 style='mso-spacerun:yes'>   </span><span class=SpellE><span class=GramE>clientNameSpace</span></span>
 971                 = new <span class=SpellE>CIMNameSpace</span>(<span class=SpellE>hostURL</span>,
 972                 <span class=SpellE>nameSpace</span>);<o:p></o:p></span></p>
 973 kumpf       1.1 
 974                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 975                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 976 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>             
 977                 </span>cc = new <span class=SpellE><span class=GramE>CIMClient</span></span><span
 978                 class=GramE>(</span><span class=SpellE>clientNameSpace</span>,
 979                 &quot;guest&quot;, &quot;guest&quot;, <span class=SpellE>CIMClient.HTTP</span>);<o:p></o:p></span></p>
 980 kumpf       1.1 
 981                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 982                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 983 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>} <o:p></o:p></span></p>
 984 kumpf       1.1 
 985                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 986                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 987 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
 988                 class=GramE>catch</span> (<span class=SpellE>CIMException</span> e) <o:p></o:p></span></p>
 989 kumpf       1.1 
 990                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 991                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 992 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
 993 kumpf       1.1 
 994                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
 995                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
 996 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>            </span><span
 997                 class=SpellE><span class=GramE>System.err.println</span></span><span
 998                 class=GramE>(</span>&quot;Failed to access CIMOM: &quot; + e);<o:p></o:p></span></p>
 999 kumpf       1.1 
1000                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1001                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1002 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>}<o:p></o:p></span></p>
1003 kumpf       1.1 
1004                 </div>
1005                 
1006                 <p class=MsoNormal>&nbsp;</p>
1007                 
1008                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1009                 
1010                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Example
1011                 HTTPS connection:<o:p></o:p></span></p>
1012                 
1013                 <p class=MsoNormal>&nbsp;</p>
1014                 
1015 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1016                 padding:1.0pt 4.0pt 1.0pt 0in'>
1017 kumpf       1.1 
1018                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1019                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1020                 mso-bidi-font-size:10.0pt;mso-bidi-font-weight:bold;mso-bidi-font-style:italic'><span
1021 kumpf       1.3 style='mso-spacerun:yes'>          </span></span><span style='font-size:12.0pt;
1022                 mso-bidi-font-size:10.0pt'>String <span class=SpellE>hostURL</span> = &quot;<b>https</b>://&quot;
1023                 + hostname + &quot;:&quot; + <span class=SpellE>portNo</span>;<o:p></o:p></span></p>
1024 kumpf       1.1 
1025                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1026                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1027 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
1028                 class=GramE>try</span> <o:p></o:p></span></p>
1029 kumpf       1.1 
1030                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1031                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1032 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
1033 kumpf       1.1 
1034                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1035                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1036 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>              </span><span
1037                 class=SpellE><span class=GramE>clientNameSpace</span></span> = new <span
1038                 class=SpellE>CIMNameSpace</span>(<span class=SpellE>hostURL</span>, <span
1039                 class=SpellE>nameSpace</span>);<o:p></o:p></span></p>
1040 kumpf       1.1 
1041                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1042                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1043 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>             
1044                 </span>cc = new <span class=SpellE><span class=GramE>CIMClient</span></span><span
1045                 class=GramE>(</span><span class=SpellE>clientNameSpace</span>,
1046                 &quot;guest&quot;, &quot;guest&quot;, <span class=SpellE>CIMClient.HTTP</span>);<o:p></o:p></span></p>
1047 kumpf       1.1 
1048                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1049                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1050 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>} <o:p></o:p></span></p>
1051 kumpf       1.1 
1052                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1053                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1054 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
1055                 class=GramE>catch</span> (<span class=SpellE>CIMException</span> e) <o:p></o:p></span></p>
1056 kumpf       1.1 
1057                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1058                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1059 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
1060 kumpf       1.1 
1061                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1062                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1063 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>            </span><span
1064                 class=SpellE><span class=GramE>System.err.println</span></span><span
1065                 class=GramE>(</span>&quot;Failed to access CIMOM: &quot; + e);<o:p></o:p></span></p>
1066 kumpf       1.1 
1067                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1068                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1069 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>         </span>}<o:p></o:p></span></p>
1070 kumpf       1.1 
1071                 </div>
1072                 
1073                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1074                 
1075                 <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:Arial;
1076                 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
1077                 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1078                 </span>
1079                 
1080                 <h3><b>Performing CIM Operations <o:p></o:p></b></h3>
1081                 
1082                 <p class=MsoNormal>&nbsp;</p>
1083                 
1084                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
1085 kumpf       1.3 following examples show how to do CIM operations using <span class=SpellE>org.snia.wbem.client</span>
1086                 APIs.<o:p></o:p></span></p>
1087 kumpf       1.1 
1088                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1089                 
1090                 <h4>&nbsp;</h4>
1091                 
1092                 <h4>Enumerating classes</h4>
1093                 
1094                 <p class=MsoNormal>&nbsp;</p>
1095                 
1096                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
1097 kumpf       1.3 following example shows how to do <span class=SpellE><i>enumerateClasses</i></span><i>
1098                 </i>of <span class=SpellE><i>CIM_ComputerSystem</i></span><o:p></o:p></span></p>
1099 kumpf       1.1 
1100                 <p class=MsoNormal>&nbsp;</p>
1101                 
1102 kumpf       1.3 <div style='margin-left:.5in'>
1103 kumpf       1.1 
1104 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1105                 padding:1.0pt 4.0pt 1.0pt 31.0pt'>
1106                 
1107                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1108 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1109 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     </span><span
1110                 class=GramE>try</span><o:p></o:p></span></p>
1111 kumpf       1.1 
1112 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1113 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1114 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1115 kumpf       1.1 </span>{<o:p></o:p></span></p>
1116                 
1117 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1118 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1119 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1120                 </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
1121                 class=GramE>(</span>&quot;\n*** Enumerate classes - No DEEP&quot;);<o:p></o:p></span></p>
1122 kumpf       1.1 
1123 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1124 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1125 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1126                 </span><span class=SpellE>CIMObjectPath</span> path = new <span class=SpellE><span
1127                 class=GramE>CIMObjectPath</span></span><span class=GramE>(</span>&quot;<span
1128                 class=SpellE>CIM_ComputerSystem</span>&quot;);<o:p></o:p></span></p>
1129 kumpf       1.1 
1130 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1131 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1132                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1133                 
1134 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1135 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1136 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1137                 </span>Boolean <span class=SpellE>deepInheritance</span> = false;<o:p></o:p></span></p>
1138 kumpf       1.1 
1139 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1140 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1141 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1142                 </span>Boolean <span class=SpellE>localOnly</span> = true;<o:p></o:p></span></p>
1143 kumpf       1.1 
1144 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1145 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1146 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1147                 </span>Boolean <span class=SpellE>includeQualifiers</span> = true;<o:p></o:p></span></p>
1148 kumpf       1.1 
1149 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1150 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1151 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1152                 </span>Boolean <span class=SpellE>includeClassOrigin</span> = true;<o:p></o:p></span></p>
1153 kumpf       1.1 
1154 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1155 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1156                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1157                 
1158 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1159 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1160 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>  </span><span
1161                 style='mso-spacerun:yes'>          </span>Enumeration en = <span class=SpellE><span
1162                 class=GramE>cc.enumerateClasses</span></span><span class=GramE>(</span>path, <span
1163                 class=SpellE>deepInheritance</span>,<o:p></o:p></span></p>
1164 kumpf       1.1 
1165 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1166 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1167 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1168                 style='mso-spacerun:yes'>                                               
1169                 </span><span class=SpellE><span class=GramE>localOnly</span></span>, <span
1170                 class=SpellE>includeQualifiers</span>,<o:p></o:p></span></p>
1171 kumpf       1.1 
1172 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1173 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1174 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1175                 style='mso-spacerun:yes'>                                               
1176                 </span><span class=SpellE><span class=GramE>includeClassOrigin</span></span>);<o:p></o:p></span></p>
1177 kumpf       1.1 
1178 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1179 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1180 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1181                 </span><span class=GramE>if</span> (en != null)<o:p></o:p></span></p>
1182 kumpf       1.1 
1183 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1184 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1185 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          
1186                 </span><span style='mso-spacerun:yes'> </span>{<o:p></o:p></span></p>
1187 kumpf       1.1 
1188 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1189 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1190 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1191                 style='mso-spacerun:yes'>                </span><span class=GramE>while</span>
1192                 ( <span class=SpellE>en.hasMoreElements</span>() )<o:p></o:p></span></p>
1193 kumpf       1.1 
1194 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1195 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1196 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1197                 style='mso-spacerun:yes'>                </span>{<o:p></o:p></span></p>
1198 kumpf       1.1 
1199 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1200 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1201 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1202                 style='mso-spacerun:yes'>                    </span><span class=SpellE>CIMClass</span>
1203                 <span class=SpellE>cimclass</span> = (<span class=SpellE>CIMClass</span>) <span
1204                 class=SpellE><span class=GramE>en.nextElement</span></span><span class=GramE>(</span>);<o:p></o:p></span></p>
1205 kumpf       1.1 
1206 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1207 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1208 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1209                 style='mso-spacerun:yes'>                    </span><span class=SpellE><span
1210                 class=GramE>System.out.println</span></span><span class=GramE>(</span>&quot;Class
1211                 name: &quot; + <span class=SpellE>cimclass.getName</span>());<o:p></o:p></span></p>
1212 kumpf       1.1 
1213 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1214 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1215 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1216                 style='mso-spacerun:yes'>                </span>}<o:p></o:p></span></p>
1217 kumpf       1.1 
1218 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1219 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1220 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1221 kumpf       1.1 </span>}<o:p></o:p></span></p>
1222                 
1223 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1224 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1225 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1226 kumpf       1.1 </span>}<o:p></o:p></span></p>
1227                 
1228 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1229 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1230 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1231                 </span><span class=GramE>catch</span> (<span class=SpellE>CIMException</span> <span
1232                 class=SpellE>ce</span>)<o:p></o:p></span></p>
1233 kumpf       1.1 
1234 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1235 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1236 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1237 kumpf       1.1 </span>{<o:p></o:p></span></p>
1238                 
1239 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1240 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1241 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1242                 </span><span class=SpellE><span class=GramE>System.err.println</span></span><span
1243                 class=GramE>(</span>&quot;Failed to enumerate classes: &quot; + <span
1244                 class=SpellE>ce</span>);<o:p></o:p></span></p>
1245 kumpf       1.1 
1246 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1247 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:
1248 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1249 kumpf       1.1 </span>}<o:p></o:p></span></p>
1250                 
1251                 </div>
1252                 
1253 kumpf       1.3 </div>
1254                 
1255 kumpf       1.1 <p class=MsoNormal style='margin-left:.5in'><span style='font-size:12.0pt;
1256                 mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1257                 
1258                 <h4>&nbsp;</h4>
1259                 
1260 kumpf       1.2 <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";
1261 kumpf       1.1 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
1262                 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1263 kumpf       1.2 </span>
1264 kumpf       1.1 
1265 kumpf       1.3 <h4><span class=SpellE>InvokeMethod</span> Operation</h4>
1266 kumpf       1.1 
1267                 <p class=MsoNormal>&nbsp;</p>
1268                 
1269                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The
1270 kumpf       1.3 following example shows how to do <span class=SpellE><i>invokeMethod</i></span><i>
1271                 </i>on a <span class=SpellE><i>Sample_MethodProvider</i></span><i>.</i><o:p></o:p></span></p>
1272 kumpf       1.1 
1273                 <p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1274                 
1275 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1276                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
1277 kumpf       1.1 
1278                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1279                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1280 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     </span>//
1281                 NOTE: The following test requires the <span class=SpellE>Sample_MethodProviderClass</span><o:p></o:p></span></p>
1282 kumpf       1.1 
1283                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1284                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1285 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     </span>//
1286                 and a sample method provider for <span class=SpellE>Sample_MethodProviderClass</span>.<o:p></o:p></span></p>
1287 kumpf       1.1 
1288                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1289                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1290 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     </span>//<o:p></o:p></span></p>
1291 kumpf       1.1 
1292                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1293                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1294 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1295                 </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
1296                 class=GramE>(</span>&quot;\n*** Invoke Method.&quot;);<o:p></o:p></span></p>
1297 kumpf       1.1 
1298                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1299                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1300 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1301                 </span>String <span class=SpellE>testNameSpace</span> = &quot;root/<span
1302                 class=SpellE>SampleProvider</span>&quot;;<o:p></o:p></span></p>
1303 kumpf       1.1 
1304                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1305                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1306 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1307                 </span>String <span class=SpellE>testClassName</span> = &quot;<span
1308                 class=SpellE>Sample_MethodProviderClass</span>&quot;;<o:p></o:p></span></p>
1309 kumpf       1.1 
1310                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1311                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1312 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1313                 </span>String <span class=SpellE>methodName</span> = &quot;<span class=SpellE>SayHello</span>&quot;;<o:p></o:p></span></p>
1314 kumpf       1.1 
1315                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1316                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1317 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1318                 </span>String <span class=SpellE>inParamValue</span> = &quot;Yoda&quot;;<o:p></o:p></span></p>
1319 kumpf       1.1 
1320                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1321                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1322 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1323                 </span>String <span class=SpellE>goodReply</span> = &quot;Hello<span
1324                 class=GramE>, &quot;</span> + <span class=SpellE>inParamValue</span> +
1325                 &quot;!&quot;;<o:p></o:p></span></p>
1326 kumpf       1.1 
1327                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1328                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1329 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1330                 </span>String <span class=SpellE>goodParam</span> = &quot;From <span
1331                 class=SpellE>Neverland</span>&quot;;<o:p></o:p></span></p>
1332 kumpf       1.1 
1333                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1334                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1335                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1336                 
1337                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1338                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1339 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1340                 </span><span class=SpellE>CIMObjectPath</span> <span class=SpellE>currentPath</span>;<o:p></o:p></span></p>
1341 kumpf       1.1 
1342                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1343                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1344 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1345                 </span>Vector <span class=SpellE>inParams</span> = new <span class=GramE>Vector(</span>);<o:p></o:p></span></p>
1346 kumpf       1.1 
1347                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1348                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1349 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1350                 </span>Vector <span class=SpellE>outParams</span> = new <span class=GramE>Vector(</span>);<o:p></o:p></span></p>
1351 kumpf       1.1 
1352                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1353                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1354 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1355                 </span><span class=SpellE>CIMValue</span> <span class=SpellE>retValue</span>;<o:p></o:p></span></p>
1356 kumpf       1.1 
1357                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1358                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1359                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1360                 
1361                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1362                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1363 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1364                 </span><span class=GramE>try</span><o:p></o:p></span></p>
1365 kumpf       1.1 
1366                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1367                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1368 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1369 kumpf       1.1 </span>{<o:p></o:p></span></p>
1370                 
1371                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1372                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1373 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1374                 </span>// construct <span class=SpellE>CIMObjectPath</span><o:p></o:p></span></p>
1375 kumpf       1.1 
1376                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1377                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1378 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1379 kumpf       1.1 </span>//<o:p></o:p></span></p>
1380                 
1381                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1382                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1383 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1384                 </span><span class=SpellE><span class=GramE>currentPath</span></span> = new <span
1385                 class=SpellE>CIMObjectPath</span>(<span class=SpellE>testClassName</span>);<o:p></o:p></span></p>
1386 kumpf       1.1 
1387                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1388                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1389                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1390                 
1391                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1392                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1393 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1394 kumpf       1.1 </span>// set the namespace<o:p></o:p></span></p>
1395                 
1396                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1397                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1398 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1399 kumpf       1.1 </span>//<o:p></o:p></span></p>
1400                 
1401                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1402                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1403 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1404                 </span><span class=SpellE><span class=GramE>currentPath.setNameSpace</span></span><span
1405                 class=GramE>(</span><span class=SpellE>testNameSpace</span>);<o:p></o:p></span></p>
1406 kumpf       1.1 
1407                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1408                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1409                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1410                 
1411                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1412                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1413 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1414 kumpf       1.1 </span>// create parameter vectors<o:p></o:p></span></p>
1415                 
1416                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1417                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1418 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1419 kumpf       1.1 </span>//<o:p></o:p></span></p>
1420                 
1421                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1422                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1423 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1424                 </span><span class=SpellE><span class=GramE>inParams.addElement</span></span><span
1425                 class=GramE>(</span> new <span class=SpellE>CIMProperty</span>(&quot;dummy&quot;,<o:p></o:p></span></p>
1426 kumpf       1.1 
1427                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1428                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1429 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1430                 </span><span style='mso-tab-count:2'>                </span><span class=GramE>new</span>
1431                 <span class=SpellE>CIMValue</span>(<span class=SpellE>inParamValue</span>, <span
1432                 class=SpellE>CIMDataType.getPredefinedType</span>(<o:p></o:p></span></p>
1433 kumpf       1.1 
1434                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1435                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1436 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1437                 style='mso-spacerun:yes'>                                </span><span
1438                 class=SpellE>CIMDataType.STRING</span>))));<o:p></o:p></span></p>
1439 kumpf       1.1 
1440                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1441                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1442                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1443                 
1444                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1445                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1446 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1447                 </span>// call <span class=SpellE>invokeMethod</span><o:p></o:p></span></p>
1448 kumpf       1.1 
1449                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1450                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1451 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1452 kumpf       1.1 </span>//<o:p></o:p></span></p>
1453                 
1454                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1455                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1456 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1457                 </span><span class=SpellE><span class=GramE>retValue</span></span><span
1458                 class=GramE>=</span><span class=SpellE>cc.invokeMethod</span>(<span
1459                 class=SpellE>currentPath</span>, <span class=SpellE>methodName</span>, <span
1460                 class=SpellE>inParams</span>,<o:p></o:p></span></p>
1461 kumpf       1.1 
1462                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1463                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1464 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1465                 style='mso-spacerun:yes'>                                     </span><span
1466                 class=SpellE><span class=GramE>outParams</span></span>);<o:p></o:p></span></p>
1467 kumpf       1.1 
1468                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1469                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1470 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1471                 </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
1472                 class=GramE>(</span>&quot;<span class=SpellE>InvokeMethod</span> response =
1473                 &quot; + <span class=SpellE>retValue.toString</span>());<o:p></o:p></span></p>
1474 kumpf       1.1 
1475                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1476                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1477 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1478 kumpf       1.1 </span>}<o:p></o:p></span></p>
1479                 
1480                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1481                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1482 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1483                 </span><span class=GramE>catch</span> (<span class=SpellE>CIMException</span> <span
1484                 class=SpellE>ce</span>)<o:p></o:p></span></p>
1485 kumpf       1.1 
1486                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1487                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1488 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1489 kumpf       1.1 </span>{<o:p></o:p></span></p>
1490                 
1491                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1492                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
1493 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>            
1494                 </span><span class=SpellE><span class=GramE>System.err.println</span></span><span
1495                 class=GramE>(</span>&quot;<span class=SpellE>invokeMethod</span> Failed: &quot;
1496                 + <span class=SpellE>ce</span>);<o:p></o:p></span></p>
1497 kumpf       1.1 
1498                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1499 kumpf       1.3 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span
1500                 style='mso-spacerun:yes'>        </span>}<span style='mso-spacerun:yes'>  
1501                 </span></p>
1502 kumpf       1.1 
1503                 </div>
1504                 
1505                 <h3><b>&nbsp;<o:p></o:p></b></h3>
1506                 
1507                 <h3><b>Closing Client Connection<o:p></o:p></b></h3>
1508                 
1509                 <p class=MsoNormal><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></b></p>
1510                 
1511 kumpf       1.3 <p class=MsoBodyText2>Clients may close the connection by calling the <span
1512                 class=SpellE><span class=GramE>CIMClient.close</span></span><span class=GramE>(</span>)
1513                 method. Client connection will also be closed when the <span class=SpellE>CIMClient</span>
1514                 object goes out of scope. </p>
1515 kumpf       1.1 
1516                 <p class=MsoNormal>&nbsp;</p>
1517                 
1518 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1519                 padding:1.0pt 4.0pt 1.0pt 0in'>
1520 kumpf       1.1 
1521                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1522                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1523 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
1524                 class=GramE>try</span><o:p></o:p></span></p>
1525 kumpf       1.1 
1526                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1527                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1528 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>{<o:p></o:p></span></p>
1529 kumpf       1.1 
1530                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1531                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1532 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>                   
1533                 </span><span class=GramE>if(</span> cc != null ) <o:p></o:p></span></p>
1534 kumpf       1.1 
1535                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1536                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1537 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>                   
1538 kumpf       1.1 </span>{<o:p></o:p></span></p>
1539                 
1540                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1541                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1542 kumpf       1.3 mso-bidi-font-size:10.0pt'><span
1543                 style='mso-spacerun:yes'>                              </span><span
1544                 class=SpellE><span class=GramE>cc.close</span></span><span class=GramE>(</span>);<o:p></o:p></span></p>
1545 kumpf       1.1 
1546                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1547                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1548 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>                   
1549 kumpf       1.1 </span>}<o:p></o:p></span></p>
1550                 
1551                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1552                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1553 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>}<o:p></o:p></span></p>
1554 kumpf       1.1 
1555                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1556                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1557 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span><span
1558                 class=GramE>catch</span> (<span class=SpellE>CIMException</span> <span
1559                 class=SpellE>ce</span>)<o:p></o:p></span></p>
1560 kumpf       1.1 
1561                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1562                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1563 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>{<o:p></o:p></span></p>
1564 kumpf       1.1 
1565                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1566                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1567 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>                   
1568                 </span><span class=SpellE><span class=GramE>System.err.println</span></span><span
1569                 class=GramE>(</span>&quot;Failed to close connection: &quot; + <span
1570                 class=SpellE>ce</span>);<o:p></o:p></span></p>
1571 kumpf       1.1 
1572                 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1573                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;
1574 kumpf       1.3 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          </span>}<o:p></o:p></span></p>
1575 kumpf       1.1 
1576                 </div>
1577                 
1578                 <p class=MsoNormal><b style='mso-bidi-font-weight:normal'><i style='mso-bidi-font-style:
1579 kumpf       1.3 normal'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></i></b></p>
1580 kumpf       1.2 
1581                 <h3><b>Java CIM Client Local connection<o:p></o:p></b></h3>
1582                 
1583                 <p class=MsoBodyText2>This version support supports Local connection in Java
1584                 CIM Client interface. I.E. Java CIM Clients that wish to do local connection to
1585 kumpf       1.3 <span class=SpellE>CIMServer</span> can now use this feature. To do local
1586                 connection clients create <span class=SpellE><span class=GramE><code><span
1587                 style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>CIMClient</span></code></span></span><span
1588                 class=GramE><code><span style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>(</span></code></span><span
1589                 class=SpellE><code><span style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>CIMNameSpace</span></code></span><code><span
1590                 style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>&nbsp;namespace)</span></code><span
1591                 style='mso-spacerun:yes'>   </span>and this creates local connection to the CIM
1592                 Server running on the local system for the specified namespace. Clients do not
1593                 have to specify the username and/or password as the authentication is done
1594 kumpf       1.2 based the user logged in.</p>
1595                 
1596                 <p class=MsoBodyText2><i style='mso-bidi-font-style:normal'><span
1597 kumpf       1.3 style='mso-bidi-font-weight:bold'><o:p>&nbsp;</o:p></span></i></p>
1598 kumpf       1.1 
1599                 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
1600 kumpf       1.2 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:
1601 kumpf       1.3 list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;
1602                 font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>3.<span
1603                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
1604                 style='font-style:normal;mso-bidi-font-style:italic'>SSL Certificate Management<o:p></o:p></span></h2>
1605 kumpf       1.1 
1606                 <p class=MsoNormal style='margin-right:.4in;text-align:justify'>&nbsp;</p>
1607                 
1608                 <p style='margin-right:.4in;text-align:justify'><b>Importing Certificates into
1609                 Java Trust Store<o:p></o:p></b></p>
1610                 
1611                 <p style='margin-right:.4in;text-align:justify'>1. Export the server
1612 kumpf       1.3 certificate from the .<span class=SpellE>pem</span> file. </p>
1613 kumpf       1.1 
1614                 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'>Use <span
1615 kumpf       1.3 class=SpellE><span style='font-family:"Courier New"'>openssl</span></span>
1616                 command to export Pegasus <span class=SpellE>CIMServer</span> certificate file.
1617                 <span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'><o:p></o:p></span></p>
1618 kumpf       1.1 
1619                 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'><span
1620 kumpf       1.3 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'># /opt/<span
1621                 class=SpellE>wbem/sbin/openssl</span> x509 -in /<span class=SpellE>var/opt/wbem/server.pem</span>
1622                 -out <span class=SpellE>server.cer</span><o:p></o:p></span></p>
1623 kumpf       1.1 
1624                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1625                 10.0pt;mso-bidi-font-family:"Courier New"'>2. Import the server certificate in
1626                 to the client trust store.<o:p></o:p></span></p>
1627                 
1628                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1629 kumpf       1.3 10.0pt;mso-bidi-font-family:"Courier New"'><span style='mso-spacerun:yes'>     
1630                 </span>- Copy the server certificate on to the client system.<o:p></o:p></span></p>
1631 kumpf       1.1 
1632                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1633 kumpf       1.3 10.0pt;mso-bidi-font-family:"Courier New"'><span style='mso-spacerun:yes'>     
1634                 </span>- Use Java </span><span class=SpellE><span style='mso-bidi-font-size:
1635                 10.0pt;font-family:"Courier New"'>keytool</span></span><span style='mso-bidi-font-size:
1636                 10.0pt;mso-bidi-font-family:"Courier New"'> to import the certificate into the
1637                 client trust store.<o:p></o:p></span></p>
1638                 
1639                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1640                 .5in;text-align:justify'><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:
1641                 "Courier New"'># <span class=SpellE><span class=GramE>keytool</span></span>
1642                 -import -alias sequoia1 -file <span class=SpellE>server.cer</span> -<span
1643                 class=SpellE>keystore</span> <span class=SpellE>mytruststore</span><o:p></o:p></span></p>
1644 kumpf       1.1 
1645                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1646                 10.0pt;mso-bidi-font-family:"Courier New"'>You will be asked to enter a
1647 kumpf       1.3 password. The password is required only for modifying <span class=SpellE>mytruststore</span>
1648                 in the future. The <span class=SpellE>keytool</span> creates the trust store if
1649                 it is not already exists and then import the specified certificate. (For example
1650                 we entered the password as “wbem01”)<o:p></o:p></span></p>
1651 kumpf       1.1 
1652                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1653 kumpf       1.3 10.0pt;mso-bidi-font-family:"Courier New"'>3. Specify the <span class=SpellE>truststore</span>
1654                 in the command line of the client application using “-<span class=SpellE>Djavax.net.ssl.trustStore</span>”.<o:p></o:p></span></p>
1655 kumpf       1.1 
1656                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1657                 10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p></span></p>
1658                 
1659 kumpf       1.3 <p style='margin-right:.4in;text-align:justify'><span class=GramE><span
1660                 style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java</span></span><span
1661                 style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>
1662                 -<span class=SpellE>Djavax.net.ssl.trustStore</span>=<span class=SpellE>mytruststore</span>
1663                 &lt;<span class=SpellE>MyClient</span>&gt; &lt;system&gt; root/cimv2 5989 <span
1664                 class=SpellE>ssl</span><o:p></o:p></span></p>
1665 kumpf       1.1 
1666                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1667                 10.0pt;mso-bidi-font-family:"Courier New"'>4. If your client application is
1668 kumpf       1.3 written to update the <span class=SpellE>truststore</span> file
1669                 programmatically then you must also specify the password that was used to
1670                 create the <span class=SpellE>truststore</span> <span class=GramE>using<span
1671                 style='mso-spacerun:yes'>  </span>“</span>-<span class=SpellE>Djavax.net.ssl.trustStorePassword</span>”.<o:p></o:p></span></p>
1672 kumpf       1.1 
1673                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1674                 10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p></span></p>
1675                 
1676 kumpf       1.3 <p style='margin-right:.4in'><span class=GramE><span style='font-size:11.0pt;
1677                 mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java</span></span><span
1678                 style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>
1679                 -<span class=SpellE>Djavax.net.ssl.trustStore</span>=<span class=SpellE>mytruststore</span><span
1680                 style='mso-spacerun:yes'>  </span>-<span class=SpellE>Djavax.net.ssl.trustStorePassword</span>=wbem01
1681                 &lt;<span class=SpellE>MyClient</span>&gt;<span style='mso-spacerun:yes'> 
1682                 </span>&lt;system&gt; root/cimv2 5989 <span class=SpellE>ssl</span><span
1683                 style='mso-spacerun:yes'>    </span><o:p></o:p></span></p>
1684 kumpf       1.1 
1685                 <p style='margin-right:.4in;text-align:justify'><b>&nbsp;<o:p></o:p></b></p>
1686                 
1687                 <p style='margin-right:.4in;text-align:justify'><b>Viewing Certificates and
1688                 Trust Store files</b><b><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:
1689                 "Courier New"'><o:p></o:p></span></b></p>
1690                 
1691                 <p style='margin-right:.4in;text-align:justify'><span style='mso-bidi-font-size:
1692 kumpf       1.3 10.0pt;mso-bidi-font-family:"Courier New"'><span style='mso-spacerun:yes'>     
1693                 </span><span class=GramE>1.You</span> view certificates in a certificate file
1694                 using <span class=SpellE>keytool</span> command.<o:p></o:p></span></p>
1695                 
1696                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1697                 .5in;text-align:justify;text-indent:.25in'><span class=SpellE><span
1698                 class=GramE><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>keytool</span></span></span><span
1699                 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'> -<span
1700                 class=SpellE>printcert</span> -file <span class=SpellE>server.cer</span><o:p></o:p></span></p>
1701                 
1702                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1703                 .5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'><span
1704                 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>1.</span><span
1705                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span
1706                 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>You can
1707                 view all the certificates in a <span class=SpellE>truststore</span> using the <span
1708                 class=SpellE>keytool</span> command.<o:p></o:p></span></p>
1709                 
1710                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1711                 .5in;text-align:justify;text-indent:.25in'><span class=SpellE><span
1712                 class=GramE><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>keytool</span></span></span><span
1713 kumpf       1.3 style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'> -list -v
1714                 -<span class=SpellE>keystore</span> <span class=SpellE>mytruststore</span></span><b><o:p></o:p></b></p>
1715 kumpf       1.1 
1716                 <h2><span style='font-style:normal;mso-bidi-font-style:italic'>&nbsp;<o:p></o:p></span></h2>
1717                 
1718 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
1719 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:
1720                 Arial;font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>4.<span
1721                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
1722                 style='font-style:normal;mso-bidi-font-style:italic'>Writing <span class=GramE>A</span>
1723                 Trust Manager<o:p></o:p></span></h2>
1724 kumpf       1.1 
1725                 <p style='margin-right:.4in;text-align:justify'>The primary responsibility of
1726 kumpf       1.3 the <span class=SpellE>TrustManager</span> is to determine whether the
1727                 presented authentication credentials should be trusted or not. If the
1728                 credentials are not trusted, the connection will be terminated. If no trust
1729                 manager is specified by the client application then JSSE will use its own trust
1730                 manager that supports authentication based on X.509 public key certificates. </p>
1731 kumpf       1.1 
1732                 <p style='margin-right:.4in;text-align:justify'>If the default X509TrustManager
1733                 behavior isn't suitable for your situation, you can implement your own
1734                 X509TrustManager. JSSE interface allows you to override certification
1735                 validation and continue the SSL handshake. You can also use the interface to
1736                 discontinue an SSL handshake by performing additional validation on a server's
1737                 digital certificate chain.</p>
1738                 
1739                 <p style='margin-right:.4in;text-align:justify'>When an SSL client connects to
1740                 an SSL server, the SSL server presents its digital certificate chain to the
1741                 client for authentication. This certificate chain can contain invalid digital
1742                 certificates. As per the SSL specification, the client should drop the SSL
1743                 connection once it discovers an invalid certificate. However, some applications
1744                 such as Web Browsers ask the user whether to accept the invalid certificate.
1745                 The Trust Manager eliminates this inconsistent practice by enabling you to
1746                 control when to continue or discontinue an SSL connection. Using a Trust
1747                 Manager you can perform custom checks before continuing an SSL connection. For
1748                 example, you can use the Trust Manager to specify that only users from specific
1749                 localities, such as towns, states, or countries, or users with other special
1750                 attributes, to gain access via the SSL connection. </p>
1751                 
1752 kumpf       1.1 <p style='margin-right:.4in;text-align:justify'>Here is an example of a Trust
1753                 Manager that basically ignores the server certificates chain by not validating
1754                 the certificate chain. It accepts any certificates from any server and goes
1755                 ahead with SSL handshake.<b> <o:p></o:p></b></p>
1756                 
1757                 <span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";
1758                 mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:
1759                 EN-US;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1760                 </span>
1761                 
1762 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
1763                 padding:1.0pt 31.0pt 1.0pt 4.0pt'>
1764 kumpf       1.1 
1765 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1766                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1767                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
1768                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>java.security.cert</span>.*;<o:p></o:p></span></p>
1769 kumpf       1.1 
1770 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1771                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1772                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
1773                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>java.security.KeyStore</span>;<o:p></o:p></span></p>
1774 kumpf       1.1 
1775 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1776                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1777                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
1778                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> javax.net.*;<o:p></o:p></span></p>
1779 kumpf       1.1 
1780 kumpf       1.3 <p class=MsoNormal style='tab-stops:400.5pt;border:none;mso-border-alt:solid windowtext .5pt;
1781                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1782                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
1783                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>javax.net.ssl</span>.*;<o:p></o:p></span></p>
1784 kumpf       1.1 
1785 kumpf       1.3 <p class=MsoNormal style='tab-stops:400.5pt;border:none;mso-border-alt:solid windowtext .5pt;
1786                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1787                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1788 kumpf       1.1 
1789 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1790 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1791                 12.0pt;mso-bidi-font-size:10.0pt'>/**<o:p></o:p></span></p>
1792                 
1793 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1794 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1795                 12.0pt;mso-bidi-font-size:10.0pt'>This class implements the X509TrustManager
1796 kumpf       1.3 interface.<span style='mso-spacerun:yes'>  </span>It does not validate the
1797                 certificate chain sent by the <span class=GramE>server,</span> it basically
1798                 ignores the certificate chain and goes ahead with the SSL hand shake. <o:p></o:p></span></p>
1799 kumpf       1.1 
1800 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1801 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1802                 12.0pt;mso-bidi-font-size:10.0pt'>*/<o:p></o:p></span></p>
1803                 
1804 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1805                 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span class=GramE><span
1806                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>public</span></span><span
1807                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class <span class=SpellE>DontValidateCertificate</span>
1808 kumpf       1.1 implements X509TrustManager<o:p></o:p></span></p>
1809                 
1810 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1811 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1812                 12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p></span></p>
1813                 
1814 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1815 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1816 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1817                 </span><span class=GramE>X509TrustManager<span style='mso-spacerun:yes'> 
1818                 </span>myX509TrustManager</span>;<o:p></o:p></span></p>
1819 kumpf       1.1 
1820 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1821 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1822                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1823                 
1824 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1825 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1826 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1827 kumpf       1.1 </span>/**<o:p></o:p></span></p>
1828                 
1829 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1830 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1831 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1832                 </span>* <span class=SpellE><span class=GramE>checkClientTrusted</span></span>
1833                 checks to see if the chain is in the <o:p></o:p></span></p>
1834 kumpf       1.1 
1835 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1836 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1837 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1838                 </span>* <span class=SpellE><span class=GramE>keyStore</span></span> object.<o:p></o:p></span></p>
1839 kumpf       1.1 
1840 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1841 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1842 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1843 kumpf       1.1 </span>*/<o:p></o:p></span></p>
1844                 
1845 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1846 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1847 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1848                 </span><span class=GramE>public</span> void <span class=SpellE>checkClientTrusted</span>(X509Certificate[]
1849                 chain, <o:p></o:p></span></p>
1850 kumpf       1.1 
1851 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1852 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1853 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'> </span><span
1854                 style='mso-spacerun:yes'>                   </span>String <span class=SpellE>authType</span>)
1855                 throws <span class=SpellE>CertificateException</span><span
1856                 style='mso-spacerun:yes'>  </span><o:p></o:p></span></p>
1857 kumpf       1.1 
1858 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1859 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1860 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1861 kumpf       1.1 </span>{ <o:p></o:p></span></p>
1862                 
1863 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1864 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1865 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1866 kumpf       1.1 </span>}<o:p></o:p></span></p>
1867                 
1868 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1869 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1870                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1871                 
1872 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1873 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1874 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1875 kumpf       1.1 </span>/**<o:p></o:p></span></p>
1876                 
1877 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1878 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1879 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1880                 </span>* <span class=SpellE><span class=GramE>checkServerTrusted</span></span>
1881                 verifies to see if the chain is in the <o:p></o:p></span></p>
1882 kumpf       1.1 
1883 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1884 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1885 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1886                 </span>* <span class=SpellE><span class=GramE>keyStore</span></span> object.<o:p></o:p></span></p>
1887 kumpf       1.1 
1888 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1889 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1890 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1891 kumpf       1.1 </span>*/<o:p></o:p></span></p>
1892                 
1893 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1894 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1895 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1896                 </span><span class=GramE>public</span> void <span class=SpellE>checkServerTrusted</span>(X509Certificate[]
1897                 chain, <o:p></o:p></span></p>
1898 kumpf       1.1 
1899 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1900 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1901 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span
1902                 style='mso-spacerun:yes'>                   </span>String <span class=SpellE>authType</span>)
1903                 throws <span class=SpellE>CertificateException</span><span
1904                 style='mso-spacerun:yes'>  </span><o:p></o:p></span></p>
1905 kumpf       1.1 
1906 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1907 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1908 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1909 kumpf       1.1 </span>{ <o:p></o:p></span></p>
1910                 
1911 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1912 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1913 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1914 kumpf       1.1 </span>}<o:p></o:p></span></p>
1915                 
1916 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1917 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1918                 12.0pt;mso-bidi-font-size:10.0pt'>&nbsp;<o:p></o:p></span></p>
1919                 
1920 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1921 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1922 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1923 kumpf       1.1 </span>/**<o:p></o:p></span></p>
1924                 
1925 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1926 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1927 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1928                 </span>* This method retrieves all of the certificates in the <span
1929                 class=SpellE>keyStore</span> <o:p></o:p></span></p>
1930 kumpf       1.1 
1931 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1932 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1933 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1934                 </span>* <span class=GramE>and</span> returns them in an X509Certificate array.
1935                 We return null <o:p></o:p></span></p>
1936 kumpf       1.1 
1937 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1938 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1939 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1940                 </span>* <span class=GramE>as</span> we are accepting any certificates. We
1941                 should only return null if we are using this trust manager <o:p></o:p></span></p>
1942 kumpf       1.1 
1943 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1944 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1945 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1946                 </span>* <span class=GramE>with</span> <span class=SpellE>CIMClient</span>
1947                 applications. However, we must return an empty <span class=GramE>X509Certificate[</span>]
1948                 is used with<o:p></o:p></span></p>
1949 kumpf       1.1 
1950 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1951 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1952 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1953 kumpf       1.1 </span>* CIM Listener (which is SSL Server) interface. <o:p></o:p></span></p>
1954                 
1955 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1956 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1957 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>        
1958 kumpf       1.1 </span>*/<o:p></o:p></span></p>
1959                 
1960 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1961 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1962 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1963                 </span><span class=GramE>public</span> X509Certificate[] <span class=SpellE>getAcceptedIssuers</span>()<o:p></o:p></span></p>
1964 kumpf       1.1 
1965 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1966 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1967 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1968 kumpf       1.1 </span>{<o:p></o:p></span></p>
1969                 
1970 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1971 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1972 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>           
1973                 </span><span class=GramE>return</span> null;<o:p></o:p></span></p>
1974 kumpf       1.1 
1975 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1976 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1977 kumpf       1.3 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>       
1978                 </span>}<o:p></o:p></span></p>
1979 kumpf       1.1 
1980 kumpf       1.3 <p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;
1981 kumpf       1.1 padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:
1982                 12.0pt;mso-bidi-font-size:10.0pt'>}<o:p></o:p></span></p>
1983                 
1984                 </div>
1985                 
1986                 <span style='font-size:12.0pt;font-family:"Times New Roman";mso-fareast-font-family:
1987                 "Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:EN-US;
1988                 mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always'>
1989                 </span>
1990                 
1991                 <p style='margin-right:.4in;text-align:justify'>The Client SDK includes the
1992                 following two simple trust managers.</p>
1993                 
1994 kumpf       1.3 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1995                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
1996                 class=SpellE>org.snia.wbemcmd.xml.CertificateManager</span></p>
1997                 
1998                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
1999                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
2000                 class=SpellE>org.snia.wbemcmd.xml.DontValidateCertificate</span></p>
2001                 
2002                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2003                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span><span
2004                 class=SpellE><span class=GramE>org.snia.wbem.listener.DoNotValidateClientCert</span></span><span
2005                 class=GramE><span style='mso-spacerun:yes'>  </span>(</span> Note: Use this
2006                 with CIM Listener interface)</p>
2007                 
2008                 <p style='margin-right:.4in;text-align:justify'>Client API uses JSSE trust manager
2009                 by default. If you want the API to use your own trust manager then you need to
2010                 explicitly specify. </p>
2011 kumpf       1.1 
2012                 <p style='margin-right:.4in'>Refer to JSSE reference guide <span
2013                 style='color:blue'><a
2014                 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>
2015                 </span>for more information about writing trust managers.</p>
2016                 
2017                 <p class=MsoNormal>&nbsp;</p>
2018                 
2019                 <h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:
2020 kumpf       1.2 .5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:
2021 kumpf       1.3 list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;
2022                 font-style:normal;mso-bidi-font-style:italic'><span style='mso-list:Ignore'>5.<span
2023                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2024                 style='font-style:normal;mso-bidi-font-style:italic'>Configuration<o:p></o:p></span></h2>
2025 kumpf       1.1 
2026                 <p style='margin-right:.4in;text-align:justify'>The Client SDK allows the
2027                 client applications to specify the following configuration properties in a
2028                 property file. If no property file is specified then the SDK will use default
2029                 values for all the properties. If the property file is specified but one or
2030                 more properties are not set in the property file, then SDK will use the default
2031                 values for those properties.</p>
2032                 
2033                 <div align=center>
2034                 
2035 kumpf       1.3 <table class=MsoNormalTable border=1 cellspacing=0 cellpadding=0
2036                  style='margin-left:54.9pt;border-collapse:collapse;border:none;mso-border-alt:
2037                  solid windowtext .5pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>
2038                  <tr style='mso-yfti-irow:0'>
2039                   <td width=252 valign=top style='width:189.0pt;border:solid windowtext 1.0pt;
2040                   mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2041                   <p style='margin-right:.4in;text-align:justify'><b><span
2042                   style='mso-spacerun:yes'>     </span>Property Name<o:p></o:p></b></p>
2043 kumpf       1.1   </td>
2044 kumpf       1.3   <td width=348 valign=top style='width:261.0pt;border:solid windowtext 1.0pt;
2045                   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
2046                   solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2047 kumpf       1.1   <p style='margin-right:.4in;text-align:justify'><b>Default Value<o:p></o:p></b></p>
2048                   </td>
2049                  </tr>
2050 kumpf       1.3  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
2051                   <td width=252 valign=top style='width:189.0pt;border:solid windowtext 1.0pt;
2052                   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
2053                   padding:0in 5.4pt 0in 5.4pt'>
2054                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2055                   .25in;text-align:justify'>DEBUG_XML </p>
2056                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2057                   .25in;text-align:justify'>DEBUG_XMLDECODE</p>
2058                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2059                   .25in;text-align:justify'><span class=SpellE>clientLogFilePath</span></p>
2060                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2061                   .25in;text-align:justify'><span class=SpellE>TrustManager</span></p>
2062 kumpf       1.1   </td>
2063                   <td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
2064 kumpf       1.3   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
2065 kumpf       1.1   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
2066 kumpf       1.3   mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2067 kumpf       1.1   <p style='margin-right:.4in;text-align:justify'>False</p>
2068                   <p style='margin-right:.4in;text-align:justify'>False</p>
2069                   <p style='margin-right:.4in;text-align:justify'>&quot;/logs/clientout.txt&quot;</p>
2070                   <p style='margin-right:.4in;text-align:justify'>Do not define this in
2071                   properties file unless you have your own Trust Manager. Do not set it to NULL
2072 kumpf       1.3   either. JSSE uses its default <span class=GramE>Trust<span
2073                   style='mso-spacerun:yes'>  </span>Manager</span> only if this property is not
2074                   defined.</p>
2075 kumpf       1.1   </td>
2076                  </tr>
2077                 </table>
2078                 
2079                 </div>
2080                 
2081                 <p style='margin-right:.4in;text-align:justify'>The DEBUG_XML, DEBUG_XMLDECODE,
2082 kumpf       1.3 and <span class=SpellE>clientLogFilePath</span> properties are only for
2083                 developmental debug purposes and they should not be set in the release product
2084                 and should not be exposed to the client application users.</p>
2085 kumpf       1.1 
2086                 <p style='margin-right:.4in;text-align:justify'>Note: The debug trace or
2087                 logging in the client API is not thread safe, it is recommended that clients do
2088                 not use debug logging in a multi-threaded application. </p>
2089                 
2090                 <p style='margin-right:.4in;text-align:justify'>The client applications can
2091 kumpf       1.3 only use the set methods in “<span class=SpellE>GlobalConfig</span>” class to
2092                 set the following configuration properties if needed. The above four properties
2093                 can also be set using the set methods.</p>
2094 kumpf       1.1 
2095                 <p style='margin-right:.4in;text-align:justify'>&nbsp;</p>
2096                 
2097                 <div align=center>
2098                 
2099 kumpf       1.3 <table class=MsoNormalTable border=1 cellspacing=0 cellpadding=0 width=547
2100                  style='width:409.9pt;margin-left:54.9pt;border-collapse:collapse;border:none;
2101                  mso-border-alt:solid windowtext .5pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>
2102                  <tr style='mso-yfti-irow:0'>
2103                   <td width=207 valign=top style='width:154.95pt;border:solid windowtext 1.0pt;
2104                   mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2105                   <p style='margin-right:.4in;text-align:justify'><b><span
2106                   style='mso-spacerun:yes'>     </span>Property Name<o:p></o:p></b></p>
2107 kumpf       1.1   </td>
2108 kumpf       1.3   <td width=340 valign=top style='width:254.95pt;border:solid windowtext 1.0pt;
2109                   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
2110                   solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2111 kumpf       1.1   <p style='margin-right:.4in;text-align:justify'><b>Default Value<o:p></o:p></b></p>
2112                   </td>
2113                  </tr>
2114 kumpf       1.3  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
2115                   <td width=207 valign=top style='width:154.95pt;border:solid windowtext 1.0pt;
2116                   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
2117                   padding:0in 5.4pt 0in 5.4pt'>
2118                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2119                   .25in;text-align:justify'><span class=SpellE>httpSocketProvider</span></p>
2120                   <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2121                   .25in;text-align:justify'><span class=SpellE>httpsSocketProvider</span></p>
2122 kumpf       1.1   </td>
2123                   <td width=340 valign=top style='width:254.95pt;border-top:none;border-left:
2124 kumpf       1.3   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
2125 kumpf       1.1   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
2126 kumpf       1.3   mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
2127                   <p style='margin-right:.4in;text-align:justify'><span class=SpellE>org.snia.wbemcmd.xml.PlainSocketProvider</span></p>
2128                   <p style='margin-right:.4in;text-align:justify'><span class=SpellE>org.snia.wbemcmd.xml.JSSESocketProvider</span></p>
2129 kumpf       1.1   </td>
2130                  </tr>
2131                 </table>
2132                 
2133                 </div>
2134                 
2135                 <p style='margin-right:.4in;text-align:justify;text-indent:.25in'>&nbsp;</p>
2136                 
2137                 <p style='margin-right:.4in;text-align:justify'>The client applications can
2138                 specify the properties file in the following ways:</p>
2139                 
2140 kumpf       1.3 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2141                 .5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'>1.<span
2142                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Specify the
2143                 property file on the command line by setting “–D <span class=SpellE>org.snia.wbem.cimom.properties</span>”</p>
2144                 
2145                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2146                 .25in;text-align:justify;text-indent:.25in'>For example,</p>
2147                 
2148                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2149                 .25in;text-align:justify'><span style='mso-tab-count:1'>      </span># <span
2150                 class=GramE>java</span> -<span class=SpellE>Dorg.snia.wbem.cimom.properties</span>=./<span
2151                 class=SpellE>cim.properties</span> &lt;<span class=SpellE>myAapp</span>&gt;</p>
2152                 
2153                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2154                 .5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'>2.<span
2155                 style='font-size:7.0pt'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Specify the
2156                 property file programmatically using the <span class=SpellE><span class=GramE>System.setProperty</span></span><span
2157                 class=GramE>(</span>) before creating the <span class=SpellE>CIMClient</span>
2158                 object.</p>
2159                 
2160                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2161 kumpf       1.3 .5in;text-align:justify'>For example,</p>
2162                 
2163                 <p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:
2164                 .5in;text-align:justify'><span class=SpellE><span class=GramE>System.setProperty</span></span><span
2165                 class=GramE>(</span>&quot;<span class=SpellE>org.snia.wbem.cimom.properties</span>&quot;,
2166                 “./<span class=SpellE>cim.properties</span>”);</p>
2167 kumpf       1.1 
2168 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>
2169 kumpf       1.1 
2170 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
2171 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:
2172                 Arial'><span style='mso-list:Ignore'>6.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2173                 </span></span></span><![endif]>CIM-<span class=GramE>HTTP<span
2174                 style='mso-spacerun:yes'>  </span>Listener</span></h2>
2175 kumpf       1.1 
2176 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
2177 kumpf       1.3 mso-bidi-font-size:8.0pt'><o:p>&nbsp;</o:p></span></p>
2178 kumpf       1.1 
2179 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
2180                 mso-bidi-font-size:8.0pt'>A <b>CIM-HTTP Listener </b>is an HTTP server that
2181 kumpf       1.3 receives and processes CIM Export Requests and issues CIM Export Responses. <span
2182                 class=GramE>An</span> CIM Export Message is used to transfer data from a CIM
2183                 entity into a non-CIM entity.</span><span style='font-size:12.0pt;display:none;
2184                 mso-hide:all'><o:p></o:p></span></p>
2185 kumpf       1.2 
2186                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2187                 none'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2188 kumpf       1.3 style='mso-spacerun:yes'> </span><o:p></o:p></span></p>
2189 kumpf       1.1 
2190 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><b><span style='font-size:12.0pt;
2191                 mso-bidi-font-size:9.0pt'>What are the components of a CIM-HTTP Listener?<o:p></o:p></span></b></p>
2192 kumpf       1.1 
2193                 <ul style='margin-top:0in' type=disc>
2194 kumpf       1.2  <li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><b><span
2195                      style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>CIM-HTTP Listener
2196 kumpf       1.1      Protocol “module”. </span></b><span style='font-size:12.0pt;mso-bidi-font-size:
2197 kumpf       1.2      7.0pt'>The CIM-HTTP Listener Protocol “module” receives indications from
2198                      (and generates responses to) the CIM/XML Indication Handler. </span><span
2199 kumpf       1.1      style='font-size:12.0pt;mso-bidi-font-size:7.5pt;display:none;mso-hide:
2200                      all'><o:p></o:p></span></li>
2201                 </ul>
2202                 
2203 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
2204 kumpf       1.3 mso-bidi-font-size:7.5pt'><o:p>&nbsp;</o:p></span></p>
2205 kumpf       1.1 
2206                 <ul style='margin-top:0in' type=disc>
2207 kumpf       1.2  <li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><b><span
2208 kumpf       1.1      style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>Indication Consumer.</span></b><span
2209                      style='font-size:12.0pt;mso-bidi-font-size:7.5pt'><span
2210 kumpf       1.3      style='mso-spacerun:yes'>  </span>A management application that processes,
2211                      displays, stores, analyzes, etc indications. <o:p></o:p></span></li>
2212 kumpf       1.2  <li class=MsoNormal style='color:black;mso-list:l3 level1 lfo14;tab-stops:
2213 kumpf       1.3      list .5in'><span class=SpellE><b><span style='font-size:12.0pt;mso-bidi-font-size:
2214                      7.5pt;color:windowtext'>CIM_Indication</span></b></span><b><span
2215                      style='font-size:12.0pt;mso-bidi-font-size:7.5pt;color:windowtext'>
2216                      Schema.</span></b><span style='font-size:12.0pt;mso-bidi-font-size:7.5pt;
2217                      color:windowtext'> The schema definition for indication objects of
2218                      interest to the CIM-XML Listener.</span><span style='font-size:11.0pt;
2219                      mso-bidi-font-size:7.5pt'><o:p></o:p></span></li>
2220 kumpf       1.1 </ul>
2221                 
2222 kumpf       1.2 <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                 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:7.5pt;
2226 kumpf       1.3 font-family:"Futura Bk";color:black'><o:p>&nbsp;</o:p></span></p>
2227 kumpf       1.2 
2228 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
2229                 listener is associated with the subscription through the destination property
2230                 of the handler instance. Multiple subscriptions can refer to the same handler
2231                 instance; so one listener can listen to multiple subscriptions.</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'><o:p>&nbsp;</o:p></span></p>
2235 kumpf       1.2 
2236 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
2237                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>With subscription you will
2238                 specify the destination where the Listener is running. <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'>For example,<o:p></o:p></span></p>
2242 kumpf       1.2 
2243 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
2244                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2245                 style='mso-spacerun:yes'>  </span>1. SSL enable consumer<o:p></o:p></span></p>
2246 kumpf       1.2 
2247 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
2248                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;PROPERTY
2249                 NAME=&quot;Destination&quot; TYPE=&quot;string&quot;&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;VALUE&gt;<b>https</b>://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer&lt;/VALUE&gt;<o:p></o:p></span></p>
2253 kumpf       1.2 
2254 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
2255                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;/PROPERTY&gt;<o:p></o:p></span></p>
2256 kumpf       1.2 
2257 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
2258                 style='mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2259 kumpf       1.2 
2260 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
2261                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2262                 style='mso-spacerun:yes'>  </span>1. Non-SSL enable consumer<o:p></o:p></span></p>
2263 kumpf       1.2 
2264 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
2265                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;PROPERTY
2266                 NAME=&quot;Destination&quot; TYPE=&quot;string&quot;&gt;<o:p></o:p></span></p>
2267 kumpf       1.2 
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;VALUE&gt;<b>http</b>://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer&lt;/VALUE&gt;<o:p></o:p></span></p>
2270 kumpf       1.1 
2271 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
2272                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>&lt;/PROPERTY&gt;<o:p></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'><o:p>&nbsp;</o:p></span></p>
2276 kumpf       1.2 
2277 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
2278                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>In the above case, Listener
2279                 would be running on mysystem.cup.hp.com at port 8189 with SSL enabled.</span><span
2280                 style='font-family:"Courier New"'> <o:p></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 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:7.5pt;
2286 kumpf       1.3 font-family:"Futura Bk";color:black'><o:p>&nbsp;</o:p></span></p>
2287 kumpf       1.1 
2288 kumpf       1.2 <h3 style='tab-stops:.5in'><b><span style='font-size:11.0pt;mso-bidi-font-size:
2289                 10.0pt'>Writing CIM-XML Consumer<o:p></o:p></span></b></h3>
2290                 
2291                 <p class=MsoNormal style='tab-stops:.5in'>&nbsp;</p>
2292 kumpf       1.1 
2293 kumpf       1.2 <p class=MsoNormal style='text-align:justify;tab-stops:.5in'><span
2294                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIM-XML consumer
2295 kumpf       1.3 applications use the </span><span class=SpellE><tt><span style='font-size:12.0pt;
2296                 mso-bidi-font-size:10.0pt;font-family:"Times New Roman";mso-bidi-font-family:
2297                 "Courier New"'>org.snia.wbem.listner</span></tt></span><span style='font-size:
2298                 12.0pt;mso-bidi-font-size:10.0pt'> APIs to handle CIM-XML indications that are
2299                 delivered by the client Applications.<span style='mso-spacerun:yes'> 
2300                 </span>Please follow some of examples that are provided with the SDK. <o:p></o:p></span></p>
2301 kumpf       1.1 
2302 kumpf       1.2 <p class=MsoNormal style='text-align:justify;tab-stops:.5in'><span
2303 kumpf       1.3 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2304 kumpf       1.2 
2305 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
2306                 implement a consumer using <span class=SpellE>CIMIndicationConsumer</span>
2307                 interface. Then create a <span class=SpellE>CIMListener</span> object, add the
2308                 list of consumers that are interested in consuming Indications. </p>
2309 kumpf       1.1 
2310 kumpf       1.2 <p style='tab-stops:.5in'>CIM-XML Listener Consumers typically follow this
2311                 sequence:</p>
2312                 
2313                 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2314 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>1.<span
2315                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Identify
2316                 the port number they want to listen for indications.</p>
2317 kumpf       1.1 
2318 kumpf       1.2 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2319 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>2.<span
2320                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Implement
2321                 a consumer using <span class=SpellE>CIMIndicationConsumer</span> interface.</p>
2322 kumpf       1.1 
2323 kumpf       1.2 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2324 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>3.<span
2325                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Write
2326                 it’s own <span class=GramE>‘<span class=SpellE>consumerIndication</span>(</span>);
2327                 method to process indication when received.</p>
2328 kumpf       1.1 
2329 kumpf       1.2 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2330 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>4.<span
2331                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Use
2332                 the CIM HTTP Listener APIs to start listening on a particular port.</p>
2333 kumpf       1.1 
2334 kumpf       1.2 <p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;
2335 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>5.<span
2336                 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><![endif]>Start
2337                 running as a process</p>
2338 kumpf       1.1 
2339 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
2340                 mso-bidi-font-size:10.0pt'>&nbsp;<b>Import classes<o:p></o:p></b></span></p>
2341 kumpf       1.1 
2342 kumpf       1.3 <div style='margin-left:.5in'>
2343 kumpf       1.1 
2344 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2345                 padding:1.0pt 0in 1.0pt 31.0pt'>
2346                 
2347                 <p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;
2348                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
2349                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
2350                 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>
2351                 
2352                 <p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;
2353                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
2354                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
2355                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.listener.<span
2356                 style='font-size:10.0pt'>CIMIndicationConsumer</span></span></span>;</p>
2357                 
2358                 <p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;
2359                 padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span class=GramE><span
2360                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import</span></span><span
2361                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>org.snia.wbem.xml.<span
2362                 style='font-size:10.0pt'>OperationContext</span></span></span>;</p>
2363                 
2364                 </div>
2365 kumpf       1.1 
2366                 </div>
2367                 
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.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2375 kumpf       1.3 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
2376 kumpf       1.1 
2377 kumpf       1.3 <h6>Implement <span class=SpellE>CIMIndicationConsumer</span> interface</h6>
2378 kumpf       1.1 
2379 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2380                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2381 kumpf       1.1 
2382 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;
2383                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2384                 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>
2385 kumpf       1.2 
2386 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;
2387                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2388                 1.0pt 4.0pt 1.0pt 4.0pt'><span class=GramE><span style='font-size:12.0pt;
2389                 mso-bidi-font-size:10.0pt'>public</span></span><span style='font-size:12.0pt;
2390                 mso-bidi-font-size:10.0pt'> class <span class=SpellE>MyIndicationConsumer</span>
2391                 implements <span class=SpellE>CIMIndicationConsumer</span><o:p></o:p></span></p>
2392 kumpf       1.1 
2393 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;
2394                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2395                 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>
2396 kumpf       1.1 
2397 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;
2398                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2399                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2400                 style='mso-spacerun:yes'>    </span><span class=SpellE><span class=GramE>MyIndicationConsumer</span></span><span
2401                 class=GramE>(</span>String name) <o:p></o:p></span></p>
2402 kumpf       1.1 
2403 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;
2404                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2405                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2406                 style='mso-spacerun:yes'>    </span>{ <o:p></o:p></span></p>
2407 kumpf       1.1 
2408 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;
2409                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2410                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2411                 style='mso-spacerun:yes'>     </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2412                 class=GramE>(</span>&quot;I am a consumer&quot; + name);<o:p></o:p></span></p>
2413 kumpf       1.1 
2414 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;
2415                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2416                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2417                 style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2418 kumpf       1.1 
2419 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;
2420                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2421                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2422                 style='mso-spacerun:yes'>    </span><span class=GramE>public</span> void <span
2423                 class=SpellE>consumeIndication</span>(<span class=SpellE>OperationContext</span>
2424                 context,<o:p></o:p></span></p>
2425                 
2426                 <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;
2427                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2428                 1.0pt 4.0pt 1.0pt 4.0pt'><span
2429                 style='mso-spacerun:yes'>                                </span>String URL, <span
2430                 class=SpellE>CIMIndication</span> <span class=SpellE>cime</span>)</p>
2431 kumpf       1.1 
2432 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;
2433                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2434                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2435                 style='mso-spacerun:yes'>    </span>{<o:p></o:p></span></p>
2436 kumpf       1.1 
2437 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;
2438                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2439                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2440                 style='mso-spacerun:yes'>         </span>// do something with indications
2441                 received<o:p></o:p></span></p>
2442 kumpf       1.1 
2443 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;
2444                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2445                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2446                 style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2447 kumpf       1.1 
2448 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;
2449                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2450                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2451                 style='mso-spacerun:yes'> </span>}</span></p>
2452 kumpf       1.1 
2453 kumpf       1.2 </div>
2454 kumpf       1.1 
2455 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2456 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>
2457 kumpf       1.1 
2458 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2459                 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Indication
2460 kumpf       1.3 Processor (<span class=SpellE><span class=GramE>consumeIndicattion</span></span><span
2461                 class=GramE>(</span>)) method<o:p></o:p></span></b></p>
2462 kumpf       1.2 
2463                 <p class=MsoBodyText2 style='tab-stops:.5in;mso-layout-grid-align:none;
2464 kumpf       1.3 text-autospace:none'>Once the indication is received you can have your own <span
2465                 class=SpellE><span class=GramE>consumerIndication</span></span><span
2466                 class=GramE>(</span>) method that can process the <span class=SpellE>CIMInstance</span>
2467                 which is passed by the <span class=SpellE>CIMListener</span>. Here is an
2468                 example:</p>
2469 kumpf       1.2 
2470                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2471 kumpf       1.3 none'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2472 kumpf       1.2 
2473 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2474                 padding:2.0pt 4.0pt 1.0pt 4.0pt'>
2475 kumpf       1.2 
2476                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2477                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2478                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2479 kumpf       1.3 style='mso-spacerun:yes'>        </span><span class=GramE>public</span> void <span
2480                 class=SpellE><b>consumeIndication</b></span>(<span class=SpellE>XMLOperationContext</span>
2481 kumpf       1.2 context , <o:p></o:p></span></p>
2482                 
2483                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2484                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2485                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2486 kumpf       1.3 style='mso-spacerun:yes'>                                                                       
2487                 </span>String URL<span class=GramE>,<span style='mso-spacerun:yes'>  </span><span
2488                 class=SpellE>CIMIndication</span></span> </span><st1:State><st1:place><span
2489                   class=SpellE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>ind</span></span></st1:place></st1:State><span
2490                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>)<o:p></o:p></span></p>
2491 kumpf       1.2 
2492                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2493                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2494                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2495 kumpf       1.3 style='mso-spacerun:yes'>    </span>{<o:p></o:p></span></p>
2496 kumpf       1.1 
2497 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2498                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2499 kumpf       1.3 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
2500 kumpf       1.2 
2501                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2502                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2503                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2504 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2505                 class=GramE>(</span>&quot;---------- Begin of event data ----------&quot;);<o:p></o:p></span></p>
2506 kumpf       1.2 
2507                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2508                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2509                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2510 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2511                 class=GramE>(</span>&quot;--- Indication URL : &quot;+<span class=SpellE>indURL</span>);<o:p></o:p></span></p>
2512 kumpf       1.2 
2513                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2514                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2515                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2516 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2517                 class=GramE>(</span>&quot;--- Indication : &quot;+<span class=SpellE>ind.toString</span>());<o:p></o:p></span></p>
2518 kumpf       1.2 
2519                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2520                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2521                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2522 kumpf       1.3 style='mso-spacerun:yes'>       </span><o:p></o:p></span></p>
2523 kumpf       1.2 
2524                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2525                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2526                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2527 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=GramE>try</span> <o:p></o:p></span></p>
2528 kumpf       1.2 
2529                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2530                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2531                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2532 kumpf       1.3 style='mso-spacerun:yes'>       </span>{<o:p></o:p></span></p>
2533 kumpf       1.2 
2534                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2535                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2536                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2537 kumpf       1.3 style='mso-spacerun:yes'>          </span>Object o=null;<o:p></o:p></span></p>
2538 kumpf       1.2 
2539                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2540                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2541                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2542 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=GramE>if</span> (<span
2543                 class=SpellE>ind.getClassName</span>().<span class=SpellE>startsWith</span>(&quot;<span
2544                 class=SpellE>CIM_Class</span>&quot;))<o:p></o:p></span></p>
2545 kumpf       1.2 
2546                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2547                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2548                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2549 kumpf       1.3 style='mso-spacerun:yes'>             </span>o<span class=GramE>=(</span>Object)<span
2550                 class=SpellE>ind.getProperty</span>(&quot;<span class=SpellE>classdefinition</span>&quot;).<span
2551                 class=SpellE>getValue</span>().<span class=SpellE>getValue</span>();<o:p></o:p></span></p>
2552 kumpf       1.2 
2553                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2554                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2555                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2556 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=GramE>if</span> (<span
2557                 class=SpellE>ind.getClassName</span>().<span class=SpellE>startsWith</span>(&quot;<span
2558                 class=SpellE>CIM_Inst</span>&quot;))<o:p></o:p></span></p>
2559 kumpf       1.2 
2560                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2561                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2562                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2563 kumpf       1.3 style='mso-spacerun:yes'>            </span>o<span class=GramE>=(</span>Object)
2564                 <span class=SpellE>ind.getProperty</span>(&quot;<span class=SpellE>sourceinstance</span>&quot;).<span
2565                 class=SpellE>getValue</span>().<span class=SpellE>getValue</span>();<o:p></o:p></span></p>
2566 kumpf       1.2 
2567                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2568                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2569 kumpf       1.3 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
2570 kumpf       1.2 
2571                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2572                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2573                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2574 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=GramE>if</span> (o <span
2575                 class=SpellE>instanceof</span> <span class=SpellE>CIMInstance</span>) <o:p></o:p></span></p>
2576 kumpf       1.2 
2577                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2578                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2579                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2580 kumpf       1.3 style='mso-tab-count:1'>      </span><span style='mso-spacerun:yes'>  </span>{<o:p></o:p></span></p>
2581 kumpf       1.2 
2582                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2583                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2584                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2585 kumpf       1.3 style='mso-spacerun:yes'>             </span><span class=SpellE>CIMInstance</span>
2586                 <span class=SpellE>eo</span><span class=GramE>=(</span><span class=SpellE>CIMInstance</span>)o;<o:p></o:p></span></p>
2587 kumpf       1.2 
2588                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2589                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2590                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2591 kumpf       1.3 style='mso-spacerun:yes'>             </span><span class=SpellE><span
2592                 class=GramE>System.out.println</span></span><span class=GramE>(</span>&quot;---
2593                 Embedded Instance: &quot;+<span class=SpellE>eo</span>);<o:p></o:p></span></p>
2594 kumpf       1.2 
2595                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2596                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2597                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2598 kumpf       1.3 style='mso-spacerun:yes'>          </span>}<o:p></o:p></span></p>
2599 kumpf       1.2 
2600                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2601                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2602                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2603 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=GramE>else</span> if (o <span
2604                 class=SpellE>instanceof</span> <span class=SpellE>CIMClass</span>) {<o:p></o:p></span></p>
2605 kumpf       1.2 
2606                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2607                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2608                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2609 kumpf       1.3 style='mso-spacerun:yes'>             </span><span class=SpellE>CIMClass</span>
2610                 <span class=SpellE>eo</span><span class=GramE>=(</span><span class=SpellE>CIMClass</span>)o;<o:p></o:p></span></p>
2611 kumpf       1.2 
2612                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2613                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2614                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2615 kumpf       1.3 style='mso-spacerun:yes'>             </span><span class=SpellE><span
2616                 class=GramE>System.out.println</span></span><span class=GramE>(</span>&quot;---
2617                 Embedded Class: &quot;+<span class=SpellE>eo</span>);<o:p></o:p></span></p>
2618 kumpf       1.2 
2619                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2620                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2621                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2622 kumpf       1.3 style='mso-spacerun:yes'>          </span>}<o:p></o:p></span></p>
2623 kumpf       1.2 
2624                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2625                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2626                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2627 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2628                 class=GramE>(</span>&quot;----------- End of event data -----------\n&quot;);<o:p></o:p></span></p>
2629 kumpf       1.2 
2630                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2631                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2632                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2633 kumpf       1.3 style='mso-spacerun:yes'>       </span>}<o:p></o:p></span></p>
2634 kumpf       1.2 
2635                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2636                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2637                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2638 kumpf       1.3 style='mso-spacerun:yes'>       </span><span class=GramE>catch</span>
2639                 (Exception <span class=SpellE>ee</span>) <o:p></o:p></span></p>
2640 kumpf       1.2 
2641                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2642                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2643                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2644 kumpf       1.3 style='mso-spacerun:yes'>       </span>{<o:p></o:p></span></p>
2645 kumpf       1.2 
2646                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2647                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2648                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2649 kumpf       1.3 style='mso-spacerun:yes'>          </span><span class=SpellE><span class=GramE>ee.printStackTrace</span></span><span
2650                 class=GramE>(</span>);<o:p></o:p></span></p>
2651 kumpf       1.1 
2652 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2653                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2654                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2655 kumpf       1.3 style='mso-spacerun:yes'>       </span>}<o:p></o:p></span></p>
2656 kumpf       1.1 
2657 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2658                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2659                 2.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
2660 kumpf       1.3 style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2661 kumpf       1.2 
2662 kumpf       1.1 </div>
2663                 
2664 kumpf       1.2 <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                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2668 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>
2669 kumpf       1.2 
2670                 <h4 style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:none'>Developing
2671                 CIM HTTP Listener</h4>
2672                 
2673 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>
2674 kumpf       1.2 
2675 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
2676                 class=GramE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>public</span></span><span
2677                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class <span class=SpellE>SampleListener</span><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'>{<o:p></o:p></span></p>
2681 kumpf       1.2 
2682 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
2683                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2684                 style='mso-spacerun:yes'>      </span><o:p></o:p></span></p>
2685 kumpf       1.2 
2686 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
2687                 class=SpellE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIMHTTPListener</span></span><span
2688                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <span class=SpellE>myListener</span>
2689                 <span class=GramE>=<span style='mso-spacerun:yes'>  </span>new</span> <span
2690                 class=SpellE>CIMHTTPListener</span>(<span class=SpellE>listenerPortNo</span>, <span
2691                 class=SpellE>isSSL</span>);<o:p></o:p></span></p>
2692                 
2693                 <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
2694                 class=GramE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>try</span></span><span
2695                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> {<o:p></o:p></span></p>
2696                 
2697                 <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
2698                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>// <span class=GramE>Add</span>
2699                 consumer<o:p></o:p></span></p>
2700                 
2701                 <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
2702                 class=SpellE>MyIndicationConsumer</span> consumer1 = new <span class=SpellE><span
2703                 class=GramE>MyIndicationConsumer</span></span><span class=GramE>(</span>&quot;1&quot;);</p>
2704                 
2705                 <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
2706                 class=SpellE><span class=GramE>myListener.addConsumer</span></span><span
2707 kumpf       1.3 class=GramE>(</span>consumer1);</p>
2708                 
2709                 <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
2710                 class=SpellE><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>myListener.start</span></span><span
2711                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> ();<o:p></o:p></span></p>
2712 kumpf       1.2 
2713 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
2714                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2715                 style='mso-spacerun:yes'>           </span>} <o:p></o:p></span></p>
2716 kumpf       1.2 
2717 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
2718                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2719                 style='mso-spacerun:yes'>          </span><span class=GramE>catch</span> (<span
2720                 class=SpellE>CIMExecption</span> <span class=SpellE>ce</span>) <o:p></o:p></span></p>
2721 kumpf       1.2 
2722 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
2723                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2724                 style='mso-spacerun:yes'>         </span>{<o:p></o:p></span></p>
2725 kumpf       1.2 
2726 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
2727                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2728                 style='mso-spacerun:yes'>      </span><span
2729                 style='mso-spacerun:yes'>         </span><span class=SpellE><span class=GramE>System.out.println</span></span><span
2730                 class=GramE>(</span>“Unable to add consumers: “ + <span class=SpellE>ce.getMessage</span>());<o:p></o:p></span></p>
2731 kumpf       1.2 
2732 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
2733                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
2734                 style='mso-spacerun:yes'>         </span>}<span style='mso-spacerun:yes'> 
2735 kumpf       1.2 </span><o:p></o:p></span></p>
2736                 
2737 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
2738                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>}<o:p></o:p></span></p>
2739 kumpf       1.2 
2740                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2741 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>
2742 kumpf       1.2 
2743                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2744                 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Operation
2745                 Context Object<o:p></o:p></span></b></p>
2746                 
2747 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;
2748                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2749                 mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'> </span><span
2750                 class=SpellE>OperationContext</span> class holds the operation specific
2751                 additional information that will be passed to clients or consumers. It carries
2752                 the information about the context in which the client program issued the
2753                 request.<span style='mso-spacerun:yes'>  </span><span class=SpellE>OperationContext</span>
2754                 holds container objects.<o:p></o:p></span></p>
2755 kumpf       1.1 
2756 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;
2757                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2758                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2759 kumpf       1.1 
2760 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;
2761                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2762                 mso-bidi-font-size:10.0pt'>For example: Listener interface would want to pass
2763                 additional information, such as content language, to consumers. In such case Listener
2764                 would create an Operation Context and add Content Language container into the
2765                 context. The context is passed to consumers.<o:p></o:p></span></p>
2766 kumpf       1.1 
2767 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;
2768                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2769                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2770 kumpf       1.1 
2771 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2772                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2773 kumpf       1.1 
2774 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;
2775                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2776                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2777                 12.0pt;mso-bidi-font-size:10.0pt'>Consumers can then use Context get method to
2778                 the container object.<o:p></o:p></span></p>
2779 kumpf       1.2 
2780 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;
2781                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2782                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2783                 12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p></span></p>
2784 kumpf       1.2 
2785 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;
2786                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2787                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2788                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2789                 </span>// Create Context<o:p></o:p></span></p>
2790 kumpf       1.2 
2791 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;
2792                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2793                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2794                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2795                 class=SpellE>OperationContext</span> <span class=SpellE>myContext</span> = new <span
2796                 class=SpellE><span class=GramE>OperationContext</span></span><span class=GramE>(</span>);<o:p></o:p></span></p>
2797 kumpf       1.2 
2798 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;
2799                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2800                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2801                 12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2802 kumpf       1.2 
2803 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;
2804                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2805                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2806                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2807                 </span>// <span class=GramE>Create</span> a <span class=SpellE>OperationContext</span>
2808                 Container object<o:p></o:p></span></p>
2809 kumpf       1.1 
2810 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;
2811                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2812                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2813                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2814                 class=SpellE>ExampleContextContainer</span> <span class=SpellE>myContainer</span>
2815                 = new <span class=SpellE><span class=GramE>ExampleContextContainer</span></span><span
2816                 class=GramE>(</span>);<o:p></o:p></span></p>
2817 kumpf       1.1 
2818 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;
2819                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2820                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2821                 12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2822 kumpf       1.1 
2823 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;
2824                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2825                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2826                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2827                 </span>//<o:p></o:p></span></p>
2828 kumpf       1.1 
2829 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;
2830                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2831                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2832                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2833                 </span>// insert objects into Context <o:p></o:p></span></p>
2834 kumpf       1.1 
2835 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;
2836                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2837                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2838                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2839                 </span>//<o:p></o:p></span></p>
2840 kumpf       1.1 
2841 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;
2842                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2843                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2844                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2845                 class=SpellE><span class=GramE>myContext.insert</span></span><span class=GramE>(</span>(<span
2846                 class=SpellE>OperationContext</span>)<span class=SpellE>myContainer</span>);<o:p></o:p></span></p>
2847 kumpf       1.1 
2848 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;
2849                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2850                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2851                 12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2852 kumpf       1.1 
2853 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;
2854                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2855                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2856                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2857                 </span>// <o:p></o:p></span></p>
2858 kumpf       1.1 
2859 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;
2860                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2861                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2862                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2863                 </span>// get objects from the Context <o:p></o:p></span></p>
2864 kumpf       1.1 
2865 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;
2866                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2867                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2868                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>     
2869                 </span>//<o:p></o:p></span></p>
2870 kumpf       1.1 
2871 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;
2872                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2873                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2874                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2875                 class=SpellE>ExampleContextContainer</span> <span class=SpellE>clCont</span> =<o:p></o:p></span></p>
2876 kumpf       1.1 
2877 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;
2878                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2879                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2880                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>          
2881                 </span>(<span class=SpellE>ExampleContextContainer</span><span class=GramE>)<span
2882                 class=SpellE>myContext.get</span></span>(<span class=SpellE>ExampleContextContainer.NAME</span>);<o:p></o:p></span></p>
2883 kumpf       1.1 
2884 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;
2885                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2886                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2887                 12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2888 kumpf       1.1 
2889 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;
2890                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2891                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:
2892                 12.0pt;mso-bidi-font-size:10.0pt'><span style='mso-spacerun:yes'>      </span><span
2893                 class=SpellE><span class=GramE>System.out.println</span></span><span
2894                 class=GramE>(</span>&quot;Got back :&quot; + <span class=SpellE>clCont.getName</span>());<o:p></o:p></span></p>
2895 kumpf       1.2 
2896                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2897                 none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
2898                 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>
2899                 
2900                 </div>
2901                 
2902                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
2903 kumpf       1.3 none'><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2904 kumpf       1.2 
2905 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>
2906 kumpf       1.2 
2907                 <h6><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman"'>Example
2908 kumpf       1.3 <span class=SpellE>OperationContext</span> Container<o:p></o:p></span></h6>
2909 kumpf       1.2 
2910 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;
2911                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2912                 mso-bidi-font-size:10.0pt'>The <span class=SpellE>ExampleContextContainer</span>
2913 kumpf       1.2 object carries the request context information that consumer may access. <o:p></o:p></span></p>
2914                 
2915 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;
2916                 mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;
2917                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
2918 kumpf       1.2 
2919 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
2920                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
2921 kumpf       1.1 
2922 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;
2923                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2924                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span class=GramE><span
2925                 style='font-family:"Courier New"'>public</span></span><span style='font-family:
2926                 "Courier New"'> class <span class=SpellE>ExampleContextContainer</span>
2927                 implements <span class=SpellE>OperationContextContainer</span><o:p></o:p></span></p>
2928 kumpf       1.1 
2929 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;
2930                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2931                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2932                 "Courier New"'>{<o:p></o:p></span></p>
2933 kumpf       1.1 
2934 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;
2935                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2936                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2937                 "Courier New"'><span style='mso-spacerun:yes'>    </span>/** Container name of this
2938                 container */<o:p></o:p></span></p>
2939 kumpf       1.1 
2940 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;
2941                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2942                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2943                 "Courier New"'><span style='mso-spacerun:yes'>    </span><span class=GramE>public</span>
2944                 static final String NAME=&quot;<span class=SpellE>ExampleContextContainer</span>&quot;;<o:p></o:p></span></p>
2945 kumpf       1.1 
2946 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;
2947                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2948                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2949                 "Courier New"'><span style='mso-spacerun:yes'>    </span><span class=GramE>public</span>
2950                 <span class=SpellE>ExampleContextContainer</span>() { }<o:p></o:p></span></p>
2951 kumpf       1.1 
2952 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;
2953                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2954                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2955                 "Courier New"'><o:p>&nbsp;</o:p></span></p>
2956 kumpf       1.1 
2957 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;
2958                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2959                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2960                 "Courier New"'><span style='mso-spacerun:yes'>    </span><span class=GramE>public</span>
2961                 String <span class=SpellE>getName</span>()<o:p></o:p></span></p>
2962 kumpf       1.1 
2963 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;
2964                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2965                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2966                 "Courier New"'><span style='mso-spacerun:yes'>    </span>{<o:p></o:p></span></p>
2967 kumpf       1.1 
2968 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;
2969                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2970                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2971                 "Courier New"'><span style='mso-spacerun:yes'>        </span><span class=GramE>return(</span>NAME);<o:p></o:p></span></p>
2972 kumpf       1.1 
2973 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;
2974                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2975                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2976                 "Courier New"'><span style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2977 kumpf       1.1 
2978 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;
2979                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2980                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2981                 "Courier New"'><span style='mso-spacerun:yes'>    </span><span class=GramE>public</span>
2982                 Object clone()<o:p></o:p></span></p>
2983 kumpf       1.1 
2984 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;
2985                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2986                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2987                 "Courier New"'><span style='mso-spacerun:yes'>    </span>{<o:p></o:p></span></p>
2988 kumpf       1.1 
2989 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;
2990                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2991                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2992                 "Courier New"'><span style='mso-spacerun:yes'>       </span><span class=GramE>return</span>
2993                 ((Object)new <span class=SpellE>ExampleContextContainer</span>());<o:p></o:p></span></p>
2994 kumpf       1.1 
2995 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;
2996                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
2997                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
2998                 "Courier New"'><span style='mso-spacerun:yes'>    </span>}<o:p></o:p></span></p>
2999 kumpf       1.1 
3000 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;
3001                 mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;
3002                 padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:
3003                 "Courier New"'>};</span><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p></o:p></span></p>
3004 kumpf       1.2 
3005 kumpf       1.1 </div>
3006                 
3007 kumpf       1.2 <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.2 
3013                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3014 kumpf       1.3 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3015 kumpf       1.1 
3016 kumpf       1.2 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3017                 none'><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>SSL Support
3018                 with CIM Listener<o:p></o:p></span></b></p>
3019                 
3020                 <p style='tab-stops:.5in'>The CIM Listener interface supports SSL for secure
3021                 communication. The CIM Listener (a Server) can accept either http or https
3022                 connections from the system delivering indications (an Indication Client). The
3023                 Listener applications (Indication Consumers) using the CIM Listener API would
3024                 require to have a server certificate and private key in order to support SSL
3025                 enabled communication with the Indication clients. The Listener applications
3026                 can write their own X509 Trust Manager where they can do additional validations
3027 kumpf       1.3 like host name verification. However the CIM Listener API provides a default
3028                 X509 Trust Manager that does not do any additional validations.</p>
3029 kumpf       1.2 
3030 kumpf       1.3 <p style='tab-stops:.5in'>The CIM Listener running as <span class=GramE>server,</span>
3031                 does client authentication by requesting the Indication Client to send its
3032                 certificate for authentication. Hence the Indication Client (e.g., CIM Server)
3033                 trying to connect to the CIM Listener using https connection must have its own
3034 kumpf       1.2 certificate. </p>
3035                 
3036 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
3037                 subscription</h4>
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'><b><span
3040                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
3041 kumpf       1.2 
3042 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
3043                 style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Creating subscription is
3044                 same as creating any CIM instance...you will use CIM Client interfaces to do
3045                 so. Currently WBEM (core <span class=SpellE>CIMServer</span>)<span class=GramE>&nbsp;
3046                 only</span> supports <span class=SpellE>CIM_IndicationSubscription</span>,&nbsp;<span
3047                 class=SpellE>CIM_IndicationFilter</span>, <span class=SpellE>CIM_IndicationHandlerCIMXML</span>
3048                 and <span class=SpellE>IndicationHandlerSNMPMapper</span> classes. </span><span
3049 kumpf       1.2 style='font-family:"Courier New"'><o:p></o:p></span></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 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3055 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>
3056 kumpf       1.1 
3057 kumpf       1.2 <h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;
3058 kumpf       1.3 tab-stops:list .5in'><![if !supportLists]><span style='font-family:"Courier New";
3059                 mso-fareast-font-family:"Courier New"'><span style='mso-list:Ignore'>7.<span
3060                 style='font:7.0pt "Times New Roman"'>&nbsp; </span></span></span><![endif]>Troubleshooting
3061 kumpf       1.1 and CIM Exceptions<span style='font-family:"Courier New"'><o:p></o:p></span></h2>
3062                 
3063 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>In addition to the standard CIM
3064                 Exceptions sent by the CIM Server to the client, the CIM Client library
3065                 generates the following exceptions. The exception generated by the client
3066                 library along with the reason and solution is explained below:</p>
3067 kumpf       1.1 
3068 kumpf       1.2 <p style='tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED
3069 kumpf       1.3 (Unable to Initialize Specified <span class=SpellE>TrustManager</span>: <a
3070 kumpf       1.1 href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span
3071                 style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</span></a>)<o:p></o:p></b></p>
3072                 
3073 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3074 kumpf       1.1 
3075 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3076 kumpf       1.3 indicates that the specified <span class=SpellE>TrustManager</span> may not
3077                 exist, may contain invalid path, or it may not have required permission to
3078                 load.</p>
3079 kumpf       1.1 
3080 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3081 kumpf       1.1 
3082 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Make sure that
3083 kumpf       1.3 the <span class=SpellE>TrustManager</span> you have specified exist and has
3084                 correct path and right permissions. Also make sure that the <span class=SpellE>TrustManager</span>
3085                 is not set to “null”. </p>
3086 kumpf       1.1 
3087 kumpf       1.3 <p style='tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_<span
3088                 class=GramE>FAILED(</span>SSL Factory Initialization failed: <a
3089 kumpf       1.2 href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span
3090 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>
3091                 
3092 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3093 kumpf       1.1 
3094 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3095                 may happen in number different scenarios. Such as, unable to find JSSE
3096                 providers, unable to generate random seed, unable to connect to correct server,
3097                 server had problem with SSL handshake, or policy permissions are incorrect.</p>
3098 kumpf       1.1 
3099 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3100 kumpf       1.1 
3101 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Follow JSSE
3102                 specification and make sure the system java configurations are setup correctly.</p>
3103 kumpf       1.1 
3104 kumpf       1.3 <p style='text-align:justify;tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_HTTP_<span
3105                 class=GramE>ERROR(</span>Couldn't find trusted certificate, response=500)<o:p></o:p></b></p>
3106 kumpf       1.1 
3107 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3108 kumpf       1.1 
3109 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3110                 may happen because of SSL handshake failure. SSL handshake may fail because the
3111 kumpf       1.1 certificate sent by the server was an invalid certificate or the certificate is
3112                 not in clients Trust store.</p>
3113                 
3114 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3115 kumpf       1.1 
3116 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Either add this
3117                 certificate to client Trust store or handle the certificate appropriately in
3118                 the Certificate Manager.</p>
3119 kumpf       1.1 
3120 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><b>Exception:
3121                 CIMCLIENT_ERR_TIMED_OUT (Request Timeout)<o:p></o:p></b></p>
3122 kumpf       1.1 
3123 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3124 kumpf       1.1 
3125 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3126                 indicates that a timeout has occurred on a socket read. This could mean the
3127                 server or provider may be slow in responding to client request, or the client
3128                 time out is small.</p>
3129 kumpf       1.1 
3130 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3131 kumpf       1.1 
3132 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Consider trying
3133                 this operation at some other time or might want to set client timeout or
3134 kumpf       1.3 increase the client timeout. Refer to <span class=SpellE>CIMClient</span> API
3135                 java documentation for how to set client timeout.</p>
3136 kumpf       1.1 
3137 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><b>Exception:
3138 kumpf       1.3 CIMCLIENT_ERR_CONNECTION_<span class=GramE>FAILED(</span>Connection refused) <o:p></o:p></b></p>
3139 kumpf       1.1 
3140 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: </p>
3141 kumpf       1.1 
3142 kumpf       1.2 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
3143 kumpf       1.3 indicates that an error occurred while attempting to connect to <span
3144                 class=SpellE>CIMServer</span> on a port. The <span class=SpellE>CIMServer</span>
3145                 may not be running on the specified address or it may not be listening on the
3146                 specified port.</p>
3147 kumpf       1.2 
3148                 <p style='text-align:justify;tab-stops:.5in'>Solution: </p>
3149                 
3150                 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Check to make
3151                 sure that the server address is correct and the port number specified is the
3152 kumpf       1.3 correct port number for an SSL or non-SSL communication. (e.g., <span
3153                 class=GramE>This</span> exception may be thrown if the <span class=SpellE>CIMServer</span>
3154                 is SSL enabled and listening on port 5989, the client trying to connect to
3155                 non-SSL port 5988.)</p>
3156 kumpf       1.1 
3157 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><b>Exception:
3158 kumpf       1.3 CIMCLIENT_ERR_CONNECTION_<span class=GramE>FAILED(</span>sequoia Unknown host) <o:p></o:p></b></p>
3159 kumpf       1.1 
3160 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Problem: This exception indicates
3161 kumpf       1.3 that the <span class=SpellE>CIMServer</span> address specified may contain an
3162                 invalid system name or the system is not reachable.</p>
3163 kumpf       1.2 
3164                 <p style='text-align:justify;tab-stops:.5in'>Solution:<span
3165 kumpf       1.3 style='mso-spacerun:yes'>  </span>Make sure the specified <span class=SpellE>CIMServer</span>
3166                 address is correct and the remote system is reachable.</p>
3167 kumpf       1.2 
3168                 <h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:
3169                 italic'>&nbsp;<o:p></o:p></span></h2>
3170                 
3171                 <i style='mso-bidi-font-style:normal'><span style='font-size:12.0pt;mso-bidi-font-size:
3172                 10.0pt;font-family:Arial;mso-fareast-font-family:"Times New Roman";mso-ansi-language:
3173                 EN-US;mso-fareast-language:EN-US;mso-bidi-language:AR-SA'><br clear=all
3174                 style='page-break-before:always'>
3175                 </span></i>
3176                 
3177                 <h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:
3178 kumpf       1.3 italic'>Appendix A:<span style='mso-spacerun:yes'>  </span>CIM Client FAQ<o:p></o:p></span></h2>
3179 kumpf       1.2 
3180 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;
3181                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3182                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3183 kumpf       1.2 
3184 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;
3185                 text-autospace:none'><span class=SpellE><span class=GramE><span
3186                 style='font-family:"Courier New"'>CIMInstance.getKeyValuePairs</span></span></span><span
3187                 class=GramE><span style='font-family:"Courier New"'>(</span></span><span
3188                 style='font-family:"Courier New"'>) returns no keys although there are multiple
3189                 keys in my (<span class=SpellE>exaple</span> <span class=SpellE>PG_OperatingSystem</span>
3190                 has 4 keys) provider.<o:p></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"'><o:p>&nbsp;</o:p></span></p>
3194 kumpf       1.2 
3195 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;
3196                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>This
3197                 bug is fixed in 2.0 Final Release. <o:p></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;
3200                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3201 kumpf       1.2 
3202 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
3203                 style='font-family:"Courier New"'>I see my client hangs and does not return or
3204                 how to set timeouts in a Client?<o:p></o:p></span></b></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"'><o:p>&nbsp;</o:p></span></p>
3208 kumpf       1.2 
3209 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;
3210                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>When
3211                 you have a SSL enabled client trying to connect non-SSL <span class=SpellE>CIMServer</span>
3212                 and vice-versa. You may notice that the client does not return. In such case
3213                 you should make sure to set the proper timeouts.<o:p></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"'><o:p>&nbsp;</o:p></span></p>
3217 kumpf       1.2 
3218 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;
3219                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>Here
3220                 is how you can set the timeouts:<o:p></o:p></span></p>
3221 kumpf       1.2 
3222 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;
3223                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>1.
3224                 Set READ timeout, refer to <span class=SpellE>CIMClient</span> class<o:p></o:p></span></p>
3225 kumpf       1.2 
3226                 <h3 style='margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt;margin-left:
3227 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;
3228                 mso-layout-grid-align:none;text-autospace:none'><span style='mso-bidi-font-size:
3229                 12.0pt;font-family:"Times New Roman"'><span style='mso-spacerun:yes'>   </span><span
3230                 style='mso-tab-count:1'>            </span><span style='mso-tab-count:1'>               </span><span
3231                 class=SpellE><span class=GramE>CIMClient.setTimeout</span></span><span
3232                 class=GramE>(</span><span class=SpellE>int</span> timeout); //in milliseconds<o:p></o:p></span></h3>
3233 kumpf       1.2 
3234 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
3235 kumpf       1.2 style='font-family:"Courier New"'>This is a read timeout, i.e. the client has
3236                 found the server and connected to it, and the server is not responding to any
3237                 request. Basically the socket is blocked. This may happen in case of a Non-SSL
3238                 client connecting to SSL server and also vice versa. For your applications I
3239 kumpf       1.3 think <span class=SpellE><span class=GramE>setTimeout</span></span><span
3240                 class=GramE>(</span>) call is good enough.<o:p></o:p></span></p>
3241                 
3242                 <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>
3243                 
3244                 <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;
3245                 mso-layout-grid-align:none;text-autospace:none'>2.<span style='font-family:
3246                 "Courier New"'> To set the connection timeout<o:p></o:p></span></p>
3247                 
3248                 <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;
3249                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><span
3250                 style='mso-spacerun:yes'>    </span><span style='mso-tab-count:2'>           </span>//Assumption
3251                 timeout is in seconds<o:p></o:p></span></p>
3252                 
3253                 <pre style='text-indent:.5in;mso-layout-grid-align:none;text-autospace:none'><span
3254                 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>
3255                 
3256                 <p class=MsoNormal style='margin-left:.5in;text-indent:.5in;tab-stops:.5in;
3257                 mso-layout-grid-align:none;text-autospace:none'><span class=SpellE><span
3258                 class=GramE><span style='font-family:"Courier New"'>System.setProperty</span></span></span><span
3259                 class=GramE><span style='font-family:"Courier New"'>(</span></span><span
3260 kumpf       1.3 style='font-family:"Courier New"'>&quot;java.net.connectiontimeout&quot;,&quot;20&quot;)
3261                 <o:p></o:p></span></p>
3262                 
3263                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3264                 none'><span style='font-family:"Courier New"'><span
3265                 style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'>     </span>Or<o:p></o:p></span></p>
3266 kumpf       1.2 
3267 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3268                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'> 
3269                 </span><span style='mso-tab-count:1'>    </span>You can pass it at run time,
3270                 using<o:p></o:p></span></p>
3271 kumpf       1.2 
3272 kumpf       1.3 <p class=MsoNormal style='margin-left:.5in;tab-stops:.5in;mso-layout-grid-align:
3273                 none;text-autospace:none'><span style='font-family:"Courier New"'><span
3274                 style='mso-spacerun:yes'>     </span><span class=GramE>java</span> -<span
3275                 class=SpellE>Djava.net.connectiontimeout</span>=20<span
3276                 style='mso-spacerun:yes'>  </span><span class=SpellE>myclient</span><o:p></o:p></span></p>
3277 kumpf       1.2 
3278 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3279                 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3280 kumpf       1.2 
3281 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><o:p>&nbsp;</o:p></p>
3282 kumpf       1.2 
3283 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>
3284 kumpf       1.2 
3285 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><b><span style='font-family:"Courier New"'>How
3286                 </span></b><b><span style='font-family:Arial'>to decode a property that is an enumeration?
3287                 I.E. to decode the numeric value that is returned for the property.<span
3288                 style='mso-spacerun:yes'>  </span>Does WBEM provide methods to look up the
3289                 numeric value to retrieve a String value?<span style='mso-spacerun:yes'> 
3290 kumpf       1.2 </span>Or do I need to implement a look up table for every enumeration that I
3291                 am interested in?<o:p></o:p></span></b></p>
3292                 
3293 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><span style='font-family:Arial'>&nbsp;<o:p></o:p></span></p>
3294 kumpf       1.2 
3295 kumpf       1.3 <pre style='mso-layout-grid-align:none;text-autospace:none'><span
3296                 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
3297                 class=SpellE>getClass</span> operation.</pre>
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"'><o:p>&nbsp;</o:p></span></p>
3301 kumpf       1.2 
3302 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3303                 none'><span style='font-family:"Courier New"'>For example, <span class=SpellE>PG_NISServerService</span><span
3304                 class=GramE>::</span> <span class=SpellE>ServerType</span> is an
3305                 enumeration.<span style='mso-spacerun:yes'>  </span>When I make the request I
3306                 get a numeric value between 0 and 4 (inclusive).<span
3307                 style='mso-spacerun:yes'>  </span>I then have to decode the numeric values as
3308 kumpf       1.2 such:<o:p></o:p></span></p>
3309                 
3310 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3311                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3312 kumpf       1.2 </span>&quot;0&quot; - Unknown<o:p></o:p></span></p>
3313                 
3314 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3315                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3316 kumpf       1.2 </span>&quot;1&quot; - Other<o:p></o:p></span></p>
3317 kumpf       1.1 
3318 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3319                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3320                 </span>&quot;2&quot; - Not an </span><st1:City><st1:place><span
3321                   style='font-family:"Courier New"'>NIS</span></st1:place></st1:City><span
3322                 style='font-family:"Courier New"'> Server<o:p></o:p></span></p>
3323 kumpf       1.1 
3324 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3325                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3326 kumpf       1.2 </span>&quot;3&quot; - NIS Master<o:p></o:p></span></p>
3327 kumpf       1.1 
3328 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3329                 none'><span style='font-family:"Courier New"'><span style='mso-spacerun:yes'>  
3330                 </span>&quot;4&quot; - </span><st1:City><st1:place><span style='font-family:
3331                   "Courier New"'>NIS</span></st1:place></st1:City><span style='font-family:
3332                 "Courier New"'> Slave<o:p></o:p></span></p>
3333                 
3334                 <p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:
3335                 none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3336                 
3337                 <p style='text-align:justify;tab-stops:.5in'><b>The <span class=SpellE>cimclient</span>
3338                 library performs the SSL handshaking and receives the certificate/key, what
3339                 environment settings must be in place for certificates to be passed?<o:p></o:p></b></p>
3340 kumpf       1.2 
3341                 <p style='text-align:justify;tab-stops:.5in'>Clients must create a trust store,
3342                 import certificates from the server they trust in to the trust store, provide
3343 kumpf       1.3 the trust store path to the JSSE either on the command line ( java -<span
3344                 class=SpellE>Djavax.net.ssl.trustStore</span>=<span class=SpellE>mytruststore</span>
3345                 &lt;<span class=SpellE>MyClient</span>&gt;<span style='mso-spacerun:yes'> 
3346                 </span>) or through</p>
3347                 
3348                 <p style='text-align:justify;tab-stops:.5in'><span class=SpellE><span
3349                 class=GramE>System.setProperty</span></span><span class=GramE>(</span>&quot;<span
3350                 class=SpellE>javax.net.trustStore</span>&quot;, &quot;<span class=SpellE>mytruststore</span>&quot;);</p>
3351                 
3352                 <p style='text-align:justify;tab-stops:.5in'><b>How do set ‘<span class=SpellE>trustManager</span>’
3353                 property </b><b><span style='font-size:10.0pt;font-family:Arial'>programmatically?<o:p></o:p></span></b></p>
3354                 
3355                 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3356                 mso-bidi-font-size:10.0pt'><span style='mso-tab-count:1'>            </span>String
3357                 <span class=SpellE>myTrustManager</span>= &quot;<span class=SpellE>org.mycompany.cimapp.myCertManager</span>&quot;;<o:p></o:p></span></p>
3358                 
3359                 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3360                 mso-bidi-font-size:10.0pt'><span style='mso-tab-count:1'>            </span><span
3361                 class=SpellE><span class=GramE>GlobalConfig.setTrustManager</span></span><span
3362                 class=GramE>(</span><span class=SpellE>myTrustManager</span>);<o:p></o:p></span></p>
3363 kumpf       1.1 
3364 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3365                 mso-bidi-font-size:10.0pt'>Note that you can not set this property to ‘null’. If
3366                 you would like to use the default trust manager provided in JSSE, do not even
3367                 define the trust manager property in your program or in your properties file.<o:p></o:p></span></p>
3368 kumpf       1.1 
3369 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3370                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></p>
3371 kumpf       1.1 
3372 kumpf       1.3 <h4 style='tab-stops:.5in'>Can I change the trust manager property in between
3373                 my program/process?</h4>
3374 kumpf       1.2 
3375 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><b><span style='font-size:12.0pt;
3376                 mso-bidi-font-size:10.0pt'><o:p>&nbsp;</o:p></span></b></p>
3377 kumpf       1.1 
3378 kumpf       1.3 <p class=MsoNormal style='tab-stops:.5in'><span style='font-size:12.0pt;
3379                 mso-bidi-font-size:10.0pt'>No, you cannot. If you define/set this property in
3380                 your Client application either using <span class=SpellE><span class=GramE>setTrustManager</span></span><span
3381                 class=GramE>(</span>) or through<span style='mso-spacerun:yes'>  </span>WBEM
3382                 Client configuration file (like <span class=SpellE>cim.properties</span>) it
3383                 will be set once per process, I.E you can not set/unset for every connection
3384                 being in the same process.<o:p></o:p></span></p>
3385                 
3386                 <p style='text-align:justify;tab-stops:.5in'><b>Does the <span class=SpellE>cimclient</span>
3387                 library accept the certificate and place it in the trust store?<span
3388                 style='mso-spacerun:yes'>  </span>How would the application specify to the <span
3389                 class=SpellE>cimclient</span> library where the trust store is<o:p></o:p></b></p>
3390 kumpf       1.1 
3391 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Client library using JSSE will
3392                 only validate the server certificate using the trust store. It accepts only
3393                 trusted certificates from the server. In case of non-trusted certificate the
3394                 client library will call the trust manager if there is one specified. It is the
3395                 job of trust manager to either accept the server certificate (possibly add that
3396                 to the trust store) or reject the certificate.</p>
3397 kumpf       1.1 
3398 kumpf       1.3 <p style='text-align:justify;tab-stops:.5in'><b>How <span class=GramE>is the
3399                 client application</span> notified that the certificate or key was placed in
3400                 the trust store?<span style='mso-spacerun:yes'>  </span>Is this assumed?<o:p></o:p></b></p>
3401 kumpf       1.1 
3402 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'>Same as above</p>
3403                 
3404                 <p style='text-align:justify;tab-stops:.5in'><b>Can the client application set
3405                 the environment so that certificates or keys are required from some target
3406                 systems but other target systems are not validated or authenticated?<o:p></o:p></b></p>
3407                 
3408                 <p style='text-align:justify;tab-stops:.5in'>Yes, trust manager can do this.</p>
3409                 
3410                 <p style='text-align:justify;tab-stops:.5in'><b>Where can I find more
3411                 information on Trust Manager and Trust Stores?<o:p></o:p></b></p>
3412                 
3413                 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>More information
3414 kumpf       1.3 can be found at J2SE web site.<span style='mso-spacerun:yes'>  </span>- ----</p>
3415 kumpf       1.2 
3416                 <p style='margin-left:.5in;text-align:justify;tab-stops:.5in'><span
3417                 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>
3418                 
3419                 <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
3420 kumpf       1.1 </p>
3421                 
3422 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><b>I am unable use/initialize SSL
3423                 connection, what do I do?<o:p></o:p></b></p>
3424 kumpf       1.1 
3425 kumpf       1.2 <p style='text-align:justify;tab-stops:.5in'><span style='mso-bidi-font-family:
3426                 "Courier New"'>Some applications have their own version of Java included in it
3427                 and they use the included Java, not the one you installed on the systems (such
3428                 as the one from /opt/java). In such cases make sure that java security
3429                 configuration files are not modified.</span></p>
3430                 
3431 kumpf       1.3 <p style='text-align:justify;tab-stops:.5in'><b>How can I find out <span
3432                 class=SpellE>cimclient.jar</span> version?<o:p></o:p></b></p>
3433 kumpf       1.2 
3434 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
3435                 class=GramE>java</span> <span class=SpellE>org.snia.wbem.PackageVersion</span></pre><pre><span style='mso-spacerun:yes'>   </span></pre>
3436 kumpf       1.2 
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'><b>My
3438                 GUI application doesn’t work properly on HP-UX?</b></p>
3439                 
3440                 <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
3441 kumpf       1.3 is a bug in Java 1.4 HP-UX version (and 1.3) AWT libraries. For this you will need
3442                 to install PHSS_24303 patch. I also found that Patch PHSS_24303 replaced by
3443                 PHSS_26262. So we will need PHSS_26262.</p>
3444                 
3445                 <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;
3446                 text-autospace:none'><span class=SpellE><span class=GramE><span
3447                 style='font-family:"Courier New"'>CIMInstance.getKeyValuePairs</span></span></span><span
3448                 class=GramE><span style='font-family:"Courier New"'>(</span></span><span
3449                 style='font-family:"Courier New"'>) returns no keys although there are multiple
3450                 keys in my (<span class=SpellE>exaple</span> <span class=SpellE>PG_OperatingSystem</span>
3451                 has 4 keys) provider.<o:p></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"'><o:p>&nbsp;</o:p></span></p>
3455                 
3456                 <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;
3457                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>This
3458                 bug is fixed in 2.0 Final Release.<span style='mso-spacerun:yes'>  </span>You
3459                 should not see this bug.<o:p></o:p></span></p>
3460 kumpf       1.1 
3461 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>
3462 kumpf       1.1 
3463 kumpf       1.2 <h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:
3464                 italic'>Appendix B: CIM Listener FAQ<o:p></o:p></span></h2>
3465 kumpf       1.1 
3466 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;
3467                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3468                 "Courier New"'>Question 1: How to Create Subscriptions?</span></b><span
3469 kumpf       1.2 style='font-family:"Courier New"'><o:p></o:p></span></p>
3470 kumpf       1.1 
3471 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
3472                 style='font-size:10.0pt;font-family:"Courier New"'>Creating subscription is
3473                 same as creating any CIM instance...you will use CIM Client interfaces to do
3474                 so. Currently WBEM (core <span class=SpellE>CIMServer</span>)
3475                 only&nbsp;supports <span class=SpellE>CIM_IndicationSubscription</span>,&nbsp;<span
3476                 class=SpellE>CIM_IndicationFilter</span>, <span class=SpellE><span class=GramE>CIM</span>_IndicationHandlerCIMXML</span>
3477                 and </span><span class=SpellE>IndicationHandlerSNMPMapper</span><span
3478 kumpf       1.2 style='font-size:10.0pt;font-family:"Courier New"'> classes.<o:p></o:p></span></p>
3479                 
3480 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
3481                 style='font-size:10.0pt;font-family:"Courier New"'>Question 2:<span
3482                 style='mso-spacerun:yes'>  </span>When a listener is created, does it execute
3483 kumpf       1.2 in its own thread, separate from the code that created it</span></b><span
3484                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
3485                 
3486 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
3487                 style='font-family:"Courier New"'>Listener runs as&nbsp;server (either SSL or
3488                 non-SSL) and listens on the specified port. When&nbsp;Listener <span
3489                 class=SpellE><span class=GramE>startCIMHTTPListener</span></span><span
3490                 class=GramE>(</span>) is called, it will create a thread and starts listening.<br>
3491 kumpf       1.2 &nbsp;<o:p></o:p></span></p>
3492 kumpf       1.1 
3493 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
3494                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3495                 
3496                 <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;
3497                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3498                 "Courier New"'>Question 3:</span></b><span style='font-family:"Courier New"'> <b>I
3499                 am unable to modify instances of <span class=SpellE>CIM_IndicationHandlerCIMXML</span>
3500                 class.<span style='mso-spacerun:yes'>  </span>Client says - Unable to modify
3501                 instance: CIM_ERR_NOT_<span class=GramE>FOUND(</span>CIM_ERR_NOT_FOUND: The
3502                 requested object could not be found: &quot;<span class=SpellE>CIM_IndicationHandlerCIMXML</span>&quot;)<o:p></o:p></b></span></p>
3503                 
3504                 <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;
3505                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3506                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3507                 
3508                 <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;
3509                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>The
3510                 <span class=SpellE>modifyInstance</span> operation is not supported for the<o:p></o:p></span></p>
3511                 
3512                 <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;
3513                 mso-layout-grid-align:none;text-autospace:none'><span class=SpellE><span
3514 kumpf       1.3 style='font-family:"Courier New"'>CIM_IndicationHandlerCIMXML</span></span><span
3515                 style='font-family:"Courier New"'> class or <span class=SpellE>CIM_IndicationFilter</span>
3516                 class, and <span class=GramE>for<span style='mso-spacerun:yes'>  </span><span
3517                 class=SpellE>CIM</span></span><span class=SpellE>_IndicationSubscription</span>,
3518                 only modification of the <span class=SpellE>SubscriptionState</span>
3519                 property<span style='mso-spacerun:yes'>  </span>is supported.<span
3520                 style='mso-spacerun:yes'>  </span>So, it's necessary to delete the old instance
3521                 and create a new instance with the desired change.<span
3522                 style='mso-spacerun:yes'>  </span>Also, deletion of a filter or handler that is
3523                 referenced by an existing subscription is not allowed, without first<o:p></o:p></span></p>
3524                 
3525                 <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;
3526                 mso-layout-grid-align:none;text-autospace:none'><span class=GramE><span
3527                 style='font-family:"Courier New"'>deleting</span></span><span style='font-family:
3528                 "Courier New"'> the subscription.<o:p></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"'><o:p>&nbsp;</o:p></span></p>
3532                 
3533                 <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;
3534                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>However,
3535 kumpf       1.3 in the case you should see something like &quot;CIM_ERR_NOT_SUPPORTED: The requested
3536                 operation is not supported&quot;, rather than CIM_ERR_NOT_FOUND.<span
3537                 style='mso-spacerun:yes'>  </span>Make sure to check that your request
3538                 specifies <span class=GramE>the<span style='mso-spacerun:yes'>  </span>correct</span>
3539                 namespace, key values, etc.<span style='mso-spacerun:yes'>  </span>It looks
3540                 like perhaps the <span class=SpellE>instancename</span> parameter to the <span
3541                 class=SpellE>modifyInstance</span> operation included only the <span
3542                 class=SpellE>classname</span> and not the key values.<o:p></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'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3546                 
3547                 <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;
3548                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3549                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3550                 
3551                 <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
3552                 4: If I create instances of <span class=SpellE>CIM_IndicationFilter</span>, and
3553                 corresponding instances of <span class=SpellE>CIM_IndicationSubscription</span>,
3554                 and <span class=SpellE>CIM_IndicationHandlerCIMXML</span> classes, does the
3555                 CIMOM check for the presence of the Indication provider? <span class=GramE>if</span>
3556 kumpf       1.3 '<span class=SpellE>RT_TestIndication</span>'(sample indication provider) is
3557                 not present, Will it give an error response?<o:p></o:p></b></p>
3558                 
3559                 <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"'><o:p>&nbsp;</o:p></span></p>
3561 kumpf       1.2 
3562 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;
3563                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>When
3564                 you create an enabled Subscription, the <span class=SpellE>IndicationService</span>
3565                 will look for indication providers that can serve the subscription.<span
3566                 style='mso-spacerun:yes'>  </span>If none are found, you will get an error
3567                 response.<span style='mso-spacerun:yes'>  </span>The subscriber doesn't specify
3568                 an indication provider. The subscriber specifies the desired indication
3569                 subclass, properties and namespace in the Filter.<span
3570                 style='mso-spacerun:yes'>   </span>The <span class=SpellE>IndicationService</span>
3571                 looks for indication providers that have registered to serve the specified
3572                 indication class in the specified namespace.<span style='mso-spacerun:yes'> 
3573                 </span>Maybe your indication provider is not registered?<span
3574                 style='mso-spacerun:yes'>  </span>Let me know if you need help registering your
3575                 indication provider.<o:p></o:p></span></p>
3576 kumpf       1.2 
3577 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;
3578                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3579 kumpf       1.2 
3580 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
3581                 5: If I create a disabled subscription (the property <span class=SpellE>SubscriptionState</span>
3582                 is set to 'Disabled'), will the <span class=SpellE>IndicationService</span>
3583 kumpf       1.2 still check for the presence of the indication provider?<o:p></o:p></b></p>
3584                 
3585 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;
3586                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3587                 
3588                 <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
3589                 style='font-weight:normal'>If you create the Subscription with <span
3590                 class=SpellE>SubscriptionState</span> property set to 'Disabled', the <span
3591                 class=SpellE>IndicationService</span> will NOT check whether there is an
3592                 indication provider to serve the subscription.<span style='mso-spacerun:yes'> 
3593                 </span>So maybe that's what you want to do for now, to get going.<o:p></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'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3597                 
3598                 <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;
3599                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3600                 "Courier New"'>Question 6:<span style='mso-spacerun:yes'>  </span>Since the <span
3601                 class=SpellE>IndicationService</span> knows which indication subclass is served
3602                 by an indication provider, is it required that the instances of indication
3603                 classes be created before the provider is registered?<o:p></o:p></span></b></p>
3604                 
3605                 <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;
3606 kumpf       1.3 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3607                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3608                 
3609                 <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
3610                 style='font-weight:normal'>The <span class=SpellE>IndicationService</span>
3611                 checks that the class specified in the Filter is a subclass of <span
3612                 class=SpellE>CIM_Indication</span>, so you must define the indication subclass
3613                 you'll be using.<span style='mso-spacerun:yes'>  </span>(Instances of the
3614                 indication subclass don't get created until the indication provider generates
3615                 an indication.)<o:p></o:p></span></p>
3616                 
3617                 <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'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
3619 kumpf       1.2 
3620 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;
3621                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3622                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3623                 
3624                 <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;
3625                 mso-layout-grid-align:none;text-autospace:none'><b><span style='font-family:
3626                 "Courier New"'><o:p>&nbsp;</o:p></span></b></p>
3627                 
3628                 <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
3629                 style='font-family:"Courier New"'>Question 7:<span style='mso-spacerun:yes'> 
3630                 </span>How a particular listener is associated with a given subscription and
3631                 what goes into the Destination property&nbsp;CIM_ <span class=SpellE>IndicationHandlerCIMXML</span><o:p></o:p></span></b></p>
3632                 
3633                 <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
3634                 style='font-size:10.0pt;font-family:"Courier New"'>The listener is associated
3635                 with the subscription through the destination property of the handler instance.
3636                 Multiple subscriptions can refer to the same handler instance; so one listener
3637                 can listen to multiple subscriptions.</span><span style='font-size:10.0pt;
3638                 mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
3639 kumpf       1.2 
3640 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
3641                 style='font-size:10.0pt;font-family:"Courier New"'>With subscription you will
3642                 specify the destination where the Listener is running. An example,</span><span
3643 kumpf       1.2 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
3644                 
3645 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
3646                 style='font-size:10.0pt;font-family:"Courier New"'>&lt;PROPERTY
3647                 NAME=&quot;Destination&quot; TYPE=&quot;string&quot;&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;VALUE&gt;https://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer&lt;/VALUE&gt;<o:p></o:p></span></p>
3651 kumpf       1.2 
3652 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
3653                 style='font-size:10.0pt;font-family:"Courier New"'>&lt;/PROPERTY&gt;</span><span
3654                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
3655 kumpf       1.2 
3656 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
3657                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'>In
3658 kumpf       1.2 the above case, Listener would be running on mysystem.cup.hp.com at port 8189
3659                 with SSL enabled.</span><span style='font-family:"Courier New"'> <o:p></o:p></span></p>
3660                 
3661 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
3662                 style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'>Question
3663                 8:<span style='mso-spacerun:yes'>  </span></span></b><b><span style='font-size:
3664                 10.0pt;font-family:"Courier New"'>Can I specify/use any port number with my
3665                 Listener?<o:p></o:p></span></b></p>
3666                 
3667                 <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
3668                 style='font-size:10.0pt;font-family:"Courier New"'>It is not a good plan to
3669                 select any port&nbsp;and have the application use it.<span
3670                 style='mso-spacerun:yes'>  </span>It is recommended that a Listener application
3671                 to have&nbsp;its own port number and is registered with IANA so that no one
3672                 else uses that port number. And also if the application is going to be running
3673                 on HP-UX, you can request INET Team to have the IANA registered port number added
3674                 to /etc/services. This way no other HP-UX application uses your port numbers.<o:p></o:p></span></p>
3675 kumpf       1.2 
3676 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
3677                 style='font-family:"Courier New"'>Question 9: when the client creates the
3678                 indication listener, does it return an error if a listener already exists on
3679                 that system on the same port?&nbsp;<o:p></o:p></span></b></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"'><o:p>&nbsp;</o:p></span></p>
3683 kumpf       1.2 
3684 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
3685                 style='font-family:"Courier New"'>Yes it does&nbsp;say - Address is in use.<o:p></o:p></span></p>
3686                 
3687                 <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>
3688 kumpf       1.2 
3689                 <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
3690 kumpf       1.3 style='font-family:"Courier New"'>Question 10: Create Instance for <span
3691                 class=SpellE>CIM_IndicationSubscription</span> fails; However, I can create
3692                 Handler and Filter instances.<o:p></o:p></span></b></p>
3693                 
3694                 <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;
3695                 mso-layout-grid-align:none;text-autospace:none'><span style='font-family:"Courier New"'>There
3696                 is a problem with Java Client API while creating instance with reference values
3697                 related to indication subscription class. This is mainly because of <span
3698                 class=GramE>Each</span> time the <span class=SpellE>ObjectPath</span> gets
3699                 passed to CIM Operations, Client API modifies the <span class=SpellE>CIMObjectPath</span>
3700                 after it gets the response from <span class=SpellE>cimserver</span>. The work
3701                 around is to store the <span class=SpellE>CIMObjectPath</span> that is passed
3702                 to <span class=SpellE><span class=GramE>createInstance</span></span><span
3703                 class=GramE>(</span>) while creating Filter and Handler instances. Then use
3704                 that stored paths in Subscription.<o:p></o:p></span></p>
3705 kumpf       1.2 
3706                 <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
3707 kumpf       1.3 style='font-family:"Courier New"'>Refer to the example (examples/Indication/<span
3708                 class=SpellE><span class=GramE>SubscribeIndTest.java</span></span><span
3709                 class=GramE> )</span> that is in WBEM Java Client SDK.<o:p></o:p></span></p>
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'><o:p>&nbsp;</o:p></span></h2>
3713 kumpf       1.2 
3714                 <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
3715 kumpf       1.3 style='font-style:normal;mso-bidi-font-style:italic'>Appendix C: Example <span
3716                 class=SpellE>cim.properties</span> configuration file<o:p></o:p></span></h2>
3717 kumpf       1.2 
3718                 <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>
3719 kumpf       1.1 
3720 kumpf       1.3 <div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;
3721                 padding:1.0pt 4.0pt 1.0pt 4.0pt'>
3722 kumpf       1.1 
3723 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;
3724                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3725                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3726 kumpf       1.3 style='mso-spacerun:yes'>    </span>// <o:p></o:p></span></p>
3727 kumpf       1.1 
3728 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;
3729                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3730                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3731 kumpf       1.3 style='mso-spacerun:yes'>    </span>// Example <span class=SpellE>cim.properties</span><o:p></o:p></span></p>
3732 kumpf       1.1 
3733 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;
3734                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3735                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3736 kumpf       1.3 style='mso-spacerun:yes'>    </span>//<o:p></o:p></span></p>
3737 kumpf       1.1 
3738 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;
3739                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3740                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3741 kumpf       1.3 style='mso-spacerun:yes'>    </span>DEBUG_XML=false <o:p></o:p></span></p>
3742 kumpf       1.1 
3743 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;
3744                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3745                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3746 kumpf       1.3 style='mso-spacerun:yes'>    </span>DEBUG_XMLDECODE=false<o:p></o:p></span></p>
3747 kumpf       1.1 
3748 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;
3749                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3750                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3751 kumpf       1.3 style='mso-spacerun:yes'>    </span><span class=SpellE><span class=GramE>clientLogFilePath</span></span><span
3752                 class=GramE>=</span>cimclient.txt<o:p></o:p></span></p>
3753 kumpf       1.1 
3754 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;
3755                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3756                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'>&nbsp;<o:p></o:p></span></p>
3757 kumpf       1.1 
3758 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;
3759                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3760                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3761 kumpf       1.3 style='mso-spacerun:yes'>    </span>// CIM Clients may specify their own Trust
3762 kumpf       1.2 Manager to use <o:p></o:p></span></p>
3763 kumpf       1.1 
3764 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;
3765                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3766                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3767 kumpf       1.3 style='mso-spacerun:yes'>    </span>// instead of the default JSSE <span
3768                 class=SpellE>TrustManager</span>.<o:p></o:p></span></p>
3769 kumpf       1.1 
3770 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;
3771                 border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:
3772                 1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:"Courier New"'><span
3773 kumpf       1.3 style='mso-spacerun:yes'>    </span><span class=SpellE>TrustManager</span>=<span
3774                 class=SpellE>org.mycompany.myapp.MyCertificateManager</span><o:p></o:p></span></p>
3775 kumpf       1.1 
3776                 </div>
3777                 
3778 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
3779                 style='font-family:"Courier New"'>&nbsp;<o:p></o:p></span></p>
3780 kumpf       1.1 
3781                 </div>
3782                 
3783                 </body>
3784                 
3785                 </html>

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2