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


  HXPBK Prolog Top of page
 
 NAME       : HCPHXPBK
 DESCRIPTION: Hyperpav paging IO block
 DSECT      : HXPBK
 FUNCTION   : The HXPBK contains necessary information
              about a CP volume for paging information.
 LOCATED BY : RDEVEXPB - Points to the HXPBK
 CREATED BY : HCPPAIAT - When the CP owned volume is brought on
              line at IPL time and during the ATTACH
              command processing.
 DELETED BY : HCPPAIDT - When the CP owned volume is DETACHed from
              the system.
 REFERENCES : HCPPHDBK - Paging Information Header Block
 SERIALIZED : Formal spin locks where each lock controls one of
              the respective cache lines of the HXPBK.
 RELOCATION CONSIDERATIONS : None
 NOTES      : There is one HXPBK for every base volume that is
              used for hyperpav paging.
              It contains pointers to:
              - A back pointer for the RDEV
              - Eight FRMTE queues (single and multi read and write)
              - Available IORBK queue
              - Active IORBK queue
              The channel program storage is not in the HXPBK. It
              is obtained from a pool anchored in the HXPBK.
 
 
  HXPBK Control Block Content Top of page
 

 HXPBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure HXPBK Hyperpav paging IO block Define the entire HXPBK to be a power of 2 in length, and a multiple of cache size. 0000 0 Bitstring 1 HXPCACH1 (256) 0100 256 Bitstring 1 HXPCACH2 (256) 0200 512 Bitstring 1 HXPCACH3 (256) 0300 768 Bitstring 1 HXPCACH4 (256) 0400 1024 Bitstring 1 HXPCACH5 (256) 0500 1280 Bitstring 1 HXPCACH6 (256) 0600 1536 Bitstring 1 HXPCACH7 (256) 0700 1792 Bitstring 1 HXPCACH8 (256) 0800 2048 Bitstring 1 HXPBKEND (0) 1st cache line - PHDBK 0000 0 Dbl-Word 8 HXPPHDBK (22) Header area mapped by PHDBK The following fields are used to implement a doubly linked chain of HXPBKs that have mapped minidisk extents. The chain is used by monitor to provide information for HXPBK spin locks. The chain is anchored at HCPPGDMX. It is serialized by the formal defer lock, HCPPGDMH. HXPBKs are added at the chain anchor when a minidisk pool is first identified for this HXPBK. The chain is not circular and is terminated by zero in the pointer fields. 00B0 176 Bitstring 1 HXPMMFLG Mapped minidisk HXPBK chain flag byte. 1... .... HXPMMONQ X'80' HXPBK is on the chain 00B1 177 Bitstring 1 * (3) Reserved for IBM use 00B4 180 Signed 4 HXPMMFWD Forward pointer to next HXPBK associated with a mapped minidisk. Field is zero if no association exists or the HXPBK is the last one on the chain. 00B8 184 Signed 4 HXPMMBCK Backward pointer to previous HXPBK associated with a mapped minidisk. Field is zero if no association exists or the HXPBK is the first one on the chain. 00000044 HXPCA1 ((256)-(*-HXPCACH1)) Nbr available bytes 00BC 188 Bitstring 1 * (68) Reserved for IBM use 2nd cache line - HXPBK 0100 256 Dbl-Word 8 HXPC1LCK (6) Formal spin lock used for all I/O driver non queue fields. These are mostly in cache line 2. 0130 304 Signed 4 * Reserved for IBM use 0134 308 Bitstring 1 HXPSTATE State of HCPPAIIO routine 1111 111. HXPSTOPD 255-HXPACTIV HXPSTOPD HCPPAIIO not active .... ...1 HXPACTIV x'01' HXPACTIV HCPPAIIO active .... ..1. HXPQADD x'02' HXPQADD HCPPAI QueueFrm added to a queue 0135 309 Bitstring 1 HXPNOHPF HPF failure flags. Usage of HPF (transport mode) has been suspended. HXPNOHPF, HXPRTYFT, and HXPRTYOT are used by monitor. If changes are made here, corresponding changes are needed in the monitor record. 1... .... HXPNPROG X'80' An unexpected error other than HPF feature no longer available has occurred .1.. .... HXPNFEAT X'40' An error occurred because the HPF feature is no longer available 0136 310 Signed 1 HXPRTYFT Retry count for feature lost 0137 311 Signed 1 HXPRTYOT Retry count for other failure 0138 312 Address 4 HXPtask SAVBK stacked for HCPPAIIO 013C 316 Address 4 * 0140 320 Address 4 HXPFIOR First IORBK of available list 0144 324 Address 4 HXPLIOR Last IORBK of available list 0148 328 Address 4 * Reserved 014C 332 Signed 4 HXPIORCU Current number of allocated IORBKS 0150 336 Signed 4 HXPIORMA Maximum number of active IORBKS 0154 340 Signed 4 HXPIORAC Number of IORBKS queued to IOS 0158 344 Signed 4 HXPIORAV Number of available IORBKs 015C 348 Signed 4 HXPCURQC Cardinal count of all outstanding paging/spooling reads/writes for this device. Used directly by Perfkit. Do not change offset. 0160 352 Signed 8 HXPACTFR Count of frames queued to IOS 0168 360 Signed 4 HXPPAIOC Cumulative count of times HCPPAIIO started 016C 364 Signed 4 HXPRDEV RDEV address 00000090 HXPCA2 ((256)-(*-HXPCACH2)) Nbr available bytes 0170 368 Bitstring 1 * (144) Reserved for IBM use 3rd and 4th cache line - Read queue anchors, queues, lock f-c-m means forced command mode 0200 512 Dbl-Word 8 HXPC2LCK (6) Input read queues formal spin lock 0230 560 Address 8 HXPnrsA Queue of normal read SVGBK 0238 568 Address 8 HXPnrsL Last normal read SVGBK 0240 576 Signed 4 HXPnrsC Count of normal read SVGBK 0244 580 Signed 4 * Reserved 0248 584 Signed 8 * Reserved 0250 592 Address 8 HXPnrfA Queue of normal read FRMTE 0258 600 Address 8 HXPnrfL Last normal read FRMTE 0260 608 Signed 4 HXPnrfC Count of normal read FRMTE 0264 612 Signed 4 * Reserved 0268 616 Signed 8 * Reserved These following queues are for I/Os forced to Command Mode even if HPF Transport Mode is supported/allowed 0270 624 Address 8 HXPfrsA Queue of f-c-m read SVGBK 0278 632 Address 8 HXPfrsL Last f-c-m read SVGBK 0280 640 Signed 4 HXPfrsC Count of f-c-m read SVGBK 0284 644 Signed 4 * Reserved 0288 648 Signed 8 * Reserved 0290 656 Address 8 HXPfrfA Queue of f-c-m read FRMTE 0298 664 Address 8 HXPfrfL Last f-c-m read FRMTE 02A0 672 Signed 4 HXPfrfC Count of f-c-m read FRMTE 02A4 676 Signed 4 * Reserved 02A8 680 Signed 8 * Reserved End of cache line 00000150 HXPCA3 ((512)-(*-HXPCACH3)) Nbr available bytes 02B0 688 Bitstring 1 * (336) Reserved for IBM use 5th and 6th cache lines - Write queue anchors, counts, lock f-c-m means forced command mode 0400 1024 Dbl-Word 8 HXPC3LCK (6) Input write queues formal spin lock 0430 1072 Address 8 HXPnwsA Queue of normal write SVGBK 0438 1080 Address 8 HXPnwsL Last normal write SVGBK 0440 1088 Signed 4 HXPnwsC Count of normal write SVGBK 0444 1092 Signed 4 * Reserved 0448 1096 Signed 8 * Reserved 0450 1104 Address 8 HXPnwfA Queue of normal write FRMTE 0458 1112 Address 8 HXPnwfL Last normal write FRMTE 0460 1120 Signed 4 HXPnwfC Count of normal write FRMTE 0464 1124 Signed 4 * Reserved 0468 1128 Signed 8 * Reserved These following queues are for I/Os forced to Command Mode even if HPF Transport Mode is supported/allowed 0470 1136 Address 8 HXPfwsA Queue of f-c-m write SVGBK 0478 1144 Address 8 HXPfwsL Last f-c-m write SVGBK 0480 1152 Signed 4 HXPfwsC Count of f-c-m write SVGBK 0484 1156 Signed 4 * Reserved 0488 1160 Signed 8 * Reserved 0490 1168 Address 8 HXPfwfA Queue of f-c-m write FRMTE 0498 1176 Address 8 HXPfwfL Last f-c-m write FRMTE 04A0 1184 Signed 4 HXPfwfC Count of f-c-m write FRMTE 04A4 1188 Signed 4 * Reserved 04A8 1192 Signed 8 * Reserved End of cache line 00000150 HXPCA5 ((512)-(*-HXPCACH5)) Nbr available bytes 04B0 1200 Bitstring 1 * (336) Reserved for IBM use 7th and 8th cache lines - Task serialized queue pointers and counts 0600 1536 Address 8 HXPnrsAL Queue of normal read SVGBK Local 0608 1544 Address 8 HXPnrsLL Last normal read SVGBK Local 0610 1552 Address 8 HXPnrfAL Queue of normal read FRMTE Local 0618 1560 Address 8 HXPnrfLL Last normal read FRMTE Local 0620 1568 Address 8 HXPnwsAL Queue of normal write SVGBK Local 0628 1576 Address 8 HXPnwsLL Last normal write SVGBK Local 0630 1584 Address 8 HXPnwfAL Queue of normal write FRMTE Local 0638 1592 Address 8 HXPnwfLL Last normal write FRMTE Local 0640 1600 Address 8 HXPfrsAL Queue of f-c-m read SVGBK Local 0648 1608 Address 8 HXPfrsLL Last f-c-m read SVGBK Local 0650 1616 Address 8 HXPfrfAL Queue of f-c-m read FRMTE Local 0658 1624 Address 8 HXPfrfLL Last f-c-m read FRMTE Local 0660 1632 Address 8 HXPfwsAL Queue of f-c-m write SVGBK Local 0668 1640 Address 8 HXPfwsLL Last f-c-m write SVGBK Local 0670 1648 Address 8 HXPfwfAL Queue of f-c-m write FRMTE Local 0678 1656 Address 8 HXPfwfLL Last f-c-m write FRMTE Local 0680 1664 Signed 4 HXPnrsCL Count of normal read SVGBK Local 0684 1668 Signed 4 HXPnrfCL Count of normal read FRMTE Local 0688 1672 Signed 4 HXPnwsCL Count of normal write SVGBK Local 068C 1676 Signed 4 HXPnwfCL Count of normal write FRMTE Local 0690 1680 Signed 4 HXPfrsCL Count of f-c-m read SVGBK Local 0694 1684 Signed 4 HXPfrfCL Count of f-c-m read FRMTE Local 0698 1688 Signed 4 HXPfwsCL Count of f-c-m write SVGBK Local 069C 1692 Signed 4 HXPfwfCL Count of f-c-m write FRMTE Local 06A0 1696 Bitstring 1 HXPFLAGC Capability flags This field is used by monitor. If changes are made here, corresponding changes are needed in the monitor record. 1... .... HXPHPAV X'80' The last I/O to this volume requested alias use. HyperPav is enabled and the device is a HyperPav base. The I/O subsystem determines if the I/O is executed on an alias device .1.. .... HXPHPF X'40' The last I/O to this volume was a transport mode channel program. HPF is enabled and the device and channel are HPF capable ..1. .... HXPFCMD X'20' The last I/O to this volume was a command mode channel program because it was directed to a minidisk on the volume or was a retry from an HPF error 06A1 1697 Bitstring 1 HXPIFLAG Internal processing flags 1... .... HXPCPHPF X'80' HXPCPHPF This channel program is using HPF 06A2 1698 Bitstring 1 * (2) Reserved for IBM use 0000015C HXPCA7 ((512)-(*-HXPCACH7)) Nbr available bytes 06A4 1700 Bitstring 1 * (348) Reserved for IBM use End of HXPBK 00000800 HXPBSIZE *-HXPBK Size of this DSECT in Bytes 00000100 HXPSIZE (((*-HXPBK)+7)/8) Size in double-words
 
 
  HXPBK Storage Layout Top of page
 
          
