The task of creating an EGL Web service is separate from the task of writing EGL programs. When you create the Web service Java bean, you can reference any EGL program. The script in the EGL program may be incomplete, but the program parameters must be fully specified.
The EGL Web Service Wizard guides you through the steps needed to create and use a Web service:
The name of the Web service becomes the name of the Web service Java bean. Also, the name of each operation become the name of a method in the Java bean.
The following restrictions apply:
The EGL Web service wizard lets you produce a Web service definition file, but does not require that you do so. (You can create this kind of file outside of the wizard, too, either by hand or as described in Creating an EGL Web service definition file. In particular, if you want to associate multiple operations with a single EGL program, you must create the file outside of the wizard.)
When you invoke the EGL Web Service Wizard, you can use an existing Web service definition file as input and so can avoid re-stating the following information, which is provided in the file:
The following Web service definition file associates each of three operations with the appropriate EGL program:
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE EGLWebServiceDefinition PUBLIC "-//IBM//DTD EGLWSD 5.0//EN" ""> <EGLWebServiceDefinition name="TimeAndDate" package="com.ibm.timedate.service"> <operation name="GetDate" programName="GetDate" programPath="/TimeDateWeb/EGL Source/GetDate.egl"/> <parameter name="DateRecord" input="NO" output="YES" /> </operation> <operation name="GetTime" programName="GetTime" programPath="/TimeDateWeb/EGL Source/GetTime.egl"/> parameter name="Time" input="NO" output="YES"/> </operation> <operation name="GetTimeAndDate" programName="GetTimeAndDate" programPath="/TimeDateWeb/EGL Source/GetTimeAndDate.egl"/> <parameter name="Time" input="NO" output="YES"/> <parameter name="DateRecord" input="NO" output="YES" /> </operation> <EGLWebServiceDefinition>
The name of the Web service definition file is the name of the Web service followed by the extension .eglwsd.
The EGL Web Service Wizard allows you to select either of two ways to generate Java wrappers and (if appropriate) BeanInfo classes. (The BeanInfo classes are necessary only if the EGL-generated program receives data as an EGL record or structure.)
Your choices are as follows:
The following rules apply for each build descriptor you specify (if any):
You can use the EGL Web service wizard to create any of three Web service clients for use in testing the Web service:
You must use the Universal Test Client if a parameter in any of the EGL programs includes either of these:
Related concepts
Java wrapper
Linkage options part
Application testing and publishing
Tools for Web services development
Web services overview
Related tasks
Adding a build descriptor part
Adding a linkage options part
Creating an EGL Web service definition file
Creating an EGL Web service
Editing an EGL Web service definition file
Related reference
enableJavaWrapperGen
Java wrapper classes
linkage
Naming conventions
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.