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.2

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

version 1.2, 2004/02/12 18:12:28

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="http://www.w3.org/TR/REC-html40">

Line 7

Line 8

<link rel=File-List

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

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

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

<o:DocumentProperties>

Line 17

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

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

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

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

<o:TotalTime>1874</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>2003-11-19T23:06:00Z</o:LastSaved>

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

<o:Pages>18</o:Pages>

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

<o:Words>5673</o:Words>

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

<o:Characters>32340</o:Characters>

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

<o:Company>Hewlett-Packard Company</o:Company>

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

<o:Lines>269</o:Lines>

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

<o:Paragraphs>64</o:Paragraphs>

<o:CharactersWithSpaces>39715</o:CharactersWithSpaces>

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

</o:DocumentProperties>

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

Line 48

Line 49

<!--

/* 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 134

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 177

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 238

Line 245

font-size:12.0pt;

font-family:"Times New Roman";

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

code

{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 316

Line 328

{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 368

{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 411

mso-level-number-position:left;

text-indent:-.25in;

font-family:Symbol;}

@list l4

@list l3:level2

{mso-list-id:749347362;

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

mso-list-type:hybrid;

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;

text-indent:-.25in;}

font-family:Symbol;}

@list l3:level3

@list l5

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

{mso-list-id:1156529437;

mso-list-type:hybrid;

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

@list l5:level1

{mso-level-start-at:2;

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l6

@list l3:level4

{mso-list-id:1305546433;

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

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

@list l3:level5

{mso-list-id:1324700588;

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

mso-list-type:hybrid;

mso-level-number-position:left;

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

text-indent:-.25in;}

@list l7:level1

@list l3:level6

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

{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 l8

@list l3:level9

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l4

{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 l4:level1

{mso-level-number-format:bullet;

mso-level-text:\F0B7;

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

Line 383

Line 455

text-indent:-.25in;

mso-ansi-font-size:10.0pt;

font-family:Symbol;}

@list l8:level2

@list l4:level2

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level3

@list l4:level3

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level4

@list l4:level4

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level5

@list l4:level5

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level6

@list l4:level6

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level7

@list l4:level7

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level8

@list l4:level8

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l8:level9

@list l4:level9

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l9

@list l5

{mso-list-id:1739132725;

mso-list-type:hybrid;

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

@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;

font-family:Symbol;}

@list l10

{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 l5:level1

{mso-level-number-format:bullet;

mso-level-text:\F0B7;

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

Line 438

Line 499

text-indent:-.25in;

mso-ansi-font-size:10.0pt;

font-family:Symbol;}

@list l10:level2

@list l5:level2

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level3

@list l5:level3

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level4

@list l5:level4

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level5

@list l5:level5

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level6

@list l5:level6

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level7

@list l5:level7

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level8

@list l5:level8

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l10:level9

@list l5: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 9]><xml>

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

</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'>HP 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.0 </h1>

<h1 align=center style='text-align:center'><span 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;

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

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

Line 505

Line 564

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 540

Line 599

org.snia.wbem.listener

<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;

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

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

Line 549

Line 608

<o:p></o:p>

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

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

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

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

</ul>

Line 565

Line 624

<o:p></o:p>

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

<li class=MsoNormal style='mso-list:l4 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>

Line 588

Line 647

<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;

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

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

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

italic'>What's new in 2.0 Release?<o:p></o:p></h2>

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

1. This version supports both SSL and non-SSL based

indications.� Two-way SSL authentication

CIM/XML indications.� Client SDK now

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

includes the CIM Listener interfaces for writing CIM/XML indication consumers.

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

With Secured Listener, 2-way SSL authentication is always enabled with CIM/XML

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

Indications.� Please refer to Java

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

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

Note:<span

2. Redesigned CIM HTTP Listener interface to separate

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

Consumer interfaces from Listener

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

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

3. Added Operation Context � which is (can be) used to

pass additional information to clients/consumers.

4. Added support for 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.

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

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

10.0pt'><![if !supportEmptyParas]> <![endif]><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:

italic'>4.

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

Line 632

Line 701

Client applications typically follow this sequence:

1.<span

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

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

CIMOM using <tt>CIMClient</tt>.

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 881

Line 950

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>

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

<o:p></o:p>

Line 955

Line 1023

<p class=MsoNormal style='margin-left:.5in;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:

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

yes">�� localOnly,

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

includeQualifiers,<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 4.0pt 1.0pt 31.0pt'><span style='font-size:

Line 981

Line 1049

<p class=MsoNormal style='margin-left:.5in;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'>��

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

��{<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 4.0pt 1.0pt 31.0pt'><span style='font-size:

Line 1038

Line 1106

<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>

Line 1233

Line 1301

<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'>��

System.out.println("InvokeMethod response = " +

System.out.println("InvokeMethod response = " + retValue.toString());<o:p></o:p>

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:

Line 1268

Line 1335

<o:p></o:p>

Clients

Clients may close the connection by calling the

may close the connection by calling the CIMClient.close() method. Client

CIMClient.close() method. Client connection will also be closed when the

connection will also be closed when the CIMClient object goes out of scope. <o:p></o:p>

CIMClient object goes out of scope.

Line 1329

Line 1396

</div>

<i style='mso-bidi-font-style:

normal'> <o:p></o:p>

normal'><![if !supportEmptyParas]> <![endif]><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;mso-ascii-font-family:"Times New Roman";

mso-hansi-font-family:"Times New Roman";mso-bidi-font-family:"Times New Roman"'>CIMClient(CIMNameSpace 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'><![if !supportEmptyParas]> <![endif]><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:

italic'>5.

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

Line 1364

Line 1446

yes">�� - 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

font-family:"Courier New"'>keytool<span style='mso-bidi-font-size:10.0pt;

style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'>keytool<span

mso-bidi-font-family:"Courier New"'> to import the certificate into the client

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'> to import

trust store.<o:p></o:p>

the certificate into the client trust store.<o:p></o:p>

<span

style='mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'># keytool

Line 1376

Line 1458

<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 in the future.

future. The keytool creates the trust store if it is not already exists and

The keytool creates the trust store if it is not already exists and then import

then import the specified certificate. (For example we entered the password as

the specified certificate. (For example we entered the password as �wbem01�)<o:p></o:p>

�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

Line 1389

Line 1470

10.0pt;mso-bidi-font-family:"Courier New"'>For Example,<o:p></o:p>

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

mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java -Djavax.net.ssl.trustStore=mytruststore

mso-bidi-font-size:10.0pt;mso-bidi-font-family:"Courier New"'>java

-Djavax.net.ssl.trustStore=mytruststore <MyClient> <system>

root/cimv2 5989 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

Line 1435

Line 1517

<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;

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

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

Line 1615

Line 1697

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

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;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

Line 1719

Line 1801

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

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'>�� <span

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

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

<p class=MsoNormal style='margin-top:0in;margin-right:.9in;margin-bottom:0in;

margin-left:9.0pt;margin-bottom:.0001pt;border:none;mso-border-alt:solid windowtext .5pt;

Line 1760

Line 1842

<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:

italic'>7.

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

Line 1891

Line 1973

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;

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

tab-stops:list .5in'><![if !supportLists]>8.

<![endif]>CIM-XML Listener</h2>

<![endif]>CIM-HTTP� Listener</h2>

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

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

mso-bidi-font-size:8.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

A CIM-xml

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

Listener is an HTTP server that receives and processes CIM Export Requests

mso-bidi-font-size:8.0pt'>A CIM-HTTP Listener is an HTTP server that

and issues CIM Export Responses. An CIM Export Message is used to transfer data

receives and processes CIM Export Requests and issues CIM Export Responses. An

from a CIM entity into a non-CIM entity.<span style='font-size:12.0pt;

CIM Export Message is used to transfer data from a CIM entity into a non-CIM

display:none;mso-hide:all'><o:p></o:p>

entity.<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>

<span

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

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

mso-bidi-font-size:9.0pt'>What are the components of a CIM-HTTP Listener?<o:p></o:p>

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'><![if !supportEmptyParas]> <![endif]><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

processes, 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;

Schema.<span style='font-size:12.0pt;mso-bidi-font-size:7.5pt;

color:windowtext'>CIM_Indication Schema.<span style='font-size:

color:windowtext'> The schema definition for indication objects of

12.0pt;mso-bidi-font-size:7.5pt;color:windowtext'> The schema definition

interest to the CIM-xml Listener.<span style='font-size:11.0pt;

for indication objects of interest to the CIM-XML Listener.<span

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

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'><![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>

<span style='font-size:7.5pt;font-family:"Futura Bk";

The listener is associated with the subscription through

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

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:7.5pt;font-family:"Futura Bk";

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

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

<h3>Writing CIM-XML

With

Consumer<o:p></o:p></h3>

subscription you will specify the destination where the Listener is running. <o:p></o:p>

For

example,<o:p></o:p>

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

<span

mso-bidi-font-size:10.0pt'>CIM-XML consumer applications use the <tt><span

style="mso-spacerun: yes">� 1. SSL enable consumer<o:p></o:p>

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

<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'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<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>

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

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: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 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;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:

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><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.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;

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.

<![endif]>Identify the port number they want to listen for indications.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

tab-stops:list .5in'><![if !supportLists]>2.

<![endif]>Use the CIM Listener APIs to start listening on a particular

<![endif]>Implement a consumer using CIMIndicationConsumer interface.

port.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

tab-stops:list .5in'><![if !supportLists]>3.

<![endif]>Write it�s own �indicationOccurred()� method to process

<![endif]>Write it�s own �consumerIndication(); method to process

indication when received.

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo11;

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

tab-stops:list .5in'><![if !supportLists]>4.

<![endif]>Start running as a process.

<![endif]>Use the CIM HTTP Listener APIs to start listening on a

particular port.

Import

<p style='margin-left:.5in;text-indent:-.25in;mso-list:l2 level1 lfo17;

CIMHTTP Listener<o:p></o:p>

tab-stops:list .5in'><![if !supportLists]>5.

<![endif]>Start running as a process

<o:p></o:p>

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

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

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

<p class=MsoNormal style='margin-left:.5in;tab-stops:.5in;border:none;

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

mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

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

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

org.snia.wbem.listener.CIMHTTPListener;<o:p></o:p>

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

<p class=MsoNormal style='margin-left:.5in;tab-stops:.5in;border:none;

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

mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:1.0pt 0in 1.0pt 31.0pt'><span

12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

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

org.snia.wbem.listener.CIMIndicationConsumer;

<p class=MsoNormal style='margin-left:.5in;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 org.snia.wbem.xml.OperationContext;

</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'><![if !supportEmptyParas]> <![endif]><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'><![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'> Initialize and

none'><![if !supportEmptyParas]> <![endif]><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>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

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

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><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='border:none;mso-border-alt:solid windowtext .5pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

12.0pt;mso-bidi-font-size:10.0pt'>public class MyIndicationConsumer implements

style="mso-spacerun: yes">�� try <o:p></o:p>

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

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

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

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

12.0pt;mso-bidi-font-size:10.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='border:none;mso-border-alt:solid windowtext .5pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style="mso-spacerun: yes">�� CIMHTTPListener ccl = new

MyIndicationConsumer(String name) <o:p></o:p>

CIMHTTPListener(listenerPortNo, isSSL) <o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

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

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style='mso-tab-count:1'>�� ��

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

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

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

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style="mso-spacerun: yes">�� public void

System.out.println("I am a consumer" + name);<o:p></o:p>

indicationOccured(CIMIndication e, String indURL) <o:p></o:p>

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

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

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

12.0pt;mso-bidi-font-size:10.0pt'>�� }<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='border:none;mso-border-alt:solid windowtext .5pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style="mso-spacerun: yes">�� handleIndication(e.getIndication(),

public void consumeIndication(OperationContext context,<o:p></o:p>

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

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

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

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

yes">�� String URL, CIMIndication cime)

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

<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none;

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

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

12.0pt;mso-bidi-font-size:10.0pt'>�� {<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='border:none;mso-border-alt:solid windowtext .5pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style="mso-spacerun: yes">�� ccl.startCIMHTTPListener();<o:p></o:p>

// 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='border:none;mso-border-alt:solid windowtext .5pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><![if !supportEmptyParas]> <![endif]><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='border:none;mso-border-alt:solid windowtext .5pt;

border:none;mso-border-alt:solid windowtext .5pt;padding:0in;mso-padding-alt:

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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

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">�� catch (Exception e) {<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'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

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;

<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'>Indication

1.0pt 4.0pt 1.0pt 4.0pt'><span

Processor (consumeIndicattion()) method<o:p></o:p>

style="mso-spacerun: yes">�� e.printStackTrace();<o:p></o:p>

<p class=MsoBodyText2 style='tab-stops:.5in;mso-layout-grid-align:none;

text-autospace:none'>Once the indication is received you can have your own

consumerIndication() method that can process the CIMInstance which is passed by

the CIMListener. Here is an example:

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><![if !supportEmptyParas]> <![endif]><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">�� public void 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">�� <span

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

style="mso-spacerun: yes">� CIMIndication ind)<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;

<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'><![if !supportEmptyParas]> <![endif]><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("----------

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("--- 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("--- 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

(ind.getClassName().startsWith("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)ind.getProperty("classdefinition").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

(ind.getClassName().startsWith("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").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'><![if !supportEmptyParas]> <![endif]><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 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">�� 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 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">�� 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("-----------

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">�� <span style="mso-spacerun:

yes">��ee.printStackTrace();<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>

</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'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

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

<h4 style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:none'>Developing

CIM HTTP Listener</h4>

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

public

class SampleListener<o:p></o:p>

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

<span

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

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

mso-bidi-font-size:10.0pt'>CIMHTTPListener myListener =<span

style="mso-spacerun: yes">� new CIMHTTPListener(listenerPortNo, isSSL);<o:p></o:p>

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

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

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

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

MyIndicationConsumer consumer1 =

new MyIndicationConsumer("1");

myListener.addConsumer(consumer1);

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

mso-bidi-font-size:10.0pt'>myListener.start ();<o:p></o:p>

<span

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

<span

style="mso-spacerun: yes">�� catch (CIMExecption ce) <o:p></o:p>

<span

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

<span

style="mso-spacerun: yes">�� System.out.println(�Unable to

add consumers: � + ce.getMessage());<o:p></o:p>

<span

style="mso-spacerun: yes">�� }�

<o:p></o:p>

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

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

none'><![if !supportEmptyParas]> <![endif]><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>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

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

yes">�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.<span

style="mso-spacerun: yes">� OperationContext holds container objects.<o:p></o:p>

<span

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

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

Processor method<o:p></o:p>

Once

<span

the indication is received you can have your own handleIndication method that

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>For example: Listener

can process the CIMInstance which is passed by the CIMListener. Here is an

interface would want to pass additional information, such as content language,

example:

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>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

Line 2128

Line 2500

<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

1.0pt 4.0pt 1.0pt 4.0pt'>Consumers

style="mso-spacerun: yes">�� void handleIndication(CIMInstance ind,

can then use Context get method to the container object.<o:p></o:p>

String indURL) <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

1.0pt 4.0pt 1.0pt 4.0pt'>{<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

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� System.out.println("----------

style="mso-spacerun: yes">�� // Create Context<o:p></o:p>

Begin of event data ----------");<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

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� System.out.println("--- Indication

style="mso-spacerun: yes">�� OperationContext myContext = new

URL : "+indURL);<o:p></o:p>

OperationContext();<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

1.0pt 4.0pt 1.0pt 4.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

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;

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">�� try <o:p></o:p>

style="mso-spacerun: yes">�� // Create a OperationContext 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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style="mso-spacerun: yes">�� ExampleContextContainer myContainer = new

ExampleContextContainer();<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

1.0pt 4.0pt 1.0pt 4.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

style="mso-spacerun: yes">�� Object o=null;<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

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� if

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

(ind.getClassName().startsWith("CIM_Class"))<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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style="mso-spacerun: yes">�� // insert objects into Context <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;

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">�� if

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

(ind.getClassName().startsWith("CIM_Inst"))<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

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� o=(Object)

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

ind.getProperty("sourceinstance").getValue().getValue();<o:p></o:p>

myContext.insert((OperationContext)myContainer);<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>

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;

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">�� if (o instanceof CIMInstance) <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

1.0pt 4.0pt 1.0pt 4.0pt'><span

style='mso-tab-count:1'>�� � {<o:p></o:p>

style="mso-spacerun: yes">�� // get objects from the Context <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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style="mso-spacerun: yes">�� //<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;

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">�� System.out.println("---

style="mso-spacerun: yes">�� ExampleContextContainer clCont =<o:p></o:p>

Embedded Instance: "+eo);<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

1.0pt 4.0pt 1.0pt 4.0pt'><span

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

style="mso-spacerun: yes">�� (ExampleContextContainer)myContext.get(ExampleContextContainer.NAME);<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;

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("Got back

:" + clCont.getName());<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:

1.0pt 4.0pt 1.0pt 4.0pt'>}<o:p></o:p>

</div>

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

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

<h6>Example

OperationContext Container<o:p></o:p></h6>

<span

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

object carries the request context information that consumer may access. <o:p></o:p>

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><![if !supportEmptyParas]> <![endif]><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'>public class

ExampleContextContainer implements OperationContextContainer<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'>{<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">�� else if (o instanceof CIMClass) {<o:p></o:p>

style="mso-spacerun: yes">�� /** Container name of this container */<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">�� CIMClass eo=(CIMClass)o;<o:p></o:p>

