WIFBK | Back to Index page

| Prolog Control Block Contents WIFBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

WIFBK Prolog | Top of page

     NAME       : HCPWIFBK
     DESCRIPTION: "Will I Fit" RAS Block
     DSECT      : WIFBK
     FUNCTION   : Contains "Will I Fit" calculations used for memory
                  capacity checking on the destination during a Live Guest
                  Relocation.  The data stored herein was either received
                  on the destination from the source, or was calculated on
                  the destination.
     LOCATED BY : HCPRLOBK - Through a LIFO chain anchored at RLOWIFBK
     CREATED BY : HCPRLLDE - When processing an RLMLG block during LGR
                  memory checks on the destination
     DELETED BY : HCPRLHRR - Destroyed prior to releasing the RLOBK
     REFERENCES : Bits defined for WIFERROR by HCPRLOBK RLOCAPCK
     SERIALIZED : None.
     RELOCATION CONSIDERATIONS : None.
     COMPATIBILITY AND MIGRATION CONCERNS : None.
     NOTES      : None.

WIFBK Control Block Content | Top of page

     WIFBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      WIFBK          "Will I Fit" RAS Block
    0000    0 Address      4 WIFNEXT        (+00) Next WIFBK on chain; a zero
                                            value indicates end-of-chain
    0004    4 Signed       4 *              (+04) Reserved for IBM use
    0008    8 Dbl-Word     8 WIFTDONE       (+08) Timestamp for when this set
                                            of WIF checks was completed
          Information about this Live Guest Relocation
    0010   16 Character    8 WIFSOURC       (+10) Name of the source guest
    0018   24 Character    8 WIFSKEL        (+18) Name of the destination
                                            "skeleton" receptor guest
    0020   32 Signed       4 WIFVMDBK       (+20) Address of the receptor
                                            guest VMDBK
    0024   36 Signed       4 WIFRLOBK       (+24) Address of the RLOBK
    0028   40 Signed       4 WIFPASS        (+28) Memory copy pass number 0 =
                                            Initial elig. checks or first
                                            pass n > 0 = Number of the
                                            last completed pass
    002C   44 Bitstring    1 WIFERROR       (+2C) History of all capacity
                                            errors found during this pass
              1... ....      RLOMXGDS       X'80' RLOMXGDS The pageable
                                            portion of this guest's maximum
                                            potential memory footprint
                                            exceeds available DASD slots on
                                            the destination system
              .1.. ....      RLOCRGDS       X'40' RLOCRGDS The pageable
                                            portion of this guest's current
                                            memory footprint exceeds
                                            available DASD slots on the
                                            destination system
              ..1. ....      RLOMXGAV       X'20' RLOMXGAV This guest's
                                            maximum potential memory
                                            footprint exceeds the available
                                            or stealable memory resources on
                                            the destination system
              ...1 ....      RLOCRGAV       X'10' RLOCRGAV This guest's
                                            current memory footprint exceeds
                                            the available or stealable memory
                                            resources on the destination
                                            system
    002D   45 Bitstring    1 * (3)          (+2D) Reserved for IBM use
    0030   48 Dbl-Word     8 WIFAVAIL       (+30) Total destination available
                                            memory, in 4K pages
    0038   56 Dbl-Word     8 WIFAVRES       (+38) Dest. available resident
                                            frames
    0040   64 Dbl-Word     8 WIFAVXST       (+40) Dest. available XSTORE blks
    0048   72 Dbl-Word     8 WIFAVAUX       (+48) Dest. available aux slots
    0050   80 Dbl-Word     8 *              (+50) Reserved for IBM use
          WIF calculations related to the source guest
    0058   88 Dbl-Word     8 WIFSREAL       (+58) Current actual source guest
                                            footprint, in 4K pages
    0060   96 Dbl-Word     8 WIFSMAX        (+60) Maximum footprint of the
                                            source guest, in 4K frames
    0068  104 Dbl-Word     8 WIFSRRES       (+68) Count of resident frames
                                            within the source guest's current
                                            actual footprint
    0070  112 Dbl-Word     8 WIFSRXST       (+70) Count of XSTORE blocks
                                            within the source guest's current
                                            actual footprint
    0078  120 Dbl-Word     8 WIFSRAUX       (+78) Count of auxiliary slots
                                            within the source guest's current
                                            actual footprint
    0080  128 Dbl-Word     8 *              (+80) Reserved for IBM use
    0088  136 Dbl-Word     8 WIFSPGOH       (+88) Pageable CP overhead of
                                            source guest, in 4K pages
    0090  144 Dbl-Word     8 WIFSNPOH       (+90) Nonpageable CP overhead of
                                            source guest, in 4K frames
          WIF calculations related to the receptor guest
    0098  152 Dbl-Word     8 WIFDREAL       (+98) Current actual receptor
                                            guest footprint, in 4K pages
    00A0  160 Dbl-Word     8 WIFDRRES       (+A0) Count of resident frames
                                            within the receptor guest's
                                            current actual footprint
    00A8  168 Dbl-Word     8 WIFDRXST       (+A8) Count of XSTORE blocks
                                            within the receptor guest's
                                            current actual footprint
    00B0  176 Dbl-Word     8 WIFDRAUX       (+B0) Count of auxiliary slots
                                            within the receptor guest's
                                            current actual footprint
    00B8  184 Dbl-Word     8 *              (+B8) Reserved for IBM use
              00000018       WIFSIZE        (*-WIFBK+7)/8 Block size in
                                            double words
              000000C0       WIFBSIZE       WIFSIZE*8 Block size in bytes

