IBM Support

OA37821: NEW FUNCTION IARV64 REQUEST=COUNTPAGES SUPPORT FOR UNSERIALIZED PROCESSING.

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • New Function in support of DB2 APAR PM49816 to provide
    an option for IARV64 REQUEST=COUNTPAGES that will
    return estimated storage usage counts without obtaining
    RSM serialization.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of HBB7750 and above.              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Provide an option to perform an IARV64  *
    *                      REQUEST=COUNTPAGES without RSM          *
    *                      serialization.                          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    IARV64 REQUEST=COUNTPAGES needs to provide an option
    to perform an estimated count without RSM serialization.
    

Problem conclusion

Temporary fix

Comments

  • IARV64 REQUEST=COUNTPAGES is enhanced with a new keyword,
    UNLOCKED=(NO|YES). When UNLOCKED=YES is coded, RSM locks will
    not be held during frame counting.
    
    The default is UNLOCKED=NO.
    
    Documentation Updates:
    ----------------------
    
    The information in the following z/OS manuals should appear as
    indicated below.  Updates will only be made to the manuals in
    future z/OS releases.
    
    SA22-7610-XX
    z/OS MVS Authorized Assembler Services Reference EDT-IXG
    ---------------------------------------------------------------
    The following updates are made to:
    
    IARV64 -- 64-bit virtual storage allocation chapter.
    REQUEST=COUNTPAGES option (see: OA35885).
    
    Add the following to the Syntax section:
    ----------------------------------------
     ,ALETVALUE=aletvalue  aletvalue: RS-type address or address in
                           register (2) - (12).
                           Default: ALETVALUE=0
    |
    |,UNLOCKED=NO          Default: UNLOCKED=NO
    |,UNLOCKED=YES
    
    
    Add the following to the Parameters section:
    --------------------------------------------
     ,ALETVALUE=aletvalue
     ,ALETVALUE=0
       An optional input parameter that indicates the ALET of the
       address space that will access the memory object.
    
       The only supported values are 0 (primary) and 2 (home).
       The default is 0.
    
       To code: Specify the RS-type address, or address in
       register (2)-(12), of a fullword field, or specify a literal
       decimal value.
    
    |,UNLOCKED=NO
    |,UNLOCKED=YES
    |  An optional parameter that specifies whether the request is
    |  to be performed without RSM serialization. This should only
    |  be used when the memory objects to be counted will not be
    |  modified or detached and an exact count is not needed.
    |  These counts will not be accurate since RSM processing can
    |  be modifying frame allocations.
    |
    |  The default is UNLOCKED=NO.
    |
    | ,UNLOCKED=NO
    |   The request will use RSM serialization. This is the
    |   recommended option.
    |
    | ,UNLOCKED=YES
    |   The request will not hold RSM locks during processing.
    
    Add the following to the Return and Reason Codes section:
    ---------------------------------------------------------
     0C   Meaning: The request is rejected due to system failure.
            For a GETSTOR request, there was insufficient storage
            to build the control structures needed by the request.
    
            Action: Free storage within address space so control
            structures can be built.
    
    |       For a COUNTPAGES request, there was an error during
    |       unlocked=yes processing indicating the page table
    |       structure changed.
    |
    |       Action: Try the request again.
    

APAR Information

  • APAR number

    OA37821

  • Reported component name

    RSM - REAL STOR

  • Reported component ID

    5752SC1CR

  • Reported release

    760

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function

  • Submitted date

    2011-10-11

  • Closed date

    2012-01-26

  • Last modified date

    2012-03-01

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UA63986 UA63987 UA63988 UA63989

Modules/Macros

  • IARV64   IAXVL    IAXV6
    

Publications Referenced
SA227610XX        

Fix information

  • Fixed component name

    RSM - REAL STOR

  • Fixed component ID

    5752SC1CR

Applicable component levels

  • R750 PSY UA63986

       UP12/02/09 P F202

  • R760 PSY UA63987

       UP12/02/09 P F202

  • R770 PSY UA63988

       UP12/02/09 P F202

  • R780 PSY UA63989

       UP12/02/09 P F202

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.



Document information

More support for: z/OS family

Software version: 760

Operating system(s): MVS, z/OS

Reference #: OA37821

Modified date: 01 March 2012


Translate this page: