VM65786: RESPOOL MEMBER LIMIT REMOVAL

Obtain the fix for this APAR.

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 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
  

Fix information

• Fixed component name

  VM CP

• Fixed component ID

  568411202

Applicable component levels

• R640 PSY UM35384

     UP19/06/19 P 2001

• R710 PSY UM35385

     UP19/06/19 P 1902

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.