WIFBK Storage Layout | Top of page

    *** WIFBK - "Will I Fit" RAS Block
    *
    *     +---------------------------+---------------------------+
    *   0 |         WIFNEXT           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *   8 |                       WIFTDONE                        |
    *     +-------------------------------------------------------+
    *  10 |                       WIFSOURC                        |
    *     +-------------------------------------------------------+
    *  18 |                       WIFSKEL                         |
    *     +---------------------------+---------------------------+
    *  20 |         WIFVMDBK          |         WIFRLOBK          |
    *     +---------------------------+------+--------------------+
    *  28 |         WIFPASS           |:ERROR|////////////////////|
    *     +---------------------------+------+--------------------+
    *  30 |                       WIFAVAIL                        |
    *     +-------------------------------------------------------+
    *  38 |                       WIFAVRES                        |
    *     +-------------------------------------------------------+
    *  40 |                       WIFAVXST                        |
    *     +-------------------------------------------------------+
    *  48 |                       WIFAVAUX                        |
    *     +-------------------------------------------------------+
    *  50 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  58 |                       WIFSREAL                        |
    *     +-------------------------------------------------------+
    *  60 |                       WIFSMAX                         |
    *     +-------------------------------------------------------+
    *  68 |                       WIFSRRES                        |
    *     +-------------------------------------------------------+
    *  70 |                       WIFSRXST                        |
    *     +-------------------------------------------------------+
    *  78 |                       WIFSRAUX                        |
    *     +-------------------------------------------------------+
    *  80 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  88 |                       WIFSPGOH                        |
    *     +-------------------------------------------------------+
    *  90 |                       WIFSNPOH                        |
    *     +-------------------------------------------------------+
    *  98 |                       WIFDREAL                        |
    *     +-------------------------------------------------------+
    *  A0 |                       WIFDRRES                        |
    *     +-------------------------------------------------------+
    *  A8 |                       WIFDRXST                        |
    *     +-------------------------------------------------------+
    *  B0 |                       WIFDRAUX                        |
    *     +-------------------------------------------------------+
    *  B8 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  C0
    *
    *** WIFBK - "Will I Fit" RAS Block

WIFBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    RLOCRGAV       002C 10
    RLOCRGDS       002C 40
    RLOMXGAV       002C 20
    RLOMXGDS       002C 80
    WIFAVAIL       0030
    WIFAVAUX       0048
    WIFAVRES       0038
    WIFAVXST       0040
    WIFBSIZE       00B8 000000C0
    WIFDRAUX       00B0
    WIFDREAL       0098
    WIFDRRES       00A0
    WIFDRXST       00A8
    WIFERROR       002C
    WIFNEXT        0000
    WIFPASS        0028
    WIFRLOBK       0024
    WIFSIZE        00B8 00000018
    WIFSKEL        0018
    WIFSMAX        0060
    WIFSNPOH       0090
    WIFSOURC       0010
    WIFSPGOH       0088
    WIFSRAUX       0078
    WIFSREAL       0058
    WIFSRRES       0068
    WIFSRXST       0070
    WIFTDONE       0008
    WIFVMDBK       0020

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:31:50 EDT.
Copyright IBM Corporation, 1990, 2020