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

 
  PF2PG Control Block Content Top of page
  




 PF2PG DSECT
Top of page


Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      PF2PG          PREFIX PAGE FOR ALL HOST CPU'S
0000    0 Dbl-Word     8 PF2HWLAP (56)  Reserved for H/W (LAP-protected)
01C0  448 Dbl-Word     8 PF2SOFTP (8)   Software area (LAP-Protected)
0200  512 Dbl-Word     8 PF2MACHN (320) Hardware area
0C00 3072 Dbl-Word     8 PF2SOFTW (128) Software area
      Prefix area page two - Hardware area (LAP-protected)
0000    0 Dbl-Word     8 * (54)         Unassigned hardware area
01B0  432 Address      8 PF2MCESA       Machine Check Extended Save Area
                                        real address (LAP-protected).
                                        Serialization is processor local
                                        or recovery processor in the case
                                        of a checkstop.
01B7  439 Bitstring    1 PF2MCELC       The Length Characteristic
                                        occupies bits 60-63 of PF2MCESA.
                                        Its value is a power of two
                                        indicating the size of the MCESA
                                        in bytes.
01B8  440 Signed       8 PF2PFTOK       Host page fault handshaking token
             Prefix area page two - Software area (LAP-protected)
01C0  448 Dbl-Word     8 * (8)          Reserved for IBM use
             Prefix area page two - Hardware area
0200  512 Dbl-Word     8 PF2FPRLG (16)  Floating-point Register logout
                                        area
0280  640 Dbl-Word     8 PF2GPRLG (16)  General-purpose Register logout
                                        area
0300  768 Bitstring   16 PF2FXLOG (0)   Fixed logout area
0300  768 Bitstring   16 PF2PSWLG       PSW logout area
0310  784 Signed       4 *              Reserved for hardware use
0314  788 Signed       4 *              Reserved for hardware use
0318  792 Signed       4 PF2PFXLG       Prefix Register logout area
031C  796 Signed       4 PF2FPCLG       Floating-point Control Register
                                        logout area
0320  800 Signed       4 *              Reserved for hardware use
0324  804 Signed       4 PF2TPRLG       TOD Clock Programmable Register
                                        logout area
0328  808 Dbl-Word     8 PF2CPTLG       CPU Timer logout area
0330  816 Bitstring    1 *              Reserved for hardware use
0331  817 Bitstring    7 PF2CKCLG       Clock Comparator 0:56 logout area
0338  824 Signed       4 *              Reserved for hardware use
033C  828 Signed       4 *              Reserved for hardware use
0340  832 Signed       4 PF2ARLG (16)   Access Register logout area
0380  896 Dbl-Word     8 PF2CRLG (16)   Control Register logout area
0400 1024 Dbl-Word     8 * (32)         Reserved for IBM use
0500 1280 Dbl-Word     8 * (32)         Reserved for IBM use
0600 1536 Dbl-Word     8 * (32)         Reserved for IBM use
0700 1792 Dbl-Word     8 * (32)         Reserved for IBM use
0800 2048 Dbl-Word     8 PF2PITDB (32)  Program-interruption TDB
0900 2304 Dbl-Word     8 * (32)         Reserved for IBM use
0A00 2560 Dbl-Word     8 * (32)         Reserved for IBM use
0B00 2816 Dbl-Word     8 * (32)         Reserved for IBM use
             Prefix area page two - Software area
0C00 3072 Dbl-Word     8 PF2COPYR (32)  IBM copyright
0D00 3328 Signed       4 PF2COPYE (0)   End of copyright area
0C00 3072 Character    8 PF2CPYRT       PID Order Number
0C08 3080 Character   30 *
0C26 3110 Character    4 *              Last Copyright Year
0C2A 3114 Character   40 *
0C52 3154 Character   42 *
0C7C 3196 Character   34 *
0C9E 3230 Character   10 *
      Transient information.  The following area is for extremely
      short term use.  Please document restrictions.
      Other than processor local, there is no serialization.
      - HCPPPGMS depends on a call to HCPSTKCP not affecting
        PF2SB0, PF2SB1.
0D00 3328 Address      8 PF2SB0         Sand Box 0
0D08 3336 Address      8 PF2SB1         Sand Box 1
0D10 3344 Address      8 PF2SB2         Sand Box 2
      Frame table scan pointers
