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

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2