PFTE mapping

Table 1. Structure PFTE
Offset
Dec
Offset
Hex
Type Len Name(Dim) Description
0 (0) STRUCTURE 32 PFTE  
0 (0) ADDRESS 4  PFTFQPTR FORWARD PFTE QUEUE POINTER
4 (4) ADDRESS 4  PFTBQPTR BACKWARD PFTE QUEUE POINTER
8 (8) CHARACTER 1  PFTQID QUEUE ID FOR CURRENT QUEUE UNLESS THE PFTE IS ON AN AVAILABLE FRAME QUEUE---- 08=>TOP-DOUBLE-FRAME-QUEUE 09=>BOTTOM-DOUBLE-FRAME-QUEUE 21=>SQA-FRAME-QUEUE 22=>RESERVED-SQA-FRAME-QUEUE 23=>REAL-STG-BUF-FRAME-QUEUE 24=>V=R-WAITING-FRAME-QUEUE 25=>General Defer Frame Queue 40=>SHARED-PAGE-FIXED-FR-QUEUE 41=>SHARED-PAGE-PAGEABLE-FR-QU EUE 81=>PAGEABLE-FRAME-QUEUE 82=>FIXED-FRAME-QUEUE 83=>DEFERRED-FREEMAIN-FR-QUEUE A1=>PAGEABLE-DATA-SPACE-FR-QUE A2=>FIXED-DATA-SPACE-FR-QUEUE A3=>DEFERRED-DELETE-FR-QUEUE E0=>PAGEABLE-RDD-FRAME-QUEUE E1=>FIXED-RDD-FRAME-QUEUE E2=>ORPHAN-FRAME-QUEUE F0=>UNQUEUED..DAT-OFF-NUCLEUS F1=>UNQUEUED..READ-ONLY-NUC. F2=>UNQUEUED..READ/WRITE-NUC. F3=>UNQUEUED..RSMDATA FRAME F4=>UNQUEUED..HW-SYSTEM-AREA F5=>UNQUEUED..ABS.-ZERO-FRAME F6=>UNQUEUED..FIXED-LPA/BLDL FD=>A-FLAWED-PFTE FE=>UNQUEUED..UNINITIALIZED FF=>UNQUEUED-PFTE
9 (9) UNSIGNED 1  PFTUIC NUMBER OF UPDATE INTERVALS DURING WHICH FRAME WAS NOT REFERENCED
10 (A) BITSTRING 1  PFTFLGS2 FLAG BYTE 2 (ALLOCATION FLAGS)
      1... ....   PFTONAFQ PFTE IS ON AN AFQ
      .1.. ....   PFTPERM FRAME IS BACKING PERMANENT STG
      ..1. ....   PFTOFFLN FRAME IS OFF-LINE
      ...1 ....   * RESERVED
      .... 1...   PFTVRWT FRAME IS WAITING FOR V=R ALLOC.
      .... .1..   PFTVRALC FRAME IS ALLOCATED TO V=R
      .... ..1.   PFTDREF FRAME IS BACKING A DREF PAGE
      .... ...1   PFTDSPPG FRAME IS BACKING A DATA SPACE PAGE
11 (B) BITSTRING 1  PFTFLGS3 FLAG BYTE 3 (MISC. FLAGS)
      1... ....   PFTIOCUR I/O IS CURRENT FOR THIS FRAME
      .1.. ....   PFTVRPLT THIS FRAME IS CURRENTLY POLLUTING THE V=R AREA
      ..1. ....   PFTVIORU THIS FRAME IS VIO REUSABLE
      ...1 ....   PFTVRINT FRAME IS V=R INTERCEPTED
      .... 1...   PFTOFINT FRAME IS OFFLINE INTERCEPTED
      .... .1..   PFTNOREC INTERCEPTED FRAME SUMMARY BIT- THIS FRAME HAS BEEN INTERCEPTED AND SHOULD NOT BE TAKEN UNLESS IT IS SENT TO AN AVAILABLE FRAME QUEUE. ALSO, THE PAGE ASSOCIATED WITH THE FRAME CANNOT BE REVALIDATED WITH A DIFFERENT FRAME IF A REQUEST FOR THE PAGE IS CURRENTLY ON THE DPQ.
      .... ..1.   PFTIOMC I/O FOR THIS FRAME MUST COMPLETE INTACT. NEITHER THE FRAME NOR THE DATA MAY BE USED UNTIL THE I/O HAS COMPLETED.
      .... ...1   PFTNOPRF FRAME SHOULD NOT BE STOLEN BY GETFRAME PREF STEAL
