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).
 RELOCATION CONSIDERATIONS : None

 

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 V6R2.0. Last updated on 21 Nov 2011 at 11:28:19 EDT.
Copyright IBM Corporation, 1990, 2011