pegasus-JavaCIMClient/docs/ReleaseNotes.htm - diff

Return to ReleaseNotes.htm CVS log

Up to [Pegasus] / pegasus-JavaCIMClient / docs

Diff for /pegasus-JavaCIMClient/docs/ReleaseNotes.htm between version 1.1.4.1 and 1.7

version 1.1.4.1, 2003/07/29 15:08:28

version 1.7, 2005/11/18 20:41:19

Line 1

<html xmlns:o="urn:schemas-microsoft-com:office:office"

<html xmlns:v="urn:schemas-microsoft-com:vml"

xmlns:o="urn:schemas-microsoft-com:office:office"

xmlns:w="urn:schemas-microsoft-com:office:word"

xmlns:st1="urn:schemas-microsoft-com:office:smarttags"

xmlns="http://www.w3.org/TR/REC-html40">

<head>

<link rel=File-List

href="./WBEM%20Java%20Client%20Release%20Notes%202_0Alpha2_files/filelist.xml">

<title>WBEM Java Client Release Notes</title>

<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"

name="City"/>

<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"

name="State"/>

<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"

name="place"/>

<!--[if gte mso 9]><xml>

<o:DocumentProperties>

<o:Subject>WBEM Java Client Release Notes </o:Subject>

<o:Author>Bapu Patil</o:Author>

<o:Template>normal</o:Template>

<o:LastAuthor>Bapu Patil</o:LastAuthor>

<o:LastAuthor>bapugoud</o:LastAuthor>

<o:Revision>2</o:Revision>

<o:Revision>4</o:Revision>

<o:TotalTime>180</o:TotalTime>

<o:TotalTime>1876</o:TotalTime>

<o:LastPrinted>2003-05-14T18:27:00Z</o:LastPrinted>

<o:LastPrinted>2003-05-14T19:27:00Z</o:LastPrinted>

<o:Created>2003-05-15T19:31:00Z</o:Created>

<o:Created>2003-11-19T23:06:00Z</o:Created>

<o:LastSaved>2003-05-15T19:31:00Z</o:LastSaved>

<o:LastSaved>2004-04-15T17:06:00Z</o:LastSaved>

<o:Pages>15</o:Pages>

<o:Pages>1</o:Pages>

<o:Words>3806</o:Words>

<o:Words>5843</o:Words>

<o:Characters>21696</o:Characters>

<o:Characters>33307</o:Characters>

<o:Lines>180</o:Lines>

<o:Company>Company</o:Company>

<o:Paragraphs>43</o:Paragraphs>

<o:Lines>277</o:Lines>

<o:CharactersWithSpaces>26644</o:CharactersWithSpaces>

<o:Paragraphs>78</o:Paragraphs>

<o:Version>9.4402</o:Version>

<o:CharactersWithSpaces>39072</o:CharactersWithSpaces>

<o:Version>10.4219</o:Version>

</o:DocumentProperties>

</xml><![endif]--><!--[if gte mso 9]><xml>

<w:WordDocument>

<w:Zoom>75</w:Zoom>

<w:SpellingState>Clean</w:SpellingState>

<w:GrammarState>Clean</w:GrammarState>

<w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>

<w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>

<w:UseMarginsForDrawingGridOrigin/>

Line 42

Line 53

<w:LayoutRawTableWidth/>

<w:LayoutTableRowsApart/>

</w:Compatibility>

<w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>

</w:WordDocument>

</xml><![endif]-->

</xml><![endif]--><!--[if !mso]><object

classid="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D" id=ieooui></object>

<style>

