PQ97586: INABILITY TO DETERMINE IF AN INSTALLATION OF A APPLICATION HAS COMPLETED HAS BEEN CORRECTED WITH A WSADMIN FUNCTION | |||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||
![]() APAR status Closed as program error. Error description During the install of an application there was no way to determine if an application has been fully expanded and is ready to be started. This APAR introduces a new wsadmin function that allows this ability: wsadmin> $AdminApp isAppReady appName <boolean: ignoreUnknownState, defalult = true> So you can use $AdminApp isAppReady MyApp The return value of this wsadmin method is a boolean. Here is how value is determined - a) If all nodes return true then the return value is true. b) If any of the nodes returns false then the return value is false. c) If a node returns unknown and if ignoreUnknownState=true (default) then that node is ignored and processing continues with other nodes. d) However if all nodes return unknown then regardless of the ignoreUnknownState flag the return value is false.Local fix Problem summary **************************************************************** * USERS AFFECTED: All users of WebSphere Application Server * * V5.0 for z/OS * **************************************************************** * PROBLEM DESCRIPTION: There is no way to determine when an * * application is fully deployed and ready * * to start. * **************************************************************** * RECOMMENDATION: * **************************************************************** When an application is installed, the actual expansion of the ear file to the installedApps directory of the AppServer is done after the successful return from the install command. There is no mechanism to determine when the application is ready to be started on the AppServer.Problem conclusion Using wsadmin, a new method to the $AdminApp object has been added called isAppReady(). This method will return true only after the application is fully deployed and ready to be started. APAR PQ97586 requires changes to documentation. NOTE: Periodically, we refresh the documentation on our Web site, so the changes might have been made before you read this text. To access the latest on-line documentation, go to the product library page at: www.ibm.com/software/webservers/appserv/zos_os390/library.html The following text has been added to the "AdminApp object for scripted administration" (rxml_adminapp) article in the Version 5.0.2 and later information centers. isAppReady Tests to see if the specified application has been distributed and is ready to be run. Returns a value of true if the application is ready, or a value of false if the application is not ready. This command is not supported when the wsadmin tool is not connected to a server. Parameters: application name, ignoreUnknownState Returns: true or false Example usage: Using Jacl: $AdminApp isAppReady DefaultApplication Using Jython: AdminApp.isAppReady('DefaultApplication') Example output: ADMA5071I: Distribution status check started for application DefaultApplication. WebSphere:cell=Node03Cell,node=myNode,distribution=true ADMA5011I: The cleanup of the temp directory for application DefaultApplication is complete. ADMA5072I: Distribution status check completed for application DefaultApplication. true isAppReady Tests to see if the specified application has been distributed and is ready to be run. Valid values for the ignoreUnknownState parameter include true and false. If you specify a value of true, nodes and servers with an unknown state will not be included in the final ready return. The command returns a value of true if the application is ready or a value of false if the application is not ready. This command is not supported when the wsadmin tool is not connected to a server. The following text has been added to the "Help object for scripted administration" (rxml_helpobject) article in the Version 5.0.2 and later information centers. isAppReady Checks whether the application is ready to be run APAR PQ97586 is associated with SERVICE LEVEL W502026 of WebSphere Application Server V5.0 for z/OS.Temporary fix Comments
APAR is sysrouted FROM one or more of the following: APAR is sysrouted TO one or more of the following: PQ97587 Modules/Macros
Publications Referenced
|
Document Information |
Current web document: swg1PQ97586.html
Product categories: Software > Application Servers >
Distributed Application & Web Servers > WebSphere Application
Server for z/OS
Operating system(s):
Software version: 500
Software edition:
Reference #: PQ97586
IBM Group: Software Group
Modified date: Apr 1, 2005
(C) Copyright IBM Corporation 2000, 2009. All Rights Reserved.