*** HXPBK - Hyperpav paging IO block
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       HXPCACH1                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 100 |                                                       |
*     =                       HXPCACH2                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 200 |                                                       |
*     =                       HXPCACH3                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 300 |                                                       |
*     =                       HXPCACH4                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 400 |                                                       |
*     =                       HXPCACH5                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 500 |                                                       |
*     =                       HXPCACH6                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 600 |                                                       |
*     =                       HXPCACH7                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 700 |                                                       |
*     =                       HXPCACH8                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** HXPBK - Hyperpav paging IO block
          
*** Overlay for HXPCACH1 in HXPBK
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       HXPPHDBK                        =
*     |                                                       |
*     +------+--------------------+---------------------------+
*  B0 |:MMFLG|////////////////////|         HXPMMFWD          |
*     +------+--------------------+---------------------------+
*  B8 |         HXPMMBCK          |///////////////////////////|
*     +---------------------------+///////////////////////////|
*  C0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 100 |                                                       |
*     =                       HXPC1LCK                        =
*     |                                                       |
*     +---------------------------+------+------+------+------+
* 130 |///////////////////////////|:STATE|:NOHPF|:RTYFT|:RTYOT|
*     +---------------------------+------+------+------+------+
* 138 |         HXPTASK           |///////////////////////////|
*     +---------------------------+---------------------------+
* 140 |         HXPFIOR           |         HXPLIOR           |
*     +---------------------------+---------------------------+
* 148 |///////////////////////////|         HXPIORCU          |
*     +---------------------------+---------------------------+
* 150 |         HXPIORMA          |         HXPIORAC          |
*     +---------------------------+---------------------------+
* 158 |         HXPIORAV          |         HXPCURQC          |
*     +---------------------------+---------------------------+
* 160 |                       HXPACTFR                        |
*     +---------------------------+---------------------------+
* 168 |         HXPPAIOC          |         HXPRDEV           |
*     +---------------------------+---------------------------+
* 170 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 200
*
*** Overlay for HXPCACH1 in HXPBK
          
*** Overlay for HXPCACH3 in HXPBK
*
*     +-------------------------------------------------------+
* 200 |                                                       |
*     =                       HXPC2LCK                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 230 |                       HXPNRSA                         |
*     +-------------------------------------------------------+
* 238 |                       HXPNRSL                         |
*     +---------------------------+---------------------------+
* 240 |         HXPNRSC           |///////////////////////////|
*     +---------------------------+---------------------------+
* 248 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 250 |                       HXPNRFA                         |
*     +-------------------------------------------------------+
* 258 |                       HXPNRFL                         |
*     +---------------------------+---------------------------+
* 260 |         HXPNRFC           |///////////////////////////|
*     +---------------------------+---------------------------+
* 268 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 270 |                       HXPFRSA                         |
*     +-------------------------------------------------------+
* 278 |                       HXPFRSL                         |
*     +---------------------------+---------------------------+
* 280 |         HXPFRSC           |///////////////////////////|
*     +---------------------------+---------------------------+
* 288 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 290 |                       HXPFRFA                         |
*     +-------------------------------------------------------+
* 298 |                       HXPFRFL                         |
*     +---------------------------+---------------------------+
* 2A0 |         HXPFRFC           |///////////////////////////|
*     +---------------------------+---------------------------+
* 2A8 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 2B0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 400
*
*** Overlay for HXPCACH3 in HXPBK
          
