PQ97586: INABILITY TO DETERMINE IF AN INSTALLATION OF A APPLICATION HAS COMPLETED HAS BEEN CORRECTED WITH A WSADMIN FUNCTION

 A fix is available

Obtain the fix for this APAR



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 information
APAR number PQ97586
Reported component name WEBSPHERE FOR Z
Reported component ID 5655I3500
Reported release 500
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention NoSpecatt
Submitted date 2004-11-23
Closed date 2005-03-21
Last modified date 2005-04-01

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:
PQ97587

Modules/Macros
BBOUBINF          

Publications Referenced

Fix information
Fixed component name WEBSPHERE FOR Z
Fixed component ID 5655I3500

Applicable component levels
R500 PSY UK01700    UP05/03/24 P F503

  Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.


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