NAME       : HCPVCZBK
 DESCRIPTION: Vacator Zone Block
 DSECT      : VCZBK
 FUNCTION   : Represent one vacating available list zone
 LOCATED BY : VACVCZLL
              VCZNEXT
              VCZPREV
              AvlVCZBK
 CREATED BY : HCPVAC
 DELETED BY : HCPVAC
 REFERENCES : AvlZn - Avail Zone block
              VACBK - Vacator Block
              VCFBK - Vacator Frame Block
 SERIALIZED : Task serialization.  Only the vacator, HCPVAC, operating
              on the specific zone represented by this block, can
              mess with this block.
 RELOCATION CONSIDERATIONS : None
 COMPATIBILITY AND MIGRATION CONCERNS : None
 NOTES      :

 VCZBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      VCZBK          Vacator Zone Block
0000    0 Signed       4 VCZNEXT        Ptr to next VCZBK in linked list
0004    4 Signed       4 VCZPREV        Ptr to prev VCZBK in linked list
0008    8 Signed       4 VCZPASS        Number of completed passes
000C   12 Signed       4 VCZPSSRC       HCPPSSDC return code saved for
                                        RAS
0010   16 Signed       4 VCZAVLZN       Addr of AvlZn block being vacated
0014   20 Signed       4 VCZVACBK       VACBK addr off of which this
                                        VCZBK is hung (in list at
                                        VACVCZLL)
0018   24 Dbl-Word     8 VCZSTRTS       Starting timestamp
0020   32 Dbl-Word     8 VCZENDTS       Ending timestamp
0028   40 Bitstring    1 VCZSTATF       Status flags
          1... ....      VCZRUNNG       X'80' VCZRUNNG Stacked/running
                                        (Note: this bit is governed by
                                        VACVCZLK)
          .1.. ....      VCZWAITN       X'40' VCZWAITN Waiting (Note:
                                        this bit is governed by VACVCZLK)
          ..1. ....      VCZDMDCN       X'20' VCZDMDCN Reclamation
                                        cancelled/halted
          ...1 ....      VCZDSRCN       X'10' VCZDSRCN DSRUnit cancelled
          .... 1...      VCZWINDO       X'08' VCZWINDO Currently in a
                                        DSBOW open window
          .... .1..      VCZNOPRG       X'04' VCZNOPRG No progress was
                                        made on the last completed pass
          .... ..1.      VCZFRxFR       X'02' VCZFRxFR The next pass
                                        should be done frame- by-frame,
                                        as there is a frame that needs
                                        moving that doesn't have a VCFBK
                                        due to the VCFBK throttle
          .... ...1      VCZDONE        X'01' VCZDONE Completed (see
                                        completion flags) (Note: this bit
                                        is governed by VACVCZLK)
0029   41 Bitstring    1 VCZCOMPF       Completion flags
          1... ....      VCZFAILD       X'80' VCZFAILD Failed
          .1.. ....      VCZCANCD       X'40' VCZCANCD Cancelled/HALTed
          ..1. ....      VCZVACTD       X'20' VCZVACTD Successfully
                                        vacated
          ...1 ....      VCZUNASI       X'10' VCZUNASI Successfully
                                        unassigned
          .... ...1      VCZLAST1       X'01' VCZLAST1 Final task to
                                        decrement VACRUNCT
002A   42 Bitstring    1 VCZFLAGS       Informational flags
          1... ....      VCZBASE        X'80' VCZBASE VCZBK for base zone
                                        of DSRUnit
002B   43 Bitstring    1 VCZPEERU       TS byte for use only during halt;
                                        Gives a cancelling zone the right
                                        to "unmark,vacating" the peer
                                        zone in which this TS lock is
                                        held
002C   44 Signed       4 VCZMRCAB       Most Recent Count ABsent
                                        (HCPFMUTL)
0030   48 Signed       4 VCZVCFHD       Ptr to 1st on VCFBK chain
0034   52 Signed       4 VCZVCFTL       Ptr to last on VCFBK chain
0038   56 Signed       4 VCZOFFLN       Number of frames offline in zone
003C   60 Signed       4 VCZVCFCT       Count of VCFBKs on VCFBK chain
0040   64 Signed       4 VCZDSRFP       Ptr to next on circular, singly
                                        linked list of VCZBKs
                                        representing zones in the same
                                        DSRUnit
0044   68 Signed       4 VCZDU2GO       Number of zones still to complete
                                        vacating in this DSRUnit (only
                                        valid in VCZBK with VCZBASE=1);
                                        init'd to RSAAvlZnsPerDSRU and
                                        decremented as zone completes
                                        vacating.
