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


  APDBK Prolog Top of page
 
 NAME       : HCPAPDBK
 DESCRIPTION: Active Page Drain Control Block
 DSECT      : APDBK
 FUNCTION   : Represents the active drain process for page volumes.
              There is only one APDBK that handles all active drains.
 LOCATED BY : RSAAPDBK - in RSMBK
 CREATED BY : HCPDRAIT
 DELETED BY : Never
 REFERENCES :
 SERIALIZED :
 RELOCATION CONSIDERATIONS : None
 COMPATIBILITY AND MIGRATION CONCERNS :
 
 
  APDBK Control Block Content Top of page
 

 APDBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure APDBK Active Page Drain Control Block 0000 0 Bitstring 32 APDMSK Drain Mask. Bits correspond to one of the 256 possible cpvols. An on bit means the corresponding cpvol is being actively drained. 0000 0 Bitstring 8 APDMSKP1 Drain Mask Part 1 0008 8 Bitstring 8 APDMSKP2 Drain Mask Part 2 0010 16 Bitstring 8 APDMSKP3 Drain Mask Part 3 0018 24 Bitstring 8 APDMSKP4 Drain Mask Part 4 0020 32 Bitstring 1 * (12) Reserved for future. Intended for greater than 256 cpvol support. APD Lockword 0080 128 Dbl-Word 8 APDLK (6) APD lockword Status Section Counts are cumulative for all volumes being scanned in current active page drain session. Counts represent the totals of the pages that have been scanned. Counts are reset when next active drain is activated. 00B0 176 Signed 4 APDCVal Count of valid pages 00B4 180 Signed 4 APDCUFO Count of IBR pages on UFO 00B8 184 Signed 4 APDCANE Count of IBR pages on Aging list that have not been early written 00BC 188 Signed 4 APDCAEW Count of IBR pages on Aging list that have been early written 00C0 192 Signed 4 APDCSyn Count of non-resident pages to be paged in synchronously 00C4 196 Signed 4 APDCASy Count of non-resident pages to be paged in asynchronously 00C8 200 Signed 4 APDCCAS Count of completed asynchronous page ins. See HCPAPDLT to control async page ins. 00CC 204 Signed 4 * Reserved for IBM use These counts are not reset between active drain runs. 00D0 208 Signed 8 APDVisited Cumulative count of guest pages visited by active page drain process. 00D8 216 Signed 8 APDRecoveredSlots Cumulative count of slots recovered by the active page drain process. 00E0 224 Signed 8 APDReadIn Cumulative count of slots read in by the active page drain process. 00E8 232 Signed 4 APDASVisited Cumulative count of address spaces visited by the active drain process. 00EC 236 Bitstring 1 APDSTAT Active Page Drain status 1... .... APDON X'80' APDON Active Page Drain is on .1.. .... APDCHNG X'40' APDCHNG APD mask has been changed since process last came up for air 00ED 237 Bitstring 1 * (3) Reserved for IBM use Size variables 0000001E APDSIZE (*-APDBK+7)/8 size in double words 000000F0 APDBSIZE APDSIZE*8 size in bytes
 
 
  APDBK Storage Layout Top of page
 
          
*** APDBK - Active Page Drain Control Block
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                        APDMSK                         =
*     |                                                       |
*     +-------------------------------------------------------+
*  20
*
*** APDBK - Active Page Drain Control Block
          
*** Overlay for APDMSK in APDBK
*
*     +-------------------------------------------------------+
*   0 |                       APDMSKP1                        |
*     +-------------------------------------------------------+
*   8 |                       APDMSKP2                        |
*     +-------------------------------------------------------+
*  10 |                       APDMSKP3                        |
*     +-------------------------------------------------------+
*  18 |                       APDMSKP4                        |
*     +-------------------------------------------------------+
*  20 |///////////////////////////////////////////////////////|
*     |///////////////////////////+---------------------------+
*     |///////////////////////////|///////////////////////////|
*     +---------------------------+///////////////////////////|
*  30 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  80 |                                                       |
*     =                        APDLK                          =
*     |                                                       |
*     +---------------------------+---------------------------+
*  B0 |         APDCVAL           |         APDCUFO           |
*     +---------------------------+---------------------------+
*  B8 |         APDCANE           |         APDCAEW           |
*     +---------------------------+---------------------------+
*  C0 |         APDCSYN           |         APDCASY           |
*     +---------------------------+---------------------------+
*  C8 |         APDCCAS           |///////////////////////////|
*     +---------------------------+---------------------------+
*  D0 |                      APDVISITED                       |
*     +-------------------------------------------------------+
*  D8 |                  APDRECOVEREDSLOTS                    |
*     +-------------------------------------------------------+
*  E0 |                      APDREADIN                        |
*     +---------------------------+------+--------------------+
*  E8 |       APDASVISITED        |:STAT |////////////////////|
*     +---------------------------+------+--------------------+
*  F0
*
*** Overlay for APDMSK in APDBK
 
 
  APDBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
APDASVisited   00E8
APDBSIZE       00ED 000000F0
APDCAEW        00BC
APDCANE        00B8
APDCASy        00C4
APDCCAS        00C8
APDCHNG        00EC 40
APDCSyn        00C0
APDCUFO        00B4
APDCVal        00B0
APDLK          0080
APDMSK         0000
APDMSKP1       0000
APDMSKP2       0008
APDMSKP3       0010
APDMSKP4       0018
APDON          00EC 80
APDReadIn      00E0
APDRecoveredSlots
               00D8
APDSIZE        00ED 0000001E
APDSTAT        00EC
APDVisited     00D0
 
This information is based on z/VM 7.5.0 Last updated on 22 Jun 2026 at 11:11:29 EDT.
Copyright IBM Corporation, 1990, 2026