12 (C) CHARACTER 4  PFTFCWRD FIX COUNT WORD. SERIALIZED BY COMPARE AND SWAP. NOTE: PFTFXCT MUST ALWAYS BE THE LOW ORDER HALFWORD OF THIS FIELD FOR ?INC/DECFXCT TO WORK.
12 (C) CHARACTER 1   PFTFREID ID OF QUEUE TO WHICH THIS PFTE IS TO BE RETURNED WHEN FREED-- 01=>PREFERRED-ABOVE-AFQ 02=>NON-PREFERRED-ABOVE-AFQ 03=>PREFERRED-BELOW-AFQ 04=>NON-PREFERRED-BELOW-AFQ 08=>TOP-DOUBLE-FRAME-QUEUE 09=>BOTTOM-DOUBLE-FRAME-QUEUE FF=>NON-FREEABLE-PFTE
13 (D) BITSTRING 1   PFTFLGS1 FLAG BYTE 1 (PHYSICAL FLAGS). SINCE PFTFCWRD IS DECLARED ABNL, PL/AS WILL GENERATE COMPARE AND SWAP INSTRUCTIONS WHEN UPDATING THESE FLAGS.
      1... ....    PFTPREF PFTE IS FOR PREFERRED AREA
      .1.. ....    PFTBELOW PFTE IS FOR REAL BELOW 16M
      ..1. ....    PFTVR PFTE IS A V=R CANDIDATE
      ...1 1...    * RESERVED
      .... .1..    PFTSRBSC SRB HAS BEEN SCHEDULED TO DO FRAME DEALLOCATION.
      .... ..1.    PFTNOUNC NO UNCORRECTABLE ERRORS HAVE OCCURRED WITHIN THE FRAME. THIS BIT IS MEANINGFUL ONLY WHEN PFTBADFR=1.
      .... ...1    PFTBADFR BAD FRAME - DO NOT REALLOCATE
14 (E) SIGNED 2   PFTFXCT FIX COUNT FOR THIS FRAME
16 (10) CHARACTER 4  PFTSER PFTE SERIALIZATION WORD
16 (10) BITSTRING 2   PFTSERFL Flags portion of PftSer
      1... ....    PFTRDS THIS PFTE IS SERIALIZED BY AN RSMDS LOCK
      .1.. ....    PFTSPAGE THIS PFTE IS IN USE FOR A SHARED PAGE AND IS SERIALIZED BY THE RSMAD/XM/CM/ST LOCK OF COMMON. PFTSDH CONTAINS THE ADDRESS OF THE SDH FOR THE SHARED PAGE GROUP
      ..1. ....    PFTLSQA FRAME IS BACKING SQA OR LSQA
      ...1 ....    PFTMEGAROOED Shared Segment page
      .... 1111    * RESERVED
17 (11) BITSTRING 1    PFTRVTEX THE RVTE INDEX IF PFTRDS=1
18 (12) BITSTRING 2   PFTASID ASID OF CURRENT OR LAST OWNER
20 (14) ADDRESS 4  PFTVSA VIRTUAL ADDRESS CURRENTLY OR LAST BACKED BY THIS FRAME
20 (14) UNSIGNED 4   PFTVIORA VIO DATA SET PAGE REUSE ARGUMENT - VALID IF PFTVIORU=1
20 (14) ADDRESS 4    PFTSDH ADDRESS OF SHARED DATA HEADER - VALID IF PFTSPAGE=1
24 (18) ADDRESS 4  PFTPCB ADDRESS OF PCB CURRENTLY BEING USED TO DO I/O FOR THIS FRAME (PFTIOCUR=1) OR PCB LAST USED TO DO THE I/O (PFTIOCUR=0)
24 (18) BITSTRING 4   PFTMEGAR Shared Segment information
24 (18) BITSTRING 1    PFTSEGNO Segment number of the segment backed by this Shared Segment page table
25 (19)   .... 1...    * Reserved
25 (19) BITSTRING 2    PFTUDSNX UDS index for the UDD that was source for the Shared Segment mapped by this page table.
28 (1C) CHARACTER 4  PFTPROG DATA SPACE PROGRAMMING WORD. THIS FIELD IS VALID IF PFTDSPPG IS ON AND THE FRAME IS NOT ON THE DDFQ.
28 (1C) ADDRESS 4   PFTSPE Address of the SPE for the view which obtained this PFTE. Valid if PFTSPAGE=1
28 (1C) ADDRESS 4    PFTTCB ADDRESS OF THE OWNING TCB IF THE FRAME IS ON THE DDFQ
28 (1C) ADDRESS 4     PFTESTE ADDRESS OF THE ESTE FOR THE E-FRAME THAT MAY CONTAIN ANOTHER COPY OF THE DATA IN THIS FRAME
Table 2. Constants for PFTE
Len Type        Value Name Description
                              PFTE QUEUE IDS
            When adding a QID, examine IARQL for possible hits
