XDRBK Back to Index page
 
Prolog 
Control Block Contents 
   XDRBK 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.


  XDRBK Prolog Top of page
 
 NAME       : HCPXDRBK
 DESCRIPTION: Expanded Storage Directory Block
 DSECT      : XDRBK
 FUNCTION   : This block maintains the state of all increments
              of expanded storage installed on the system.
 LOCATED BY : The pointer to the collection of XDRBKs known
              as the "directory" is located in field
              XSTDIRAN of the Expanded Storage Management
              Data Block (XSTMG).
 CREATED BY : HCPESCDI during initialization processing.
 DELETED BY : HCPESCDI if no expanded storage is configured
              to the system.
 RELOCATION CONSIDERATIONS : None
 
 
  XDRBK Control Block Content Top of page
 

 XDRBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure XDRBK Expanded Storage Directory Block 0000 0 Dbl-Word 8 XDRINCDR (4) Increment Directory Entry 0000 0 Dbl-Word 8 XDRENTRY (0) Increment Directory Entry 0000 0 Signed 4 XDRAEMAP Address of allocation and error maps (XSUBK) for this increment. 0004 4 Signed 4 XDRINDX Increment index. 0008 8 Dbl-Word 8 XDRCURNT Current status of allocation. 0010 16 Signed 4 XDRINALC Count of blocks available in the increment 0014 20 Signed 4 XDRINERC Count of blocks in error in the increment. 0018 24 Signed 4 XDRFLAGS Flags and locks for the entry 001C 28 Signed 4 * Reserved for IBM use 0008 8 Signed 4 XDRINCRS Increment cursor which points to the next available block to attempt to allocate within this increment. 000C 12 Signed 4 XDRSCLEN Length of allocation map left to scan. It is the number of bytes between XDRINCRS and the end of the allocation map. 0010 16 Signed 4 XDRVMDBK Address of the base VMDBK which owns this increment of xstore. This base VMDBK is the base for the primary configuration for this user. It is equivalent to VMDORIG. This field is valid if XDRSTAT is in the Guest and not Migrating state. 0018 24 Signed 2 XDRLOCK Lock area for this increment 001A 26 Bitstring 1 XDRSTAT Increment status flag byte 1... .... XDRCONFG X'80' XDRCONFG Increment is configured to this hardware partition. .1.. .... XDRSTDBY X'40' XDRSTDBY Increment is in standby mode ..1. .... XDRRESVD X'20' XDRRESVD Increment is in reserved mode .... 1... XDRONLIN X'08' XDRONLIN Increment is logically online and usable. When this bit is on, the XSUBK address in XDRAEMAP can be used. When this bit is off, all the blocks associated with this XDRBK are in error despite the contents of the allocation and error maps. .... ..1. XDRCP X'02' XDRCP Increment belongs to CP. When off the increment belongs to a guest. .... ...1 XDRINCMD X'01' XDRINCMD Increment state modifier. When on: If XDRCP is on then increment is in the CP-Retained state. If XDRCP is off then increment is in the Guest-Migrating state. 001B 27 Bitstring 1 * Reserved for IBM use 0018 24 Bitstring 1 XDRINCLK This is the lock byte for the increment. The lock must be obtained to scan for a block within the increment. 0019 25 Bitstring 1 XDROWNER This is the lock owner identifier field. 000000E3 XDRATTCH X'E3' XDRATTCH Attach owns the lock 000000D9 XDREPAIR X'D9' XDREPAIR Usability map repair owns lock 000000D8 XDRQUERY X'D8' XDRQUERY Query XSTORE owns the lock 000000D5 XDRETAIN X'D5' XDRETAIN Retain XSTORE owns the lock 000000D4 XDRMCH X'D4' XDRMCH Machine Check Handler owns lock 000000C5 XDRDETCH X'C5' XDRDETCH Detach owns the lock 000000C4 XDRDEALC X'C4' XDRDEALC Deallocation owns the lock 00000000 XDRALLOC X'00' XDRALLOC If XDRINCLK is set, allocation owns the lock. If XDRINCLK is not set then no owner. 00000020 XDRLENTH *-XDRBK Length of each XDRBK in bytes 00000004 XDRSIZE (*-XDRBK+7)/8 Length of each XDRBK in dwords
 
 
  XDRBK Storage Layout Top of page
 
          
*** XDRBK - Expanded Storage Directory Block
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       XDRINCDR                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  20
*
*** XDRBK - Expanded Storage Directory Block
          
*** Overlay for XDRINCDR in XDRBK
*
*     +---------------------------+---------------------------+
*   0 |         XDRAEMAP          |         XDRINDX           |
*     +---------------------------+---------------------------+
*   8 |                       XDRCURNT                        |
*     +---------------------------+---------------------------+
*  10 |         XDRINALC          |         XDRINERC          |
*     +---------------------------+---------------------------+
*  18 |         XDRFLAGS          |///////////////////////////|
*     +---------------------------+---------------------------+
*  20
*
*** Overlay for XDRINCDR in XDRBK
          
*** Overlay for XDRCURNT in XDRBK
*
*     +---------------------------+---------------------------+
*   8 |         XDRINCRS          |         XDRSCLEN          |
*     +---------------------------+---------------------------+
*  10
*
*** Overlay for XDRCURNT in XDRBK
          
*** Overlay for XDRINALC in XDRBK
*
*     +---------------------------+
*  10 |         XDRVMDBK          | 14
*     +---------------------------+
*
*** Overlay for XDRINALC in XDRBK
          
*** Overlay for XDRFLAGS in XDRBK
*
*     +-------------+------+------+
*  18 |  XDRLOCK    |:STAT |//////| 1C
*     +-------------+------+------+
*
*** Overlay for XDRFLAGS in XDRBK
          
*** Overlay for XDRLOCK in XDRBK
*
*     +------+------+
*  18 |:INCLK|:OWNER| 1A
*     +------+------+
*
*** Overlay for XDRLOCK in XDRBK
 
 
  XDRBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
XDRAEMAP       0000
XDRALLOC       0019 00000000
XDRATTCH       0019 000000E3
XDRCONFG       001A 80
XDRCP          001A 02
XDRCURNT       0008
XDRDEALC       0019 000000C4
XDRDETCH       0019 000000C5
XDRENTRY       0000
XDREPAIR       0019 000000D9
XDRETAIN       0019 000000D5
XDRFLAGS       0018
XDRINALC       0010
XDRINCDR       0000
XDRINCLK       0018
XDRINCMD       001A 01
XDRINCRS       0008
XDRINDX        0004
XDRINERC       0014
XDRLENTH       0019 00000020
XDRLOCK        0018
XDRMCH         0019 000000D4
XDRONLIN       001A 08
XDROWNER       0019
XDRQUERY       0019 000000D8
XDRRESVD       001A 20
XDRSCLEN       000C
XDRSIZE        0019 00000004
XDRSTAT        001A
XDRSTDBY       001A 40
XDRVMDBK       0010
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:58:08 EDT.
Copyright IBM Corporation, 1990, 2022