TTEBK | Back to Index page

| Prolog Control Block Contents TTEBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

TTEBK Prolog | Top of page

     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 or from the TRACG instr.
                  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.
     RELOCATION CONSIDERATIONS : None

TTEBK Control Block Content | Top of page

     TTEBK DSECT
    Top of page

    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' TRACE instruction code
    0001    1 Bitstring    1 TTEFORM        Trace entry format
              00000080       TTETRACG       X'80' TTETRACG TRACG instruction
                                            entry
              00000000       TTETRACE       X'00' TTETRACE 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 Signed       4 TTEOPRND       TRACE operand
    0008    8 Bitstring    2 *              RESERVED FOR HARDWARE USE
    0008    8 Bitstring    1 *
    0009    9 Bitstring    1 *              Model dependent data
    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
                 TRACG Instruction trace entry format
    0000    0 Bitstring    1 TTEGCODE       Hardware trace entry identifier
                                            '7n' (n is the number of
                                            registers stored minus one: 6-1=5
                                            for CP)
              .111 .1.1      TTECDTRG       X'75' 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.
                                     Fullword operand of the TRACG
                                     instruction.  For CP this has
                                     historically been two bytes of
                                     zeros followed by a two byte
                                     trace entry identification
                                     token.  Starting with the z10
                                     support, CP set the TRACE TOD
                                     control bit on in CR0 which
                                     caused, when the store clock
                                     fast facility is installed, a
                                     model dependent value to be
                                     stored in the second byte of the
                                     operand.  Lastly, for function
                                     specific trace table entries
                                     the high halfword of the operand
                                     is set to the CPU address of
                                     processor where the entry was
                                     originally cut.
    000C   12 Signed       4 TTEGOPRND      TRACG operand
    000C   12 Bitstring    2 *
    000C   12 Bitstring    1 *
    000D   13 Bitstring    1 *              Model dependent data
    000C   12 Signed       2 TTEGCPU        CPU address (only valid in
                                            entries copied to function
                                            specific trace tables by the
                                            HCPFRTT facility)
    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 | Top of page

    *** TTEBK - TRACE TABLE ENTRY FORMAT
    *
    *     +------+------+-----------------------------------------+
    *   0 |:CODE |:FORM |                TTETODCK                 |
    *     +------+------+-------------+---------------------------+
    *   8 |         TTEOPRND          | C
    *     +---------------------------+
    *
    *** TTEBK - TRACE TABLE ENTRY FORMAT

    *** Overlay for TTEOPRND in TTEBK
    *
    *     +-------------+
    *   8 |/////////////| A
    *     +-------------+
    *
    *** Overlay for TTEOPRND in TTEBK

    *** Overlay for TTEOPRND in TTEBK
    *
    *     +------+------+-------------+---------------------------+
    *   8 |//////|//////|   TTECID    |         TTEDATA0          |
    *     +------+------+-------------+---------------------------+
    *  10 |         TTEDATA1          |         TTEDATA2          |
    *     +---------------------------+---------------------------+
    *  18 |         TTEDATA3          |         TTEDATA4          |
    *     +---------------------------+---------------------------+
    *
    *** Overlay for TTEOPRND in TTEBK

    *** 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)    |/////////////|        TTEGOPRND          |
    *     +-------------+-------------+---------------------------+
    *  10
    *
    *** Overlay for TTECODE in TTEBK

    *** Overlay for TTEGOPRND in TTEBK
    *
    *                                 +-------------+
    *   8 ...                       C |/////////////| E
    *                                 +-------------+
    *
    *** Overlay for TTEGOPRND in TTEBK

    *** Overlay for TTEGOPRND in TTEBK
    *
    *                                 +------+------+
    *   8 ...                       C |//////|//////| E
    *                                 +------+------+
    *
    *** Overlay for TTEGOPRND in TTEBK

    *** Overlay for TTEGOPRND in TTEBK
    *
    *                                 +-------------+-------------+
    *   8 ...                       C |  TTEGCPU    |  TTEGCID    |
    *     +---------------------------+-------------+-------------+
    *  10 |                       TTEGDAT0                        |
    *     +-------------------------------------------------------+
    *  18 |                       TTEGDAT1                        |
    *     +-------------------------------------------------------+
    *  20 |                       TTEGDAT2                        |
    *     +-------------------------------------------------------+
    *  28 |                       TTEGDAT3                        |
    *     +-------------------------------------------------------+
    *  30 |                       TTEGDAT4                        |
    *     +-------------------------------------------------------+
    *  38 |                       TTEGDAT5                        |
    *     +-------------------------------------------------------+
    *
    *** Overlay for TTEGOPRND 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 | Top of page

    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
    TTEGCPU        000C
    TTEGDAT0       0010
    TTEGDAT1       0018
    TTEGDAT2       0020
    TTEGDAT3       0028
    TTEGDAT4       0030
    TTEGDAT5       0038
    TTEGFORM       0001
    TTEGLEN        0040 00000040
    TTEGNEXT       0040
    TTEGOPRND      000C
    TTEGTODC       0002
    TTEGTODM       0004
    TTELEN         0020 00000020
    TTENEXT        0020
    TTEOPRND       0008
    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 7.2.0 Last updated on 24 Jun 2020 at 09:31:26 EDT.
Copyright IBM Corporation, 1990, 2020