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

TTPBK

Prolog  

Control Block Contents  
   TTPBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


TTPBK Prolog

 NAME       : HCPTTPBK
 DESCRIPTION: TRACE TABLE PAGE FORMAT
 DSECT      : TTPBK
 FUNCTION   : THIS CONTROL BLOCK DEFINES THE FORMAT OF ONE TRACE
              TABLE PAGE AS USED BY CP.
 LOCATED BY : PFXTTPNT - FULL WORD POINTER USED TO LOCATE TRACE
              TABLE PAGES DURING SYSTEM INITIALIZATION
              AND FOR DUMPS
              TTPFPNT  - FORWARD POINTER FOR CHAIN OF TRACE TABLE
              PAGES
              TTPBPNT  - BACKWARD POINTER FOR CHAIN OF TRACE
              TABLE PAGES
 CREATED BY : HCPMPSON - WHILE ACQUIRING TRACE TABLE PAGES FOR A
              PROCESSOR BEING BROUGHT ONLINE
 DELETED BY : HCPMPSOF - WHEN RELEASING TRACE TABLE PAGES FOR A
              PROCESSOR BEING TAKEN OFFLINE
 RELOCATION CONSIDERATIONS : None

 

TTPBK Control Block Content


TTPBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      TTPBK          TRACE TABLE PAGE FORMAT
0000    0 Bitstring   32 TTPNEXT (126)  TRACE ENTRIES
0FC0 4032 Bitstring   32 TTPLAST        TRACE INTERRUPT TRACE ENTRY (HAND
                                        BUILT TO RECORD INTERRUPT)
0FE0 4064 Signed       4 TTPFRMAD       Backing Frame Host Real Address.
                                        Frame is always below 2G. If the
                                        value is x'FFFFFFFF' the trace
                                        page is a CSE trace page and not
                                        used with hardware tracing.
0FE0 4064 Signed       4 TTPFRTBK       Logical Address of Corresponding
                                        Vector Entry (FRTBK) of Function
                                        Related Trace Table.
0FE4 4068 Signed       2 TTPCPUAD       CPU ADDR OF OWNER OF THIS PAGE
0FE6 4070 Signed       2 *              RESERVED FOR FUTURE USE
0FE8 4072 Dbl-Word     8 TTPTODIN       TOD CLOCK ON ENTRY TO PAGE
0FF0 4080 Dbl-Word     8 TTPTODEX       TOD CLOCK ON EXIT FROM PAGE
0FF8 4088 Signed       4 TTPFPNT        FORWARD POINTER FOR TRACE TABLE
                                        CHAIN
0FFC 4092 Signed       4 TTPBPNT        BACKWARD POINTER FOR TRACE TABLE
                                        CHAIN
0FC0 4032 Bitstring    1 TTPCODE        HARDWARE TRACE ENTRY IDENTIFIER
                                        X'7N' (WHERE N IS THE NUMBER OF
                                        REGISTERS STORED MINUS ONE, WILL
                                        ALWAYS BE FOUR IN VM)
0FC1 4033 Bitstring    1 *              RESERVED FOR FUTURE HARDWARE USE
0FC2 4034 Bitstring    6 TTPTODCK (0)   LAST 6 BYTES OF TOD CLOCK,
                                        HARDWARE SUPPLIED.
0FC2 4034 Bitstring    2 TTPTOD23       BYTES 2 AND 3 OF TOD CLOCK
0FC4 4036 Bitstring    4 TTPTOD47       BYTES 4 THROUGH 7 OF TOD CLOCK
                                 ALL OF THE ABOVE FIELDS ARE SUPPLIED
                                 BY THE HARDWARE EXECUTION OF THE
                                 TRACE INSTRUCTION.
                                 THE FOLLOWING FIELDS ARE THE DATA
                                 PASSED TO THE TRACE INSTRUCTION BY
                                 THE SOFTWARE.
0FC8 4040 Signed       4 TTPTRCCD (0)   TRACE ENTRY IDENTIFIER
0FC8 4040 Bitstring    2 *              TRACE PARAMETER, ARCHITECTED TO
                                        BE ZEROES.
0FCA 4042 Bitstring    2 TTPCID         TRACE ENTRY ID (IE 0300 = PROGRAM
                                        INTERRUPT)
                                 THE FOLLOWING FIELDS ARE PASSED TO THE
                                 TRACE INSTRUCTION IN CONSECUTIVE GENERAL
                                 PURPOSE REGISTERS.
0FCC 4044 Signed       4 TTPDATA0       FIRST DATA FIELD PASSED TO TRACE
0FD0 4048 Signed       4 TTPDATA1       SECOND DATA FIELD PASSED TO TRACE
0FD4 4052 Signed       4 TTPDATA2       THIRD DATA FIELD PASSED TO TRACE
0FD8 4056 Signed       4 TTPDATA3       FOURTH DATA FIELD PASSED TO TRACE
0FDC 4060 Signed       4 TTPDATA4       FIFTH DATA FIELD PASSED TO TRACE

 

TTPBK Storage Layout

          
*** TTPBK - TRACE TABLE PAGE FORMAT
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       TTPNEXT                         =
*     |                                                       |
*     +-------------------------------------------------------+
* FC0 |                                                       |
*     =                       TTPLAST                         =
*     |                                                       |
*     +---------------------------+-------------+-------------+
* FE0 |         TTPFRMAD          |  TTPCPUAD   |/////////////|
*     +---------------------------+-------------+-------------+
* FE8 |                       TTPTODIN                        |
*     +-------------------------------------------------------+
* FF0 |                       TTPTODEX                        |
*     +---------------------------+---------------------------+
* FF8 |         TTPFPNT           |         TTPBPNT           |
*     +---------------------------+---------------------------+
*1000
*
*** TTPBK - TRACE TABLE PAGE FORMAT
          
*** Overlay for TTPFRMAD in TTPBK
*
*     +---------------------------+
* FE0 |         TTPFRTBK          | FE4
*     +---------------------------+
*
*** Overlay for TTPFRMAD in TTPBK
          
*** Overlay for TTPLAST in TTPBK
*
*     +------+------+-------------+---------------------------+
* FC0 |:CODE |//////|  TTPTOD23   |         TTPTOD47          |
*     +------+------+-------------+---------------------------+
* FC8 |/////////////|   TTPCID    |         TTPDATA0          |
*     +-------------+-------------+---------------------------+
* FD0 |         TTPDATA1          |         TTPDATA2          |
*     +---------------------------+---------------------------+
* FD8 |         TTPDATA3          |         TTPDATA4          |
*     +---------------------------+---------------------------+
* FE0
*
*** Overlay for TTPLAST in TTPBK

 

TTPBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
TTPBPNT        0FFC
TTPCID         0FCA
TTPCODE        0FC0
TTPCPUAD       0FE4
TTPDATA0       0FCC
TTPDATA1       0FD0
TTPDATA2       0FD4
TTPDATA3       0FD8
TTPDATA4       0FDC
TTPFPNT        0FF8
TTPFRMAD       0FE0
TTPFRTBK       0FE0
TTPLAST        0FC0
TTPNEXT        0000
TTPTODCK       0FC2
TTPTODEX       0FF0
TTPTODIN       0FE8
TTPTOD23       0FC2
TTPTOD47       0FC4
TTPTRCCD       0FC8

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:28:44 EDT.
Copyright IBM Corporation, 1990, 2011