style="mso-spacerun: yes">�� public static final String

NAME="ExampleContextContainer";<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("---

style="mso-spacerun: yes">�� public ExampleContextContainer() { }<o:p></o:p>

Embedded Class: "+eo);<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;

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>

style="mso-spacerun: yes">�� public String getName()<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("-----------

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

End of event data -----------\n");<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">�� }<o:p></o:p>

style="mso-spacerun: yes">�� return(NAME);<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">�� catch (Exception ee) <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">�� {<o:p></o:p>

style="mso-spacerun: yes">�� public Object clone()<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">�� ee.printStackTrace();<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">�� }<o:p></o:p>

style="mso-spacerun: yes">�� return ((Object)new

ExampleContextContainer());<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">�� }<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='font-size:12.0pt;mso-bidi-font-size:10.0pt'><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'><![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'>SSL Support with CIM

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

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

The CIM Listener interface supports SSL for secure communication. The CIM

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

Listener (a Server) can accept either http or https connections from the system

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

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

<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'>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.

<h4>Creating subscription</h4>

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

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, 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'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

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

<p class=MsoNormal style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:

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

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

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

In addition to the standard CIM

by the CIM Server to the client, the CIM Client library generates the following

Exceptions sent by the CIM Server to the client, the CIM Client library

exceptions. The exception generated by the client library along with the reason

generates the following exceptions. The exception generated by the client

and solution is explained below:

library along with the reason and solution is explained below:

Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED (Unable to Initialize

Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED

Specified TrustManager: <a

(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:

Problem:

This exception indicates that

This exception

the specified TrustManager may not exist, may contain invalid path, or it may

indicates that the specified TrustManager may not exist, may contain invalid

not have required permission to load.

path, or it may not have required permission to load.

Solution:

Solution:

Make sure that the TrustManager

Make sure that

you have specified exist and has correct path and right permissions. Also make

the TrustManager you have specified exist and has correct path and right

sure that the TrustManager is not set to �null�.

permissions. Also make sure that the TrustManager is not set to �null�.

Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED(SSL Factory Initialization

Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED(SSL

failed: <a href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span

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>

Problem:

Problem:

This exception may happen in

This exception

number different scenarios. Such as, unable to find JSSE providers, unable to

may happen in number different scenarios. Such as, unable to find JSSE

generate random seed, unable to connect to correct server, server had problem

providers, unable to generate random seed, unable to connect to correct server,

with SSL handshake, or policy permissions are incorrect.

server had problem with SSL handshake, or policy permissions are incorrect.

Solution:

Solution:

Follow JSSE specification and

Follow JSSE

make sure the system java configurations are setup correctly.

specification and make sure the system java configurations are setup correctly.

Exception: CIMCLIENT_ERR_HTTP_ERROR(Couldn't

Exception:

find trusted certificate, response=500)<o:p></o:p>

CIMCLIENT_ERR_HTTP_ERROR(Couldn't find trusted certificate, response=500)<o:p></o:p>

Problem:

Problem:

This exception may happen

This exception

because of SSL handshake failure. SSL handshake may fail because the

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:

Solution:

Either add this certificate to

Either add this

client Trust store or handle the certificate appropriately in the Certificate

certificate to client Trust store or handle the certificate appropriately in

Manager.

the Certificate Manager.

Exception: CIMCLIENT_ERR_TIMED_OUT (Request

Exception:

Timeout)<o:p></o:p>

CIMCLIENT_ERR_TIMED_OUT (Request Timeout)<o:p></o:p>

Problem:

Problem:

This exception indicates that a

This exception

timeout has occurred on a socket read. This could mean the server or provider

indicates that a timeout has occurred on a socket read. This could mean the

may be slow in responding to client request, or the client time out is small.

server or provider may be slow in responding to client request, or the client

time out is small.

Solution:

Solution:

Consider trying this operation

Consider trying

at some other time or might want to set client timeout or increase the client

this operation at some other time or might want to set client timeout or

timeout. Refer to CIMClient API java documentation for how to set client

increase the client timeout. Refer to CIMClient API java documentation for how

timeout.

to set client timeout.

Exception:

Exception:

CIMCLIENT_ERR_CONNECTION_FAILED(Connection refused) <o:p></o:p>

Problem:

Problem:

This exception indicates that an

This exception

error occurred while attempting to connect to CIMServer on a port. The CIMServer

indicates that an error occurred while attempting to connect to CIMServer on a

may not be running on the specified address or it may not be listening on the

port. The CIMServer may not be running on the specified address or it may not

specified port.

be listening on the specified port.

Solution:

Solution:

Check to make sure that the

Check to make

server address is correct and the port number specified is the correct port

sure that the server address is correct and the port number specified is the

number for an SSL or non-SSL communication. (e.g., This exception may be thrown

correct port number for an SSL or non-SSL communication. (e.g., This exception

if the CIMServer is SSL enabled and listening on port 5989, the client trying

may be thrown if the CIMServer is SSL enabled and listening on port 5989, the

to connect to non-SSL port 5988.)

client trying to connect to non-SSL port 5988.)

Exception:

Exception:

CIMCLIENT_ERR_CONNECTION_FAILED(sequoia Unknown host) <o:p></o:p>

Problem: This exception indicates that the CIMServer

Problem: This exception indicates

address specified may contain an invalid system name or the system is not

that the CIMServer address specified may contain an invalid system name or the

reachable.

system is not reachable.

Solution:�

Solution:<span

Make sure the specified CIMServer address is correct and the remote

style="mso-spacerun: yes">� Make sure the specified CIMServer address is

system is reachable.

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>

<span

<span

style='font-size:12.0pt;mso-bidi-font-size:10.0pt;font-family:Arial;mso-fareast-font-family:

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

"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>

CIMInstance.getKeyValuePairs()

returns no keys although there are multiple keys in my (exaple

PG_OperatingSystem has 4 keys) provider.<o:p></o:p>

The cimclient library performs the SSL handshaking

<span

and receives the certificate/key

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

What environment settings must be in place for

<span

certificates to be passed?<o:p></o:p>

style='font-family:"Courier New"'>This bug is fixed in 2.0 Final Release. <o:p></o:p>

Clients must create a trust store, import

<span

certificates from the server they trust in to the trust store, provide the

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

trust store path to the JSSE either on the command line ( java

I see my client

hangs and does not return or how to set timeouts in a Client?<o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'>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>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'>Here is how you can set the timeouts:<o:p></o:p>

<p class=MsoNormal style='text-indent:.5in;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;mso-layout-grid-align:none;text-autospace:none'><span style='mso-bidi-font-size:

12.0pt;font-family:"Times New Roman"'>��

�� CIMClient.setTimeout(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() call is good enough.<o:p></o:p>

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

<p class=MsoNormal style='text-indent:.5in;mso-layout-grid-align:none;

text-autospace:none'>2. To set the

connection timeout<o:p></o:p>

<span

style='font-family:"Courier New"'>�� <span

style='mso-tab-count:2'>�� //Assumption timeout is in seconds<o:p></o:p>

<pre style='text-indent:.5in;tab-stops:.5in;mso-layout-grid-align:none;

text-autospace:none'>�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;mso-layout-grid-align:

none;text-autospace:none'>System.setProperty("java.net.connectiontimeout","20")

<o:p></o:p>

<span

style='font-family:"Courier New"'>�<span

style='mso-tab-count:1'>�� Or<o:p></o:p>

<span

style='font-family:"Courier New"'>� <span

style='mso-tab-count:1'>�� You can pass it at run time, using<o:p></o:p>

<p class=MsoNormal style='margin-left:.5in;mso-layout-grid-align:none;

text-autospace:none'><span

style="mso-spacerun: yes">�� java -Djava.net.connectiontimeout=20<span

style="mso-spacerun: yes">� myclient<o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

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

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

How <span

style='font-family:Arial'>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='tab-stops:.5in;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 getClass operation.</pre>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'>For example, PG_NISServerService:: 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>

<span

style='font-family:"Courier New"'>��

"0" - Unknown<o:p></o:p>

<span

style='font-family:"Courier New"'>��

"1" - Other<o:p></o:p>

<span

style='font-family:"Courier New"'>��

"2" - Not an NIS Server<o:p></o:p>

<span

style='font-family:"Courier New"'>��

"3" - NIS Master<o:p></o:p>

<span

style='font-family:"Courier New"'>��

"4" - NIS Slave<o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><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

-Djavax.net.ssl.trustStore=mytruststore <MyClient><span

style="mso-spacerun: yes">� ) or through

System.setProperty("javax.net.trustStore",

System.setProperty("javax.net.trustStore",

"mytruststore");

Does the cimclient library accept the

How do set �trustManager�

certificate and place it in the trust store?�

property programmatically?<o:p></o:p>

How would the application specify to the cimclient library where the

trust store is<o:p></o:p>

Client library using JSSE will only validate the

<span

server certificate using the trust store. It accepts only trusted certificates

style='mso-tab-count:1'>�� String myTrustManager=

from the server. In case of non-trusted certificate the client library will

"org.mycompany.cimapp.myCertManager";<o:p></o:p>

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

<span

certificate or key was placed in the trust store?<span style="mso-spacerun:

style='mso-tab-count:1'>�� GlobalConfig.setTrustManager(myTrustManager);<o:p></o:p>

yes">� Is this assumed?<o:p></o:p>

Same as above

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>

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

Can the client application set the environment

<h4>Can I change the trust manager property in between my program/process?</h4>

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.

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

Where can I find more information on Trust

No,

Manager and Trust Stores?<o:p></o:p>

you cannot. If you define/set this property in your Client application either

using setTrustManager() 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>

More information can be found at J2SE web

Does the cimclient library

site.� - ----

accept the certificate and place it in the trust store?<span

style="mso-spacerun: yes">� How would the application specify to the

cimclient library where the trust store is<o:p></o:p>

http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html<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.

http://java.sun.com/j2se/1.4/docs/api/javax/net/ssl/X509TrustManager.html

How is the client application

notified that the certificate or key was placed in the trust store?<span

style="mso-spacerun: yes">� 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>

More information

can be found at J2SE web site.� - ----

<span

style='mso-bidi-font-family:"Courier New"'>http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html<o:p></o:p>

http://java.sun.com/j2se/1.4/docs/api/javax/net/ssl/X509TrustManager.html

I am unable use/initialize SSL connection,

I am unable use/initialize SSL

what do I do?<o:p></o:p>

connection, what do I do?<o:p></o:p>

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

"Courier New"'>Some 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>

<pre>You can run PackageVersion program to look at the version.</pre><pre>�� 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.

CIMInstance.getKeyValuePairs()

returns no keys although there are multiple keys in my (exaple

PG_OperatingSystem has 4 keys) provider.<o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'>This bug is fixed in 2.0 Final Release.<span

style="mso-spacerun: yes">� You should not see this bug.<o:p></o:p>

Some

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

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>

<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>

<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>

<span

style='font-family:"Courier New"'>Question 1: How to Create Subscriptions?<span

style='font-family:"Courier New"'><o:p></o:p>

My GUI application doesn�t work properly on HP-UX?

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, CIM_IndicationFilter,

CIM_IndicationHandlerCIMXML and IndicationHandlerSNMPMapper<span

style='font-size:10.0pt;font-family:"Courier New"'> classes.<o:p></o:p>

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>

Listener runs

as server (either SSL or non-SSL) and listens on the specified port.

When Listener startCIMHTTPListener() is called, it will create a thread

and starts listening.

<o:p></o:p>

There is a bug in Java 1.4 HP-UX version (and

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

1.3) AWT libraries. For this you will need to install PHSS_24303 patch. I also

mso-bidi-font-size:12.0pt;font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

found that Patch PHSS_24303 replaced by PHSS_26262. So we will need PHSS_26262.

<span

style='font-family:"Courier New"'>Question 3:<span style='font-family:

"Courier New"'> 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>

<h2>Appendix E:

<span

Example cim.properties configuration file<o:p></o:p></h2>

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'>The modifyInstance operation is not supported

for the<o:p></o:p>

<span

style='font-family:"Courier New"'>CIM_IndicationHandlerCIMXML class or

CIM_IndicationFilter class, and for�

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>

<span

style='font-family:"Courier New"'>deleting the subscription.<o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'>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<span

style="mso-spacerun: yes">� correct namespace, key values, etc.<span

style="mso-spacerun: yes">� It looks like perhaps the instancename

parameter to the modifyInstance operation included only the classname and not

the key values.<o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><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>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'>When you create an enabled Subscription, the

IndicationService will look for indication providers that can serve the

subscription.� 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?� Let me know

if you need help registering your indication provider.<o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><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>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

If you create the

Subscription with SubscriptionState property set to 'Disabled', the

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>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'>Question 6:�

Since the 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>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

The IndicationService

checks that the class specified in the Filter is a subclass of CIM_Indication,

so you must define the indication subclass you'll be using.<span

style="mso-spacerun: yes">� (Instances of the indication subclass don't

get created until the indication provider generates an indication.)<o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

Question 7:<span

style="mso-spacerun: yes">� How a particular listener is associated with

a given subscription and what goes into the Destination property CIM_

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

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>

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>

In

the above case, Listener would be running on mysystem.cup.hp.com at port 8189

with SSL enabled. <o:p></o:p>

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>

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>

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>

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

Yes it does say

- Address is in use.<o:p></o:p>

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

<span

style='font-family:"Courier New"'>Question 10: Create Instance for

CIM_IndicationSubscription fails; However, I can create Handler and Filter

instances.<o:p></o:p>

<span

style='font-family:"Courier New"'>There is a problem with Java Client API while

creating instance with reference values related to indication subscription

class. This is mainly because of 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() 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/SubscribeIndTest.java ) 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'><![if !supportEmptyParas]> <![endif]><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

cim.properties configuration file<o:p></o:p></h2>

<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"'>�� // <o:p></o:p>

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� // <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"'>�� // Example

1.0pt 4.0pt 1.0pt 4.0pt'><span

cim.properties<o:p></o:p>

style="mso-spacerun: yes">�� // Example cim.properties<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"'>�� //<o:p></o:p>

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� //<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"'>�� DEBUG_XML=false <o:p></o:p>

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� DEBUG_XML=false <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"'>�� DEBUG_XMLDECODE=false<o:p></o:p>

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� DEBUG_XMLDECODE=false<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"'>�� clientLogFilePath=cimclient.txt<o:p></o:p>

1.0pt 4.0pt 1.0pt 4.0pt'><span

style="mso-spacerun: yes">�� clientLogFilePath=cimclient.txt<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"'> <o:p></o:p>

1.0pt 4.0pt 1.0pt 4.0pt'> <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"'>�� // CIM Clients may

1.0pt 4.0pt 1.0pt 4.0pt'><span

specify their own Trust Manager to use <o:p></o:p>

style="mso-spacerun: yes">�� // 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;

<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 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"'>�� // instead of the

1.0pt 4.0pt 1.0pt 4.0pt'><span

default JSSE TrustManager.<o:p></o:p>

style="mso-spacerun: yes">�� // instead of the default JSSE

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=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.2

No CVS admin address has been configured