*** Overlay for HXPCACH5 in HXPBK
*
*     +-------------------------------------------------------+
* 400 |                                                       |
*     =                       HXPC3LCK                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 430 |                       HXPNWSA                         |
*     +-------------------------------------------------------+
* 438 |                       HXPNWSL                         |
*     +---------------------------+---------------------------+
* 440 |         HXPNWSC           |///////////////////////////|
*     +---------------------------+---------------------------+
* 448 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 450 |                       HXPNWFA                         |
*     +-------------------------------------------------------+
* 458 |                       HXPNWFL                         |
*     +---------------------------+---------------------------+
* 460 |         HXPNWFC           |///////////////////////////|
*     +---------------------------+---------------------------+
* 468 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 470 |                       HXPFWSA                         |
*     +-------------------------------------------------------+
* 478 |                       HXPFWSL                         |
*     +---------------------------+---------------------------+
* 480 |         HXPFWSC           |///////////////////////////|
*     +---------------------------+---------------------------+
* 488 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 490 |                       HXPFWFA                         |
*     +-------------------------------------------------------+
* 498 |                       HXPFWFL                         |
*     +---------------------------+---------------------------+
* 4A0 |         HXPFWFC           |///////////////////////////|
*     +---------------------------+---------------------------+
* 4A8 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 4B0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 600
*
*** Overlay for HXPCACH5 in HXPBK
          
