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

#### 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.
    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 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
    TTPLAST        0FC0
    TTPNEXT        0000
    TTPTODCK       0FC2
    TTPTODEX       0FF0
    TTPTODIN       0FE8
    TTPTOD23       0FC2
    TTPTOD47       0FC4
    TTPTRCCD       0FC8

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