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

#### TTEBK

Prolog

Control Block Contents
TTEBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### TTEBK Prolog

     NAME       : HCPTTEBK
     DESCRIPTION: TRACE TABLE ENTRY FORMAT
     DSECT      : TTEBK
     FUNCTION   :
                  THIS CONTROL BLOCK DEFINES THE FORMAT OF A CP TRACE
                  TABLE ENTRY CREATED BY HARDWARE FROM THE TRACE
                  instruction's execution (as coded in VM/ESA), or
                  from the TRACG instruction's execution, as coded in
                  VM/ESAME.
                  EACH CP TRACE ENTRY MADE HAS A UNIQUE TRACE CODE
                  USED WHEN EXECUTING THE TRACE INSTRUCTION.  ALL THE
                  TRACE ENTRY CODES ARE DEFINED IN THE TTABK DSECT.
     LOCATED BY :
                  CONTROL REGISTER 12:  CONTAINS THE ADDRESS OF THE
                  NEXT ENTRY TO BE GENERATED IN EACH CPU'S TRACE
                  TABLE.
     CREATED BY :
                  NOT APPLICABLE.  DSECT DEFINES FORMAT USED BY TRACE
                  or TRACG instruction.
     DELETED BY :
                  NOT APPLICABLE.

#### TTEBK Control Block Content

#### TTEBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      TTEBK          TRACE TABLE ENTRY FORMAT
    0000    0 Bitstring    1 TTECODE        HARDWARE TRACE ENTRY IDENTIFIER
                                            '7N' (N IS THE NO. OF REGISTERS
                                            MINUS ONE STORED: 4 FOR VM/XA)
              .111 .1..      TTECDTRC       X'74' VM/ESA TRACE instruction
                                            code
    0001    1 Bitstring    1 TTEFORM        Trace entry format
              00000080       TTETRACG       X'80' TRACG instruction entry
              00000000       TTETRACE       X'00' TRACE instruction entry
    0002    2 Bitstring    6 TTETODCK       LAST 6 BYTES OF TOD CLOCK, BY
                                            HARDWARE
         ALL OF THE ABOVE FIELDS ARE SUPPLIED BY THE HARDWARE EXECUTION OF THE
         TRACE INSTRUCTION
         THE FOLLOWING FIELDS ARE THE DATA PASSED BY THE TRACE INSTRUCTION BY
         THE SOFTWARE.
    0008    8 Bitstring    2 *              RESERVED FOR HARDWARE USE
    000A   10 Bitstring    2 TTECID         TRACE ENTRY ID (IE 0A00=RUN USER)
         THE FOLLOWING FIELDS ARE PASSED TO THE TRACE INSTRUCTION IN CONSECUTIVE
         GENERAL PURPOSE REGISTERS.
    000C   12 Signed       4 TTEDATA0       FIRST DATA FIELD PASSED (RX)
    0010   16 Signed       4 TTEDATA1       SECOND DATA FIELD PASSED (RX+1)
    0014   20 Signed       4 TTEDATA2       THIRD DATA FIELD PASSED (RX+2)
    0018   24 Signed       4 TTEDATA3       FOURTH DATA FIELD PASSED (RX+3)
    001C   28 Signed       4 TTEDATA4       FIFTH DATA FIELD PASSED (RX+4)
    0020   32 Signed       4 TTENEXT (0)    NEXT TRACE ENTRY
              00000004       TTESIZE        (*-TTEBK+7)/8 :SIZE OF BLOCK IN
                                            DOUBLE WORDS
              00000020       TTELEN         (*-TTEBK) :LENGTH OF BLOCK IN
                                            BYTES
    0000    0 Signed       4 *              1ST WORD NOT SAVED ON TAPE
    0004    4 Bitstring   28 TTETSTRT       LAST HALF OF TOD ON IS SAVED
              0000001C       TTETSTSZ       *-TTETSTRT SIZE OF TST TRACE
                                            ENTRY ON TAPE
         ESAME TRACG Instruction trace entry format
    0000    0 Bitstring    1 TTEGCODE       Hardware trace entry identifier
                                            '7n' (n is the number of
                                            registers stored minus one: 5 for
                                            VM/ESAME)
              .111 .1.1      TTECDTRG       X'75' VM/ESA TRACG instruction
                                            code
    0001    1 Bitstring    1 TTEGFORM       Trace entry format
    0002    2 Bitstring   10 TTEGTODC (0)   Bits 0-79 of TOD clock
    0002    2 Bitstring    2 *              Bits 0-15
    0004    4 Bitstring    6 TTEGTODM       Bits 16-63
    000A   10 Bitstring    2 *              Bits 64-79
         The fields above are supplied by hardware executon of the TRACG
         instruction.
         The following fields are the data for the TRACG instruction.
    000C   12 Bitstring    2 *
    000E   14 Bitstring    2 TTEGCID        Trace entry ID
                                            (E.g.,0A00=RUNUSER)
         The following fields are passed to the TRACG instruction in consecutive
         general-purpose registers.
    0010   16 Dbl-Word     8 TTEGDAT0       First register (RX)
    0018   24 Dbl-Word     8 TTEGDAT1       Second register (RX+1)
    0020   32 Dbl-Word     8 TTEGDAT2       Third register (RX+2)
    0028   40 Dbl-Word     8 TTEGDAT3       Fourth register (RX+3)
    0030   48 Dbl-Word     8 TTEGDAT4       Fifth register (RX+4)
    0038   56 Dbl-Word     8 TTEGDAT5       Sixth register (RX+5)
    0040   64 Dbl-Word     8 TTEGNEXT (0)   Next TRACE/TRACG entry
              00000040       TTEGLEN        (*-TTEBK) Length of TRACG entry
                                            in bytes
    0002    2 Bitstring    1 TTETOD1        FIRST BYTE OF TTETODCK
    0002    2 Bitstring    4 TTETODHI       FIRST 4 BYTES OF TTATODCK

