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

TTSBK

Prolog  

Control Block Contents  
   TTSBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


TTSBK Prolog

 NAME       : HCPTTSBK
 DESCRIPTION: TRACE TABLE SAVE ENTRY FORMAT
 DSECT      : TTSBK
 FUNCTION   :
              THIS CONTROL BLOCK DEFINES THE FORMAT OF A 28-BYTE
              CP TRACE TABLE ENTRY, SAVED ONTO TAPE BY HSERV AND
              USED BY DVF FOR TRACE SERVICE TOOLS.
              THIS CONTROL BLOCK IS IDENTICAL TO THE FORMAT OF
              THE HARDWARE TRACE ENTRIES, EXCEPT THAT THE FIRST
              FULLWORD HAS BEEN REMOVED AND THE ID OF THE PRO-
              CESSOR GENERATING THE TRACE ENTRY HAS BEEN INCLUDED
              THE TRACE ENTRY HAS BEEN INCLUDED.
              IF THIS CONTROL BLOCK IS CHANGED, THE TTEBK MUST BE
              VERIFIED TO SEE IF THE SAME CHANGE EXISTS THERE.
 LOCATED BY :
              WORK REGISTERS IN HCPTSM (SAVES THE TRACE ENTRIES)
 CREATED BY :
              NOT APPLICABLE.  DSECT DEFINES FORMAT USED BY TRACE
              INSTRUCTION.
 DELETED BY :
              NOT APPLICABLE.

 

TTSBK Control Block Content


TTSBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      TTSBK          TRACE TABLE SAVE ENTRY FORMAT
0000    0 Bitstring    4 TTSTODCK       LAST 4 BYTES OF TOD CLOCK
0004    4 Bitstring    1 TTSTYPE (0)    Trace entry type
          1... ....      TTSTRACG       X'80' TTSTRACG First half of
                                        TRACG entry
          .... ....      TTSTRACE       X'00' TTSTRACE Entire TRACE entry
0004    4 Bitstring    2 TTSCPUID       ID OF THE PROCESSOR GENERATING
                                        THIS TRACE INSTRUCTION
0006    6 Bitstring    2 TTSCID         TRACE ENTRY ID (IE 0A00=RUN USER)
0008    8 Signed       4 TTSDATA0       FIRST DATA FIELD PASSED (RX)
000C   12 Signed       4 TTSDATA1       SECOND DATA FIELD PASSED (RX+1)
0010   16 Signed       4 TTSDATA2       THIRD DATA FIELD PASSED (RX+2)
0014   20 Signed       4 TTSDATA3       FOURTH DATA FIELD PASSED (RX+3)
0018   24 Signed       4 TTSDATA4       FIFTH DATA FIELD PASSED (RX+4)
          00000004       TTSSIZE        (*-TTSBK+7)/8 :SIZE OF BLOCK IN
                                        DOUBLE WORDS
          0000001C       TTSLEN         (*-TTSBK) :LENGTH OF BLOCK IN
                                        BYTES
             THE FOLLOWING IS A REDEFINITION OF THE FIRST TWO
             DATA AREAS (TTSDATA0,1) IS USED BY THE COMMUNICA-
             ENTRY 'FFCC'.  THIS ENTRY IS ONLY USED BY TRACE
             SERVICE TOOLS (VIA TRSAVE), IT WILL NOT APPEAR
             IN THE SYSTEM TRACE TABLES.  IT'S PURPOSE IS TO
             PROVIDE A FULL TOD CLOCK VALUE WHENEVER THE HIGH
             ORDER 2 FULLWORDS CHANGE.  IT IS USED BY DVF TO
             FORMAT A COMPLETE TOD.
0008    8 Dbl-Word     8 TTSTODCM       FULL 8-BYTE TOD ENTRY FOR
                                        COMMUNICATION TO DVF

 

TTSBK Storage Layout

          
*** TTSBK - TRACE TABLE SAVE ENTRY FORMAT
*
*     +---------------------------+-------------+-------------+
*   0 |         TTSTODCK          |  TTSCPUID   |   TTSCID    |
*     +---------------------------+-------------+-------------+
*   8 |         TTSDATA0          |         TTSDATA1          |
*     +---------------------------+---------------------------+
*  10 |         TTSDATA2          |         TTSDATA3          |
*     +---------------------------+---------------------------+
*  18 |         TTSDATA4          | 1C
*     +---------------------------+
*
*** TTSBK - TRACE TABLE SAVE ENTRY FORMAT
          
*** Overlay for TTSDATA0 in TTSBK
*
*     +-------------------------------------------------------+
*   8 |                       TTSTODCM                        |
*     +-------------------------------------------------------+
*  10
*
*** Overlay for TTSDATA0 in TTSBK

 

TTSBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
TTSCID         0006
TTSCPUID       0004
TTSDATA0       0008
TTSDATA1       000C
TTSDATA2       0010
TTSDATA3       0014
TTSDATA4       0018
TTSLEN         0018 0000001C
TTSSIZE        0018 00000004
TTSTODCK       0000
TTSTODCM       0008
TTSTRACE       0004 00
TTSTRACG       0004 80
TTSTYPE        0004

This information is based on z/VM V5R3.0. Last updated on 25 Jun 2007 at 17:49:32 EDT.
Copyright IBM Corporation, 1990, 2007