IBM Support

OA35885: CURRENT REAL AND AUXILIARY STORAGE USAGE INFORMATION IS NOT AVAILABLE FOR HIGH VIRTUAL STORAGE

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • IARV64 REQUEST=LIST does not return the amount of real and
    auxiliary storage currently allocated for a high virtual
    storage range.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of HBB7750 and above.                  *
    ****************************************************************
    * PROBLEM DESCRIPTION: In support of PM24723, RSM IARV64 macro *
    *                      service should provide an interface to  *
    *                      obtain the real frame and auxiliary     *
    *                      storage in use to support an input high *
    *                      virtual storage range.                  *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    High virtual storage users do not have a means to determine the
    amount of storage resources currently in use to support the high
    virtual storage allocated.
    

Problem conclusion

  • A new IARV64 request type Countpages is provided.
    
    IARV64 REQUEST=COUNTPAGES will return three counts:
    - the number of 4K pages with a copy in real storage
    - the number of 4K pages with a copy on auxiliary storage
    - the number of 4K pages with a copy in real storage and
      on auxiliary storage.
    
    Publication changes:
    
    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.
    
    GA22-7589-xx z/OS MVS Diagnosis: Tools and Service Aids
    ---------------------------------------------------------------
    Add V6count description to the options parameter
    definition for IARV64.
    
    Section: Requesting a SYSRSM trace
    OPTIONS parameter
    IARV64
        Traces all IARV64 requests. The High Virtual services
        group options, which can be specified separately are:
    |
    |   V6COUNT
    |       Trace IARV64 COUNTPAGES requests.
    ---------------------------------------------------------------
     z/OS MVS Data Areas Volume 2 (DDRCOM-IEFALCXT)
    ---------------------------------------------------------------
     The following updates are made to the IAXV64WA chapter
     titled:
    
    IAXV64WA Programming Interface Information
    -------------------------------------------
    --------- Programming Interface information -------------------
    IAXV64WA
    ONLY the following fields are part of the programming interface
    information:
    
         * V64WAENTRY
         * V64WAHEADERPUBLIC
         * V64WADiagData
     |   * V64WACountData
    
     -------- End of Programming Interface information ------------
    IAXV64WA Heading Information
    ----------------------------
        Size:          Variable
                       V64WAHEADER -- X'0028' bytes
                       V64WAENTRY  -- X'0014' bytes
                       V64WADiagData- X'002C' bytes
     |                 V64WACountData - x'0018' bytes
    IAXV64WA Map
    ------------
    New section for Count data:
    ----------------------------
      OFFSET OFFSET
     DECIMAL HEX  TYPE     LEN   NAME (DIM)    DESCRIPTION
     =====  ==== ========  === ============= ===================
    
    |  0     (0)  STRUCTURE  0  V64WACOUNTDATA Map for COUNTPAGES
    |                                          output area
    |  0     (0)  DBL WORD   8  V64WAONAUX     Number of 4K pages
    |                                          with a copy on AUX
    |  8     (8)  DBL WORD   8  V64WAINREAL    Number of 4K pages
    |                                          with a copy in REAL
    |  16    (10) DBL WORD   8  V64WABOTH      Number of 4K pages
    |                                          with a copy in REAL
    |                                          and on AUX
    |  16    (10) X'18'      0  V64WACOUNT_LEN "*-V64WACountData"
    
    The following fields are added to the Cross Reference
     CROSS REFERENCE
                                    HEX        HEX      HEX
      NAME                          OFFSET     VALUE    LEVEL
      ====                          ======     =======  ======
    
    | V64WABOTH                        10                 2
    | V64WAINREAL                       8                 2
    | V64WAONAUX                        0                 2
    
    SA22-7610-XX
    z/OS MVS Authorized Assembler Services Reference EDT-IXG
    ---------------------------------------------------------------
    The following new request type is added to the
    IARV64 -- 64-bit virtual storage allocation chapter.
    
    |REQUEST=COUNTPAGES Option of IARV64
    |         REQUEST=COUNTPAGES requests counts for the number of
    |         4K pages currently in use to back the input virtual
    |         storage ranges in real, on auxiliary storage or both
    |         be returned to the caller.
    |Environment
    | The requirements for the caller are:
    | Minimum authorization:        Supervisor state or PSW key 0-7
    |                               The caller must be running in
    |                               supervisor state or with PSW
    |                               key 0-7.
    | Dispatchable unit mode:       Task or SRB
    | Cross memory mode:            Any PASN, any HASN, any SASN
    | AMODE:                        31- or 64-bit
    | ASC mode:                     Primary or access register (AR)
    | Interrupt status:             Enabled for I/O and external
    | Locks:                        A local lock may be held
    | Control parameters:           Control parameters must be in
    |                               the primary address space and
    |                               can reside both below and above
    |                               the bar.
    |Programming Requirements
    |             None.
    |Restrictions
    |             None
    |
    |             This macro supports multiple versions. Some
    |             keywords are unique to certain versions. See the
    |             PLISTVER parameter description.
    |Input Register Information
    |            Before issuing the IARV64 macro, the caller does
    |            not have to place any information into any
    |            resgister unless using it in register notation for
    |            a particular parameter, or using it as a base
    |            register.
    |Output Register Information
    |             When control returns to the caller, the GPRs
    |             contain:
    |
    |             Register Contents
    |             0      Reason code, if GPR 15 is non-zero
    |
    |             1      Used as a work register by the system
    |             2-13   Unchanged
    |             14     Used as a work register by the system
    |
    |             15     Return code
    |
    |             When control returns to the caller, the ARs
    |             contain:
    |
    |             Register Contents
    |
    |             0-1   Used as work registers by the system
    |             2-13  Unchanged
    |
    |             14-15 Used as work registers by the system
    |
    |             Some callers depend on register contents
    |             remaining the same before and after issuing a
    |             service. If the system changes the contents of
    |             registers on which the caller depends, the caller
    |             must save them before issuing the service, and
    |             restore them after the system returns control.
    |Performance Implications
    |             None
    
    For complete syntax please see the DOC track file.
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA35885

  • Reported component name

    RSM - REAL STOR

  • Reported component ID

    5752SC1CR

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-03-08

  • Closed date

    2011-06-09

  • Last modified date

    2011-07-05

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

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

    UA60823 UA60824 UA60825 UA60826

Modules/Macros

  • IARQC    IARRCE   IARV64   IARV64P  IAXMJ
    IAXMR    IAXTRTBL IAXVL    IAXV6    IAXV64WA IAXZIFTE IAXZITBL
    IAXZTRID
    

Publications Referenced
GA227589XX SA227610XX      

Fix information

  • Fixed component name

    RSM - REAL STOR

  • Fixed component ID

    5752SC1CR

Applicable component levels

  • R750 PSY UA60823

       UP11/06/22 P F106

  • R760 PSY UA60824

       UP11/06/22 P F106

  • R770 PSY UA60825

       UP11/06/22 P F106

  • R780 PSY UA60826

       UP11/06/22 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.



Document information

More support for: z/OS family

Software version: 750

Operating system(s): MVS, z/OS

Reference #: OA35885

Modified date: 05 July 2011


Translate this page: