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.3.0 Last updated on 22 Jun 2022 at 15:57:20 EDT.
Copyright IBM Corporation, 1990, 2022