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 is sysrouted FROM one or more of the following: APAR is sysrouted TO one or more of the following: Modules/Macros
|
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
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.