PK97877: STARTING AND STOPPING AN APPLICATION ON A Z/OS MAY RESULT IN AN INCONSISTENT APPLICATION STATE BETWEEN THE SERVANTS & ADJUNCT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Starting and Stopping an application on a z/OS may result in an
  inconsistent application state between the Servants & Adjunct
  regions.
  The application state can only be made consistent after a server
  restart.
  .
  Set Custom Properties
  "com.ibm.ws390.management.proxy.ApplicationMgrMBeanProxy.zos.pre
  FilterCheck" to "true".
  .
  There are two way in doing so:
  o   At the CELL level
  o   At the AppServer level
  .
  At the AppServer Level
  ======================
  #  From the AdminConsole.  Select the AppServer and under
     "Server Infreastructure" select "Process Defination"
  
  #  Then select the "Control" and "Custom Properties "
  
  #  Then "NEW"  and "ADD"
  
  
    com.ibm.ws390.management.proxy.ApplicationMgrMBeanProxy.zos.
  preFilterCheck with a value of true
  
  
  
  #   Save your change by selecting "Apply"
  .
  Application servers > server1 > Process Definition > Control >
  Custom Properties >
  com.ibm.ws390.management.proxy.ApplicationMgrMBeanProxy.zos.preF
  ilterCheck
  ..
  At the Cell Level
  =================
  
  #  From the Environment tab select WebSphere Variables
  
  #  create a new variable IBM_JAVA_OPTIONS and set the value of
     this variable to
  -Dcom.ibm.ws390.management.proxy.ApplicationMgrMBeanProxy.zos.pr
  eFilterCheck=true
  
  #  Then save you change
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere Application Server    *
  *                 V7.0                                         *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The ApplicationMgr did not provide a    *
  *                      facility for maintaining a consistent   *
  *                      application stop state between          *
  *                      regions on z/OS.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Runtime components can control whether applications should
  start or stop by installing a DeployedApplicationFilter with
  the ApplicationMgr. On z/OS, each region has it's own set of
  runtime components and installed DeployedApplicationFilters.
  When an application is stopped on all regions, it is possible
  for some regions to agree to the application stop while others
  don't. This results in an inconsistent application state
  across the regions.
  

Problem conclusion

• A flag has been introduced to enable a new behavior that will
  attempt to maintain a consistent application state among the
  regions on z/OS. A servant region will first be asked whether
  the application can stop, before an application stop is issued
  to all the regions.
  
  APAR PK97877 is currently targeted for inclusion in Service
  Level (Fix Pack) 7.0.0.7 of WebSphere Application Server V7.0.
  
  Please refer to URL:
  //www.ibm.com/support/docview.wss?rs=404&uid=swg27006970
  for Fix Pack availability.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PK81647

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

Modules/Macros

• BBGUBINF BBOUBINF
  

Fix information

• Fixed component name

  WEBSPHERE FOR Z

• Fixed component ID

  5655I3500

Applicable component levels

• R700 PSY UK51554

     UP09/11/10 P F911

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.