0D18 3352 Address      8 PF2FTSRL       Host logical address of FRMTE
          PF2FTSRL       PF2FTXBL       00004 PF2FTSRL+L'PF2FTSRL,4 at
                                        which to resume scan for frames
                                        <2G, followed by host logical
                                        address of current FTXBK entry
                                        <2G.
0D24 3364 Address      4 *              Reserved for IBM use.
0D28 3368 Address      8 PF2FTSRA       Host logical address of FRMTE
          PF2FTSRA       PF2FTXBA       00004 PF2FTSRA+L'PF2FTSRA,4 at
                                        which to resume scan for frames
                                        <>2G, followed by host
                                        logical address of current FTXBK
                                        entry.
0D34 3380 Address      4 *              Reserved for IBM use
0D38 3384 Signed       4 *              Reserved for IBM use.
0D3C 3388 Signed       4 *              Reserved for IBM use.
      Per-processor TSGET statistics area
      These fields are only adjusted when a TSGET (must have)
      request fails to obtain the lock immediately.
0D40 3392 Dbl-Word     8 PF2TSGTM       Total elapsed wall-clock time
                                        consumed by TSGET requests
0D48 3400 Signed       4 PF2TSCNT       Count of TSGET requests
0D4C 3404 Signed       4 PF2TSCAD       Count of CAD instructions
                                        executed during TSGET requests
      Formal lock CAD count - the total of all CAD instructions
      executed while obtaining a formal spin lock.
0D50 3408 Dbl-Word     8 PF2CADCT       Total CAD instruction count for
                                        all HCPSYN spin locks
      Counters for the prorated core time calculation
      These counters are extracted for the prorated core time
      calculation when Multithreading is enabled and the
      running core has more than one activated thread.
      The C1 counter field PF2DSPC1 is also reused for storing
      prorated conversion factor.
0D58 3416 Dbl-Word     8 PF2DSPC1       Cycle count with one thread
                                        active extracted at user dispatch
                                        or un-dispatch
0D58 3416 Dbl-Word     8 PF2PROCF       Prorated conversion factor
0D60 3424 Dbl-Word     8 PF2DSPC2       Cycle count with two threads
                                        active extracted at user dispatch
                                        or un-dispatch
      Host logical address of Machine Check Extended Save Area
0D68 3432 Signed       4 PF2MCLSA       Mach Check Ext Save Area Log Addr
      Frame request management area.
0D6C 3436 Address      4 PF2AvlBF       First <2G AVLBK scanned for
                                        this request.
0D70 3440 Address      4 PF2AvlBN       Next <2G AVLBK from which to
                                        satisfy the next request
0D74 3444 Address      4 PF2AvlAF       First >2G AVLBK scanned for
                                        this request.
0D78 3448 Address      4 PF2AvlAN       Next >2G AVLBK from which to
                                        satisfy the next request
0D7C 3452 Signed       4 *              Reserved for IBM use
      Wait time info for STHYI and Monitor reporting
      accuracy. Both fields must be in the same quadword
      and updated with STPQ or CDSG. They get updated
      whenever the processor enters or exits wait state.
0D80 3456 Signed       8 PF2WTTOD       TOD at entry to wait. 0
                                        otherwise.
0D88 3464 Bitstring    8 PF2TOTWT       PFXTOTWT copy for STHYI.
      Reserved for IBM use
0D90 3472 Dbl-Word     8 * (14)         Reserved for IBM use
      Define space for the AR saveareas pointed to by the PFX
      saveareas.  Each should be wholly within a cache line,
      which we will accomplish (any other technique could have
      been chosen) by aligning the first on a cache boundary.
0E00 3584 Signed       4 PF2TMPAR (16)
0E40 3648 Signed       4 PF2WRKAR (16)
0E80 3712 Signed       4 PF2BALAR (16)
0EC0 3776 Signed       4 PF2PTRAR (16)
0F00 3840 Signed       4 PF2FREAR (16)
0F40 3904 Dbl-Word     8 * (22)         Reserved for IBM use
0FEC 4076 Address      4 PF2ISTRD       RAMdisk constants address
      WARNING - The following field must not be moved from this
                location.  Internal tools depend on it being in a
                fixed place in the PF2PG.
0FF0 4080 Signed       8 PF2CPUST       Time CPU Started
      WARNING - The following field is used by the VM Dump Tool
                to determine displacements of significant fields
                in control blocks in the dump.  Because the VM
                Dump Tool depends on this address being in a
                fixed place in the PF2PG, it must not be moved
                from this location.  Thus the CKMAINT to check it.
