                    QuoteStockPriceService Java Weblet

       Copyright (C) 1997, webMethods, Inc. All Rights Reserved.

_____________________________________________________________________

   TABLE OF CONTENTS
   -----------------
   1. Introduction
   2. Requirements
   3. Files
   4. Development
   5. Deployment Scenarios
    5.1 Running the Weblet class
    5.2 Running the applet
        5.2.1 Standalone application
        5.2.2 Appletviewer
        5.2.3 Browser
   6. Further Information


   1. INTRODUCTION

   The webMethods Web Automation Toolkit(TM) generates Java Weblets which may
   be deployed as either standalone service classes or as applets. A Weblet
   is generated specifically for the QuoteStockPriceService service defined
   in Quote.widl.


   2. REQUIREMENTS

   The Java Weblet produced by the Toolkit can be compiled and run using any
   currently available JDK, such as the ones from JavaSoft (JDK 1.02, 1.1.x),
   Symantec (Cafe), or Microsoft (J++).

   In addition, an instance of the webMethods Automation Server must be
   running on the network.

   3. FILES

   The Toolkit produces the following files for each Java Weblet:

       QuoteStockPriceService.java
            The main service class.
       QuoteStockPriceServiceApplet.java
            The applet with a rudimentary user interface which uses
            the classes in QuoteStockPriceService.java to retrieve web
            data and services.
       QuoteStockPriceService.html
            The applet html page.


   4. DEVELOPMENT

   The Java code produced by the Toolkit demonstrates the most common uses of
   the webMethods core API and should serve as a good starting point for your
   own development.

   It is recommended that you do not modify the code in
   QuoteStockPriceService.java but rather subclass it. Note that if you
   change any of the service, interface, or field names defined in
   QuoteStockPriceService.widl a new service class will have to be
   generated.

   5. DEPLOYMENT SCENARIOS

   5.1 Running the standalone service class

   Make sure you have installed a fully functional JDK and have the webMethods
   Automation Server running. Then, compile the generated Java classes:

        > javac StockPriceService.java

   You may then invoke the service class by typing

        > java StockPriceService <Correct number and order of input arguments>

   The Weblet will attempt to connect to a webMethods Automation Server running
   on port 5555 by default. You may specify an alternate server on the
   commandline:

        > java -server YourServer:7777 \
               StockPriceService <Correct number and order of input arguments>

   The results of the service are displayed on standard output.

   5.2 Running the applet

   You'll be able to run StockPriceServiceApplet as either a standalone application
   or as an applet within the appletviewer or a web browser. It features a
   rudimentary graphical user interface which allows interaction with
   the StockPriceService web service.

   Make sure you have installed a fully functional JDK and have the webMethods
   Automation Server running. Then, compile the generated Java classes:

        > javac *.java

   5.2.1 Standalone application

   You may run the "applet" as a standalone application by typing

        > java StockPriceServiceApplet

   The applet will attempt to connect to a webMethods Automation Server running
   on port 5555 by default. You may specify an alternate server on the
   commandline:

        > java -server YourServer:7777 \
               StockPriceService <Correct number and order of input arguments>

   5.2.2 Appletviewer

   You may run the service applet with the appletviewer by typing

        > appletviewer StockPriceService.html

   Be sure the "SERVER" applet parameter in StockPriceService.html corresponds to
   a running webMethods Automation Server, such as

	    <PARAM name=SERVER value="wmServerHost:5555">

   5.2.3 Browser

   Web browsers restrict applets from accessing web sites other than the one
   it was downloaded from. In order to run the applet from within a web browser
   it is therefore necessary to have a webMethods Automation Server installed
   and running on the web server the applet originated from. Note that the
   webMethods Automation Toolkit starts a single server on port 5555.

   Once the webmethods Automation Server is installed, edit StockPriceService.html
   and specify the server host and port. Note that the hostname specified must
   be identical to your web server.

	    <PARAM name=SERVER value="www.yourWebserver.com:5555">

   Continue by placing all files associated with the Java Weblet into a
   directory located within the document root of your web server.

   Place the wattrun.zip file (located in the <Toolkit Home>/lib directory)
   into the same directory as the applet. Specify the "ARCHIVE" applet
   parameter, such as

        <APPLET CODE=StockPriceServiceApplet.class ... ARCHIVE="wattrun.zip">

   You may place the wattrun.zip anywhere in your document root as long
   as you specify the "CODEBASE" applet parameter.

   For some browsers you may have to specify the "CODEBASE" applet parameter
   for the applet to locate the StockPriceService.widl file.


   6. FURTHER INFORMATION

   For more details on the webMethods core API please refer to the webMethods
   Technical Reference Manual contained in the Documentation Section of the
   User Guide.

_____________________________________________________________________
	Web Automation Toolkit and Web Automation Platform are
	trademarks and webMethods is a registered trademark of
	webMethods, Inc. All other marks are the property of
	their respective owners.
