A fix is available
APAR status
Closed as new function.
Error description
New Function
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users of HBB7790 and up * **************************************************************** * PROBLEM DESCRIPTION: New Function - RSM Support to enable * * JAVA to use the compressed references * * feature * **************************************************************** * RECOMMENDATION: * **************************************************************** This APAR provides RSM support to enable JAVA to use the compressed references feature which is documented in z/OS User Guide for IBM SDK, JAVA Technology Edition.
Problem conclusion
Temporary fix
Comments
To support JAVA's use of the compressed references feature, new parameters, USE2GTO32G and USE2GTO64G, can be specified on IARV64 REQUEST=GETSTOR to allow callers to specify whether this is an explicit allocation request for 64-bit virtual storage in the 2G to 32G virtual storage area or 2G to 64G virtual storage area. IBM suggests that you not use this parameter because JAVA and other language runtimes use it. If there is not enough memory available in this range, these language runtimes could fail to start, or there could be increased memory usage and reduced performance. This parameter relates to usage of the compressed references feature which is documented in z/OS User Guide for IBM SDK, Java Technology Edition. The RCEUSE2GTO32GAREAOK and RCE_USE2GTO64GENABLE bits in the IARRCE macro must be checked to ensure that the system supports these keywords. The following publication changes will be made: 1. SA22-7607-XX z/OS MVS Programming: Assembler Services Reference IAR-XCT 2. SA23-1370-XX z/OS MVS Programming: Assembler Services Reference IAR-XCT 3. SA22-7610-XX z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG 4. SA23-1373-XX z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG The following parameter is added to the IARV64 Macro for REQUEST=GETSTOR: USE2GTO32G=NO|YES is an optional keyword input that specifies whether this is an explicit allocation request for 64-bit virtual storage in the 2G to 32G virtual storage area. IBM suggests that you not use this parameter because JAVA and other language runtimes use it. If there is not enough memory available in this range, these language runtimes could fail to start, or there could be increased memory usage and reduced performance. This parameter relates to usage of the compressed references feature which is documented in z/OS User Guide for IBM SDK, Java Technology Edition. The RCEUSE2GTO32GAREAOK bit in the IARRCE macro must be checked to ensure that the system supports this keyword. DEFAULT: NO USE2GTO32G=NO The request will not be satisfied from the 2G to 32G virtual storage area. USE2GTO32G=YES The request is to be satisfied from the 2G to 32G virtual storage area. USE2GTO32G=YES cannot be specified with USE2GTO64G=YES. USE2GTO64G=NO is ignored when USE2GTO32G=YES is specified. USE2GTO64G=NO|YES is an optional keyword input that specifies whether this is an explicit allocation request for 64-bit virtual storage in the 2G to 64G virtual storage area. IBM suggests that you not use this parameter because JAVA and other language runtimes use it. If there is not enough memory available in this range, these language runtimes could fail to start, or there could be increased memory usage and reduced performance. This parameter relates to usage of the compressed references feature which is documented in z/OS User Guide for IBM SDK, Java Technology Edition. The RCE_USE2GTO64GENABLE bit in the IARRCE macro must be checked to ensure that the system supports this keyword. DEFAULT: NO USE2GTO64G=NO The request will not be satisfied from the 2G to 64G virtual storage area. USE2GTO64G=YES The request is to be satisfied from the 2G to 64G virtual storage area. USE2GTO64G=YES cannot be specified with USE2GTO32G=YES. USE2GTO32G=NO is ignored when USE2GTO64G=YES is specified. 5. GA32-0857-XX z/OS MVS Data Areas, Volume 5 6. GA32-0937-XX z/OS V2R2 MVS Data Areas Volume 3 (ITK - SCE) In the RCE Information chapter: Add the following field to the RCE Programming Interface information section: RCE_USE2GTO64GENABLE Add the following field to the RCE Map section: Offsets Dec Hex Type/Value Len Name (Dim) Description 335 (14F) CHARACTER 1 RCEFLAGS4 FLAGS .... 1... RCE_USE2GTO64GENABLE "X'08'" Indicates that Use2gto64g is supported Add the following field to the RCE Cross Reference section: Name Hex Offset Hex Value RCE_USE2GTO64GENABLE 14F 08
APAR Information
APAR number
OA49416
Reported component name
RSM - REAL STOR
Reported component ID
5752SC1CR
Reported release
790
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2015-11-17
Closed date
2016-04-04
Last modified date
2016-05-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA81224 UA81223
Modules/Macros
IARRCE IARV64 IAXCH IAXGA IAXMR IAXRA IAXRG IAXVD IAXVJ IAXVS IAXVU IAXVV IAXV2 IAXV3 IAXV7 IAXZGPPP IAXZGPQP IAXZGPRI IAXZVLVA IAXZXLCB
| SA231370XX | SA231373XX | SA227607XX | SA227610XX | GA320857XX |
| GA320937XX |
Fix information
Fixed component name
RSM - REAL STOR
Fixed component ID
5752SC1CR
Applicable component levels
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","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"790","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"790","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 May 2016