0FF8 4088 Address      4 PF2VMDT        Addr of Displacement Table
          00001000       PF2PGLEN       (*-PF2PG) Size of PF2PG in bytes
             The following macro invocation ensures the length of
             the PF2PG is exactly 4096 bytes (one 4K page).
 
 
  PF2PG Storage Layout Top of page
  
          
*** PF2PG - PREFIX PAGE FOR ALL HOST CPU'S
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       PF2HWLAP                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 1C0 |                                                       |
*     =                       PF2SOFTP                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 200 |                                                       |
*     =                       PF2MACHN                        =
*     |                                                       |
*     +-------------------------------------------------------+
* C00 |                                                       |
*     =                       PF2SOFTW                        =
*     |                                                       |
*     +-------------------------------------------------------+
*1000
*
*** PF2PG - PREFIX PAGE FOR ALL HOST CPU'S
          
*** Overlay for PF2HWLAP in PF2PG
*
*     +-------------------------------------------------------+
*   0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 1B0 |                       PF2MCESA                        |
*     +-------------------------------------------------------+
* 1B8
*
*** Overlay for PF2HWLAP in PF2PG
          
*** Overlay for PF2MCESA+7 in PF2PG
*
*                                                      +------+
* 1B0 ...                                          1B7 |:MCELC|
*     +------------------------------------------------+------+
* 1B8 |                       PF2PFTOK                        |
*     +-------------------------------------------------------+
* 1C0
*
*** Overlay for PF2MCESA+7 in PF2PG
          
*** Overlay for PF2SOFTP in PF2PG
*
*     +-------------------------------------------------------+
* 1C0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 200
*
*** Overlay for PF2SOFTP in PF2PG
          
*** Overlay for PF2MACHN in PF2PG
*
*     +-------------------------------------------------------+
* 200 |                                                       |
*     =                       PF2FPRLG                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 280 |                                                       |
*     =                       PF2GPRLG                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 300 |                       PF2PSWLG                        |
*     |                                                       |
*     +---------------------------+---------------------------+
* 310 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
* 318 |         PF2PFXLG          |         PF2FPCLG          |
*     +---------------------------+---------------------------+
* 320 |///////////////////////////|         PF2TPRLG          |
*     +---------------------------+---------------------------+
* 328 |                       PF2CPTLG                        |
*     +------+------------------------------------------------+
* 330 |//////|                   PF2CKCLG                     |
*     +------+--------------------+---------------------------+
* 338 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
* 340 |                                                       |
*     =                       PF2ARLG                         =
*     |                                                       |
*     +-------------------------------------------------------+
* 380 |                                                       |
*     =                       PF2CRLG                         =
*     |                                                       |
*     +-------------------------------------------------------+
* 400 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 500 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 600 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 700 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 800 |                                                       |
*     =                       PF2PITDB                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 900 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* A00 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* B00 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* C00
*
*** Overlay for PF2MACHN in PF2PG
          
*** Overlay for PF2SOFTW in PF2PG
*
*     +-------------------------------------------------------+
* C00 |                                                       |
*     =                       PF2COPYR                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** Overlay for PF2SOFTW in PF2PG
          
*** Overlay for PF2COPYR in PF2PG
*
*     +-------------------------------------------------------+
* C00 |                       PF2CPYRT                        |
*     +-------------------------------------------------------+
* C08 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |/////////////////////////////////////////+-------------+
*     |/////////////////////////////////////////|/////////////|
*     +-------------+---------------------------+-------------+
* C28 |/////////////|/////////////////////////////////////////|
*     +-------------+/////////////////////////////////////////|
* C30 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |/////////////+-----------------------------------------+
*     |/////////////|/////////////////////////////////////////|
*     +-------------+/////////////////////////////////////////|
* C58 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////+---------------------------+
*     |///////////////////////////|///////////////////////////|
*     +---------------------------+///////////////////////////|
* C80 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |/////////////////////////////////////////+-------------+
* C98 |/////////////////////////////////////////|/////////////|
*     +-----------------------------------------+/////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* CA8
*
*** Overlay for PF2COPYR in PF2PG
          
