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 (0)   RECORDING LOCK
    0058   88 Bitstring    1 TSDRFLAG       Recording lock flags
              1... ....      TSDHELD        X'80' TSDHELD Indicate that lock
                                            is held
    0059   89 Bitstring    1 *              Reserved for IBM use
    005A   90 Signed       2 TSDCPUAD       CPU address of lock holder
    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' TSDM6088 NEED TO ISSUE
                                            6088I
              .1.. ....      TSDDISBL       X'40' TSDDISBL DISABLE PROCESSING
                                            OCCURRING
              ..1. ....      TSDWRTER       X'20' TSDWRTER ERROR OCCURRED IN
                                            WRITING TRACE TO DASD
              ...1 ....      TSDMDERR       X'10' TSDMDERR Mode error
                                            occurred, block only
    0063   99 Character    1 TSDTSRCD       TSR code
              00000001       TSDCD001       X'01' TSDCD001
                                            LOCKED_SAME_CPU_001
              00000002       TSDCD002       X'02' TSDCD002
                                            TOO_MANY_BUFFERS_002
              00000003       TSDCD003       X'03' TSDCD003
                                            INVALID_TRCTYPE_003
              00000063       TSDCD099       X'63' TSDCD099 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 |:RFLAG|//////|  TSDCPUAD   |         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
    TSDCPUAD       005A
    TSDDISBL       0062 40
    TSDFLAG        0062
    TSDHELD        0058 80
    TSDL6088       0078
    TSDMDERR       0062 10
    TSDM6088       0062 80
    TSDNEXTP       0000
    TSDORIG        0008
    TSDPCNT        003E
    TSDRECLK       0058
    TSDRFLAG       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 V6R1.0. Last updated on 18 Feb 2010 at 09:19:27 EDT.
Copyright IBM Corporation, 1990, 2008