Running the sample on a web server

You can load and run the sample Server Access Interface code samples. This section shows you how.

  1. Install Server Access Development software and go to DevelopmentKits\sadk\ServerAccessInterfaces\AccessSample to locate the following:
  2. Load the SampleRepos.in with the repos_copy utility. For help with loading files into the repository, see the System Administration Guide.
  3. Compile the servlet file ATPServlet.java.
  4. Deploy the compiled servlet into your web server. Set the initialization parameter values appropriately for your configuration. Refer to your web server documentation for details about deployment and initialization of servlets.
  5. If you have a Solaris or HP-UX operating system, add the ibmorb.jar, located in <ProductDirectory>jre\lib\ext (IBM Java ORB class files) to the classpath of the client and the web server. Restart the web server if needed. For details, consult your web server documentation.
  6. Make Example2.html available to your web server.
  7. Copy the AccessSample\collaborations directory to ProductDir\collaborations.
  8. Copy the AccessSample\DLMs directory to ProductDir\DLMs.
  9. Compile HtmlDataHandler.java.
  10. Create a .jar file and save it as HtmlDataHandler.jar, maintaining the output directory structure.
  11. Copy the HtmlDataHandler.jar file to ProductDir\lib.
  12. Modify the start_server batch file, adding ProductDir\lib\HtmlDataHandler.jar to the class path.
  13. Restart InterChange Server.
  14. Make the Interoperable Object Reference (.ior) file available to your web server.

    For more information, see "Setting up the run-time environment".

  15. Launch a browser, and open the example2.html page (see Figure 10).
  16. Start the test connector, and open and add the "SampleSapConnector" profile. Press the Connect button to bring the connector up.
  17. Enter data in at least one row of fields (see Sample HTML data handler for more on the sample HTML page) and perform a sample Retrieve operation.

The following sections describe the data handler and servlet used in this example:

Copyright IBM Corp. 1997, 2004