A fix is available
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 number
PH38038
Reported component name
EXP FOR ZOS RSE
Reported component ID
5655EXP33
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-06-10
Closed date
2021-06-11
Last modified date
2021-07-13
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"100"}]
Document Information
Modified date:
14 July 2021