PH38038: RSEAPI V1.0.5 INTERNAL DEFECT FIX

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• RSEAPI v1.0.5 internal defect fix
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 01.RSE API users                             *
  *                 02.RSE API users                             *
  *                 03.RSE API                                   *
  *                 04.RSE API                                   *
  *                 05.All RSEAPI users                          *
  *                 06.All RSEAPI users                          *
  *                 07.All RSEAPI users                          *
  *                 08.RSE API                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: 01.Users may get NPE when running RSE   *
  *                         Job API                              *
  *                      02.RSE API users are not able to get    *
  *                         the active job address space data    *
  *                         like cpu consumption.                *
  *                      03.New feature to allow RSE shell       *
  *                         commands to be run without line      *
  *                         interpretation First access          *
  *                         performance for multiple users       *
  *                         slowed down by multiple calls to     *
  *                         expensive hostname API               *
  *                      04.This is intermittent problem.        *
  *                         Sometimes RSE job api may not be     *
  *                         able to query the job.               *
  *                      05.Enhancement to provide extended      *
  *                         lock tracking ability, including     *
  *                         lock and unlock commands.            *
  *                      06.Enhancement to provide autoscaling   *
  *                         ability with overflow servers.       *
  *                      07.Enhancement to provide levels of     *
  *                         logging for RSEAPI server common     *
  *                         logger.                              *
  *                      08.Users can only connect to the        *
  *                         common jmon port for their servers   *
  ****************************************************************
  01.The phase number may be null and causing the following null
     pointer exception.
  
     java.lang.NullPointerException at
     com.ibm.rse.rest.adapters.dstore.DStoreJESJobsAdapter.process
     JESResults(DStoreJESJobsAdapter.java:346) at
     com.ibm.rse.rest.adapters.dstore.DStoreJESJobsAdapter.doJobsQ
     uery(DStoreJESJobsAdapter.java:279) at
     com.ibm.rse.rest.api.jaxrs.JESJobsRESTService.getJobs(JESJobs
     RESTService.java:113) at
     sun.reflect.GeneratedMethodAccessor37.invoke(Unknown Source)
     at
     sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMet
     hodAccessorImpl.java:55)
  02.Introduce new end points for RSE API users to retrieve the
     system and active job address space info
  03.New feature to allow RSE shell commands to be run without
     line interpretation The ClientAttributes update will reduce
     redundant expensive calls
  04.When RSE job api making connection to JMON, DISPLAY ACTIVE
     -? command will be run to determine whether the
     DISPLAYACTIVE command is supported. But sometimes it failed
     to read the expected cpu cost message and caused the next
     command to fail.
  05.Implement lock tracking ability for RSE and RSEAPI by
     utilizing VSAM dataset to be able to see true lock owner
     across different threadpool process as well as on different
     LPAR in a sysplex environment. This is a requirement for
     lock and unlock commands.
  06.Support autoscaling ability for RSE and RSEAPI by the
     implementation of overflow servers chain to be able to
     redistribute requests and user sessions to overflow servers.
  07.Introducing level for server common logging activity. Use
     RSEAPI_SERVER_LOG_LEVEL to specify the level.
  08.This feature enable users to configure different jmon ports
     for their individual RSEAPI servers.
  

Problem conclusion

• 01.Add condition to handle the possible invalid phase number
     and prevent NPE generation.
  02.RSE API users can run display active end points to get the
     system and active job address space data.
  03.In RSE API, there is no client integration with interpretted
     output so line interpretation in such cases consumes extra
     CPU and adds no value. Therefore we need a way to levage the
     shell output without interpretation. In RSE API, because
     ClientAttributes is used with each user, which gets the
     hostname, caching the result improves performacne
  04.Update the DISPLAYACTIVE in JESMiner to ensure the cpu cost
     message will be read.
  05.Code implemented.
  06.Code implemented.
  07.Code implemented.
  08.Users can configure jmon port for individual RSEAPI server
     in rseapi.env. If the jmon port is not set, it will default
     to the configured common jmon port.
  

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:

  UI75853

Modules/Macros

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

Fix information

• Fixed component name

  EXP FOR ZOS RSE

• Fixed component ID

  5655EXP33

Applicable component levels

• R100 PSY UI75853

     UP21/06/21 P F106

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.