Java_PermissionsGUI_Explain.html 3.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. <HTML>
  2. <HEAD>
  3. <!--
  4. Licensed Materials - Property of IBM
  5. IBM Cognos Products: DOCS
  6. (C) Copyright IBM Corp. 2005, 2008
  7. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
  8. IBM Corp.
  9. -->
  10. <TITLE>IBM Cognos Java PermissionsGUI Program Sample</TITLE>
  11. <link rel="STYLESHEET" type="text/css" href="../../../webcontent/samples/samplesFonts.css">
  12. </HEAD>
  13. <BODY>
  14. <p class="headerTitle"><img src="../../../webcontent/samples/sdk/asp/images/go_logo_small.gif">&nbsp;IBM Cognos Sample Programs</p>
  15. <p class="FormLabel">PermissionsGUI.java - Modifies permissions.</p>
  16. <p class="formText">The Java PermissionsGUI sample program modifies permissions.</p>
  17. <br>
  18. <!-- * * * * * * * * * -->
  19. <!-- -->
  20. <!-- Dependent Files -->
  21. <!-- -->
  22. <!-- * * * * * * * * * -->
  23. <p class="FormLabel">Dependent Files</p>
  24. <p class="formText">Associated files are contained under the java sample folder.<br>
  25. Additional files required for running are identified in the CLASSPATH definitions in the file run.bat.</p>
  26. <!-- * * * * * * * * * -->
  27. <!-- -->
  28. <!-- How To Run -->
  29. <!-- -->
  30. <!-- * * * * * * * * * -->
  31. <p class="FormLabel">How To Run The Sample Program</p>
  32. <p class="FormLabel">Initial Setup:</p>
  33. <p class="formText">
  34. Depending on your configuration, you may need to perform the following setup before the sample will execute properly.<br>
  35. 1. Log on to IBM Cognos Connection as the user you will use to run the sample.<br>
  36. 2. Click the <b>My Folders</b> tab.<br>
  37. 3. Click <b>Set Properties</b> for My Folders.<br>
  38. 4. Click the <b>Permissions</b> tab.<br>
  39. 5. Select the <b>Override the access permissions acquired from the parent entry</b> checkbox.<br>
  40. 6. In the Grant and Deny pane on the right side of the page, select the <b>Read</b> checkbox under the Grant column, and click <b>Apply</b>.<br>
  41. &nbsp;&nbsp;&nbsp;&nbsp;The user is now granted Read permission.
  42. </p>
  43. <hr align=left width=25%>
  44. <p class="formText">Double click on the file run.bat.<br><br>
  45. A window will be opened containing:<br>
  46. &nbsp;&nbsp;&nbsp;&nbsp;- Set Permissions command button<br>
  47. &nbsp;&nbsp;&nbsp;&nbsp;- URL text box<br>
  48. &nbsp;&nbsp;&nbsp;&nbsp;- Results Display Pane<br>
  49. Click on the 'Set Permissions' button to run the sample program.</p>
  50. <!-- * * * * * * * * * -->
  51. <!-- -->
  52. <!-- Expected Results -->
  53. <!-- -->
  54. <!-- * * * * * * * * * -->
  55. <p class="FormLabel">Expected Results</p>
  56. <p class="formText">By default, read permission will be denied to the current user's <b>My Folders</b> folder. A confirmation message will be displayed in the Results Display Window.</p>
  57. <p class="formText">If you run samples that affect security settings, you may wish to use a test account. If you use a real account, you may need to ask your administrator to restore permissions or capabilities that you remove. If there is only one administrator account, do not run these samples as that user.</p>
  58. <!-- * * * * * * * * * -->
  59. <!-- -->
  60. <!-- Documentation -->
  61. <!-- -->
  62. <!-- * * * * * * * * * -->
  63. <p class="FormLabel">Documentation</p>
  64. <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>
  65. <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>
  66. </BODY>
  67. </HTML>