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 V6R1.0. Last updated on 18 Feb 2010 at 09:20:08 EDT.
Copyright IBM Corporation, 1990, 2008