PQ73188: DOC APAR TO DESCRIBE SYNTAX AND BEHAVIOR OF XML CONFIGURATION DEFINITION FOR CUSTOM SERVICES FOR WEBSPHERE FOR Z/OS V4.01

APAR status
Closed as documentation error.

Error description
WebSphere V4.0.1 Custom Services documentation tells the
customer to use the V4.0 AE InfoCenter Custom Services
documentation. However, the WebSphere V4.0 AE user
can use the GUI to pass property values to the initialize()
method, but currently there is no documentation for
WebSphere V4.0.1 z/OS customers.
We need documentation of the full xml configuration definition
for custom services on WebSphere for z/OS.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: Custom Services documentation tells the *
*                      customer to use the V4.0 AE InfoCenter  *
*                      Custom Services documentation. However, *
*                      the WebSphere V4.0 AE user can use the  *
*                      GUI to pass property values to the      *
*                      initialize() method, but currently      *
*                      there is no documentation for WebSphere *
*                      V4.0.1 z/OS and OS/390 customers.       *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The WebSphere Application Server V4.0.1 for z/OS and OS/390
Custom Services documentation tells the customer to use the
V4.0 AE InfoCenter Custom Services documentation. However,
that documentation tells the user to use the GUI is not
available to WebSphere Application Server V4.0.1 for z/OS
and OS/390 customers.
Problem conclusion
APAR PQ73188 requires changes to documentation.

The following note will be added to the section "Deploying an
Enterprise application as a SOAP-accessible Web Service" in
Chapter 15 of "WebSphere Application Server V4.0.1 for z/OS and
OS/390: Assembling J2EE Applications," SA22-7836:

Note:  WebSphere Application Server for z/OS does not support
the dynamic-properties elements in the XML file that defines a
custom service. These elements are supported by WebSphere
Application Server for distributed platforms. Therefore, if you
are porting a Web service from the distributed platform version
of the product to the z/OS version you may need to make the
following code change to use the externalConfigURL tag to pass
initialization parameters to your Web service:

1. Create a separate XML file that contains the
   dynamic-properties elements.
2. Specify the fully qualified name of this file for the
   externalConfigURL object when you import the Web service
   application into an Application Server configuration. The
   resulting XML file for the Web Service will be similar to
   the following:

   <applicationserver
        version="2.0"
        xmi=""
        applicationserver="applicationserver.xmi"
        server="server.xmi"
        id="">
      <nodes
          id="">
        <servers
     type="ApplicationServer">
          <customServices
     description="Service1-str2tst"
     displayName="str2tst"
              classname="str2tst"
         externalConfigURL="fully_qualified_file_name"
         enable="true"
     />
       </servers>
       </nodes>
   </applicationserver>

3. Change the custom service initialization routine to read
   from this new file.

This code change causes the property
"com.ibm.websphere.runtime.CustomService.externalConfigURLKey"
to set the value of the "externalConfigURL" tag in the Custom
Service implementation. This property, which is set to one of
the following values, is then passed to the CustomService
initialize method:

 1. null, if nothing is specified in the externalConfigURL tag
    in the custom service XML file.
 2. The property
"com.ibm.websphere.runtime.CustomService.externalConfigURLKey ="
    which is set to the value of the "externalConfigURL" tag in
    the Custom Service implementation.

In either case, this information should show up during tracing
if orb tracing is turned on.

 This changed Web service can be used on all WebSphere
 Application Server platforms.

NOTE: Periodically, we refresh the documentation on our Web site
so the changes might have been made before youread this text. To
access the latest on-line documentation, go to the product
library page at URL:

//www.ibm.com/software/webservers/appserv/zos_os390/library/
Temporary fix Comments
APAR information
APAR number PQ73188
Reported component name WEBSPHERE OS/39
Reported component ID 5655A9800
Reported release 401
Status CLOSED DOC
PE NoPE
HIPER NoHIPER
Submitted date 2003-04-14
Closed date 2003-07-22
Last modified date 2003-10-02

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 401
Software edition:
Reference #: PQ73188
IBM Group: Software Group
Modified date: Oct 2, 2003