The second step in creating a Web service from a DADX file is to
create a DADX group and configuration. The DADX group contains connection
(JDBC and JNDI) and other information that is shared between DADX files within
the group.
Prerequisites:
- Before creating a DADX group you need to create and configure a Web project
as described in: Create a Web
project.
To create the DADX group and configuration:
- In the Project Explorer view, select the Web project in which you
want to create the DADX group.
- Click File > New > Other > Web Services in order
to display the various Web service wizards.
- Select the Web Services DADX Group Configuration wizard.
Click Next
- Select your Web project. Click Add group. Enter a name
for your DADX group. If you have not selected a DB2 Web service provider version
for the Web project as outlined in the Create
a Web project task you will be prompted to enter a version now. Click
Group properties.
- Use this panel to enter the configuration information for your
DADX group. You must enter the DB URL and the database user ID and password. Enter any additionally required parameters:
- Context Factory
- When using a datasource to connect to the database this value specifies
the context factory class that should be used. The suggested value when running
on a WebSphere server
is com.ibm.websphere.naming.WsnInitialContextFactory.
- Datasource
- When using a datasource to connect to the database this value specifies
the datasource name to be used.
- DB driver
- When using JDBC to connect to the database this value specifies the database
driver class to be used. Note that the default JDBC driver is com.ibm.db2.jcc.DB2Driver for
both versions of the DADX Web Service Provider. The COM.ibm.db2.jdbc.app.DB2DriverJDBC driver
will be shipped in DB2 v9.1 but will no longer be the default JDBC driver.
- dbURL
- When using JDBC to connect to the database this value specifies the database
URL of the database.
- If you are using the IBM® DB2® Legacy JDBC Driver Type 2 connection, your dbURL
in the group.properties file is jdbc:db2:<databaseName>,
for example jdbc:db2:sample
- If you are using the IBM DB2 Universal JDBC with type 2 connection, your dbURL
in the group.properties file is jdbc:db2://<server>/<databaseName>,
for example jdbc:db2://localhost/sample
- If you are using the IBM DB2 Universal JDBC driver with type 4 connection, the
DB URL is jdbc:db2://<server>:<port>/<databaseName>,
for example jdbc:db2://localhost:50000/sample
- Userid and Password
- These fields are used to specify the authentication information when connecting
via a JDBC connection.
- Namespace table
- The field specifies the namespace table file name that the DADX runtime
should use. This file defines mapping between DTD identifiers and their associated
XSD namespace and location. Note: entries in this file only need to be made
if the DADX file references a DAD file.
- Autoreload
- This field specifies whether the DADX runtime should reload resources,
such as a DADX file, that have changed on the server. Enter true or false.
- Reload interval
- This value specifies in seconds how often the DADX runtime should check
for changed resources. Note: this is only used if autoreload is set to true.
- Group namespace URI
- This field specifies the namespace URI prefix that is put at the beginning
of all namespaces associated with DADX files in this DADX group. If this field
is left blank the default prefix is http://tempuri.org.
- Enable XML CLOB
- This field specifies with the DB2 XML Extender CLOB feature should be
used or not. This value should be true when using DB2 XML Extender 7.2 and later. It should
be false for older versions.
- Use document Style
- This field indicates whether the DADX runtime should use document style
or RPC style. A value of true indicates that document style should be used.
The default value of false indicates that RPC style is used. Only document
style is WS-I compliant.
Click OK.
- Click Finish. The DADX group has now been
created. The following artifacts are created:
- a new directory for the group under the group directory
- a group.properties file in the group directory
- a namespacetable.nst file in the group directory
Once you have created the DADX group, create a DADX file as described
in:
Create a DADX file.