|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
TTEBK
Control Block Contents
TTEBK DSECT
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
Copyright IBM Corporation, 1990, 2001