IBM: TSDBK

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

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 TO
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