InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.42: Administering J2C related administrative resources (overview)

6.6.42: Administering J2C related administrative resources (overview)

To deploy and assemble your application, you use a combination of the:

In general, the flow looks like this:

  1. Convert the EJB 1.0 jar file (.ser) to EJB 1.1 jar (.xml) and generate the deployment code.
  2. Assemble the EJB JAR file and application client JAR file into a J2C application (.ear).
  3. Define the J2C Resource Adapters and Connection Factories.
  4. Install the application and resolve any References.
  5. Run the application.

Convert the EJB JAR file and generate the deployment code

During this step, you will convert the EJB 1.0 JAR file (.ser) to an EJB 1.1 JAR file (.xml), and generate the deployment code.

  1. Open a system command prompt.
  2. Change directory to the product_installation_root/bin directory.
  3. Execute the command:
    ejbdeploy YourFilename.jar tmp YourFilenameDep.jar
    
    where YourFilename.jar is the fully-qualified EJB 1.0 JAR file to be converted, tmp is a directory for temporary files, and YourFilenameDep.jar is the fully-qualified name of the new file for the converted EJB 1.1 JAR.

Assemble the EJB JAR file and application client JAR file into a J2EE application

  1. Open the Application Assembly Tool.
  2. Using the the AAT instructions, create an application:

    1. Under File -> New -> Application, provide properties and change the Display name: to (for example) YourApp.ear.
    2. Import the EJB 1.1 jar (the deployed .jar file you created in the previous step (Convert the EJB JAR file and generate the deployment code).
  3. Use File -> SaveAs to save the .ear (enterprise application archive) file in the sought location.
  4. Exit the Application Assembly Tool.

Define the J2C Resource Adapters and Connection Factories

Use the administrative console to define the J2C Resource Adapters and Connection Factories.

To define the J2C Resource Adapter, complete the following steps:

  1. Open the administrative console.
  2. Expand the tree view to Resources -> J2C Resource Adapters.
  3. Right click the J2C Resource Adapter folder and click New....
  4. Enter the resource adapter properties.

    Use the Browse [...] button located next to the Archive file name on the properties dialog to browse for the .rar file that you downloaded from the Web site in Installing the J2C (Beta) Resource Adapters, such as cicseci.rar.

  5. Click OK. If you look on the Node tab you should now see your Resource Adapter installed and configured on your node.

  Notes:

  • After finding and loading the .rar file, the Connections and Advanced tabs should contain the read-only contents of the ra.xml descriptor within the .rar file. These values will be propagated to the Connection Factory when you create it.
  • By default, the Resource Adapter is created on the current node. Another tabbed page in J2C Resource Adapter properties enables you to create the Resource Adapter on additional nodes.

To define the Connection Factory, complete the following steps:

  1. Open the administrative console.
  2. Expand the tree view to Resources -> J2C Resource Adapters -> adapter_name -> J2C Connection Factories.
  3. Right click the J2C Connection Factories folder and click New....
  4. Enter the resource adapter properties.
    • Enter a name such as cicsDeptA.
    • Modify the values on the Connections and Advanced tabbed pages as required by your installation.

      See the Resource Adapter documentation in the HowTo.html or similar file in the RAR archive for specific instructions.)

  5. Click OK. You should now see your Connection Factory created and associated with your Resource Adapter.

For another way to define J2C Resource Adapters and Connection Factories, see Specifying a J2C connection factory.

Install the application and resolve any References

Here, the procedure is outlined for installing the application, with links to detailed instructions for each step. Depending on the complexity of the .ear file that you are installing, you might need to specify values for fields that are not discussed here. See the enterprise application properties.

  1. Open the administrative console.
  2. Create a new application server if you do not have one already.
  3. Install the enterprise application (.ear file).

    Notes:

    • When you get to the Mapping Resource References to Resources panel, the resource-ref entries as defined by your bean should be listed on the left side. For each resource-ref, click Select Resource and select the defined (J2C Connection Factory) resource that you previously configured.

    • On the Deploy window, click No when asked whether the application should be redeployed.

Run the application

To run the application, you start and use a configured application server just as you would for any other IBM WebSphere enterprise application. For more information, see the administrative overview of application servers.

Go to previous article: Establishing multiple administrative domains on a machine Go to next article: Properties of J2C Resource Adapters

 

 
Go to previous article: Establishing multiple administrative domains on a machine Go to next article: Properties of J2C Resource Adapters