PH69655: An RSEAPI user log out may result in NullPointerException and the user may not logon again until RSEAPI task is restarted

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• During RSEAPI v1.1.4 user log out, a NullPointerException (NPE)
  is
  observed in catalina and server logs. Here is the
  exception trace:
  05-Jan-2026 09:14:00.000 WARNING [http-nio-6800-exec-83]
  org.glassfish.jersey.server.ServerRuntime$Responder.process An
  exception mapping did not successfully produce and processed a
  response. Logging the exception propagated to the default
  exception mapper.
  java.lang.NullPointerException
  at com.ibm.rse.rest.adapters.AdapterManager.shutdown
  (AdapterMa
  nager.java:218)
  at com.ibm.rse.rest.adapters.dstore.
  RACFAuthenticationService.
  logoutToken(RACFAuthenticationService.java:361)
  at com.ibm.rse.rest.api.jaxrs.AuthRESTService.logout
  (AuthRESTS
  ervice.java:255)
  ....
  Caused by: java.lang.NullPointerException
  at com.ibm.rse.rest.adapters.AdapterManager.shutdown
  (AdapterMa
  nager.java:218)
  at com.ibm.rse.rest.adapters.dstore.
  RACFAuthenticationService.
  logoutToken(RACFAuthenticationService.java:361)
  at com.ibm.rse.rest.api.jaxrs.AuthRESTService.logout
  (AuthRESTS
  ervice.java:255)
  
  After NPE users may not be able to connect to RSEAPI until its
  task is restarted.
  
  ZOS0302T/K
  SEMERU25T/K
  

Local fix

• Restart RSEAPI started task
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 1. All users                                 *
  *                 2. All users                                 *
  *                 3. All users                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. In Explorer for z/OS 3.4.3, when a   *
  *                      user logs in after a host upgrade, a    *
  *                      directory, private_common_properties,   *
  *                      is created under the z/OS Explorer      *
  *                      user's OMVS home directory, even if     *
  *                      the feature is not enabled in rse.env.  *
  *                      2. An RSEAPI user logout may result     *
  *                      in NullPointerException, and the user   *
  *                      may not connect until RSEAPI is         *
  *                      restarted                               *
  *                      3. A SEQ search with text could         *
  *                      return error 500                        *
  ****************************************************************
  1. A directory, private_common_properties, is created under
  the z/OS Explorer user's OMVS home directory, even if the
  feature is not enabled.
  2.  During RSEAPI v1.1.4 user logging out,
  NullPointerExceptions (NPEs) may be observed in catalina and
  server logs.
  org.glassfish.jersey.server.ServerRuntime$Responder.process An
  exception mapping did not successfully produce and processed a
  response. Logging the exception propagated to the default
  exception mapper.
  java.lang.NullPointerException
  at com.ibm.rse.rest.adapters.AdapterManager.shutdown
  (AdapterManager.java:218)
  at com.ibm.rse.rest.adapters.dstore.RACFAuthenticationService.
  logoutToken(RACFAuthenticationService.java:361)
  at com.ibm.rse.rest.api.jaxrs.AuthRESTService.logout
  (AuthRESTService.java:255)
  3. When a SEQ data set with an invalid block size is included
  in the filter and pattern search, mvs miner returns the error
  for the validation check which in turn having the search
  return the error
  

Problem conclusion

• 1. Add a check for the RSE_COMMON_PROPERTIES environment
  variable to verify whether the service is enabled. If the
  service is not enabled, do not create the private common
  properties.
  2. Rapid login and out or error operation scenarios may cause
  unfinished user resources initialization, which in turn may
  lead to the logout's NPEs. Proper check on null resources have
  been added to prevent the NPEs.
  3. RSE API now returns error in processing the data sets only
  when there is no search result returned to raise caller's
  awareness; otherwise, the search result returned as successful
  status. A warning trace for the error if there is is logged in
  RSE API server log.
  

Temporary fix

Comments

APAR Information

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

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

  UO07919

Modules/Macros

• HUH1SMPE HUH2RCVE HUH3ALOC HUH4ZFS  HUH5MKD  HUH6DDEF HUH7APLY
  HUH8ACPT HUHCRYPT HUHFT000 HUHFT002 HUHFT003 HUHFT004 HUHFT005
  HUHFT006 HUHFT007 HUHFT008 HUHFT009 HUHFT010 HUHFT011 HUHMKDIR
  HUHMOUNT HUHPAX01 HUHRACF  HUHSETUP HUHSHPAX HUHSTC
  

Fix information

• Fixed component name

  EXP FOR ZOS RSE

• Fixed component ID

  5655EXP33

Applicable component levels

• R110 PSY UO07919

     UP26/06/01 P F605

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.