Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### PPIBK

Prolog

Control Block Contents
PPIBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### PPIBK Prolog

     NAME       : HCPPPIBK
     DESCRIPTION: PAG/PAH INTERFACE BLOCK
     DSECT      : PPIBK
     FUNCTION   : THE PAG/PAH INTERFACE BLOCK REDEFINES THE
                  WORK AREA USED TO PASS INFORMATION BETWEEN
                  MODULE HCPPAG AND HCPPAH.
                  THIS SET OF EQUATES IS USED TO GIVE MORE
                  MEANINGFUL NAMES TO THE DATA THAT IS SHARED
                  BY THE TWO MODULES.
     LOCATED BY : NOT APPLICABLE
                  THIS COPY FILE IS NOT A DSECT,
                  AND CONSISTS ONLY OF COMMENTS
                  AND ASSEMBLER EQUATE (EQU)
                  STATEMENTS.
     CREATED BY : NOT APPLICABLE
     DELETED BY : NOT APPLICABLE
     Comments   :
                        PPIBK/SVGBK mapping:
                     PPIBK                      SVGBK
           +-----+-----+-----+-----+  +-----+-----+-----+-----+
     x'00' |FWDPT|BCKPT|-----|-----|  |FPNT |BPNT |-----|-----|
           +-----+-----+-----+-----+  +-----+-----+-----+-----+
     x'10' |*-*--|-----|-----|-----|  |*-*--|-----|-----|-----|
           +-----+-----+-----+-----+  +-----+-----+-----+-----+
     x'20' |    R0     |    R1     |  |   SVGR0   |   SVGR1   |
           +-----------+-----------+  +-----------+-----------+
     x'30' |    R2     |    R3     |  |   SVGR2   |   SVGR3   |
           +-----------+-----------+  +-----------+-----------+
     x'40' |    R4     |    R5     |  |   SVGR4   |   SVGR5   |
           +-----------+-----------+  +-----------+-----------+
     x'50' |    R6     |    R7     |  |   SVGR6   |   SVGR7   |
           +-----------+-----------+  +-----------+-----------+
     x'60' |    R8     |    R9     |  |   SVGR8   |   SVGR9   |
           +-----------+-----------+  +-----------+-----------+
     x'70' |    R10    |    R11    |  |   SVGR10  |   SVGR11  |
           +-----------+-----------+  +-----------+-----------+
     x'80' |    R12    |    R13    |  |   SVGR12  |   SVGR13  |
           +-----------+-----------+  +-----------+-----------+
     x'90' |    R14    | R15=RCODE |  |   SVGR14  |   SVGR15  |
           +-----------+-----------+  +-----------+-----------+
     x'A0' |///////////////////////|  |///////////////////////|
           +-----+-----+-----------+  +-----------+-----------+
     x'B0' |>>>>>|CCPV |FGx//|/////|  |  SVGWRK0  |  SVGWRK1  |
           +-----+-----+-----+-----+  +-----------+-----------+
     x'C0' |    FRM@   |  FRMTE@   |  |  SVGWRK2  |  SVGWRK3  |
           +-----+-----+-----+-----+  +-----------+-----------+
     x'D0' |    PTE@   | CCHH|R//RR|  |  SVGWRK4  |  SVGWRK5  |
           +-----+-----+-----+-----+  +-----------+-----------+
     x'E0' |   FRMEQ   |/////|MEXBK|  |  SVGWRK6  |  SVGWRK7  |
           +-----+-----+-----+-----+  +-----------+-----------+
     x'F0' |   FRMQG   |/////|SCCHH|  |  SVGWRK8  |  SVGWRK9  |
           +-----+-----+-----+-----+  +-----------+-----------+
            * Bytes SVGSCHC and SVGFORM (and the flag bits
              defined in them) are referred to by their SVGBK
              names, and are not redefined in the PPIBK.
     For FBA devices, the following mapping is used for the
     last part of the SVGBK.
     x'D0' |>>>>>|PTE@ |/////|BLOCK|  |  SVGWRK4  |  SVGWRK5  |
           +-----+-----+-----+-----+  +-----------+-----------+
     x'E0' |   FRMEQ   |/////|MEXBK|  |  SVGWRK6  |  SVGWRK7  |
           +-----+-----+-----+-----+  +-----------+-----------+
     x'F0' |   FRMQG   |?????|SCCP/|  |  SVGWRK8  |  SVGWRK9  |
           +-----+-----+-----+-----+  +-----------+-----------+
     Note that any of the fields marked with '/' are available
     for use.  Fields marked '-' are part of the SVGBK header,
     and are available for use while in use as a PPIBK, but may
     need to be set/restored to proper SVGBK values before use
     as an actual SVGBK.
     Fields marked with ">>>>>" are reserved for possible
     expansion to 64 bits of the fields to the immediate right.
     Notes      :
     Since this b ock redefines the SVGBK, the assemble
     statement 'H PUSING SVGBK,RX' must precede the use of any
     ppibk fields

#### PPIBK Control Block Content

#### PPIBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      PPIBK          PAG/PAH INTERFACE BLOCK
              00000000       PPIFWDPT       SVGFPNT Forward pointer
              00000004       PPIBCKPT       SVGBPNT Backward pointer
              0000009C       PPIRCODE       SVGR15LO Return code from I/O
                                            operation
              000000B4       PPICCPV        SVGWRK0L The CCPV, PPPV, or PRBN
              000000B8       PPIPGFG0       SVGWRK1,1 Flag byte for HCPPAG
              000000B9       PPIPGFG1       SVGWRK1+1,1 2nd flag byte for
                                            HCPPAG
              000000C0       PPIFRM@G       SVGWRK2 64 bit host absolute
                                            address of frame from which the
                                            page is to be written or to which
                                            the page is to be read
              000000C8       PPIFTE@G       SVGWRK3 64-bit host logical
                                            address of the FRMTE for the
                                            PPIFRM@G frame
              000000D0       PPIPTE@G       SVGWRK4 64-bit host absolute
                                            address of PTE for page
                                            associated with the PPIFRM@G
                                            frame (page to be written out or
                                            read in)
              000000D8       PPICCHHR       SVGWRK5,5 Represents CC, HH, and
                                            R for the Locate Record Search
                                            argument
              000000D8       PPICCHH        SVGWRK5 Represents both CC and HH
                                            for the Locate Record Seek
                                            argument
              000000D8       PPICC          SVGWRK5,2 Represents the cylinder
                                            number
              000000DA       PPIHH          SVGWRK5+2,2 Represents the head
                                            number
              000000DC       PPIREC         SVGWRK5L,1 Represents the record
                                            number
              000000DF       PPIRLREC       SVGWRK5L+3,1 Relative record
                                            number of track
              000000E0       PPIFRMEQ       SVGWRK6 64 bit host logical
                                            address of the last FRMTE on
                                            PPIFRMQG.
              000000F0       PPIFRMQG       SVGWRK8 64 bit host logical
                                            address of the first FRMTE in a
                                            chain (FRMFPNTG) that has been
                                            deferred.
              000000FC       PPISCCHH       SVGWRK9L Seek CCHH cylinder and
                                            head number
              000000FC       PPISCC         SVGWRK9L,2 Represents seek's
                                            cylinder number
              000000FE       PPISHH         SVGWRK9L+2,2 Represents seek's
                                            head number
           The following equates are used when the paging operation
           is being done for an FBA device.
              000000DC       PPIBLOCK       SVGWRK5L Starting block number
              000000FC       PPIFCCP        SVGWRK9L,3 CCP corresponding to
                                            block number
              000000FC       PPIFCC         SVGWRK9L,2 CC corresponding to
                                            block number
              000000FE       PPIFP          SVGWRK9L+2,1 P corresponding to
                                            block number
            These bits are used inthe PPIBK for flag PPIPGFG0 in
          modules HCPPAG and HCPPAH.
              .... ...1      PPISGWRT       X'01' Indicates single write
                                            operation
              .... ..1.      PPIMUWRT       X'02' Indicates multiple write
                                            operation
              .... .1..      PPISNGRD       X'04' Indicates single read
                                            operation.
              .... 1...      PPIMULRD       X'08' Indicates multiple read
                                            operation.
              ...1 ....      PPIORGSV       X'10' Indicates original savearea
              ..1. ....      PPISPLSL       X'20' Indicates a spooling slot
              .1.. ....      PPIMRDRV       X'40' Indicates multi operation
                                            redrive
              1... ....      PPIMPRBN       X'80' Indicates a minidisk-pool
                                            PRBN.
            These bits are used inthe PPIBK for flag PPIPGFG1 in
          module HCPPAG.
              .... ...1      PPINPRBN       X'01' Indicates invalid PRBN
              .... ..1.      PPI2NDPG       X'02' Indicates the FRMTE is for
                                            the 2nd page of a pageable PGMBK

#### PPIBK Storage Layout

    *** PPIBK - PAG/PAH INTERFACE BLOCK
    *
    *
    *** PPIBK - PAG/PAH INTERFACE BLOCK

#### PPIBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    PPIBCKPT       0000 00000004
    PPIBLOCK       0000 000000DC
    PPICC          0000 000000D8
    PPICCHH        0000 000000D8
    PPICCHHR       0000 000000D8
    PPICCPV        0000 000000B4
    PPIFCC         0000 000000FC
    PPIFCCP        0000 000000FC
    PPIFP          0000 000000FE
    PPIFRM@G       0000 000000C0
    PPIFRMEQ       0000 000000E0
    PPIFRMQG       0000 000000F0
    PPIFTE@G       0000 000000C8
    PPIFWDPT       0000 00000000
    PPIHH          0000 000000DA
    PPIMPRBN       0000 80
    PPIMRDRV       0000 40
    PPIMULRD       0000 08
    PPIMUWRT       0000 02
    PPINPRBN       0000 01
    PPIORGSV       0000 10
    PPIPGFG0       0000 000000B8
    PPIPGFG1       0000 000000B9
    PPIPTE@G       0000 000000D0
    PPIRCODE       0000 0000009C
    PPIREC         0000 000000DC
    PPIRLREC       0000 000000DF
    PPISCC         0000 000000FC
    PPISCCHH       0000 000000FC
    PPISGWRT       0000 01
    PPISHH         0000 000000FE
    PPISNGRD       0000 04
    PPISPLSL       0000 20
    PPI2NDPG       0000 02

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:58:07 EDT.
Copyright IBM Corporation, 1990, 2008