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 Dbl-Word     8 PF2BEALG       Breaking-Event-Address Register
                                        logout area. Stored when the BEAR
                                        Enhancement facility is
                                        installed.
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 PF2CCD         Cryptography-Counter Designation
0508 1288 Dbl-Word     8 PF2AI1D        Activity-Instrumentation-Control
                                        Designation
0510 1296 Dbl-Word     8 * (30)         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 PF2AvSRL       Host logical address of FRMTE
          PF2AvSRL       PF2AvXBL       00004 PF2AvSRL+L'PF2AvSRL,4 at
                                        which to resume scan for frames
                                        <2G, followed by host logical
                                        address of current AvlZn entry
                                        <2G.
0D24 3364 Address      4 *              Reserved for IBM use.
0D28 3368 Address      8 PF2AvSRA       Host logical address of FRMTE
          PF2AvSRA       PF2AvXBA       00004 PF2AvSRA+L'PF2AvSRA,4 at
                                        which to resume scan for frames
                                        <>2G, followed by host
                                        logical address of current AvlZn
                                        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
0D6C 3436 Signed       4 *              Reserved for IBM use
0D70 3440 Address      8 PF2ESXSs       HLA of ESXS start
0D78 3448 Address      8 PF2ESXSe       HLA of ESXS end
      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.
      Per Processor footprint for determining the progress of
      a processor going through unpark processing. This footprint
      is set in HCPSGRSP by the processor controlling unpark
      and from the processor represented by this PF2PG as it
      progresses through unpark processing. This field is
      serialized by interlocked update instructions.
0D90 3472 Bitstring    1 PF2UNPST       marker of where this processor is
                                        in unpark processing
          .... ...1      PF2MIDS1       X'01' processor is in the middle
                                        of stage 1 unpark.
          .... ..1.      PF2ENDS1       X'02' processor is at the end of
                                        stage 1 unpark.
          .... .1..      PF2CLRS2       X'04' processor is clear to start
                                        stage 2 unpark.
          .... 1...      PF2MIDS2       X'08' processor is in the middle
                                        of stage 2 unpark.
          ...1 ....      PF2ENDS2       X'10' processor is at the end of
                                        stage 2 unpark.
0D91 3473 Bitstring    3 *              Reserved for IBM use
      Reserved for IBM use
0D94 3476 Signed       4 *              Reserved for IBM use
0D98 3480 Dbl-Word     8 PF2PRGBR       Program interruption BEA
0DA0 3488 Dbl-Word     8 PF2SVCBR       SVC BEA
0DA8 3496 Dbl-Word     8 PF2BEASV       BEA savearea used in HCPSVF and
                                        HCPWRP
0DB0 3504 Dbl-Word     8 * (10)         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)
      Define space to support the ELF64 C environment.
0F40 3904 Address      8 PF2ELFFS       Pointer to cached ELF64 C stack
0F48 3912 Address      8 PF2ELFSH       Pointer to stack header of
                                        currently used stack
0F50 3920 Dbl-Word     8 * (19)         Reserved for IBM use
0FE8 4072 Address      4 *              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 |                       PF2BEALG                        |
*     +-------------------------------------------------------+
* 340 |                                                       |
*     =                       PF2ARLG                         =
*     |                                                       |
*     +-------------------------------------------------------+
* 380 |                                                       |
*     =                       PF2CRLG                         =
*     |                                                       |
*     +-------------------------------------------------------+
* 400 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 500 |                        PF2CCD                         |
*     +-------------------------------------------------------+
* 508 |                       PF2AI1D                         |
*     +-------------------------------------------------------+
* 510 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 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 |                       PF2AVSRL                        |
*     +---------------------------+---------------------------+
* D20 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
* D28 |                       PF2AVSRA                        |
*     +---------------------------+---------------------------+
* 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          |///////////////////////////|
*     +---------------------------+---------------------------+
* D70 |                       PF2ESXSS                        |
*     +-------------------------------------------------------+
* D78 |                       PF2ESXSE                        |
*     +-------------------------------------------------------+
* D80 |                       PF2WTTOD                        |
*     +-------------------------------------------------------+
* D88 |                       PF2TOTWT                        |
*     +------+--------------------+---------------------------+
* D90 |:UNPST|////////////////////|///////////////////////////|
*     +------+--------------------+---------------------------+
* D98 |                       PF2PRGBR                        |
*     +-------------------------------------------------------+
* DA0 |                       PF2SVCBR                        |
*     +-------------------------------------------------------+
* DA8 |                       PF2BEASV                        |
*     +-------------------------------------------------------+
* DB0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* E00 |                                                       |
*     =                       PF2TMPAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* E40 |                                                       |
*     =                       PF2WRKAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* E80 |                                                       |
*     =                       PF2BALAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* EC0 |                                                       |
*     =                       PF2PTRAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* F00 |                                                       |
*     =                       PF2FREAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* F40 |                       PF2ELFFS                        |
*     +-------------------------------------------------------+
* F48 |                       PF2ELFSH                        |
*     +-------------------------------------------------------+
* F50 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
* FE8 |///////////////////////////|         PF2ISTRD          |
*     +---------------------------+---------------------------+
* FF0 |                       PF2CPUST                        |
*     +---------------------------+---------------------------+
* FF8 |         PF2VMDT           | FFC
*     +---------------------------+
*
*** Overlay for PF2DSPC1 in PF2PG
 
 
  PF2PG Cross Reference Top of page
  
 
Symbol         Dspl Value
-------------- ---- -----
PF2AvSRA       0D28
PF2AvSRL       0D18
PF2AvXBA       0D28 PF2AvSRA
PF2AvXBL       0D18 PF2AvSRL
PF2AI1D        0508
PF2ARLG        0340
PF2BALAR       0E80
PF2BEALG       0338
PF2BEASV       0DA8
PF2CADCT       0D50
PF2CCD         0500
PF2CKCLG       0331
PF2CLRS2       0D90 04
PF2COPYE       0D00
PF2COPYR       0C00
PF2CPTLG       0328
PF2CPUST       0FF0
PF2CPYRT       0C00
PF2CRLG        0380
PF2DSPC1       0D58
PF2DSPC2       0D60
PF2ELFFS       0F40
PF2ELFSH       0F48
PF2ENDS1       0D90 02
PF2ENDS2       0D90 10
PF2ESXSe       0D78
PF2ESXSs       0D70
PF2FPCLG       031C
PF2FPRLG       0200
PF2FREAR       0F00
PF2FXLOG       0300
PF2GPRLG       0280
PF2HWLAP       0000
PF2ISTRD       0FEC
PF2MACHN       0200
PF2MCELC       01B7
PF2MCESA       01B0
PF2MCLSA       0D68
PF2MIDS1       0D90 01
PF2MIDS2       0D90 08
PF2PFTOK       01B8
PF2PFXLG       0318
PF2PGLEN       0FF8 00001000
PF2PITDB       0800
PF2PRGBR       0D98
PF2PROCF       0D58
PF2PSWLG       0300
PF2PTRAR       0EC0
PF2SB0         0D00
PF2SB1         0D08
PF2SB2         0D10
PF2SOFTP       01C0
PF2SOFTW       0C00
PF2SVCBR       0DA0
PF2TMPAR       0E00
PF2TOTWT       0D88
PF2TPRLG       0324
PF2TSCAD       0D4C
PF2TSCNT       0D48
PF2TSGTM       0D40
PF2UNPST       0D90
PF2VMDT        0FF8
PF2WRKAR       0E40
PF2WTTOD       0D80
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:58:17 EDT.
Copyright IBM Corporation, 1990, 2022