st1\:*{behavior:url(#ieooui) }

</style>

<![endif]-->

<style>

<!--

/* Font Definitions */

@font-face

{font-family:Wingdings;

panose-1:5 0 0 0 0 0 0 0 0 0;

mso-font-charset:2;

mso-generic-font-family:auto;

mso-font-pitch:variable;

mso-font-signature:0 268435456 0 0 -2147483648 0;}

@font-face

{font-family:"Futura Bk";

panose-1:0 0 0 0 0 0 0 0 0 0;

mso-font-alt:"Times New Roman";

Line 140

Line 150

mso-bidi-font-size:10.0pt;

font-family:"Times New Roman";

font-weight:normal;}

{mso-style-next:Normal;

margin:0in;

margin-bottom:.0001pt;

mso-pagination:widow-orphan;

page-break-after:avoid;

mso-outline-level:6;

tab-stops:.5in;

mso-layout-grid-align:none;

text-autospace:none;

font-size:10.0pt;

font-family:"Courier New";

font-weight:bold;}

p.MsoNormalIndent, li.MsoNormalIndent, div.MsoNormalIndent

{margin-top:0in;

margin-right:0in;

Line 170

Line 193

margin-bottom:.0001pt;

text-indent:-.25in;

mso-pagination:widow-orphan;

mso-list:l0 level1 lfo16;

mso-list:l0 level1 lfo3;

tab-stops:list .5in;

font-size:10.0pt;

font-family:"Times New Roman";

Line 230

Line 253

text-decoration:underline;

text-underline:single;}

{margin-right:0in;

{mso-margin-top-alt:auto;

mso-margin-top-alt:auto;

margin-right:0in;

mso-margin-bottom-alt:auto;

margin-left:0in;

mso-pagination:widow-orphan;

font-size:12.0pt;

font-family:"Times New Roman";

mso-fareast-font-family:"Times New Roman";}

code

{font-family:"Courier New";

mso-ascii-font-family:"Courier New";

mso-fareast-font-family:"Courier New";

mso-hansi-font-family:"Courier New";

mso-bidi-font-family:"Courier New";}

pre

{margin:0in;

margin-bottom:.0001pt;

Line 247

Line 276

font-family:"Courier New";

mso-fareast-font-family:"Courier New";}

{mso-ascii-font-family:"Courier New";

{font-family:"Courier New";

mso-ascii-font-family:"Courier New";

mso-fareast-font-family:"Courier New";

mso-hansi-font-family:"Courier New";

mso-bidi-font-family:"Courier New";}

Line 287

Line 317

font-size:10.0pt;

font-family:"Times New Roman";

mso-fareast-font-family:"Times New Roman";}

span.SpellE

{mso-style-name:"";

mso-spl-e:yes;}

span.GramE

{mso-style-name:"";

mso-gram-e:yes;}

@page Section1

{size:8.5in 11.0in;

margin:1.0in 1.25in 1.0in 1.25in;

Line 316

Line 352

{mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l1:level2

{mso-level-tab-stop:1.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l1:level3

{mso-level-tab-stop:1.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l1:level4

{mso-level-tab-stop:2.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l1:level5

{mso-level-tab-stop:2.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l1:level6

{mso-level-tab-stop:3.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l1:level7

{mso-level-tab-stop:3.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l1:level8

{mso-level-tab-stop:4.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l1:level9

{mso-level-tab-stop:4.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2

{mso-list-id:252513578;

mso-list-type:hybrid;

Line 324

Line 392

{mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2:level2

{mso-level-tab-stop:1.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2:level3

{mso-level-tab-stop:1.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2:level4

{mso-level-tab-stop:2.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2:level5

{mso-level-tab-stop:2.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2:level6

{mso-level-tab-stop:3.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2:level7

{mso-level-tab-stop:3.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2:level8

{mso-level-tab-stop:4.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l2:level9

{mso-level-tab-stop:4.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l3

{mso-list-id:524485251;

mso-list-type:hybrid;

Line 335

Line 435

mso-level-number-position:left;

text-indent:-.25in;

font-family:Symbol;}

@list l3:level2

{mso-level-tab-stop:1.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l3:level3

{mso-level-tab-stop:1.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l3:level4

{mso-level-tab-stop:2.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l3:level5

{mso-level-tab-stop:2.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l3:level6

{mso-level-tab-stop:3.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l3:level7

{mso-level-tab-stop:3.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l3:level8

{mso-level-tab-stop:4.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l3:level9

{mso-level-tab-stop:4.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l4

{mso-list-id:749347362;

{mso-list-id:856769335;

mso-list-type:hybrid;

mso-list-template-ids:-958241750;}

mso-list-template-ids:1295564480 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}

@list l4:level1

{mso-level-number-format:bullet;

mso-level-text:\F0B7;

mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;

mso-ansi-font-size:10.0pt;

font-family:Symbol;}

@list l5

{mso-list-id:1156529437;

{mso-list-id:1052342615;

mso-list-type:hybrid;

mso-list-template-ids:-1504563160;}

mso-list-template-ids:1568459352 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}

@list l5:level1

{mso-level-start-at:2;

{mso-level-number-format:bullet;

mso-level-text:\F0B7;

mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;}

text-indent:-.25in;

mso-ansi-font-size:10.0pt;

font-family:Symbol;}

@list l6

{mso-list-id:1305546433;

mso-list-type:hybrid;

mso-list-template-ids:1768434552 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}

@list l6:level1

{mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l7

{mso-list-id:1324700588;

mso-list-type:hybrid;

mso-list-template-ids:1419687056 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}

@list l7:level1

{mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l8

{mso-list-id:1505632988;

mso-list-type:hybrid;

mso-list-template-ids:904969346 1896489038 -1021140422 616970556 753855378 -307702454 337287590 -362651142 1385077412 129915254;}

@list l8:level1

@list l6:level1

{mso-level-number-format:bullet;

mso-level-text:\F0B7;

mso-level-tab-stop:.5in;

Line 383

Line 501

text-indent:-.25in;

mso-ansi-font-size:10.0pt;

font-family:Symbol;}

@list l8:level2

@list l6:level2

{mso-level-tab-stop:1.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level3

@list l6:level3

{mso-level-tab-stop:1.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level4

@list l6:level4

{mso-level-tab-stop:2.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level5

@list l6:level5

{mso-level-tab-stop:2.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level6

@list l6:level6

{mso-level-tab-stop:3.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level7

@list l6:level7

{mso-level-tab-stop:3.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level8

@list l6:level8

{mso-level-tab-stop:4.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level9

@list l6:level9

{mso-level-tab-stop:4.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l9

@list l7

{mso-list-id:1739132725;

{mso-list-id:1816099078;

mso-list-type:hybrid;

mso-list-template-ids:1218716582;}

mso-list-template-ids:417074740 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}

@list l7:level1

@list l9:level1

{mso-level-number-format:bullet;

mso-level-text:\F0B7;

mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;

mso-ansi-font-size:10.0pt;

font-family:Symbol;}

@list l10

@list l8

{mso-list-id:1842894525;

mso-list-template-ids:-1532178110;}

@list l8:level1

{mso-level-number-format:bullet;

mso-level-text:\F0B7;

mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;

mso-ansi-font-size:10.0pt;

font-family:Symbol;}

@list l9

{mso-list-id:2007662374;

mso-list-type:hybrid;

mso-list-template-ids:1413667294 -1837347444 1447836560 -2085591486 1525986426 420924086 1411915016 220890626 1754024258 -168013522;}

@list l10:level1

@list l9:level1

{mso-level-number-format:bullet;

mso-level-text:\F0B7;

mso-level-tab-stop:.5in;

Line 438

Line 567

text-indent:-.25in;

mso-ansi-font-size:10.0pt;

font-family:Symbol;}

@list l10:level2

@list l9:level2

{mso-level-tab-stop:1.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level3

@list l9:level3

{mso-level-tab-stop:1.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level4

@list l9:level4

{mso-level-tab-stop:2.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level5

@list l9:level5

{mso-level-tab-stop:2.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level6

@list l9:level6

{mso-level-tab-stop:3.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level7

@list l9:level7

{mso-level-tab-stop:3.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level8

@list l9:level8

{mso-level-tab-stop:4.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level9

@list l9:level9

{mso-level-tab-stop:4.5in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l11

{mso-list-id:2122145077;

mso-list-type:hybrid;

mso-list-template-ids:229274478 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}

@list l11:level1

{mso-level-tab-stop:.5in;

mso-level-number-position:left;

text-indent:-.25in;}

{margin-bottom:0in;}

-->

</style>

<!--[if gte mso 10]>

<style>

/* Style Definitions */

table.MsoNormalTable

{mso-style-name:"Table Normal";

mso-tstyle-rowband-size:0;

mso-tstyle-colband-size:0;

mso-style-noshow:yes;

mso-style-parent:"";

mso-padding-alt:0in 5.4pt 0in 5.4pt;

mso-para-margin:0in;

mso-para-margin-bottom:.0001pt;

mso-pagination:widow-orphan;

font-size:10.0pt;

font-family:"Times New Roman";}

</style>

<![endif]--><!--[if gte mso 9]><xml>

<o:shapedefaults v:ext="edit" spidmax="4098"/>

</xml><![endif]--><!--[if gte mso 9]><xml>

<o:shapelayout v:ext="edit">

<o:idmap v:ext="edit" data="1"/>

</o:shapelayout></xml><![endif]-->

</head>

<h1 align=center style='text-align:center'>WBEM Services</h1>

<h1 align=center style='text-align:center'>Java Client SDK Version 2.0 Alpha 2</h1>

<h1 align=center style='text-align:center'>Java Client SDK Version 2.5.1 </h1>

<h1 align=center style='text-align:center'><span style="mso-spacerun:

<h1 align=center style='text-align:center'><span

yes">�Release Notes</h1>

style='mso-spacerun:yes'>�Release Notes</h1>

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;

tab-stops:list .5in'><![if !supportLists]><span style='font-style:normal;

tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:

mso-bidi-font-style:italic'>1.

Arial;font-style:normal;mso-bidi-font-style:italic'>1.<span

<![endif]><span style='font-style:normal;mso-bidi-font-style:

style='font:7.0pt "Times New Roman"'>      <![endif]><span

italic'>Overview<o:p></o:p></h2>

style='font-style:normal;mso-bidi-font-style:italic'>Overview<o:p></o:p></h2>

The WBEM Java Client SDK is a

set of APIs that contain the components necessary to write management

applications that communicate with WBEM-enabled management devices using XML and

applications that communicate with WBEM-enabled management devices using XML

HTTP communication standards.

and HTTP communication standards.

WBEM applications request

information or services from the Common Information Model (CIM) Object Manager

Line 515

Line 658

managed objects on a system.

WBEM client applications use

the <tt>org.snia.wbem.client</tt>

the <tt>org.snia.wbem.client</tt>

APIs to manipulate CIM objects. A client application uses the CIM API to

construct an object (for example, a class, instance, or namespace) and then

initializes, or instantiates that object. The application uses the client APIs

to pass the object to the CIM Object Manager (CIMOM) and request an operation,

such as creating a CIM class, instance, or deleting an instance.

CIM Listener (org.snia.wbem.listener)

CIM Listener (<span

provides interfaces to process CIM/XML Indications.

class=SpellE>org.snia.wbem.listener) provides interfaces to process

CIM/XML Indications.

The javadoc documentation

includes the following packages that the client applications require to make

The javadoc

CIM operation requests to a CIM Object Manager.

documentation includes the following packages that the client applications

require to make CIM operation requests to a CIM Object Manager.

<span

style='mso-tab-count:1'>�� org.snia.wbem.client

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>�� <span

<span

class=SpellE>org.snia.wbem.client

style='mso-tab-count:1'>�� org.snia.wbem.cim

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

<span

.25in;text-align:justify'>�� <span

style='mso-tab-count:1'>�� org.snia.wbemcfg

class=SpellE>org.snia.wbem.cim

org.snia.wbem.listener

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>�� <span

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;

class=SpellE>org.snia.wbemcfg

tab-stops:list .5in'><![if !supportLists]><span style='font-style:normal;

mso-bidi-font-style:italic'>2.

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

<![endif]><span style='font-style:normal;mso-bidi-font-style:

.5in;text-align:justify'>org.snia.wbem.listener

italic'>Requirements<o:p></o:p></h2>

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;

tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:

Arial;font-style:normal;mso-bidi-font-style:italic'>2.<span

style='font:7.0pt "Times New Roman"'>      <![endif]><span

style='font-style:normal;mso-bidi-font-style:italic'>Requirements<o:p></o:p></h2>

<o:p></o:p>

<li class=MsoNormal style='mso-list:l10 level1 lfo3;tab-stops:list .5in'><span

<li class=MsoNormal style='mso-list:l9 level1 lfo8;tab-stops:list .5in'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The apache xerces XML

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>The apache <span

parser 1.4.4. <o:p></o:p></li>

class=SpellE>xerces XML parser 1.4.4. <o:p></o:p></li>

</ul>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>You must use Xerces 1.4.4 version. It can be

mso-bidi-font-size:10.0pt'>You must use Xerces 1.4.4

downloaded from<o:p></o:p>

version. It can be downloaded from<o:p></o:p>

<span

style="mso-spacerun: yes">�� �� <a

style='mso-spacerun:yes'>�� �� <a

href="http://xml.apache.org/dist/xerces-j/">http://xml.apache.org/dist/xerces-j/</a><o:p></o:p>

<o:p></o:p>

<li class=MsoNormal style='mso-list:l8 level1 lfo6;tab-stops:list .5in'><span

<li class=MsoNormal style='mso-list:l6 level1 lfo11;tab-stops:list .5in'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Java 1.4 version ( JRE

1.4 ) <o:p></o:p></li>

</ul>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>Java 1.4 version is used because it includes JSSE

(for SSL), JAAS (Java authentication), JCE (Crypto). Note that all these

(for SSL). Note JSEE is not part of earlier versions of Java. <span

packages (JSEE, JAAS, JCE) are not part of earlier versions of Java. You may

style='mso-spacerun:yes'>�For HP-UX, you may download Java 1.4 from http://www.hp.com/go/java/.<o:p></o:p>

download Java 1.4 from http://www.hp.com/go/java/.<o:p></o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'> <o:p></o:p>

Line 584

Line 731

<o:p></o:p>

CLASSPATH=$JAVA_HOME/jre/lib/rt.jar:$JAVA_HOME/jre/lib/jsse.jar:$XERCES_HOME/xerces-1_4_4/xerces.jar:$CIMCLIENT_HOME/cimclient.jar:.<o:p></o:p>

class=GramE>:.<o:p></o:p>

<o:p></o:p>

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;

tab-stops:list .5in'><![if !supportLists]><span style='font-style:normal;

tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:

mso-bidi-font-style:italic'>3.

Arial;font-style:normal;mso-bidi-font-style:italic'>1.<span

<![endif]><span style='font-style:normal;mso-bidi-font-style:

style='font:7.0pt "Times New Roman"'>      <![endif]><span

italic'>What's new in Alpha 2 Release<o:p></o:p></h2>

style='font-style:normal;mso-bidi-font-style:italic'>What's new in 2.5.1 Release?<o:p></o:p></h2>

This version supports both SSL and non-SSL based CIM/XML

indications.� Two-way SSL authentication

Several defects have been fixed. For further information, please, see the following Bugzillas:

is always enabled with CIM/XML Indications. Client SDK now includes the CIM

<ol>

Listener interfaces for writing CIM/XML indication consumers. Please refer to

<li>

Java documentation of org.snia.wbem.listener package. You can also refer to the

<a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=3967">Bugzilla #3967 - Java Client should honor the "useHTTP11=false"</a>

�CIM-XML Listener� section in this document on how to write consumers.

</li>

<li>

Note:<span

<a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4147">Bugzilla #4147 - Java Client is sometimes causing HTTP errors</a>

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> SSL is fully supported with

</li>

Alpha 2 release and onwards.<o:p></o:p>

<li>

<a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4258">Bugzilla #4258 - setTimeout is failing on Java Client API</a>

</li>

<li>

<a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4259">Bugzilla #4259 - NullPointerException is being generated in Java indication listener</a>

</li>

<li>

<a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4375">Bugzilla #4375 - Java CIMDateTime String constructor overflow microseconds into minutes</a>

</li>

<li>

<a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=4461">Bugzilla #4461 - Unable to access attributes in CIMOMHandleXML and CIMClient</a>

</li>

</ol>

<o:p> </o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt'><o:p> </o:p>

<h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:

.5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo12;tab-stops:

.5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:

list .5in'><![if !supportLists]><span style='font-style:normal;mso-bidi-font-style:

list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;

italic'>4.

font-style:normal;mso-bidi-font-style:italic'>2.<span

<![endif]><span style='font-style:normal;mso-bidi-font-style:

style='font:7.0pt "Times New Roman"'>      <![endif]><span

italic'>Writing WBEM Clients<o:p></o:p></h2>

style='font-style:normal;mso-bidi-font-style:italic'>Writing WBEM Clients<o:p></o:p></h2>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>WBEM client applications use the <tt><span

mso-bidi-font-size:10.0pt'>WBEM client applications use the <span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt;mso-ascii-font-family:"Times New Roman";

class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;

mso-hansi-font-family:"Times New Roman"'>org.snia.wbem.client</tt><span

font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>org.snia.wbem.client</tt><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> APIs to manipulate CIM

objects on the CIM Object Manager. A client application uses classes in <tt><span

objects on the CIM Object Manager. A client application uses classes in <span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt;mso-ascii-font-family:"Times New Roman";

class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;

mso-hansi-font-family:"Times New Roman"'>org.snia.wbem.cim package </tt><span

font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>org.snia.wbem.cim</tt><tt><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";

mso-bidi-font-family:"Courier New"'> package </tt><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>to construct an object (for

example, a class, instance, or namespace) and initializes that object. Then

uses the client APIs to pass the object to the CIMOM and request a CIM

Line 633

Line 799

1.<span

style='font-size:7.0pt'>      Connect to the

CIMOM using <tt>CIMClient</tt>.

CIMOM using <tt>CIMClient</tt>.

A client application connects to the CIMOM before performing a CIM operation,

such as creating a CIM class or updating a CIM instance.

Line 645

Line 811

3.<span

style='font-size:7.0pt'>      Close the client

connection to the CIM Object Manager using <tt><span style='font-size:10.0pt;

connection to the CIM Object Manager using <tt><span

font-family:"Courier New"'>CIMClient</tt>, to free the server resources

style='font-size:10.0pt'>CIMClient</tt>, to free the server

used by the client session.

resources used by the client session.

Line 657

Line 823

Client applications typically import the required CIM

classes and create CIM objects and then open client connection.<span

style="mso-spacerun: yes">� Some of the common imports and CIM object

style='mso-spacerun:yes'>� Some of the common imports and CIM object creations

creations are show below.

are show below.

<o:p></o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 0in 1.0pt 31.0pt'>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.client.CIMClient;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.cim.CIMNameSpace;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.cim.CIMObjectPath;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.cim.CIMClass;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.cim.CIMProperty;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.cim.CIMInstance;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.cim.CIMValue;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.cim.CIMQualifierType;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.cim.CIMException;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

</div>

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.client.CIMClient;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMNameSpace;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMObjectPath;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMClass;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMProperty;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMInstance;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMValue;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMQualifierType;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>import org.snia.wbem.cim.CIMException;<o:p></o:p>

</div>

Line 706

Line 886

<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

padding:1.0pt 4.0pt 1.0pt 31.0pt'>

12.0pt;mso-bidi-font-size:10.0pt'>CIMNameSpace clientNameSpace = null;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span

12.0pt;mso-bidi-font-size:10.0pt'>CIMClient cc = null;<o:p></o:p>

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIMNameSpace<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> clientNameSpace

= null;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIMClient<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> cc = null;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span

12.0pt;mso-bidi-font-size:10.0pt'>int portNo = CIMNameSpace.DEFAULT_PORT;<o:p></o:p>

class=GramE>int<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> portNo

= CIMNameSpace.DEFAULT_PORT;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>String nameSpace =

12.0pt;mso-bidi-font-size:10.0pt'>String nameSpace =

"root/cimv2";�� //

"root/cimv2";� <span

namespace<o:p></o:p>

style='mso-spacerun:yes'>��// namespace<o:p></o:p>

</div>

Line 737

Line 927

<o:p></o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>To open a client connection, you use the <tt><span

mso-bidi-font-size:10.0pt'>To open a client connection, you use the <span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt;mso-ascii-font-family:"Times New Roman";

class=SpellE><tt><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;

mso-hansi-font-family:"Times New Roman"'>CIMClient</tt><span

font-family:"Times New Roman";mso-bidi-font-family:"Courier New"'>CIMClient</tt><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class to connect to the CIM

Object Manager. You must specify the required type of connection (HTTP or

HTTPS) in the CIMNameSpace constructor. If connection type is not specified the

HTTPS) in the CIMNameSpace constructor. If connection

HTTP is used as the default. You must also specify the user name and password

type is not specified the HTTP is used as the default. You must also specify

for the connection to the specified CIM server.<o:p></o:p>

the user name and password for the connection to the specified CIM server.<o:p></o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'> <o:p></o:p>

Line 755

Line 945

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'> <o:p></o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 0in'>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt;mso-bidi-font-weight:bold;mso-bidi-font-style:italic'><span

style="mso-spacerun: yes">�� <span style='font-size:12.0pt;

style='mso-spacerun:yes'>�� <span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>String hostURL = "http://" +

mso-bidi-font-size:10.0pt'>String hostURL = "http://"

hostname + ":" + portNo;<o:p></o:p>

+ hostname + ":" + portNo;<o:p></o:p>

<p style='margin:0in;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='mso-bidi-font-size:

10.0pt'>�� try <o:p></o:p>

10.0pt'>�� try

<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>�� <span

clientNameSpace = new CIMNameSpace(hostURL, nameSpace);<o:p></o:p>

style='mso-spacerun:yes'>��clientNameSpace

= new CIMNameSpace(hostURL,

nameSpace);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>��

cc = new CIMClient(clientNameSpace, "guest",

cc = new CIMClient<span

"guest", CIMClient.HTTP);<o:p></o:p>

class=GramE>(clientNameSpace,

"guest", "guest", CIMClient.HTTP);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� } <o:p></o:p>

mso-bidi-font-size:10.0pt'>�� } <o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>�� <span

catch (CIMException e) <o:p></o:p>

class=GramE>catch (CIMException e) <o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>�� <span

System.err.println("Failed to access CIMOM: " + e);<o:p></o:p>

class=SpellE>System.err.println<span

class=GramE>("Failed to access CIMOM: " + e);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� }<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� }<o:p></o:p>

</div>

Line 816

Line 1012

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 0in'>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt;mso-bidi-font-weight:bold;mso-bidi-font-style:italic'><span

style="mso-spacerun: yes">�� <span style='font-size:12.0pt;

style='mso-spacerun:yes'>�� <span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>String hostURL = "https://" +

mso-bidi-font-size:10.0pt'>String hostURL = "https://"

hostname + ":" + portNo;<o:p></o:p>

+ hostname + ":" + portNo;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� try

mso-bidi-font-size:10.0pt'>�� <span

<o:p></o:p>

class=GramE>try <o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>�� <span

clientNameSpace = new CIMNameSpace(hostURL, nameSpace);<o:p></o:p>

class=SpellE>clientNameSpace = new <span

class=SpellE>CIMNameSpace(hostURL, <span

class=SpellE>nameSpace);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>��

cc = new CIMClient(clientNameSpace, "guest",

cc = new CIMClient<span

"guest", CIMClient.HTTP);<o:p></o:p>

class=GramE>(clientNameSpace,

"guest", "guest", CIMClient.HTTP);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� } <o:p></o:p>

mso-bidi-font-size:10.0pt'>�� } <o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>�� <span

catch (CIMException e) <o:p></o:p>

class=GramE>catch (CIMException e) <o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>�� <span

System.err.println("Failed to access CIMOM: " + e);<o:p></o:p>

class=SpellE>System.err.println<span

class=GramE>("Failed to access CIMOM: " + e);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� }<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� }<o:p></o:p>

</div>

Line 881

Line 1082

The

following examples show how to do CIM operations using org.snia.wbem.client

following examples show how to do CIM operations using org.snia.wbem.client

APIs.<o:p></o:p>

<o:p></o:p>

Line 893

Line 1094

The

following example shows how to do enumerateClasses of CIM_ComputerSystem<o:p></o:p>

following example shows how to do enumerateClasses

of CIM_ComputerSystem<o:p></o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 31.0pt'>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>�� <span

try<o:p></o:p>

class=GramE>try<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

{<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

System.out.println("\n*** Enumerate classes - No DEEP");<o:p></o:p>

System.out.println<span

class=GramE>("\n*** Enumerate classes - No DEEP");<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

CIMObjectPath path = new CIMObjectPath("CIM_ComputerSystem");<o:p></o:p>

CIMObjectPath path = new <span

class=GramE>CIMObjectPath("<span

class=SpellE>CIM_ComputerSystem");<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

Boolean deepInheritance = false;<o:p></o:p>

Boolean deepInheritance = false;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

Boolean localOnly = true;<o:p></o:p>

Boolean localOnly = true;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

Boolean includeQualifiers = true;<o:p></o:p>

Boolean includeQualifiers = true;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

Boolean includeClassOrigin = true;<o:p></o:p>

Boolean includeClassOrigin = true;<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>� <span

Enumeration en = cc.enumerateClasses(path, deepInheritance,<o:p></o:p>

style='mso-spacerun:yes'>��Enumeration en = <span

class=GramE>cc.enumerateClasses(path, <span

class=SpellE>deepInheritance,<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� <span style="mso-spacerun:

style='mso-spacerun:yes'>��

yes">��localOnly, includeQualifiers,<o:p></o:p>

localOnly, <span

class=SpellE>includeQualifiers,<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">��

style='mso-spacerun:yes'>��

includeClassOrigin);<o:p></o:p>

includeClassOrigin);<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

if (en != null)<o:p></o:p>

if (en != null)<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

{<o:p></o:p>

�{<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� while ( en.hasMoreElements() )<o:p></o:p>

style='mso-spacerun:yes'>�� while

( en.hasMoreElements() )<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� {<o:p></o:p>

style='mso-spacerun:yes'>�� {<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� CIMClass cimclass = (CIMClass)

style='mso-spacerun:yes'>�� CIMClass

en.nextElement();<o:p></o:p>

cimclass = (CIMClass) <span

class=SpellE>en.nextElement();<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� System.out.println("Class name: " +

style='mso-spacerun:yes'>�� <span

cimclass.getName());<o:p></o:p>

class=GramE>System.out.println("Class

name: " + cimclass.getName());<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� }<o:p></o:p>

style='mso-spacerun:yes'>�� }<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

}<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

}<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

catch (CIMException ce)<o:p></o:p>

catch (CIMException <span

class=SpellE>ce)<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

{<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

System.err.println("Failed to enumerate classes: " + ce);<o:p></o:p>

System.err.println<span

class=GramE>("Failed to enumerate classes: " + <span

class=SpellE>ce);<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

}<o:p></o:p>

</div>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'> <o:p></o:p>

<span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";

<span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:"Times New Roman";

mso-fareast-font-family:"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:

EN-US;mso-bidi-language:AR-SA'>

<h4>InvokeMethod Operation</h4>

<h4>InvokeMethod Operation</h4>

The

following example shows how to do invokeMethod on a Sample_MethodProvider.<o:p></o:p>

following example shows how to do invokeMethod

on a Sample_MethodProvider.<o:p></o:p>

<o:p></o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 4.0pt'>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>�� //

// NOTE: The following test requires the Sample_MethodProviderClass<o:p></o:p>

NOTE: The following test requires the Sample_MethodProviderClass<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>�� //

// and a sample method provider for Sample_MethodProviderClass.<o:p></o:p>

and a sample method provider for Sample_MethodProviderClass.<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>�� //<o:p></o:p>

//<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

System.out.println("\n*** Invoke Method.");<o:p></o:p>

System.out.println<span

class=GramE>("\n*** Invoke Method.");<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

String testNameSpace = "root/SampleProvider";<o:p></o:p>

String testNameSpace = "root/<span

class=SpellE>SampleProvider";<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

String testClassName = "Sample_MethodProviderClass";<o:p></o:p>

String testClassName = "<span

class=SpellE>Sample_MethodProviderClass";<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

String methodName = "SayHello";<o:p></o:p>

String methodName = "SayHello";<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

String inParamValue = "Yoda";<o:p></o:p>

String inParamValue = "Yoda";<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

String goodReply = "Hello, " + inParamValue + "!";<o:p></o:p>

String goodReply = "Hello<span

class=GramE>, " + inParamValue +

"!";<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

String goodParam = "From Neverland";<o:p></o:p>

String goodParam = "From <span

class=SpellE>Neverland";<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

Line 1110

Line 1336

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

CIMObjectPath currentPath;<o:p></o:p>

CIMObjectPath currentPath;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

Vector inParams = new Vector();<o:p></o:p>

Vector inParams = new Vector();<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

Vector outParams = new Vector();<o:p></o:p>

Vector outParams = new Vector();<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

CIMValue retValue;<o:p></o:p>

CIMValue retValue;<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

Line 1134

Line 1360

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

try<o:p></o:p>

try<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

{<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

// construct CIMObjectPath<o:p></o:p>

// construct CIMObjectPath<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

//<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

currentPath = new CIMObjectPath(testClassName);<o:p></o:p>

currentPath = new <span

class=SpellE>CIMObjectPath(testClassName);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

Line 1163

Line 1390

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

// set the namespace<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

//<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

currentPath.setNameSpace(testNameSpace);<o:p></o:p>

currentPath.setNameSpace<span

class=GramE>(testNameSpace);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

Line 1182

Line 1410

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

// create parameter vectors<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

//<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

inParams.addElement( new CIMProperty("dummy",<o:p></o:p>

inParams.addElement<span

class=GramE>( new CIMProperty("dummy",<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

�� new

�� new

CIMValue(inParamValue, CIMDataType.getPredefinedType(<o:p></o:p>

CIMValue(inParamValue, <span

class=SpellE>CIMDataType.getPredefinedType(<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� CIMDataType.STRING))));<o:p></o:p>

style='mso-spacerun:yes'>�� <span

class=SpellE>CIMDataType.STRING))));<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

Line 1212

Line 1443

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

// call invokeMethod<o:p></o:p>

// call invokeMethod<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

//<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

retValue=cc.invokeMethod(currentPath, methodName, inParams,<o:p></o:p>

retValue<span

class=GramE>=cc.invokeMethod(<span

class=SpellE>currentPath, methodName, <span

class=SpellE>inParams,<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� outParams);<o:p></o:p>

style='mso-spacerun:yes'>�� <span

class=SpellE>outParams);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

System.out.println("InvokeMethod response = " +

System.out.println<span

retValue.toString());<o:p></o:p>

class=GramE>("InvokeMethod response =

" + retValue.toString());<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

}<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

catch (CIMException ce)<o:p></o:p>

catch (CIMException <span

class=SpellE>ce)<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

{<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

System.err.println("invokeMethod Failed: " + ce);<o:p></o:p>

System.err.println<span

class=GramE>("invokeMethod Failed: "

+ ce);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style="mso-spacerun:

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span

yes">�� }��

style='mso-spacerun:yes'>�� }��

</div>

Line 1268

Line 1508

<o:p></o:p>

Clients

Clients may close the connection by calling the <span

may close the connection by calling the CIMClient.close() method. Client

class=SpellE>CIMClient.close()

connection will also be closed when the CIMClient object goes out of scope. <o:p></o:p>

method. Client connection will also be closed when the CIMClient

object goes out of scope.

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 0in'>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� try<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� <span

class=GramE>try<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>��

if( cc != null ) <o:p></o:p>

if( cc != null ) <o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>��

{<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

mso-bidi-font-size:10.0pt'><span

yes">�� cc.close();<o:p></o:p>

style='mso-spacerun:yes'>�� <span

class=SpellE>cc.close();<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>��

}<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� }<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� }<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>�� <span

catch (CIMException ce)<o:p></o:p>

class=GramE>catch (CIMException <span

class=SpellE>ce)<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� {<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>��

mso-bidi-font-size:10.0pt'>��

System.err.println("Failed to close connection: " + ce);<o:p></o:p>

System.err.println<span

class=GramE>("Failed to close connection: " + <span

class=SpellE>ce);<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 0in'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� }<o:p></o:p>

mso-bidi-font-size:10.0pt'>�� }<o:p></o:p>

</div>

<i style='mso-bidi-font-style:

normal'> <o:p></o:p>

normal'><o:p> </o:p>

<h3>Java CIM Client Local connection<o:p></o:p></h3>

This version support supports Local connection in Java

CIM Client interface. I.E. Java CIM Clients that wish to do local connection to

CIMServer can now use this feature. To do local

connection clients create <code><span

style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'>CIMClient</code><span

class=GramE><code>(</code><span

class=SpellE><code>CIMNameSpace</code><code><span

style='mso-ansi-font-size:12.0pt;font-family:"Times New Roman"'> namespace)</code><span

style='mso-spacerun:yes'>�� and this creates local connection to the CIM

Server running on the local system for the specified namespace. Clients do not

have to specify the username and/or password as the authentication is done

based the user logged in.

<span

style='mso-bidi-font-weight:bold'><o:p> </o:p>

<h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:

.5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo12;tab-stops:

.5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:

list .5in'><![if !supportLists]><span style='font-style:normal;mso-bidi-font-style:

list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;

italic'>5.

font-style:normal;mso-bidi-font-style:italic'>3.<span

<![endif]><span style='font-style:normal;mso-bidi-font-style:

style='font:7.0pt "Times New Roman"'>      <![endif]><span

italic'>SSL Certificate Management<o:p></o:p></h2>

style='font-style:normal;mso-bidi-font-style:italic'>SSL Certificate Management<o:p></o:p></h2>

Line 1344

Line 1609

Java Trust Store<o:p></o:p>

1. Export the server

certificate from the .pem file.

certificate from the .pem file.

Use <span

style='font-family:"Courier New"'>openssl command to export Pegasus

class=SpellE>openssl

CIMServer certificate file. <span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:

command to export Pegasus CIMServer certificate file.

"Courier New"'><o:p></o:p>

<o:p></o:p>

<span

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>#

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'># /opt/<span

/opt/wbem/sbin/openssl x509 -in /var/opt/wbem/server.pem -out server.cer<o:p></o:p>

class=SpellE>wbem/sbin/openssl x509 -in /var/opt/wbem/server.pem

-out server.cer<o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'>2. Import the server certificate in

to the client trust store.<o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'><span style="mso-spacerun:

10.0pt;mso-bidi-font-family:"Courier New"'>��

yes">�� - Copy the server certificate on to the client system.<o:p></o:p>

- Copy the server certificate on to the client system.<o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'><span style="mso-spacerun:

10.0pt;mso-bidi-font-family:"Courier New"'>��

yes">�� - Use Java <span style='mso-bidi-font-size:10.0pt;

- Use Java <span style='mso-bidi-font-size:

font-family:"Courier New"'>keytool<span style='mso-bidi-font-size:10.0pt;

10.0pt;font-family:"Courier New"'>keytool<span style='mso-bidi-font-size:

mso-bidi-font-family:"Courier New"'> to import the certificate into the client

10.0pt;mso-bidi-font-family:"Courier New"'> to import the certificate into the

trust store.<o:p></o:p>

client trust store.<o:p></o:p>

<span

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'># keytool

.5in;text-align:justify'><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:

-import -alias sequoia1 -file server.cer -keystore mytruststore<o:p></o:p>

"Courier New"'># keytool

-import -alias sequoia1 -file server.cer -<span

class=SpellE>keystore mytruststore<o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'>You will be asked to enter a

password. The password is required only for modifying mytruststore in the

password. The password is required only for modifying mytruststore

future. The keytool creates the trust store if it is not already exists and

in the future. The keytool creates the trust store if

then import the specified certificate. (For example we entered the password as

it is not already exists and then import the specified certificate. (For example

�wbem01�)<o:p></o:p>

we entered the password as �wbem01�)<o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'>3. Specify the truststore in the

10.0pt;mso-bidi-font-family:"Courier New"'>3. Specify the truststore

command line of the client application using �-Djavax.net.ssl.trustStore�.<o:p></o:p>

in the command line of the client application using �-Djavax.net.ssl.trustStore�.<o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p>

<span style='font-size:11.0pt;

<span

mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java -Djavax.net.ssl.trustStore=mytruststore

style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java<span

style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>

-Djavax.net.ssl.trustStore=mytruststore

<MyClient> <system> root/cimv2 5989 <span

class=SpellE>ssl<o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'>4. If your client application is

written to update the truststore file programmatically then you must also

written to update the truststore file

specify the password that was used to create the truststore using<span

programmatically then you must also specify the password that was used to

style="mso-spacerun: yes">� �-Djavax.net.ssl.trustStorePassword�.<o:p></o:p>

create the truststore using<span

style='mso-spacerun:yes'>� �-Djavax.net.ssl.trustStorePassword�.<o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p>

<span style='font-size:11.0pt;mso-bidi-font-size:

<span style='font-size:11.0pt;

10.0pt;mso-bidi-font-family:"Courier New"'>java

mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java<span

-Djavax.net.ssl.trustStore=mytruststore�

style='font-size:11.0pt;mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>

-Djavax.net.ssl.trustStorePassword=wbem01 <MyClient><span

-Djavax.net.ssl.trustStore=mytruststore<span

style="mso-spacerun: yes">� <system> root/cimv2 5989 ssl<span

style='mso-spacerun:yes'>� -Djavax.net.ssl.trustStorePassword=wbem01

style="mso-spacerun: yes">�� <o:p></o:p>

<MyClient>�

<system> root/cimv2 5989 ssl<span

style='mso-spacerun:yes'>�� <o:p></o:p>

<o:p></o:p>

Line 1415

Line 1689

"Courier New"'><o:p></o:p>

<span style='mso-bidi-font-size:

10.0pt;mso-bidi-font-family:"Courier New"'><span style="mso-spacerun:

10.0pt;mso-bidi-font-family:"Courier New"'>��

yes">�� 1.You view certificates in a certificate file using keytool

1.You view certificates in a certificate file

command.<o:p></o:p>

using keytool command.<o:p></o:p>

<p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in'>keytool

.5in;text-align:justify;text-indent:.25in'><span

-printcert -file server.cer<o:p></o:p>

class=GramE>keytool<span

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'> -<span

<p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:

class=SpellE>printcert -file server.cer<o:p></o:p>

-.25in;tab-stops:list .5in'><span style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:

"Courier New"'>1.

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

You

.5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'><span

can view all the certificates in a truststore using the keytool command.<o:p></o:p>

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>1.<span

style='font-size:7.0pt'>      <span

<p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>You can

.25in'>keytool

view all the certificates in a truststore using the <span

-list -v -keystore mytruststore<o:p></o:p>

class=SpellE>keytool command.<o:p></o:p>

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.5in;text-align:justify;text-indent:.25in'><span

class=GramE>keytool<span

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'> -list -v

-keystore mytruststore<o:p></o:p>

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;

tab-stops:list .5in'><![if !supportLists]><span style='font-style:normal;

tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:

mso-bidi-font-style:italic'>6.

Arial;font-style:normal;mso-bidi-font-style:italic'>4.<span

<![endif]><span style='font-style:normal;mso-bidi-font-style:

style='font:7.0pt "Times New Roman"'>      <![endif]><span

italic'>Writing A Trust Manager<o:p></o:p></h2>

style='font-style:normal;mso-bidi-font-style:italic'>Writing A

Trust Manager<o:p></o:p></h2>

The primary responsibility of

the TrustManager is to determine whether the presented authentication

the TrustManager is to determine whether the

credentials should be trusted or not. If the credentials are not trusted, the

presented authentication credentials should be trusted or not. If the

connection will be terminated. If no trust manager is specified by the client

credentials are not trusted, the connection will be terminated. If no trust

application then JSSE will use its own trust manager that supports

manager is specified by the client application then JSSE will use its own trust

authentication based on X.509 public key certificates.

manager that supports authentication based on X.509 public key certificates.

If the default X509TrustManager

behavior isn't suitable for your situation, you can implement your own

Line 1478

Line 1759

EN-US;mso-bidi-language:AR-SA'>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 31.0pt 1.0pt 4.0pt'>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

12.0pt;mso-bidi-font-size:10.0pt'>import java.security.cert.*;<o:p></o:p>

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> java.security.cert.*;<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

12.0pt;mso-bidi-font-size:10.0pt'>import java.security.KeyStore;<o:p></o:p>

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> java.security.KeyStore;<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

12.0pt;mso-bidi-font-size:10.0pt'>import javax.net.*;<o:p></o:p>

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> javax.net.*;<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='tab-stops:400.5pt;border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;tab-stops:400.5pt;border:none;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span

mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import javax.net.ssl.*;<o:p></o:p>

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> javax.net.ssl.*;<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='tab-stops:400.5pt;border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;tab-stops:400.5pt;border:none;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span

12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p>

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>/**<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>This class implements the X509TrustManager

interface.� It does not validate the

interface.� It does not validate the

certificate chain sent by the server, it basically ignores the certificate

certificate chain sent by the server, it basically

chain and goes ahead with the SSL hand shake. <o:p></o:p>

ignores the certificate chain and goes ahead with the SSL hand shake. <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>*/<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>public<span

12.0pt;mso-bidi-font-size:10.0pt'>public class DontValidateCertificate

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class DontValidateCertificate

implements X509TrustManager<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

X509TrustManager�

X509TrustManager�

myX509TrustManager;<o:p></o:p>

myX509TrustManager;<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

/**<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

* checkClientTrusted checks to see if the chain is in the <o:p></o:p>

* checkClientTrusted

checks to see if the chain is in the <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

* keyStore object.<o:p></o:p>

* keyStore object.<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

*/<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

public void checkClientTrusted(X509Certificate[] chain, <o:p></o:p>

public void checkClientTrusted(X509Certificate[]

chain, <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'>�<span

yes">�� String authType) throws

style='mso-spacerun:yes'>�� String authType)

CertificateException� <o:p></o:p>

throws CertificateException<span

style='mso-spacerun:yes'>� <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

{ <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

}<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

/**<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

* checkServerTrusted verifies to see if the chain is in the <o:p></o:p>

* checkServerTrusted

verifies to see if the chain is in the <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>�� <span

12.0pt;mso-bidi-font-size:10.0pt'>��

style="mso-spacerun: yes">��* keyStore object.<o:p></o:p>

* keyStore object.<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

*/<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

public void checkServerTrusted(X509Certificate[] chain, <o:p></o:p>

public void checkServerTrusted(X509Certificate[]

chain, <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><span

yes">�� String authType) throws

style='mso-spacerun:yes'>�� String authType)

CertificateException� <o:p></o:p>

throws CertificateException<span

style='mso-spacerun:yes'>� <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

{ <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

}<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'> <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

/**<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

* This method retrieves all of the certificates in the keyStore <o:p></o:p>

* This method retrieves all of the certificates in the <span

class=SpellE>keyStore <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

* and returns them in an X509Certificate array. We return null <o:p></o:p>

* and returns them in an X509Certificate array.

We return null <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

* as we are accepting any certificates. We should only return null if we

* as we are accepting any certificates. We

are using this trust manager <o:p></o:p>

should only return null if we are using this trust manager <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

* with CIMClient applications. However, we must return an empty

* with CIMClient

X509Certificate[] is used with<o:p></o:p>

applications. However, we must return an empty X509Certificate[]

is used with<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

* CIM Listener (which is SSL Server) interface. <o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

*/<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

public X509Certificate[] getAcceptedIssuers()<o:p></o:p>

public X509Certificate[] getAcceptedIssuers()<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

{<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

return null;<o:p></o:p>

return null;<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>��

12.0pt;mso-bidi-font-size:10.0pt'>��

}<o:p></o:p>

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 31.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'>}<o:p></o:p>

Line 1737

Line 1991

The Client SDK includes the

following two simple trust managers.

<span

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

style='mso-tab-count:1'>�� org.snia.wbemcmd.xml.CertificateManager

.25in;text-align:justify'>�� <span

class=SpellE>org.snia.wbemcmd.xml.CertificateManager

<span

style='mso-tab-count:1'>�� org.snia.wbemcmd.xml.DontValidateCertificate

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>�� <span

<span

class=SpellE>org.snia.wbemcmd.xml.DontValidateCertificate

style='mso-tab-count:1'>�� org.snia.wbem.listener.DoNotValidateClientCert<span

style="mso-spacerun: yes">� ( Note: Use this with CIM Listener

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

interface)

.25in;text-align:justify'>�� <span

class=SpellE>org.snia.wbem.listener.DoNotValidateClientCert<span

Client API uses JSSE trust

class=GramE>� ( Note: Use this

manager by default. If you want the API to use your own trust manager then you

with CIM Listener interface)

need to explicitly specify.

Client API uses JSSE trust manager

by default. If you want the API to use your own trust manager then you need to

explicitly specify.

Refer to JSSE reference guide <span

style='color:blue'><a

Line 1760

Line 2017

<h2 style='margin-top:12.0pt;margin-right:.4in;margin-bottom:3.0pt;margin-left:

.5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo12;tab-stops:

.5in;text-align:justify;text-indent:-.25in;mso-list:l1 level1 lfo5;tab-stops:

list .5in'><![if !supportLists]><span style='font-style:normal;mso-bidi-font-style:

list .5in'><![if !supportLists]><span style='mso-fareast-font-family:Arial;

italic'>7.

font-style:normal;mso-bidi-font-style:italic'>5.<span

<![endif]><span style='font-style:normal;mso-bidi-font-style:

style='font:7.0pt "Times New Roman"'>      <![endif]><span

italic'>Configuration<o:p></o:p></h2>

style='font-style:normal;mso-bidi-font-style:italic'>Configuration<o:p></o:p></h2>

The Client SDK allows the

client applications to specify the following configuration properties in a

Line 1775

Line 2032

<table border=1 cellspacing=0 cellpadding=0 style='margin-left:54.9pt;

<table class=MsoNormalTable border=1 cellspacing=0 cellpadding=0

border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;

style='margin-left:54.9pt;border-collapse:collapse;border:none;mso-border-alt:

mso-padding-alt:0in 5.4pt 0in 5.4pt'>

solid windowtext .5pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>

<tr>

<td width=252 valign=top style='width:189.0pt;border:solid windowtext .5pt;

<td width=252 valign=top style='width:189.0pt;border:solid windowtext 1.0pt;

padding:0in 5.4pt 0in 5.4pt'>

mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

<span style="mso-spacerun:

<span

yes">�� Property Name<o:p></o:p>

style='mso-spacerun:yes'>�� Property Name<o:p></o:p>

</td>

<td width=348 valign=top style='width:261.0pt;border:solid windowtext .5pt;

<td width=348 valign=top style='width:261.0pt;border:solid windowtext 1.0pt;

border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:

solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

Default Value<o:p></o:p>

</td>

</tr>

<tr>

<td width=252 valign=top style='width:189.0pt;border:solid windowtext .5pt;

<td width=252 valign=top style='width:189.0pt;border:solid windowtext 1.0pt;

border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;

DEBUG_XML

padding:0in 5.4pt 0in 5.4pt'>

DEBUG_XMLDECODE

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

clientLogFilePath

.25in;text-align:justify'>DEBUG_XML

TrustManager

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>DEBUG_XMLDECODE

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>clientLogFilePath

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>TrustManager

</td>

<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:

none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

False

"/logs/clientout.txt"

Do not define this in

properties file unless you have your own Trust Manager. Do not set it to NULL

either. JSSE uses its default Trust�

either. JSSE uses its default Trust<span

Manager only if this property is not defined.

style='mso-spacerun:yes'>� Manager only if this property is not

defined.

</td>

</tr>

</table>

Line 1815

Line 2079

</div>

The DEBUG_XML, DEBUG_XMLDECODE,

and clientLogFilePath properties are only for developmental debug purposes and

and clientLogFilePath properties are only for

they should not be set in the release product and should not be exposed to the

developmental debug purposes and they should not be set in the release product

client application users.

and should not be exposed to the client application users.

Note: The debug trace or

logging in the client API is not thread safe, it is recommended that clients do

not use debug logging in a multi-threaded application.

The client applications can

only use the set methods in �GlobalConfig� class to set the following

only use the set methods in �GlobalConfig� class to

configuration properties if needed. The above four properties can also be set

set the following configuration properties if needed. The above four properties

using the set methods.

can also be set using the set methods.

<table border=1 cellspacing=0 cellpadding=0 width=547 style='width:409.9pt;

<table class=MsoNormalTable border=1 cellspacing=0 cellpadding=0 width=547

margin-left:54.9pt;border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;

style='width:409.9pt;margin-left:54.9pt;border-collapse:collapse;border:none;

mso-padding-alt:0in 5.4pt 0in 5.4pt'>

mso-border-alt:solid windowtext .5pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>

<tr>

<td width=207 valign=top style='width:154.95pt;border:solid windowtext .5pt;

<td width=207 valign=top style='width:154.95pt;border:solid windowtext 1.0pt;

padding:0in 5.4pt 0in 5.4pt'>

mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

<span style="mso-spacerun:

<span

yes">�� Property Name<o:p></o:p>

style='mso-spacerun:yes'>�� Property Name<o:p></o:p>

</td>

<td width=340 valign=top style='width:254.95pt;border:solid windowtext .5pt;

<td width=340 valign=top style='width:254.95pt;border:solid windowtext 1.0pt;

border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:

solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

Default Value<o:p></o:p>

</td>

</tr>

<tr>

<td width=207 valign=top style='width:154.95pt;border:solid windowtext .5pt;

<td width=207 valign=top style='width:154.95pt;border:solid windowtext 1.0pt;

border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;

httpSocketProvider

padding:0in 5.4pt 0in 5.4pt'>

httpsSocketProvider

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>httpSocketProvider

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>httpsSocketProvider

</td>

<td width=340 valign=top style='width:254.95pt;border-top:none;border-left:

none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

mso-border-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

org.snia.wbemcmd.xml.PlainSocketProvider

org.snia.wbemcmd.xml.PlainSocketProvider

org.snia.wbemcmd.xml.JSSESocketProvider

org.snia.wbemcmd.xml.JSSESocketProvider

</td>

</tr>

</table>

Line 1869

Line 2137

The client applications can

specify the properties file in the following ways:

<p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

-.25in;tab-stops:list .5in'>1.

.5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'>1.<span

Specify the property file on the command line by setting ��D

style='font-size:7.0pt'>      Specify the

org.snia.wbem.cimom.properties�

property file on the command line by setting ��D org.snia.wbem.cimom.properties�

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify;text-indent:.25in'>For example,

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.25in;text-align:justify'>�� # <span

class=GramE>java -Dorg.snia.wbem.cimom.properties=./<span

class=SpellE>cim.properties <myAapp>

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.5in;text-align:justify;text-indent:-.25in;tab-stops:list .5in'>2.<span

style='font-size:7.0pt'>      Specify the

property file programmatically using the System.setProperty<span

class=GramE>() before creating the CIMClient

object.

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.5in;text-align:justify'>For example,

<p style='margin-top:5.0pt;margin-right:.4in;margin-bottom:5.0pt;margin-left:

.5in;text-align:justify'>System.setProperty<span

class=GramE>("org.snia.wbem.cimom.properties",

�./cim.properties�);

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;

tab-stops:list .5in'><![if !supportLists]><span style='mso-fareast-font-family:

Arial'>6.

<![endif]>CIM-HTTP<span

style='mso-spacerun:yes'>� Listener</h2>

<span style='font-size:12.0pt;

mso-bidi-font-size:8.0pt'><o:p> </o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:8.0pt'>A CIM-HTTP Listener is an HTTP server that

receives and processes CIM Export Requests and issues CIM Export Responses. <span

class=GramE>An CIM Export Message is used to transfer data from a CIM

entity into a non-CIM entity.<span style='font-size:12.0pt;display:none;

mso-hide:all'><o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><span

style='mso-spacerun:yes'>�<o:p></o:p>

<p style='margin-right:.4in;margin-left:.25in;text-align:justify;text-indent:

<span style='font-size:12.0pt;

.25in'>For example,

mso-bidi-font-size:9.0pt'>What are the components of a CIM-HTTP Listener?<o:p></o:p>

<span

style='mso-tab-count:1'>�� # java

-Dorg.snia.wbem.cimom.properties=./cim.properties <myAapp>

<p style='margin-right:.4in;margin-left:.5in;text-align:justify;text-indent:

-.25in;tab-stops:list .5in'>2.

Specify the property file programmatically using the

System.setProperty() before creating the CIMClient object.

For example,

System.setProperty("org.snia.wbem.cimom.properties",

�./cim.properties�);

<pre style='tab-stops:.5in'><span style='font-family:"Times New Roman";

mso-fareast-font-family:"Times New Roman"'> <o:p></o:p></pre>

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;

tab-stops:list .5in'><![if !supportLists]>8.

<![endif]>CIM-XML Listener</h2>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

A CIM-xml

Listener is an HTTP server that receives and processes CIM Export Requests

and issues CIM Export Responses. An CIM Export Message is used to transfer data

from a CIM entity into a non-CIM entity.<span style='font-size:12.0pt;

display:none;mso-hide:all'><o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span style="mso-spacerun:

yes">�<o:p></o:p>

What

are the components of a CIM-xml Listener?<o:p></o:p>

<li class=MsoNormal style='mso-list:l3 level1 lfo9;tab-stops:list .5in'><span

<li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><span

style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>CIM-xml Listener

style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>CIM-HTTP Listener

Protocol �module�. <span style='font-size:12.0pt;mso-bidi-font-size:

7.0pt'>The CIM-xml Listener Protocol �module� receives indications from

7.0pt'>The CIM-HTTP Listener Protocol �module� receives indications from

(and generates responses to) the CIM-xml Indication Handler. <span

(and generates responses to) the CIM/XML Indication Handler. <span

style='font-size:12.0pt;mso-bidi-font-size:7.5pt;display:none;mso-hide:

all'><o:p></o:p></li>

</ul>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:7.5pt'><o:p> </o:p>

<li class=MsoNormal style='mso-list:l3 level1 lfo9;tab-stops:list .5in'><span

<li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><span

style='font-size:12.0pt;mso-bidi-font-size:7.5pt'>Indication Consumer.<span

style='font-size:12.0pt;mso-bidi-font-size:7.5pt'><span

style="mso-spacerun: yes">� A management application that

style='mso-spacerun:yes'>� A management application that processes,

processes, displays, stores, analyzes, etc indications. <o:p></o:p></li>

displays, stores, analyzes, etc indications. <o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l3 level1 lfo9;tab-stops:list .5in'><span

<li class=MsoNormal style='color:black;mso-list:l3 level1 lfo14;tab-stops:

style='font-size:12.0pt;mso-bidi-font-size:7.5pt;color:windowtext'>CIM_Indication

list .5in'><span style='font-size:12.0pt;mso-bidi-font-size:

7.5pt;color:windowtext'>CIM_Indication<span

style='font-size:12.0pt;mso-bidi-font-size:7.5pt;color:windowtext'>

Schema.<span style='font-size:12.0pt;mso-bidi-font-size:7.5pt;

color:windowtext'> The schema definition for indication objects of

interest to the CIM-xml Listener.<span style='font-size:11.0pt;

interest to the CIM-XML Listener.<span style='font-size:11.0pt;

mso-bidi-font-size:7.5pt'><o:p></o:p></li>

</ul>

<span style='font-size:7.5pt;font-family:"Futura Bk";

<span style='font-size:7.5pt;

color:black'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

font-family:"Futura Bk";color:black'><o:p> </o:p>

<span style='font-size:7.5pt;font-family:"Futura Bk";

color:black'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span style='font-size:7.5pt;font-family:"Futura Bk";

color:black'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<h3>Writing CIM-XML

Consumer<o:p></o:p></h3>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>CIM-XML consumer applications use the <tt><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt;mso-ascii-font-family:"Times New Roman";

mso-hansi-font-family:"Times New Roman"'>org.snia.wbem.listner</tt><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> APIs to handle CIM-XML

indications that are delivered by the client Applications.<span

style="mso-spacerun: yes">� Please follow some of examples that are

provided with the SDK. <o:p></o:p>

CIM-XML Listener Consumers typically follow this sequence:

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;

tab-stops:list .5in'><![if !supportLists]>1.

<![endif]>Identify the port number they want to listen for indications.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;

tab-stops:list .5in'><![if !supportLists]>2.

<![endif]>Use the CIM Listener APIs to start listening on a particular

port.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;

tab-stops:list .5in'><![if !supportLists]>3.

<![endif]>Write it�s own �indicationOccurred()� method to process

indication when received.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;

tab-stops:list .5in'><![if !supportLists]>4.

<![endif]>Start running as a process.

Import

CIMHTTP Listener<o:p></o:p>

<o:p></o:p>

<span style='font-size:7.5pt;

font-family:"Futura Bk";color:black'><o:p> </o:p>

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

The

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

listener is associated with the subscription through the destination property

12.0pt;mso-bidi-font-size:10.0pt'>import

of the handler instance. Multiple subscriptions can refer to the same handler

org.snia.wbem.listener.CIMHTTPListener;<o:p></o:p>

instance; so one listener can listen to multiple subscriptions.

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>With subscription you will

specify the destination where the Listener is running. <o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>For example,<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span

style='mso-spacerun:yes'>� 1. SSL enable consumer<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><PROPERTY

NAME="Destination" TYPE="string"><o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><VALUE>https://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer</VALUE><o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'></PROPERTY><o:p></o:p>

<span

style='mso-bidi-font-size:10.0pt'><o:p> </o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span

style='mso-spacerun:yes'>� 1. Non-SSL enable consumer<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><PROPERTY

NAME="Destination" TYPE="string"><o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><VALUE>http://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer</VALUE><o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'></PROPERTY><o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>In the above case, Listener

would be running on mysystem.cup.hp.com at port 8189 with SSL enabled.<span

style='font-family:"Courier New"'> <o:p></o:p>

<span style='font-size:7.5pt;

font-family:"Futura Bk";color:black'><o:p> </o:p>

<span style='font-size:7.5pt;

font-family:"Futura Bk";color:black'><o:p> </o:p>

<h3 style='tab-stops:.5in'><span style='font-size:11.0pt;mso-bidi-font-size:

10.0pt'>Writing CIM-XML Consumer<o:p></o:p></h3>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>CIM-XML consumer

applications use the <tt><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt;font-family:"Times New Roman";mso-bidi-font-family:

"Courier New"'>org.snia.wbem.listner</tt><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'> APIs to handle CIM-XML indications that are

delivered by the client Applications.�

Please follow some of examples that are provided with the SDK. <o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p>

First

implement a consumer using CIMIndicationConsumer

interface. Then create a CIMListener object, add the

list of consumers that are interested in consuming Indications.

CIM-XML Listener Consumers typically follow this

sequence:

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

tab-stops:list .5in'><![if !supportLists]>1.<span

style='font:7.0pt "Times New Roman"'>      <![endif]>Identify

the port number they want to listen for indications.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

tab-stops:list .5in'><![if !supportLists]>2.<span

style='font:7.0pt "Times New Roman"'>      <![endif]>Implement

a consumer using CIMIndicationConsumer interface.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

tab-stops:list .5in'><![if !supportLists]>3.<span

style='font:7.0pt "Times New Roman"'>      <![endif]>Write

it�s own �consumerIndication();

method to process indication when received.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

tab-stops:list .5in'><![if !supportLists]>4.<span

style='font:7.0pt "Times New Roman"'>      <![endif]>Use

the CIM HTTP Listener APIs to start listening on a particular port.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

tab-stops:list .5in'><![if !supportLists]>5.<span

style='font:7.0pt "Times New Roman"'>      <![endif]>Start

running as a process

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'> Import classes<o:p></o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 0in 1.0pt 31.0pt'>

<p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.listener.CIMHTTPListener;<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.listener.<span

style='font-size:10.0pt'>CIMIndicationConsumer;

<p class=MsoNormal style='tab-stops:.5in;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>import<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> org.snia.wbem.xml.<span

style='font-size:10.0pt'>OperationContext;

<p class=MsoNormal style='margin-left:.5in;border:none;mso-border-alt:solid windowtext .5pt;

</div>

padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

</div>

<span

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

none'><o:p> </o:p>

<span

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

none'><o:p> </o:p>

<span

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> Initialize and

none'><o:p> </o:p>

extend CIMHTTPListener<o:p></o:p>

<span

<h6>Implement CIMIndicationConsumer interface</h6>

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 4.0pt'>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><o:p> </o:p>

style="mso-spacerun: yes">�� CIMHTTPListener myCIML=null;<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:12.0pt;

style="mso-spacerun: yes">�� try <o:p></o:p>

mso-bidi-font-size:10.0pt'>public<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'> class MyIndicationConsumer

implements CIMIndicationConsumer<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'>{<o:p></o:p>

style="mso-spacerun: yes">�� <span style="mso-spacerun:

yes">��{<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� CIMHTTPListener ccl = new

style='mso-spacerun:yes'>�� MyIndicationConsumer<span

CIMHTTPListener(listenerPortNo, isSSL) <o:p></o:p>

class=GramE>(String name) <o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-tab-count:1'>�� ��

style='mso-spacerun:yes'>�� { <o:p></o:p>

{ <o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� public void

style='mso-spacerun:yes'>�� System.out.println<span

indicationOccured(CIMIndication e, String indURL) <o:p></o:p>

class=GramE>("I am a consumer" + name);<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� {<o:p></o:p>

style='mso-spacerun:yes'>�� }<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� handleIndication(e.getIndication(),

style='mso-spacerun:yes'>�� public void <span

indURL);<o:p></o:p>

class=SpellE>consumeIndication(OperationContext

context,<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<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;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� }<o:p></o:p>

style='mso-spacerun:yes'>�� String URL, <span

class=SpellE>CIMIndication cime)

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� };<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� ccl.startCIMHTTPListener();<o:p></o:p>

style='mso-spacerun:yes'>�� {<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� }<o:p></o:p>

style='mso-spacerun:yes'>�� // do something with indications

received<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� catch (Exception e) {<o:p></o:p>

style='mso-spacerun:yes'>�� }<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� System.out.println(e);<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� e.printStackTrace();<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� }<o:p></o:p>

style='mso-spacerun:yes'>�}

</div>

<span

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

none'><o:p> </o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> Indication

none'>Indication

Processor method<o:p></o:p>

Processor (consumeIndicattion<span

class=GramE>()) method<o:p></o:p>

Once

the indication is received you can have your own handleIndication method that

<p class=MsoBodyText2 style='tab-stops:.5in;mso-layout-grid-align:none;

can process the CIMInstance which is passed by the CIMListener. Here is an

text-autospace:none'>Once the indication is received you can have your own <span

class=SpellE>consumerIndication<span

class=GramE>() method that can process the CIMInstance

which is passed by the CIMListener. Here is an

example:

<span

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

none'><o:p> </o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:2.0pt 4.0pt 1.0pt 4.0pt'>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

2.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� void handleIndication(CIMInstance ind,

style='mso-spacerun:yes'>�� public void <span

String indURL) <o:p></o:p>

class=SpellE>consumeIndication(XMLOperationContext

context , <o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>��

String URL,� <span

class=SpellE>CIMIndication <st1:State><st1:place><span

class=SpellE>ind</st1:place></st1:State><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>)<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� {<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� System.out.println<span

class=GramE>("---------- Begin of event data ----------");<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� System.out.println<span

class=GramE>("--- Indication URL : "+indURL);<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� System.out.println<span

class=GramE>("--- Indication : "+ind.toString());<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� <o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� try <o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� {<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� Object o=null;<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� if (<span

class=SpellE>ind.getClassName().startsWith("<span

class=SpellE>CIM_Class"))<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� o=(Object)<span

class=SpellE>ind.getProperty("classdefinition").<span

class=SpellE>getValue().getValue();<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� if (<span

class=SpellE>ind.getClassName().startsWith("<span

class=SpellE>CIM_Inst"))<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� o=(Object)

ind.getProperty("sourceinstance").<span

class=SpellE>getValue().getValue();<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� if (o <span

class=SpellE>instanceof CIMInstance) <o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-tab-count:1'>�� � {<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� CIMInstance

eo=(CIMInstance)o;<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� <span

class=GramE>System.out.println("---

Embedded Instance: "+eo);<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� }<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� else if (o <span

class=SpellE>instanceof CIMClass) {<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� CIMClass

eo=(CIMClass)o;<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� <span

class=GramE>System.out.println("---

Embedded Class: "+eo);<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� }<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� System.out.println<span

class=GramE>("----------- End of event data -----------\n");<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� }<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� catch

(Exception ee) <o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� {<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� ee.printStackTrace<span

class=GramE>();<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� }<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

2.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� }<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

</div>

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� {<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

none'><o:p> </o:p>

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� System.out.println("----------

Begin of event data ----------");<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

none'><o:p> </o:p>

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� System.out.println("--- Indication

URL : "+indURL);<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<h4 style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:none'>Developing

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

CIM HTTP Listener</h4>

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� System.out.println("--- Indication

: "+ind.toString());<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<o:p> </o:p>

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

<span

style="mso-spacerun: yes">�� try <o:p></o:p>

class=GramE>public<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> class SampleListener<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

<span

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p>

style="mso-spacerun: yes">�� {<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span

style='mso-spacerun:yes'>�� <o:p></o:p>

<span

class=SpellE>CIMHTTPListener<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> myListener

=� new <span

class=SpellE>CIMHTTPListener(listenerPortNo, <span

class=SpellE>isSSL);<o:p></o:p>

<span

class=GramE>try<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> {<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>// Add

consumer<o:p></o:p>

<span

class=SpellE>MyIndicationConsumer consumer1 = new <span

class=GramE>MyIndicationConsumer("1");

<span

class=SpellE>myListener.addConsumer<span

class=GramE>(consumer1);

<span

class=SpellE>myListener.start<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'> ();<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span

style='mso-spacerun:yes'>�� } <o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span

style='mso-spacerun:yes'>�� catch (<span

class=SpellE>CIMExecption ce) <o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span

style='mso-spacerun:yes'>�� {<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span

style='mso-spacerun:yes'>�� <span

style='mso-spacerun:yes'>��System.out.println<span

class=GramE>(�Unable to add consumers: � + ce.getMessage());<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span

style='mso-spacerun:yes'>�� }�

<o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>}<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'>Operation

Context Object<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�<span

class=SpellE>OperationContext class holds the operation specific

additional information that will be passed to clients or consumers. It carries

the information about the context in which the client program issued the

request.� OperationContext

holds container objects.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>For example: Listener interface would want to pass

additional information, such as content language, to consumers. In such case Listener

would create an Operation Context and add Content Language container into the

context. The context is passed to consumers.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'><o:p> </o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 4.0pt'>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� Object o=null;<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>Consumers can then use Context get method to

the container object.<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� if

(ind.getClassName().startsWith("CIM_Class"))<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� <span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'>{<o:p></o:p>

yes">�o=(Object)ind.getProperty("classdefinition").getValue().getValue();<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� if

12.0pt;mso-bidi-font-size:10.0pt'>��

(ind.getClassName().startsWith("CIM_Inst"))<o:p></o:p>

// Create Context<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� o=(Object)

12.0pt;mso-bidi-font-size:10.0pt'>�� <span

ind.getProperty("sourceinstance").getValue().getValue();<o:p></o:p>

class=SpellE>OperationContext myContext = new <span

class=SpellE>OperationContext();<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� if (o instanceof CIMInstance) <o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>��

// Create a OperationContext

Container object<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style='mso-tab-count:1'>�� � {<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>�� <span

class=SpellE>ExampleContextContainer myContainer

= new ExampleContextContainer<span

class=GramE>();<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� <span style="mso-spacerun:

12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p>

yes">��CIMInstance eo=(CIMInstance)o;<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� System.out.println("---

12.0pt;mso-bidi-font-size:10.0pt'>��

Embedded Instance: "+eo);<o:p></o:p>

//<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� }<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>��

// insert objects into Context <o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� else if (o instanceof CIMClass) {<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>��

//<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� CIMClass eo=(CIMClass)o;<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>�� <span

class=SpellE>myContext.insert((<span

class=SpellE>OperationContext)myContainer);<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� System.out.println("---

12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p>

Embedded Class: "+eo);<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� }<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>��

// <o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� System.out.println("-----------

12.0pt;mso-bidi-font-size:10.0pt'>��

End of event data -----------\n");<o:p></o:p>

// get objects from the Context <o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� }<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>��

//<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� catch (Exception ee) <o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>�� <span

class=SpellE>ExampleContextContainer clCont =<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� {<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>��

(ExampleContextContainer)<span

class=SpellE>myContext.get(ExampleContextContainer.NAME);<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� ee.printStackTrace();<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

1.0pt 4.0pt 1.0pt 4.0pt'><span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-size:

style="mso-spacerun: yes">�� }<o:p></o:p>

12.0pt;mso-bidi-font-size:10.0pt'>�� <span

class=SpellE>System.out.println<span

class=GramE>("Got back :" + clCont.getName());<o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

none;border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

1.0pt 4.0pt 1.0pt 4.0pt'>}<o:p></o:p>

style="mso-spacerun: yes">�� }<o:p></o:p>

</div>

<span

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

none'><o:p> </o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>SSL Support with CIM

Listener<o:p></o:p>

The CIM Listener interface supports SSL for secure communication. The CIM

Listener (a Server) can accept either http or https connections from the system

delivering indications (an Indication Client). The Listener applications

(Indication Consumers) using the CIM Listener API would require to have a

server certificate and private key in order to support SSL enabled

communication with the Indication clients. The Listener applications can write

their own X509 Trust Manager where they can do additional validations like host

name verification. However the CIM Listener API provides a default X509 Trust

Manager that does not do any additional validations.

The CIM Listener running as server, does client authentication by requesting

the Indication Client to send its certificate for authentication. Hence the

Indication Client (e.g., CIM Server) trying to connect to the CIM Listener

using https connection must have its own certificate.

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo12;

tab-stops:list .5in'><![if !supportLists]>9.<span

style='font:7.0pt "Times New Roman"'>  <![endif]>Troubleshooting

and CIM Exceptions<o:p></o:p></h2>

In addition to the standard CIM Exceptions sent

by the CIM Server to the client, the CIM Client library generates the following

exceptions. The exception generated by the client library along with the reason

and solution is explained below:

Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED (Unable to Initialize

Specified TrustManager: <a

href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span

style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</a>)<o:p></o:p>

Problem:

This exception indicates that

the specified TrustManager may not exist, may contain invalid path, or it may

not have required permission to load.

Solution:

<h6>Example

OperationContext Container<o:p></o:p></h6>

Make sure that the TrustManager

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

you have specified exist and has correct path and right permissions. Also make

mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;

sure that the TrustManager is not set to �null�.

mso-bidi-font-size:10.0pt'>The ExampleContextContainer

object carries the request context information that consumer may access. <o:p></o:p>

Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED(SSL Factory Initialization

failed: <a href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</a>)<o:p></o:p>

mso-layout-grid-align:none;text-autospace:none'><span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'><o:p> </o:p>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 4.0pt'>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span

style='font-family:"Courier New"'>public<span style='font-family:

"Courier New"'> class ExampleContextContainer

implements OperationContextContainer<o:p></o:p>

Problem:

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

This exception may happen in

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

number different scenarios. Such as, unable to find JSSE providers, unable to

"Courier New"'>{<o:p></o:p>

generate random seed, unable to connect to correct server, server had problem

with SSL handshake, or policy permissions are incorrect.

Solution:

Follow JSSE specification and

make sure the system java configurations are setup correctly.

Exception: CIMCLIENT_ERR_HTTP_ERROR(Couldn't

find trusted certificate, response=500)<o:p></o:p>

Problem:

This exception may happen

because of SSL handshake failure. SSL handshake may fail because the

certificate sent by the server was an invalid certificate or the certificate is

not in clients Trust store.

Solution:

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� /** Container name of this

container */<o:p></o:p>

Either add this certificate to

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

client Trust store or handle the certificate appropriately in the Certificate

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

Manager.

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� public

static final String NAME="ExampleContextContainer";<o:p></o:p>

Exception: CIMCLIENT_ERR_TIMED_OUT (Request

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

Timeout)<o:p></o:p>

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� public

ExampleContextContainer() { }<o:p></o:p>

Problem:

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'><o:p> </o:p>

This exception indicates that a

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

timeout has occurred on a socket read. This could mean the server or provider

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

may be slow in responding to client request, or the client time out is small.

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� public

String getName()<o:p></o:p>

Solution:

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� {<o:p></o:p>

Consider trying this operation

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

at some other time or might want to set client timeout or increase the client

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

timeout. Refer to CIMClient API java documentation for how to set client

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

timeout.

"Courier New"'>�� return(NAME);<o:p></o:p>

Exception:

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

CIMCLIENT_ERR_CONNECTION_FAILED(Connection refused) <o:p></o:p>

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� }<o:p></o:p>

Problem:

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� public

Object clone()<o:p></o:p>

This exception indicates that an

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

error occurred while attempting to connect to CIMServer on a port. The CIMServer

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

may not be running on the specified address or it may not be listening on the

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

specified port.

"Courier New"'>�� {<o:p></o:p>

Solution:

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� return

((Object)new ExampleContextContainer());<o:p></o:p>

Check to make sure that the

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

server address is correct and the port number specified is the correct port

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

number for an SSL or non-SSL communication. (e.g., This exception may be thrown

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

if the CIMServer is SSL enabled and listening on port 5989, the client trying

"Courier New"'>�� }<o:p></o:p>

to connect to non-SSL port 5988.)

Exception:

CIMCLIENT_ERR_CONNECTION_FAILED(sequoia Unknown host) <o:p></o:p>

Problem: This exception indicates that the CIMServer

address specified may contain an invalid system name or the system is not

reachable.

Solution:�

Make sure the specified CIMServer address is correct and the remote

system is reachable.

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none;border:none;mso-border-alt:solid windowtext .5pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>};<o:p></o:p>

<span

</div>

style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:Arial;mso-fareast-font-family:

"Times New Roman";mso-ansi-language:EN-US;mso-fareast-language:EN-US;

mso-bidi-language:AR-SA'>

<h2>Appendix A: FAQ<o:p></o:p></h2>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><o:p> </o:p>

The cimclient library performs the SSL handshaking

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

and receives the certificate/key

none'><o:p> </o:p>

What environment settings must be in place for

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

certificates to be passed?<o:p></o:p>

none'><o:p> </o:p>

Clients must create a trust store, import

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

certificates from the server they trust in to the trust store, provide the

none'>SSL Support

trust store path to the JSSE either on the command line ( java

with CIM Listener<o:p></o:p>

-Djavax.net.ssl.trustStore=mytruststore <MyClient><span

style="mso-spacerun: yes">� ) or through

The CIM Listener interface supports SSL for secure

communication. The CIM Listener (a Server) can accept either http or https

connections from the system delivering indications (an Indication Client). The

Listener applications (Indication Consumers) using the CIM Listener API would

require to have a server certificate and private key in order to support SSL

enabled communication with the Indication clients. The Listener applications

can write their own X509 Trust Manager where they can do additional validations

like host name verification. However the CIM Listener API provides a default

X509 Trust Manager that does not do any additional validations.

The CIM Listener running as server,

does client authentication by requesting the Indication Client to send its

certificate for authentication. Hence the Indication Client (e.g., CIM Server)

trying to connect to the CIM Listener using https connection must have its own

certificate.

<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

subscription</h4>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Creating subscription is

same as creating any CIM instance...you will use CIM Client interfaces to do

so. Currently WBEM (core CIMServer)

only supports CIM_IndicationSubscription, <span

class=SpellE>CIM_IndicationFilter, CIM_IndicationHandlerCIMXML

and IndicationHandlerSNMPMapper classes. <span

style='font-family:"Courier New"'><o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><o:p> </o:p>

<h2 style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo5;

tab-stops:list .5in'><![if !supportLists]><span style='font-family:"Courier New";

mso-fareast-font-family:"Courier New"'>7.<span

style='font:7.0pt "Times New Roman"'>  <![endif]>Troubleshooting

and CIM Exceptions<o:p></o:p></h2>

System.setProperty("javax.net.trustStore",

In addition to the standard CIM

"mytruststore");

Exceptions sent by the CIM Server to the client, the CIM Client library

generates the following exceptions. The exception generated by the client

library along with the reason and solution is explained below:

Does the cimclient library accept the

Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED

certificate and place it in the trust store?�

(Unable to Initialize Specified TrustManager: <a

How would the application specify to the cimclient library where the

href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span

trust store is<o:p></o:p>

style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</a>)<o:p></o:p>

Client library using JSSE will only validate the

Problem:

server certificate using the trust store. It accepts only trusted certificates

from the server. In case of non-trusted certificate the client library will

call the trust manager if there is one specified. It is the job of trust

manager to either accept the server certificate (possibly add that to the trust

store) or reject the certificate.

How is the client application notified that the

This exception

certificate or key was placed in the trust store?<span style="mso-spacerun:

indicates that the specified TrustManager may not

yes">� Is this assumed?<o:p></o:p>

exist, may contain invalid path, or it may not have required permission to

load.

Solution:

Make sure that

the TrustManager you have specified exist and has

correct path and right permissions. Also make sure that the TrustManager

is not set to �null�.

Same as above

Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_<span

class=GramE>FAILED(SSL Factory Initialization failed: <a

href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span

style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</a>)<o:p></o:p>

Can the client application set the environment

Problem:

so that certificates or keys are required from some target systems but other

target systems are not validated or authenticated?<o:p></o:p>

Yes, trust manager can do this.

This exception

may happen in number different scenarios. Such as, unable to find JSSE

providers, unable to generate random seed, unable to connect to correct server,

server had problem with SSL handshake, or policy permissions are incorrect.

Where can I find more information on Trust

Solution:

Manager and Trust Stores?<o:p></o:p>

More information can be found at J2SE web

Follow JSSE

site.� - ----

specification and make sure the system java configurations are setup correctly.

http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html<o:p></o:p>

Exception: CIMCLIENT_ERR_HTTP_<span

class=GramE>ERROR(Couldn't find trusted certificate, response=500)<o:p></o:p>

http://java.sun.com/j2se/1.4/docs/api/javax/net/ssl/X509TrustManager.html

Problem:

I am unable use/initialize SSL connection,

This exception

what do I do?<o:p></o:p>

may happen because of SSL handshake failure. SSL handshake may fail because the

certificate sent by the server was an invalid certificate or the certificate is

not in clients Trust store.

Some

Solution:

applications have their own version of Java included in it and they use the

included Java, not the one you installed on the systems (such as the one from

/opt/java). In such cases make sure that java security configuration files are

not modified.

How can I find out cimclient.jar version ?<o:p></o:p>

Either add this

certificate to client Trust store or handle the certificate appropriately in

the Certificate Manager.

<pre>�1. Extract MANIFEST file</pre><pre>�� jar xf cimclient.jar META-INF/MANIFEST.MF</pre><pre><![if !supportEmptyParas]> <![endif]><o:p></o:p></pre><pre> 2. You can then look at MANIFEST file to fin</pre><pre>�� a] type META-INF/MANIFEST.MF</pre><pre>�� or</pre><pre>�� b] grep "Name:" META-INF/MANIFEST.MF</pre><pre>�� </pre>

Exception:

CIMCLIENT_ERR_TIMED_OUT (Request Timeout)<o:p></o:p>

My GUI application doesn�t work properly on HP-UX?

Problem:

There is a bug in Java 1.4 HP-UX version (and

This exception

1.3) AWT libraries. For this you will need to install PHSS_24303 patch. I also

indicates that a timeout has occurred on a socket read. This could mean the

found that Patch PHSS_24303 replaced by PHSS_26262. So we will need PHSS_26262.

server or provider may be slow in responding to client request, or the client

time out is small.

Solution:

<h2>Appendix E:

Consider trying

Example cim.properties configuration file<o:p></o:p></h2>

this operation at some other time or might want to set client timeout or

increase the client timeout. Refer to CIMClient API

java documentation for how to set client timeout.

Exception:

CIMCLIENT_ERR_CONNECTION_FAILED(Connection refused) <o:p></o:p>

Problem:

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

This exception

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

indicates that an error occurred while attempting to connect to <span

"Courier New"'>�� // <o:p></o:p>

class=SpellE>CIMServer on a port. The CIMServer

may not be running on the specified address or it may not be listening on the

specified port.

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

Solution:

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>�� // Example

cim.properties<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

Check to make

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

sure that the server address is correct and the port number specified is the

"Courier New"'>�� //<o:p></o:p>

correct port number for an SSL or non-SSL communication. (e.g., <span

class=GramE>This exception may be thrown if the CIMServer

is SSL enabled and listening on port 5989, the client trying to connect to

non-SSL port 5988.)

Exception:

CIMCLIENT_ERR_CONNECTION_FAILED(sequoia Unknown host) <o:p></o:p>

Problem: This exception indicates

that the CIMServer address specified may contain an

invalid system name or the system is not reachable.

Solution:<span

style='mso-spacerun:yes'>� Make sure the specified CIMServer

address is correct and the remote system is reachable.

<h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:

italic'> <o:p></o:p></h2>

<span style='font-size:12.0pt;mso-bidi-font-size:

10.0pt;font-family:Arial;mso-fareast-font-family:"Times New Roman";mso-ansi-language:

EN-US;mso-fareast-language:EN-US;mso-bidi-language:AR-SA'><br clear=all

style='page-break-before:always'>

<h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:

italic'>Appendix A:� CIM Client FAQ<o:p></o:p></h2>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'><o:p> </o:p>

<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;

text-autospace:none'><span

style='font-family:"Courier New"'>CIMInstance.getKeyValuePairs<span

class=GramE>(<span

style='font-family:"Courier New"'>) returns no keys although there are multiple

keys in my (exaple PG_OperatingSystem

has 4 keys) provider.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'>This

bug is fixed in 2.0 Final Release. <o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<span

style='font-family:"Courier New"'>I see my client hangs and does not return or

how to set timeouts in a Client?<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'>When

you have a SSL enabled client trying to connect non-SSL CIMServer

and vice-versa. You may notice that the client does not return. In such case

you should make sure to set the proper timeouts.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'>Here

is how you can set the timeouts:<o:p></o:p>

<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;

mso-layout-grid-align:none;text-autospace:none'>1.

Set READ timeout, refer to CIMClient class<o:p></o:p>

<h3 style='margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt;margin-left:

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;

mso-layout-grid-align:none;text-autospace:none'><span style='mso-bidi-font-size:

12.0pt;font-family:"Times New Roman"'>�� <span

style='mso-tab-count:1'>�� �� <span

class=SpellE>CIMClient.setTimeout<span

class=GramE>(int timeout); //in milliseconds<o:p></o:p></h3>

<span

style='font-family:"Courier New"'>This is a read timeout, i.e. the client has

found the server and connected to it, and the server is not responding to any

request. Basically the socket is blocked. This may happen in case of a Non-SSL

client connecting to SSL server and also vice versa. For your applications I

think setTimeout<span

class=GramE>() call is good enough.<o:p></o:p>

<o:p> </o:p>

<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;

mso-layout-grid-align:none;text-autospace:none'>2.<span style='font-family:

"Courier New"'> To set the connection timeout<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span

style='mso-spacerun:yes'>�� �� //Assumption

timeout is in seconds<o:p></o:p>

<pre style='text-indent:.5in;mso-layout-grid-align:none;text-autospace:none'><span

style='mso-fareast-font-family:"Times New Roman"'>�Either you add the following line in your client program<o:p></o:p></pre>

<p class=MsoNormal style='margin-left:.5in;text-indent:.5in;tab-stops:.5in;

mso-layout-grid-align:none;text-autospace:none'><span

class=GramE>System.setProperty<span

class=GramE>(<span

style='font-family:"Courier New"'>"java.net.connectiontimeout","20")

<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

none'><span

"Courier New"'>�� DEBUG_XML=false <o:p></o:p>

style='mso-spacerun:yes'>��� Or<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'>�

�� You can pass it at run time,

using<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;tab-stops:.5in;mso-layout-grid-align:

none;text-autospace:none'><span

style='mso-spacerun:yes'>�� java -<span

class=SpellE>Djava.net.connectiontimeout=20<span

style='mso-spacerun:yes'>� myclient<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><o:p> </o:p>

<o:p> </o:p>

<o:p> </o:p>

How

to decode a property that is an enumeration?

I.E. to decode the numeric value that is returned for the property.<span

style='mso-spacerun:yes'>� Does WBEM provide methods to look up the

numeric value to retrieve a String value?�

Or do I need to implement a look up table for every enumeration that I

am interested in?<o:p></o:p>

<o:p></o:p>

<pre style='mso-layout-grid-align:none;text-autospace:none'><span

style='mso-fareast-font-family:"Times New Roman"'>The strings associated with enumeration property values are defined as qualifiers on the class schema.� A client does not get these strings from a provider directly.� But rather than duplicate the string definitions on the client side, you can get them from the CIM server using a <span

class=SpellE>getClass operation.</pre>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'>For example, PG_NISServerService<span

class=GramE>:: ServerType is an

enumeration.� When I make the request I

get a numeric value between 0 and 4 (inclusive).<span

style='mso-spacerun:yes'>� I then have to decode the numeric values as

such:<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'>��

"0" - Unknown<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'>��

"1" - Other<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'>��

"2" - Not an <st1:City><st1:place><span

style='font-family:"Courier New"'>NIS</st1:place></st1:City><span

style='font-family:"Courier New"'> Server<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'>��

"3" - NIS Master<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'>��

"4" - <st1:City><st1:place><span style='font-family:

"Courier New"'>NIS</st1:place></st1:City><span style='font-family:

"Courier New"'> Slave<o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><o:p> </o:p>

The cimclient

library performs the SSL handshaking and receives the certificate/key, what

environment settings must be in place for certificates to be passed?<o:p></o:p>

Clients must create a trust store,

import certificates from the server they trust in to the trust store, provide

the trust store path to the JSSE either on the command line ( java -<span

class=SpellE>Djavax.net.ssl.trustStore=mytruststore

<MyClient>�

) or through

<span

class=GramE>System.setProperty("<span

class=SpellE>javax.net.trustStore", "mytruststore");

How do set �trustManager�

property programmatically?<o:p></o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� String

myTrustManager= "org.mycompany.cimapp.myCertManager";<o:p></o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>�� <span

class=SpellE>GlobalConfig.setTrustManager<span

class=GramE>(myTrustManager);<o:p></o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>Note that you can not set this property to �null�. If

you would like to use the default trust manager provided in JSSE, do not even

define the trust manager property in your program or in your properties file.<o:p></o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'><o:p> </o:p>

<h4 style='tab-stops:.5in'>Can I change the trust manager property in between

my program/process?</h4>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'><o:p> </o:p>

<span style='font-size:12.0pt;

mso-bidi-font-size:10.0pt'>No, you cannot. If you define/set this property in

your Client application either using setTrustManager<span

class=GramE>() or through� WBEM

Client configuration file (like cim.properties) it

will be set once per process, I.E you can not set/unset for every connection

being in the same process.<o:p></o:p>

Does the cimclient

library accept the certificate and place it in the trust store?<span

style='mso-spacerun:yes'>� How would the application specify to the <span

class=SpellE>cimclient library where the trust store is<o:p></o:p>

Client library using JSSE will

only validate the server certificate using the trust store. It accepts only

trusted certificates from the server. In case of non-trusted certificate the

client library will call the trust manager if there is one specified. It is the

job of trust manager to either accept the server certificate (possibly add that

to the trust store) or reject the certificate.

How is the

client application notified that the certificate or key was placed in

the trust store?� Is this assumed?<o:p></o:p>

Same as above

Can the client application set

the environment so that certificates or keys are required from some target

systems but other target systems are not validated or authenticated?<o:p></o:p>

Yes, trust manager can do this.

Where can I find more

information on Trust Manager and Trust Stores?<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

More information

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

can be found at J2SE web site.� - ----

"Courier New"'>�� DEBUG_XMLDECODE=false<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

<span

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

style='mso-bidi-font-family:"Courier New"'>http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html<o:p></o:p>

"Courier New"'>�� clientLogFilePath=cimclient.txt<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

http://java.sun.com/j2se/1.4/docs/api/javax/net/ssl/X509TrustManager.html

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'> <o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

I am unable use/initialize SSL

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

connection, what do I do?<o:p></o:p>

"Courier New"'>�� // CIM Clients may

specify their own Trust Manager to use <o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

<span style='mso-bidi-font-family:

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

"Courier New"'>Some applications have their own version of Java included in it

"Courier New"'>�� // instead of the

and they use the included Java, not the one you installed on the systems (such

default JSSE TrustManager.<o:p></o:p>

as the one from /opt/java). In such cases make sure that java security

configuration files are not modified.

How can I find out <span

class=SpellE>cimclient.jar version?<o:p></o:p>

<pre>You can run PackageVersion program to look at the version.</pre><pre>�� <span

class=GramE>java org.snia.wbem.PackageVersion</pre><pre>�� </pre>

My

GUI application doesn�t work properly on HP-UX?

There

is a bug in Java 1.4 HP-UX version (and 1.3) AWT libraries. For this you will need

to install PHSS_24303 patch. I also found that Patch PHSS_24303 replaced by

PHSS_26262. So we will need PHSS_26262.

<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;

text-autospace:none'><span

style='font-family:"Courier New"'>CIMInstance.getKeyValuePairs<span

class=GramE>(<span

style='font-family:"Courier New"'>) returns no keys although there are multiple

keys in my (exaple PG_OperatingSystem

has 4 keys) provider.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'>This

bug is fixed in 2.0 Final Release.� You

should not see this bug.<o:p></o:p>

<o:p> </o:p>

<h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:

italic'>Appendix B: CIM Listener FAQ<o:p></o:p></h2>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'>Question 1: How to Create Subscriptions?<span

style='font-family:"Courier New"'><o:p></o:p>

<span

style='font-size:10.0pt;font-family:"Courier New"'>Creating subscription is

same as creating any CIM instance...you will use CIM Client interfaces to do

so. Currently WBEM (core CIMServer)

only supports CIM_IndicationSubscription, <span

class=SpellE>CIM_IndicationFilter, CIM_IndicationHandlerCIMXML

and IndicationHandlerSNMPMapper<span

style='font-size:10.0pt;font-family:"Courier New"'> classes.<o:p></o:p>

<span

style='font-size:10.0pt;font-family:"Courier New"'>Question 2:<span

style='mso-spacerun:yes'>� When a listener is created, does it execute

in its own thread, separate from the code that created it<span

style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p>

<span

style='font-family:"Courier New"'>Listener runs as server (either SSL or

non-SSL) and listens on the specified port. When Listener <span

class=SpellE>startCIMHTTPListener<span

class=GramE>() is called, it will create a thread and starts listening.

<o:p></o:p>

<span

style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'>Question 3: I

am unable to modify instances of CIM_IndicationHandlerCIMXML

class.� Client says - Unable to modify

instance: CIM_ERR_NOT_FOUND(CIM_ERR_NOT_FOUND: The

requested object could not be found: "CIM_IndicationHandlerCIMXML")<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'>The

modifyInstance operation is not supported for the<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span

style='font-family:"Courier New"'>CIM_IndicationHandlerCIMXML<span

style='font-family:"Courier New"'> class or CIM_IndicationFilter

class, and for� <span

class=SpellE>CIM_IndicationSubscription,

only modification of the SubscriptionState

property� is supported.<span

style='mso-spacerun:yes'>� So, it's necessary to delete the old instance

and create a new instance with the desired change.<span

style='mso-spacerun:yes'>� Also, deletion of a filter or handler that is

referenced by an existing subscription is not allowed, without first<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span

style='font-family:"Courier New"'>deleting<span style='font-family:

"Courier New"'> the subscription.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'>However,

in the case you should see something like "CIM_ERR_NOT_SUPPORTED: The requested

operation is not supported", rather than CIM_ERR_NOT_FOUND.<span

style='mso-spacerun:yes'>� Make sure to check that your request

specifies the� correct

namespace, key values, etc.� It looks

like perhaps the instancename parameter to the <span

class=SpellE>modifyInstance operation included only the <span

class=SpellE>classname and not the key values.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'><o:p> </o:p>

Question

4: If I create instances of CIM_IndicationFilter, and

corresponding instances of CIM_IndicationSubscription,

and CIM_IndicationHandlerCIMXML classes, does the

CIMOM check for the presence of the Indication provider? if

'RT_TestIndication'(sample indication provider) is

not present, Will it give an error response?<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'>When

you create an enabled Subscription, the IndicationService

will look for indication providers that can serve the subscription.<span

style='mso-spacerun:yes'>� If none are found, you will get an error

response.� The subscriber doesn't specify

an indication provider. The subscriber specifies the desired indication

subclass, properties and namespace in the Filter.<span

style='mso-spacerun:yes'>�� The IndicationService

looks for indication providers that have registered to serve the specified

indication class in the specified namespace.�

Maybe your indication provider is not registered?<span

style='mso-spacerun:yes'>� Let me know if you need help registering your

indication provider.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

Question

5: If I create a disabled subscription (the property SubscriptionState

is set to 'Disabled'), will the IndicationService

still check for the presence of the indication provider?<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<span

style='font-weight:normal'>If you create the Subscription with <span

class=SpellE>SubscriptionState property set to 'Disabled', the <span

class=SpellE>IndicationService will NOT check whether there is an

indication provider to serve the subscription.�

So maybe that's what you want to do for now, to get going.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'>Question 6:� Since the <span

class=SpellE>IndicationService knows which indication subclass is served

by an indication provider, is it required that the instances of indication

classes be created before the provider is registered?<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'><o:p> </o:p>

<span

style='font-weight:normal'>The IndicationService

checks that the class specified in the Filter is a subclass of <span

class=SpellE>CIM_Indication, so you must define the indication subclass

you'll be using.� (Instances of the

indication subclass don't get created until the indication provider generates

an indication.)<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'><o:p> </o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'><span style='font-family:

"Courier New"'><o:p> </o:p>

<span

style='font-family:"Courier New"'>Question 7:�

How a particular listener is associated with a given subscription and

what goes into the Destination property CIM_ IndicationHandlerCIMXML<o:p></o:p>

<span

style='font-size:10.0pt;font-family:"Courier New"'>The listener is associated

with the subscription through the destination property of the handler instance.

Multiple subscriptions can refer to the same handler instance; so one listener

can listen to multiple subscriptions.<span style='font-size:10.0pt;

mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p>

<span

style='font-size:10.0pt;font-family:"Courier New"'>With subscription you will

specify the destination where the Listener is running. An example,<span

style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p>

<span

style='font-size:10.0pt;font-family:"Courier New"'><PROPERTY

NAME="Destination" TYPE="string"><o:p></o:p>

<span

style='font-size:10.0pt;font-family:"Courier New"'><VALUE>https://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer</VALUE><o:p></o:p>

<span

style='font-size:10.0pt;font-family:"Courier New"'></PROPERTY><span

style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p>

<span

style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'>In

the above case, Listener would be running on mysystem.cup.hp.com at port 8189

with SSL enabled. <o:p></o:p>

<span

style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'>Question

8:� <span style='font-size:

10.0pt;font-family:"Courier New"'>Can I specify/use any port number with my

Listener?<o:p></o:p>

<span

style='font-size:10.0pt;font-family:"Courier New"'>It is not a good plan to

select any port and have the application use it.<span

style='mso-spacerun:yes'>� It is recommended that a Listener application

to have its own port number and is registered with IANA so that no one

else uses that port number. And also if the application is going to be running

on HP-UX, you can request INET Team to have the IANA registered port number added

to /etc/services. This way no other HP-UX application uses your port numbers.<o:p></o:p>

<span

style='font-family:"Courier New"'>Question 9: when the client creates the

indication listener, does it return an error if a listener already exists on

that system on the same port? <o:p></o:p>

<span

style='font-family:"Courier New"'><o:p> </o:p>

<span

style='font-family:"Courier New"'>Yes it does say - Address is in use.<o:p></o:p>

<o:p> </o:p>

<span

style='font-family:"Courier New"'>Question 10: Create Instance for <span

class=SpellE>CIM_IndicationSubscription fails; However, I can create

Handler and Filter instances.<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

mso-layout-grid-align:none;text-autospace:none'>There

is a problem with Java Client API while creating instance with reference values

related to indication subscription class. This is mainly because of <span

class=GramE>Each time the ObjectPath gets

passed to CIM Operations, Client API modifies the CIMObjectPath

after it gets the response from cimserver. The work

around is to store the CIMObjectPath that is passed

to createInstance<span

class=GramE>() while creating Filter and Handler instances. Then use

that stored paths in Subscription.<o:p></o:p>

<span

style='font-family:"Courier New"'>Refer to the example (examples/Indication/<span

class=SpellE>SubscribeIndTest.java<span

class=GramE> ) that is in WBEM Java Client SDK.<o:p></o:p>

<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

style='font-style:normal;mso-bidi-font-style:italic'><o:p> </o:p></h2>

<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

style='font-style:normal;mso-bidi-font-style:italic'>Appendix C: Example <span

class=SpellE>cim.properties configuration file<o:p></o:p></h2>

<div style='border:solid windowtext 1.0pt;mso-border-alt:solid windowtext .5pt;

padding:1.0pt 4.0pt 1.0pt 4.0pt'>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� // <o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� // Example cim.properties<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� //<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� DEBUG_XML=false <o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� DEBUG_XMLDECODE=false<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� clientLogFilePath<span

class=GramE>=cimclient.txt<o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'> <o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� // CIM Clients may specify their own Trust

Manager to use <o:p></o:p>

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-spacerun:yes'>�� // instead of the default JSSE <span

class=SpellE>TrustManager.<o:p></o:p>

<p class=MsoNormal style='border:none;mso-border-alt:solid windowtext .5pt;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;

padding:0in;mso-padding-alt:1.0pt 4.0pt 1.0pt 4.0pt'><span style='font-family:

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

"Courier New"'>��

1.0pt 4.0pt 1.0pt 4.0pt'><span

TrustManager=org.mycompany.myapp.MyCertificateManager<o:p></o:p>

style='mso-spacerun:yes'>�� TrustManager=<span

class=SpellE>org.mycompany.myapp.MyCertificateManager<o:p></o:p>

</div>

<o:p></o:p>

<span

style='font-family:"Courier New"'> <o:p></o:p>

</div>

Legend:

Removed from v.1.1.4.1
changed lines
	Added in v.1.7

No CVS admin address has been configured