*** Overlay for HXPCACH7 in HXPBK
*
*     +-------------------------------------------------------+
* 600 |                       HXPNRSAL                        |
*     +-------------------------------------------------------+
* 608 |                       HXPNRSLL                        |
*     +-------------------------------------------------------+
* 610 |                       HXPNRFAL                        |
*     +-------------------------------------------------------+
* 618 |                       HXPNRFLL                        |
*     +-------------------------------------------------------+
* 620 |                       HXPNWSAL                        |
*     +-------------------------------------------------------+
* 628 |                       HXPNWSLL                        |
*     +-------------------------------------------------------+
* 630 |                       HXPNWFAL                        |
*     +-------------------------------------------------------+
* 638 |                       HXPNWFLL                        |
*     +-------------------------------------------------------+
* 640 |                       HXPFRSAL                        |
*     +-------------------------------------------------------+
* 648 |                       HXPFRSLL                        |
*     +-------------------------------------------------------+
* 650 |                       HXPFRFAL                        |
*     +-------------------------------------------------------+
* 658 |                       HXPFRFLL                        |
*     +-------------------------------------------------------+
* 660 |                       HXPFWSAL                        |
*     +-------------------------------------------------------+
* 668 |                       HXPFWSLL                        |
*     +-------------------------------------------------------+
* 670 |                       HXPFWFAL                        |
*     +-------------------------------------------------------+
* 678 |                       HXPFWFLL                        |
*     +---------------------------+---------------------------+
* 680 |         HXPNRSCL          |         HXPNRFCL          |
*     +---------------------------+---------------------------+
* 688 |         HXPNWSCL          |         HXPNWFCL          |
*     +---------------------------+---------------------------+
* 690 |         HXPFRSCL          |         HXPFRFCL          |
*     +---------------------------+---------------------------+
* 698 |         HXPFWSCL          |         HXPFWFCL          |
*     +------+------+-------------+---------------------------+
* 6A0 |:FLAGC|:IFLAG|/////////////|///////////////////////////|
*     +------+------+-------------+///////////////////////////|
* 6A8 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 800
*
*** Overlay for HXPCACH7 in HXPBK
 
 
  HXPBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
HXPfrfA        0290
HXPfrfAL       0650
HXPfrfC        02A0
HXPfrfCL       0694
HXPfrfL        0298
HXPfrfLL       0658
HXPfrsA        0270
HXPfrsAL       0640
HXPfrsC        0280
HXPfrsCL       0690
HXPfrsL        0278
HXPfrsLL       0648
HXPfwfA        0490
HXPfwfAL       0670
HXPfwfC        04A0
HXPfwfCL       069C
HXPfwfL        0498
HXPfwfLL       0678
HXPfwsA        0470
HXPfwsAL       0660
HXPfwsC        0480
HXPfwsCL       0698
HXPfwsL        0478
HXPfwsLL       0668
HXPnrfA        0250
HXPnrfAL       0610
HXPnrfC        0260
HXPnrfCL       0684
HXPnrfL        0258
HXPnrfLL       0618
HXPnrsA        0230
HXPnrsAL       0600
HXPnrsC        0240
HXPnrsCL       0680
HXPnrsL        0238
HXPnrsLL       0608
HXPnwfA        0450
HXPnwfAL       0630
HXPnwfC        0460
HXPnwfCL       068C
HXPnwfL        0458
HXPnwfLL       0638
HXPnwsA        0430
HXPnwsAL       0620
HXPnwsC        0440
HXPnwsCL       0688
HXPnwsL        0438
HXPnwsLL       0628
HXPtask        0138
HXPACTFR       0160
HXPACTIV       0134 01
HXPBKEND       0800
HXPBSIZE       06A4 00000800
HXPCACH1       0000
HXPCACH2       0100
HXPCACH3       0200
HXPCACH4       0300
HXPCACH5       0400
HXPCACH6       0500
HXPCACH7       0600
HXPCACH8       0700
HXPCA1         00B8 00000044
HXPCA2         016C 00000090
HXPCA3         02A8 00000150
HXPCA5         04A8 00000150
HXPCA7         06A2 0000015C
HXPCPHPF       06A1 80
HXPCURQC       015C
HXPC1LCK       0100
HXPC2LCK       0200
HXPC3LCK       0400
HXPFCMD        06A0 20
HXPFIOR        0140
HXPFLAGC       06A0
HXPHPAV        06A0 80
HXPHPF         06A0 40
HXPIFLAG       06A1
HXPIORAC       0154
HXPIORAV       0158
HXPIORCU       014C
HXPIORMA       0150
HXPLIOR        0144
HXPMMBCK       00B8
HXPMMFLG       00B0
HXPMMFWD       00B4
HXPMMONQ       00B0 80
HXPNFEAT       0135 40
HXPNOHPF       0135
HXPNPROG       0135 80
HXPPAIOC       0168
HXPPHDBK       0000
HXPQADD        0134 02
HXPRDEV        016C
HXPRTYFT       0136
HXPRTYOT       0137
HXPSIZE        06A4 00000100
HXPSTATE       0134
HXPSTOPD       0134 FE
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:51:19 EDT.
Copyright IBM Corporation, 1990, 2022