Attachmate Verastream® Host Integrator
J2EE Connector Examples Readme

Overview

We have provided example applications to illustrate how to design, package and deploy J2EE applications using the Attachmate Verastream Host Integrator J2EE Connector (resource adapter or RA).

Notes

  1. All hyperlinks on this page refer to localhost on the default ports for the respective appservers.
  2. Application server administration consoles may change without notice. The instructions are typical for the admin consoles in effect at the time of this writing. Your results may vary.
  3. Most problems with deployment and operation can be traced to invalid configuration. Double-check JNDI names, capitalization, security settings, etc.

Example Contents

The examples/j2ee/jca directory contains the following:

Deployment

This section explains how to deploy the Attachmate Verastream Host Integrator J2EE Connector Examples to the supported application servers and run them.

Sun JSAS 8.x & 9.x

  1. Log in to JSAS Administration Console.
  2. In "Enterprise Applications", click "Deploy..."
  3. In "Deploy Enterprise Application", enter the path to jca-examples.ear and click "Next".
  4. Check the Verifier check box and click "Next" again.
  5. If the application deployment was successful, proceed to configuration instructions, now running on your appserver.

WebSphere 6.x

  1. Log in to WebSphere Administrative Console.
  2. In "Applications/Enterprise Applications", click "Install"
  3. Specify the path to jca-examples.ear and click "Next".
  4. Accept the defaults and click "Next".
  5. On "Step 1: Select installation options", accept the defaults and click "Next".
  6. On "Step 2: Map modules to servers", accept the defaults and click "Next".
  7. On "Step 3: Map JCA resource references to resources", accept the defaults and click "Next".
  8. On "Step 4: Map resource references to resourcss", enter "eis/jca/CICSAcctsDemo" and "eis/jca/PurchasesDemo" (respectively for each reference binding) in the JNDI name column. Accept the other defaults and click "Next".
  9. On "Application Resource Warnings" page, click "Continue". We will address the warnings in the configuration phase.
  10. On "Step 5: Map virtual hosts for Web modules", accept the defaults and click "Next".
  11. On "Step 6: Summary", click "Finish".
  12. On the "Installing" page click "Save to Master Configuration".
  13. On "Enterprise Applications > Save" click "Save".
  14. Back on the "Enterprise Applications" page, check "VHI J2EE Connector Examples" and click "Start".
  15. If the application deployment was successful, proceed to configuration instructions, now running on your appserver.

WebLogic 9.x

  1. Log in to BEA WebLogic Administration Console.
  2. Click "Lock & Edit".
  3. Under "Domain Structure", click "Deployments".
  4. Under "Deployments", click "Install".
  5. Browse to jca-examples.ear and click "Next".
  6. Click the "Install this deployment as an application" radio button, then click "Next".
  7. On "Install Application Assistant", name the application "VHI Connector Examples", accept the other defaults and click "Next".
  8. On "Install Application Assistant", review your choices and click "Next".
  9. After the install completes, click "Activate Changes".
  10. Click "Lock & Edit".
  11. Under "Domain Structure", click "Deployments".
  12. Under "Deployments", select "VHI Connector Examples (Prepared)".
  13. Click "Start>Servicing all requests".
  14. On "Start Application Assistant", click "Yes".
  15. If the application deployment was successful, proceed to configuration instructions, now running on your appserver.
Note: You cannot run the applications ejb-examples and jca-examples simultaneously in WebLogic. The error
"A Resource Adapter may only be accessed from within the same application from which it was deployed."
will result. Stop one application before installing or starting the other.

Other Application Servers

Consult the documentation for your application server for specific information describing how to deploy applications. Many servers require some sort of descriptor file along with, or within the EAR file. As with WebLogic, configuration and deployment is often a one-step process, sometimes as simple as copying a file to a "deploy" directory.

You will need to set the following parameters:

CICSAcctsDemo Pool

Pool Settings
Properties

PurchasesDemo Pool

Pool Settings
Properties
If the application deployment is successful, proceed to the examples page now running on your appserver, e.g., http://localhost:port/vhi/jca/examples/index.html, where port is the port on which your appserver publishes web applications.