<HTML>
 <HEAD>
<!--
Licensed Materials - Property of IBM

IBM Cognos Products: DOCS

(C) Copyright IBM Corp. 2005, 2008

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.
-->
  <TITLE>IBM Cognos Java DispatcherUI Program Sample</TITLE>
	  <link rel="STYLESHEET" type="text/css" href="../../../webcontent/samples/samplesFonts.css">
 </HEAD>


<BODY>

<p class="headerTitle"><img src="../../../webcontent/samples/sdk/asp/images/go_logo_small.gif">&nbsp;IBM Cognos Sample Programs</p>

<p class="FormLabel">DispatcherUI.java - View and set dispatcher setting.</p>

<p class="formText">The Java DispatcherUI sample program will display dispatcher properties and also set diapatcher settings.</p>
<br>

<!-- * * * * * * * * * -->
<!--                   -->
<!-- Dependent Files   -->
<!--                   -->
<!-- * * * * * * * * * -->
<p class="FormLabel">Dependent Files</p>

<p class="formText">Associated files are contained under the java sample folder.<br>
Additional files required for running are identified in the CLASSPATH definitions in run.bat or run.sh file.</p>

<!-- * * * * * * * * * -->
<!--                   -->
<!-- How To Run        -->
<!--                   -->
<!-- * * * * * * * * * -->
<p class="FormLabel">How To Run The Sample Program</p>

<p class="formText">Double click on the file run.bat for WINDOWS or run.sh for UNIX.<br><br>
A window will be opened containing:<br>
&nbsp;&nbsp;&nbsp;&nbsp;- Dispatcher Options dropdown box<br>
&nbsp;&nbsp;&nbsp;&nbsp;- Dispatcher Search Path dropdown box<br>
&nbsp;&nbsp;&nbsp;&nbsp;- Run Option command button<br>
&nbsp;&nbsp;&nbsp;&nbsp;- URL text box<br>
&nbsp;&nbsp;&nbsp;&nbsp;- Output Pane<br>

<br>
Select a Samples Option and click on the 'Run Option' button to run the sample program.</p>


<!-- * * * * * * * * * -->
<!--                   -->
<!-- Expected Results  -->
<!--                   -->
<!-- * * * * * * * * * -->
<p class="FormLabel">Expected Results</p>

<p class="formText">The 'Ping Dispatcher' option will display the dispatcher version.<br>
The 'Dispatcher Properties' option will display several dispatcher properties.<br>
The 'Start Service' option will start a Service identified in the service name combo box<br>
The 'Stop Service' option will stop a Service identified in the service name combo box<br>
The 'Set Logging Level' option will set a Service logging level to the value that is identified in the logging level combo box.<br>
The 'Set Maximum Processes' option will set a Service maximum number of processes to the value that is identified in the maximum processes value combo box.</p>

<!-- * * * * * * * * * -->
<!--                   -->
<!-- Documentation     -->
<!--                   -->
<!-- * * * * * * * * * -->
<p class="FormLabel">Documentation</p>

<p class="formText">The IBM Cognos Software Development Kit Developer Guide contains additional information about the samples.  See the chapter titled 'Methods' and the appendix titled 'Code Samples and Language-Specific Coding Practices'.</p>

<p class="formText">Please note that the samples are not intended to be treated as end-user applications. Refer to the sample code for examples of how to use the API when developing your own applications.</p>

</BODY>
</HTML>