*** Overlay for PF2COPYE in PF2PG
*
*     +-------------------------------------------------------+
* D00 |                        PF2SB0                         |
*     +-------------------------------------------------------+
* D08 |                        PF2SB1                         |
*     +-------------------------------------------------------+
* D10 |                        PF2SB2                         |
*     +-------------------------------------------------------+
* D18 |                       PF2FTSRL                        |
*     +---------------------------+---------------------------+
* D20 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
* D28 |                       PF2FTSRA                        |
*     +---------------------------+---------------------------+
* D30 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
* D38 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
* D40 |                       PF2TSGTM                        |
*     +---------------------------+---------------------------+
* D48 |         PF2TSCNT          |         PF2TSCAD          |
*     +---------------------------+---------------------------+
* D50 |                       PF2CADCT                        |
*     +-------------------------------------------------------+
* D58 |                       PF2DSPC1                        |
*     +-------------------------------------------------------+
* D60
*
*** Overlay for PF2COPYE in PF2PG
          
*** Overlay for PF2DSPC1 in PF2PG
*
*     +-------------------------------------------------------+
* D58 |                       PF2PROCF                        |
*     +-------------------------------------------------------+
* D60 |                       PF2DSPC2                        |
*     +---------------------------+---------------------------+
* D68 |         PF2MCLSA          |         PF2AVLBF          |
*     +---------------------------+---------------------------+
* D70 |         PF2AVLBN          |         PF2AVLAF          |
*     +---------------------------+---------------------------+
* D78 |         PF2AVLAN          |///////////////////////////|
*     +---------------------------+---------------------------+
* D80 |                       PF2WTTOD                        |
*     +-------------------------------------------------------+
* D88 |                       PF2TOTWT                        |
*     +-------------------------------------------------------+
* D90 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* E00 |                                                       |
*     =                       PF2TMPAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* E40 |                                                       |
*     =                       PF2WRKAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* E80 |                                                       |
*     =                       PF2BALAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* EC0 |                                                       |
*     =                       PF2PTRAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* F00 |                                                       |
*     =                       PF2FREAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* F40 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* FF0
*
*** Overlay for PF2DSPC1 in PF2PG
          
*** Overlay for *-4 in PF2PG
*
*                                 +---------------------------+
* FE8 ...                     FEC |         PF2ISTRD          |
*     +---------------------------+---------------------------+
* FF0 |                       PF2CPUST                        |
*     +---------------------------+---------------------------+
* FF8 |         PF2VMDT           | FFC
*     +---------------------------+
*
*** Overlay for *-4 in PF2PG
 
 
  PF2PG Cross Reference Top of page
  
 
Symbol         Dspl Value
-------------- ---- -----
PF2AvlAF       0D74
PF2AvlAN       0D78
PF2AvlBF       0D6C
PF2AvlBN       0D70
PF2ARLG        0340
PF2BALAR       0E80
PF2CADCT       0D50
PF2CKCLG       0331
PF2COPYE       0D00
PF2COPYR       0C00
PF2CPTLG       0328
PF2CPUST       0FF0
PF2CPYRT       0C00
PF2CRLG        0380
PF2DSPC1       0D58
PF2DSPC2       0D60
PF2FPCLG       031C
PF2FPRLG       0200
PF2FREAR       0F00
PF2FTSRA       0D28
PF2FTSRL       0D18
PF2FTXBA       0D28 PF2FTSRA
PF2FTXBL       0D18 PF2FTSRL
PF2FXLOG       0300
PF2GPRLG       0280
PF2HWLAP       0000
PF2ISTRD       0FEC
PF2MACHN       0200
PF2MCELC       01B7
PF2MCESA       01B0
PF2MCLSA       0D68
PF2PFTOK       01B8
PF2PFXLG       0318
PF2PGLEN       0FF8 00001000
PF2PITDB       0800
PF2PROCF       0D58
PF2PSWLG       0300
PF2PTRAR       0EC0
PF2SB0         0D00
PF2SB1         0D08
PF2SB2         0D10
PF2SOFTP       01C0
PF2SOFTW       0C00
PF2TMPAR       0E00
PF2TOTWT       0D88
PF2TPRLG       0324
PF2TSCAD       0D4C
PF2TSCNT       0D48
PF2TSGTM       0D40
PF2VMDT        0FF8
PF2WRKAR       0E40
PF2WTTOD       0D80
 
This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:31:58 EDT.
Copyright IBM Corporation, 1990, 2020