Enabling an EAR file for Web services

This task explains how to enable the enterprise archive (EAR) file that you have assembled with artifacts that are necessary to build a Web service. The EAR file is an application that is enabled for Web services.

Before you begin

You need to assemble the Java archive (JAR) file before you can assemble these files into the EAR file, because the enterprise JAR file is an artifact that is required to build the EAR file.

About this task

You can add router modules to your application that is enabled for Web services with either the endptEnabler command-line tool or with assembly tools provided with WebSphere Application Server. The tool that you choose to use for this task depends on your preference to work with a command-line tool or a graphical user interface. To learn how to use an assembly tool to accomplish this task see the Assembly Toolkit documentation.

These tools add one or more router modules to the EAR file for each Web service-enabled Enterprise JavaBeans (EJB) module contained in the EAR file. A router module provides an endpoint for the Web service in a particular EJB module.

You should not modify the contents of the EJB module or the Web module that was generated using the endptEnabler command-line tool. If you do, an error occurs during run time. The following is an example of the error that displays:
"Error]- WSWS3142E: Error: Could not find Web services engine.]: javax.servlet.ServletException: WSWS3142E: Error: Could not find Web services engine."

Each router module supports a specific transport such as HTTP or Java Message Service (JMS). If no enterprise bean JAR modules are located in the EAR file, it is not necessary to use these tools.

Procedure

Enable an EAR file with the endptEnabler command-line tool. In its interactive mode, the endptEnabler command guides you through the required steps to enable one or more services within an application.

What to do next

Deploy the EAR file into WebSphere Application Server. An assembled EAR file that is enabled for Web services is required for deployment.



In this information ...


Related concepts
Related reference

IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Sep 20, 2010 10:03:57 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-zos&topic=twbs_endptenabler
File name: twbs_endptenabler.html