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

#### TSDBK

Prolog

Control Block Contents
TSDBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### TSDBK Prolog

     NAME       : HCPTSDBK
     DESCRIPTION: TRACE SERVICE DASD BLOCK
     DSECT      : TSDBK
     FUNCTION   : CONTAINS DATA RELATED TO TRACING TO DASD
     LOCATED BY : TSTTSDBK (FOR CP TRACING) FIELD IN HCPTSTBK
                  TRCTSDBK (FOR TRACEIDS) FIELD IN HCPTRCBK
     CREATED BY : HCPTSA   : When saving DASD options on
                  TRSAVE FOR CP ON DASD ...
                  HCPTSJ   : Enabling a traceid
     DELETED BY : HCPTSE   : WHEN TERMINATING THE TRSAVE
                  FUNCTION FOR CP
                  HCPTSF   : WHEN TERMINATING THE TRSAVE
                  FUNCTION FOR A TRACEID
                  HCPTSJ   : Enabling a traceid (If error)
     SERIALIZED : This control block is serialized by the
                  TSDWRTLK (Trace services write lock).

#### TSDBK Control Block Content

#### TSDBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      TSDBK          TRACE SERVICE DASD BLOCK
    0000    0 Signed       4 TSDNEXTP       Used in GT FOR GROUP traces. One
                                            TSDBK for each member
    0004    4 Signed       4 TSDTSABK       -> to TRSAVE descriptor block
    0008    8 Character    8 TSDORIG        ORIGINATOR OF TRACE EQUALS THE
                                            USERID ON TRSOURCE FOR USER
                                            COMMANDS, EQUALS SYSTEM FOR OTHER
                                            COMMANDS
    0010   16 Signed       4 TSDBPQP        -> TO BUFFER PENDING QUEUE
    0014   20 Signed       4 TSDSDFP (9)    -> TO SDFBK'S FOR THIS TRACE
    0038   56 Bitstring    1 TSDSDFPI       INDEX OF CURRENT SDF BEING USED
    0039   57 Bitstring    1 * (5)          Reserved for IBM use
    003E   62 Signed       2 TSDPCNT        NUMBER OF FILES PURGED
    0040   64 Dbl-Word     8 TSDWRTLK (3)   WRITING LOCK
    0058   88 Signed       4 TSDRECLK       RECORDING LOCK
    005C   92 Signed       4 TSDBUFF        -> TO BUFFER WE'RE CURRENTLY
                                            RECORDING
    0060   96 Signed       2 TSDAVCNT       NUMBER OF BYTES STILL AVAILABLE
                                            IN CURRENT BUFFER
    0062   98 Bitstring    1 TSDFLAG        TSD FLAGS
              1... ....      TSDM6088       X'80' NEED TO ISSUE 6088I
              .1.. ....      TSDDISBL       X'40' DISABLE PROCESSING
                                            OCCURRING
              ..1. ....      TSDWRTER       X'20' ERROR OCCURRED IN WRITING
                                            TRACE TO DASD
              ...1 ....      TSDMDERR       X'10' Mode error occurred, block
                                            only
    0063   99 Character    1 TSDTSRCD       TSR code
              00000001       TSDCD001       X'01' LOCKED_SAME_CPU_001
              00000002       TSDCD002       X'02' TOO_MANY_BUFFERS_002
              00000003       TSDCD003       X'03' INVALID_TRCTYPE_003
              00000063       TSDCD099       X'63' RETURN_CODE_099
    0064  100 Signed       4 TSDBMSBK       Address of BMSBK for traceid if
                                            DEFERIO trace
    0068  104 Character    8 TSDTSREP       TSR entry point
    0070  112 Signed       4 TSDTSRRC       TSR return code
    0074  116 Signed       4 *              Reserved for IBM
    0078  120 Dbl-Word     8 TSDL6088       TOD when last msg 6088 was issued
              00000010       TSDSIZE        (*-TSDBK+7)/8 SIZE OF TSDBK IN
                                            DOUBLEWORDS

#### TSDBK Storage Layout

    *** TSDBK - TRACE SERVICE DASD BLOCK
    *
    *     +---------------------------+---------------------------+
    *   0 |         TSDNEXTP          |         TSDTSABK          |
    *     +---------------------------+---------------------------+
    *   8 |                       TSDORIG                         |
    *     +---------------------------+---------------------------+
    *  10 |         TSDBPQP           |                           |
    *     +---------------------------+                           |
    *  18 |                                                       |
    *     =                       TSDSDFP                         =
    *     |                                                       |
    *     +------+----------------------------------+-------------+
    *  38 |:SDFPI|//////////////////////////////////|  TSDPCNT    |
    *     +------+----------------------------------+-------------+
    *  40 |                                                       |
    *     =                       TSDWRTLK                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  58 |         TSDRECLK          |         TSDBUFF           |
    *     +-------------+------+------+---------------------------+
    *  60 |  TSDAVCNT   |:FLAG |:TSRCD|         TSDBMSBK          |
    *     +-------------+------+------+---------------------------+
    *  68 |                       TSDTSREP                        |
    *     +---------------------------+---------------------------+
    *  70 |         TSDTSRRC          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  78 |                       TSDL6088                        |
    *     +-------------------------------------------------------+
    *  80
    *
    *** TSDBK - TRACE SERVICE DASD BLOCK

#### TSDBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    TSDAVCNT       0060
    TSDBMSBK       0064
    TSDBPQP        0010
    TSDBUFF        005C
    TSDCD001       0063 00000001
    TSDCD002       0063 00000002
    TSDCD003       0063 00000003
    TSDCD099       0063 00000063
    TSDDISBL       0062 40
    TSDFLAG        0062
    TSDL6088       0078
    TSDMDERR       0062 10
    TSDM6088       0062 80
    TSDNEXTP       0000
    TSDORIG        0008
    TSDPCNT        003E
    TSDRECLK       0058
    TSDSDFP        0014
    TSDSDFPI       0038
    TSDSIZE        0078 00000010
    TSDTSABK       0004
    TSDTSRCD       0063
    TSDTSREP       0068
    TSDTSRRC       0070
    TSDWRTER       0062 20
    TSDWRTLK       0040

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 18:14:32 EDT.
Copyright IBM Corporation, 1990, 2002