#### TTEBK Storage Layout

    *** TTEBK - TRACE TABLE ENTRY FORMAT
    *
    *     +------+------+-----------------------------------------+
    *   0 |:CODE |:FORM |                TTETODCK                 |
    *     +------+------+-------------+---------------------------+
    *   8 |/////////////|   TTECID    |         TTEDATA0          |
    *     +-------------+-------------+---------------------------+
    *  10 |         TTEDATA1          |         TTEDATA2          |
    *     +---------------------------+---------------------------+
    *  18 |         TTEDATA3          |         TTEDATA4          |
    *     +---------------------------+---------------------------+
    *
    *** TTEBK - TRACE TABLE ENTRY FORMAT

    *** Overlay for TTECODE in TTEBK
    *
    *     +---------------------------+---------------------------+
    *   0 |///////////////////////////|                           |
    *     +---------------------------+                           |
    *   8 |                                                       |
    *     =                       TTETSTRT                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  20
    *
    *** Overlay for TTECODE in TTEBK

    *** Overlay for TTECODE in TTEBK
    *
    *     +------+------+-------------+---------------------------+
    *   0 |:GCODE|:GFORM|/////////////|        TTEGTODM-          |
    *     +------+------+-------------+-------------+-------------+
    *   8 |   -(004)    |/////////////|/////////////|  TTEGCID    |
    *     +-------------+-------------+-------------+-------------+
    *  10 |                       TTEGDAT0                        |
    *     +-------------------------------------------------------+
    *  18 |                       TTEGDAT1                        |
    *     +-------------------------------------------------------+
    *  20 |                       TTEGDAT2                        |
    *     +-------------------------------------------------------+
    *  28 |                       TTEGDAT3                        |
    *     +-------------------------------------------------------+
    *  30 |                       TTEGDAT4                        |
    *     +-------------------------------------------------------+
    *  38 |                       TTEGDAT5                        |
    *     +-------------------------------------------------------+
    *
    *** Overlay for TTECODE in TTEBK

    *** Overlay for TTETODCK in TTEBK
    *
    *                   +------+
    *   0 ...         2 |:TOD1 | 3
    *                   +------+
    *
    *** Overlay for TTETODCK in TTEBK

    *** Overlay for TTETODCK in TTEBK
    *
    *                   +---------------------------+
    *   0 ...         2 |         TTETODHI          | 6
    *                   +---------------------------+
    *
    *** Overlay for TTETODCK in TTEBK

#### TTEBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    TTECDTRC       0000 74
    TTECDTRG       0000 75
    TTECID         000A
    TTECODE        0000
    TTEDATA0       000C
    TTEDATA1       0010
    TTEDATA2       0014
    TTEDATA3       0018
    TTEDATA4       001C
    TTEFORM        0001
    TTEGCID        000E
    TTEGCODE       0000
    TTEGDAT0       0010
    TTEGDAT1       0018
    TTEGDAT2       0020
    TTEGDAT3       0028
    TTEGDAT4       0030
    TTEGDAT5       0038
    TTEGFORM       0001
    TTEGLEN        0040 00000040
    TTEGNEXT       0040
    TTEGTODC       0002
    TTEGTODM       0004
    TTELEN         0020 00000020
    TTENEXT        0020
    TTESIZE        0020 00000004
    TTETODCK       0002
    TTETODHI       0002
    TTETOD1        0002
    TTETRACE       0001 00000000
    TTETRACG       0001 00000080
    TTETSTRT       0004
    TTETSTSZ       0004 0000001C

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 18:16:25 EDT.
Copyright IBM Corporation, 1990, 2002