1 HEX 01 PFTPAFQN PREFERRED ABOVE AFQ
1 HEX 02 PFTNAFQN NON-PREFERRED ABOVE AFQ
1 HEX 03 PFTPBFQN PREFERRED BELOW AFQ
1 HEX 04 PFTNBFQN NON-PREFERRED BELOW AFQ
1 HEX 08 PFTTDFQN TOP DOUBLE FRAME QUEUE
1 HEX 09 PFTBDFQN BOTTOM DOUBLE FRAME QUEUE
1 HEX 21 PFTSFQN SQA FRAME QUEUE
1 HEX 22 PFTRSFQN RESERVED SQA FRAME QUEUE
1 HEX 23 PFTSBFQN REAL STG BUFFER FRAME QUEUE
1 HEX 24 PFTVRFQN V=R WAITING FRAME QUEUE
1 HEX 25 PFTGDFQN General Defer Frame Queue
1 HEX 40 PFTSFFQN SHARED PAGE FIXED FRAME QUEUE
1 HEX 41 PFTSPFQN SHARED PAGE PAGEABLE FRAME QUEUE
1 HEX 81 PFTPFQN PAGEABLE FRAME QUEUE
1 HEX 82 PFTFFQN FIXED FRAME QUEUE
1 HEX 83 PFTDFFQN DEFERRED FREEMAIN FRAME Q
1 HEX A1 PFTPDFQN PAGEABLE DATA SPACE FQ
1 HEX A2 PFTFDFQN FIXED DATA SPACE FQ
1 HEX A3 PFTDDFQN DEFERED DELETE FRAME Q
1 HEX E0 PFTPRFQN PAGEABLE RDD FRAME Q
1 HEX E1 PFTFRFQN FIXED RDD FRAME QUEUE
1 HEX E2 PFTOFQN ORPHAN FRAME QUEUE
1 HEX F0 PFTDONN UNQUEUED- DAT-OFF NUCLEUS
1 HEX F1 PFTRONN UNQUEUED- READ ONLY NUC.
1 HEX F2 PFTRWNN UNQUEUED- READ/WRITE NUC.
1 HEX F3 PFTIPCN UNQUEUED- RSM IPCS USE ONLY
1 HEX F4 PFTHSAN UNQUEUED- HW SYSTEM AREA
1 HEX F5 PFTAZN UNQUEUED- ABSOLUTE ZERO FR
1 HEX F6 PFTFXAN UNQUEUED- FIXED LPA
1 HEX FC PFTSADN RESERVED FOR STAND ALONE DUMP
1 HEX FD PFTFLAWN UNQUEUED- PFTE WAS FOUND FLAWED DURING RECOVERY
1 HEX FE PFTUNIN UNQUEUED- UNINITIALIZED
1 HEX FF PFTUNQDN UNQUEUED
1 HEX FF PFTNOFRN WHEN IN THE PFTFREID FIELD - THIS PFTE CANNOT BE FREED
1 HEX 07 PFTAFQMK HIGHEST POSSIBLE AVAILABLE FRAME QUEUE ID.
1 HEX 20 PFTRITMK LOWEST POSSIBLE RIT BASED QUEUE ID (EXCLUDING AFQS AND DOUBLE FRAME QUEUES).
1 HEX 2F PFTGLMK Highest possible queue id for a PFTE serialized by the RSMGL lock.
1 HEX 80 PFTRABMK LOWEST POSSIBLE QUEUE ID FOR AN ADDRESS SPACE RELATED QUEUE (RAB, DAB, OR RDD BASED FRAME QUEUE).
1 HEX A0 PFTDABMK LOWEST POSSIBLE QUEUE ID FOR A DAB BASED FRAME QUE
1 HEX E0 PFTRDDML LOWEST POSSIBLE QUEUE ID FOR AN RDD BASED FRAME QUE
1 HEX E7 PFTRDDMH HIGHEST POSSIBLE QUEUE ID FOR AN RDD BASED FRAME QUE
1 HEX F0 PFTUNQMK LOWEST ID POSSIBLE FOR AN UNQUEUED PFTE.
                              PFTE CONSTANTS
1 HEX FE PFTKMUIC MAXIMUM UIC VALUE
1 HEX FF PFTKBUIC UIC VALUE USED TO INDICATE A BLOCKED PAGE THAT HAS NEVER BEEN REFERENCED
Table 3. Cross Reference for PFTE
Name Offset Hex Tag
PFTASID 12
PFTBADFR D 01
PFTBELOW D 40
PFTBQPTR 4
PFTDREF A 02
PFTDSPPG A 01
PFTE 0
PFTESTE 1C
PFTFCWRD C
PFTFLGS1 D
PFTFLGS2 A
PFTFLGS3 B
PFTFQPTR 0
PFTFREID C
PFTFXCT E
PFTIOCUR B 80
PFTIOMC B 02
PFTLSQA 10 20
PFTMEGAR 18
PFTMEGAROOED 10 10
PFTNOPRF B 01
PFTNOREC B 04
PFTNOUNC D 02
PFTOFFLN A 20
PFTOFINT B 08
PFTONAFQ A 80
PFTPCB 18
PFTPERM A 40
PFTPREF D 80
PFTPROG 1C
PFTQID 8
PFTRDS 10 80
PFTRVTEX 11
PFTSDH 14
PFTSEGNO 18
PFTSER 10
PFTSERFL 10
PFTSPAGE 10 40
PFTSPE 1C
PFTSRBSC D 04
PFTTCB 1C
PFTUDSNX 19
PFTUIC 9
PFTVIORA 14
PFTVIORU B 20
PFTVR D 20
PFTVRALC A 04
PFTVRINT B 10
PFTVRPLT B 40
PFTVRWT A 08
PFTVSA 14