A fix is available
APAR status
Closed as new function.
Error description
The limit of 1000 members of an individual RESPOOL (CPUPOOL) is removed. The new limit is the logged on user limit (MAXUSERS).
Local fix
n/a
Problem summary
**************************************************************** * USERS AFFECTED: Customers using RESPOOLs. * **************************************************************** * PROBLEM DESCRIPTION: * **************************************************************** * RECOMMENDATION: APPLY PTF * **************************************************************** Attempts to add more than 1000 members to a single RESPOOL would result in MSHCPLMC3159E Resource pool $1 member limit exceeded. However, cases that were not handled properly could result in ABENDFRE001 in HCPLMC. These cases are: - When a member of a RESPOOL was relocated to another system of the SSI cluster and automatically added to the RESPOOL with the same name on the target system. The limit was not tested and members were allowed to be added to the RESPOOL to the point that the new required list size exceeded the maximum allowed free storage request size. The result was ABENDFRE001. - The same problem could occur when the SCHEDULE command moved a member from one RESPOOL to another. In the case of the move the limit was not checked so ABENDFRE001 was possible when the limit was exceeded.
Problem conclusion
Temporary fix
FOR RELEASE VM/ESA CP/ESA R640 : PREREQ: VM66105 VM66154 CO-REQ: NONE IF-REQ: NONE FOR RELEASE VM/ESACP/ESAR710 : PREREQ: VM66154 CO-REQ: NONE IF-REQ: NONE
Comments
This APAR removes the limit of 1000 members allowed in a single Resource Pool. The new effective limit is the maximum number of users allowed to be logged on to the system as controlled by MAXUSERS on the FEATURES statement of the System Configuration File. This APAR also enhances STHYI Function Code 6 "Resource Pool Member List" to support buffer lengths long enough to return the maximum size member list in a single continuous response. Message HCPLMC3159E "Resource pool $1 member limit exceeded" is removed because there is no longer a limit specific to the number of members in a Resource Pool. Changed parts: - HCPLIMBK COPY - LIMVMDLS is changed from a fullword pointer to memory containing a list of VMDBK addresses to a doubleword containing fullword forward and backward pointers for a doubly-linked chain of VMDBKs. - HCPVMDBK COPY/PLXCOPY - a doubleword containing 2 fullword pointers used for the LIMVMDLS doubly-linked list. Serialized by LIMVMDLK. - HCPLMC ASSEMBLE - checks to enforce the 1000 member limit were removed. - code that prepares and issues HCP3159E was removed. - sections of code that manipulate or traverse the member list are revised to use the doubly-linked list of VMDBKs rather than the in memory list of VMDBK addresses. The allocation and deallocation of vmdbk address list buffers were removed. - HCPSHI ASSEMBLE - sections of code that traverse the member list were changed to use the doubly-linked list rather that the list of VMDBK addresses. - code was restructured to pre-allocate sufficient host buffer pages for the request prior to acquiring locks and to release locks before copying the results to the guest buffer and releasing the host buffer pages. SRL changes: GC24-6270-01 CP messages and Codes - z/VM Version 7 Release 1 - Page 625 - Remove HCP3159E. - This is Chapter 3. System Messages - CP Messages GC24-6177-12 CP messages and Codes - z/VM Version 6 Release 4 - Page 471 - Remove HCP3159E. - This is Chapter 3. System Messages - CP Messages - HCP3001E - HCP5769E. SC24-6268-01 CP Commands and Utilities Ref - Ver 7 Rel 1 - Page 1352 - Remove usage note 8 - This is Chapter 2. CP Commands - SCHEDULE - Page 1353 - Remove HCP3159E from the list. - This is Chapter 2. CP Commands - SCHEDULE SC24-6175-13 CP Commands and Utilities Ref - Ver 6 Rel 4 - Page 1444 - Remove usage note 8 - This is Chapter 2. CP Commands - SCHEDULE - Page 1445 - Remove HCP3159E from the list. - This is Chapter 2. CP Commands - SCHEDULE
APAR Information
APAR number
VM65786
Reported component name
VM CP
Reported component ID
568411202
Reported release
640
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2019-05-15
Closed date
2019-06-14
Last modified date
2020-12-16
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UM35384 UM35385
Modules/Macros
HCPLIMBK HCPLMC HCPSHI HCPVMDBK SCHEDULE
GC24627001 | GC24617712 | SC24626801 | SC24617513 |
Fix information
Fixed component name
VM CP
Fixed component ID
568411202
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":"SG27M","label":"APARs - z\/VM environment"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"640","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]
Document Information
Modified date:
12 January 2021