HelloUser PSP Sample
--------------------------------

Overview of HelloUser PSP Sample
--------------------------------------
  This Sample describes how to create a simple HelloUser application using PSPs.
The PSP application provides an interface to greet the user displaying:
"Hello <entered username>!"

  The input is submitted through a text field with a prompt 'Enter username'.
A button 'Submit' should be pressed to see the greetings.

  The greetings is displayed with BLACK background and RED font along with a
border on all four sides at TOP LEFT of the page.

Steps in the Sample :
---------------------

  1) Invoke the application by opening the HelloUser page. This will display
      the interface see the greetings to the user.

 2) Enter the username in text field provided in the page. Next, press the
     Submit button. On successful submission the application will display the
     greetings as Hello <entered username>!

Description of Sample Files :
-----------------------------
  The sample is provided as a zip file. This zip file contains all the files
required for the sample. It contains the following files:

        1) Install.html                     -  The steps to install the HelloUser PSP in the Oracle Database
        2) Readme.html                  -  This file
        3) HelloUser.psp               -   Displays the text field to accept a user name and greets the user
                                                       with a message like 'Hello User!'

The steps in running the sample in iAS environment is explained below :

Running the sample using Oracle iAS:
--------------------------------------

     Step 1. Install the PSP onto the Oracle database using the instructions
                 in the Install.html

     Step 2. On the Application Server machine where iAS is installed, create
                 a Database Access Descriptor(DAD) to connect to the schema where
                 the PSP is installed in Step 1.

     Note: For details on creating DADs, refer to the document "Using mod_plsql"
              on the Documentation Library CD-ROM of iAS software.

     Step 3. After creating the DAD, access the page by using a URL like:

     http://<ipaddress>:<Port>/<virtual_path>/<dadname>/<PL/SQL procedure name>
     where,
       <ipaddress>    -> is the ip-address of the machine on which iAS is setup
       <Port>            -> is the port on which iAS http listener is setup to run
                      (refer to file $IAS_HOME/Apache/Apache/conf/httpds.conf)
       <virtual_path> -> is the prefix defined for the PL/SQL module
                      (refer to file $IAS_HOME/Apache/modplsql/cfg/plsql.conf)
       <dadname>     -> is the name of the DAD created in Step 2.
           Example:-
                http://152.69.168.209:7890/pls/sample/hellouser