Importing a JAX-RPC Handler Archive

Figure 1 Message Handler Archive Icon

To begin, you need to have a JAX-RPC handler archive available on your system.

To Import an Existing Message Handler Archive

1. On the NetBeans IDE, click the Services tab.
2. Expand CAPS Environments.
3. Right-click the Environment to which you are importing, point to Import, and then select Message Handler Archive.

   The Import Message Handler Archive Wizard appears.

4. Do one of the following:
   • To import the archive provided with Java CAPS, select Import Pre-installed Archive From Repository.
   • To import a custom archive, select Import Custom Archive From Local Directory.
5. Click Next.
6. Select the archive file you want to import, and click Next.
7. If the selected archive file imports correctly, the Summary page appears. Review the information provided, and then click Finish.

   The message handler archive now appears in the Services window as a child node of the Environment, and the message handler itself appears as a child node of the archive, as shown in the following figure.

   
   

   Figure 2 Message Handler Nodes

   

   To display the Message Handler Properties window, right-click the message handler in the Environment and select Properties.

   
   

   Figure 3 Example Message Handler Properties Dialog

   
8. If the archive file did not import properly, you will see an error message on the Import Message Handler Archive wizard Summary page. You will then need to determine the reason for the failure to import.