Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
PPIBK
Control Block Contents
PPIBK DSECT
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
Copyright IBM Corporation, 1990, 2008