To Access a JMS Resource From an Application Client

1. Create a JMS client.

2. Next, configure a JMS resource on the GlassFish Server.

   For information on configuring JMS resources, see Creating JMS Resources: Destinations and Connection Factories.

3. Define the @Resource or @Resources annotations or the resource-ref elements in the application-client.xml file. Define the corresponding resource-ref elements in the sun-application-client.xml file.

   For more information on the sun-application-client.xml file, see The sun-application-client.xml file in Oracle GlassFish Server 3.0.1 Application Deployment Guide. For a general explanation of how to map JNDI names using reference elements, see Mapping References.

4. Ensure that the client JAR file includes the following files:

   • A Java class to access the resource.

   • application-client.xml - (optional) Java EE application client deployment descriptor.

   • sun-application-client.xml - (optional) GlassFish Server specific client deployment descriptor. For information on the sun-application-client.xml file, see The sun-application-client.xml file in Oracle GlassFish Server 3.0.1 Application Deployment Guide.

   • The MANIFEST.MF file. This file contains a reference to the main class, which states the complete package prefix and class name of the Java client.

5. Prepare the client machine. This step is not needed for Java Web Start.

   If you are using the appclient script, package the GlassFish Server system files required to launch application clients on remote systems using the package-appclient script, then retrieve the application client itself using the asadmin get-client-stubs command.

   For more information, see Using the package-appclient Script and the Oracle GlassFish Server 3.0.1 Reference Manual.

6. Run the application client.

   See Using Java Web Start or Running an Application Client Using the appclient Script.