Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

WIFBK

Prolog  

Control Block Contents  
   WIFBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


WIFBK Prolog

 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


WIFBK DSECT

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

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

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 V6R2.0. Last updated on 21 Nov 2011 at 11:32:22 EDT.
Copyright IBM Corporation, 1990, 2011