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 V4R2.0. Last updated on 17 Oct 2001 at 17:05:07 EDT.
Copyright IBM Corporation, 1990, 2001