0048   72 Bitstring    1 VCZVCFLK       TS byte governing any changes to
                                        the VCFBK chain for this zone,
                                        including VCZVCFHD, VCZVCFTL, and
                                        VCZVCFCT.
0049   73 Bitstring    1 * (3)          Reserved for IBM use
004C   76 Signed       4 VCZPagesMoved  MI number of pages moved by
                                        HCPPTEFS. Rolled into DSRBK for
                                        monitor.
0050   80 Signed       4 VCZPgSkpSer    MI number of times a page was
                                        skipped because necessary
                                        serialization could not be
                                        obtained. Rolled into DSRBK for
                                        monitor.
0054   84 Signed       4 VCZPgSkpPin    MI number of times a page was
                                        skipped because it was
                                        locked/pinned. Rolled into DSRBK
                                        for monitor.
0058   88 Signed       4 VCZPgSkpFrm    MI number of times a page was
                                        skipped and the HCPVACAT thread
                                        was suspended because no frame
                                        was available to receive the page
                                        content. Rolled into DSRBK for
                                        monitor.
0060   96 Dbl-Word     8 VCZLastSkip    Last FRMTE skipped in this zone
0068  104 Signed       4 VCZLastSkPs    Last pass during which a FRMTE
                                        was skipped
          0000000E       VCZSIZE        (*-VCZBK+7)/8 size in double
                                        words
          00000070       VCZBSIZE       VCZSIZE*8 size in bytes

          
*** VCZBK - Vacator Zone Block
*
*     +---------------------------+---------------------------+
*   0 |         VCZNEXT           |         VCZPREV           |
*     +---------------------------+---------------------------+
*   8 |         VCZPASS           |         VCZPSSRC          |
*     +---------------------------+---------------------------+
*  10 |         VCZAVLZN          |         VCZVACBK          |
*     +---------------------------+---------------------------+
*  18 |                       VCZSTRTS                        |
*     +-------------------------------------------------------+
*  20 |                       VCZENDTS                        |
*     +------+------+------+------+---------------------------+
*  28 |:STATF|:COMPF|:FLAGS|:PEERU|         VCZMRCAB          |
*     +------+------+------+------+---------------------------+
*  30 |         VCZVCFHD          |         VCZVCFTL          |
*     +---------------------------+---------------------------+
*  38 |         VCZOFFLN          |         VCZVCFCT          |
*     +---------------------------+---------------------------+
*  40 |         VCZDSRFP          |         VCZDU2GO          |
*     +------+--------------------+---------------------------+
*  48 |:VCFLK|////////////////////|      VCZPAGESMOVED        |
*     +------+--------------------+---------------------------+
*  50 |       VCZPGSKPSER         |       VCZPGSKPPIN         |
*     +---------------------------+---------------------------+
*  58 |       VCZPGSKPFRM         |///////////////////////////|
*     +---------------------------+---------------------------+
*  60 |                     VCZLASTSKIP                       |
*     +---------------------------+---------------------------+
*  68 |       VCZLASTSKPS         | 6C
*     +---------------------------+
*
*** VCZBK - Vacator Zone Block

 
Symbol         Dspl Value
-------------- ---- -----
VCZAVLZN       0010
VCZBASE        002A 80
VCZBSIZE       0068 00000070
VCZCANCD       0029 40
VCZCOMPF       0029
VCZDMDCN       0028 20
VCZDONE        0028 01
VCZDSRCN       0028 10
VCZDSRFP       0040
VCZDU2GO       0044
VCZENDTS       0020
VCZFAILD       0029 80
VCZFLAGS       002A
VCZFRxFR       0028 02
VCZLastSkip    0060
VCZLastSkPs    0068
VCZLAST1       0029 01
VCZMRCAB       002C
VCZNEXT        0000
VCZNOPRG       0028 04
VCZOFFLN       0038
VCZPagesMoved  004C
VCZPgSkpFrm    0058
VCZPgSkpPin    0054
VCZPgSkpSer    0050
VCZPASS        0008
VCZPEERU       002B
VCZPREV        0004
VCZPSSRC       000C
VCZRUNNG       0028 80
VCZSIZE        0068 0000000E
VCZSTATF       0028
VCZSTRTS       0018
VCZUNASI       0029 10
VCZVACBK       0014
VCZVACTD       0029 20
VCZVCFCT       003C
VCZVCFHD       0030
VCZVCFLK       0048
VCZVCFTL       0034
VCZWAITN       0028 40
VCZWINDO       0028 08