TSTBK Back to Index page
 
Prolog 
Control Block Contents 
   TSTBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  TSTBK Prolog Top of page
 
 NAME       : HCPTSTBK
 DESCRIPTION: Trace Service Tool Block
 DSECT      : TSTBK
 FUNCTION   : Contains the status of Trace Service Tools
              and anchors the necessary resources when it
              is active
 LOCATED BY : SYSTSTBK
 CREATED BY : HCPTSAVE : When the TRSAVE ON command is
              first specified
 DELETED BY : HCPTSEND : When the TRSAVE function is
              complete
              HCPTSINT : TRSAVE initialization (if error)
 SERIALIZED : This control block is serialized by the
              TXCLOCKC (Trace services command lock).
 RELOCATION CONSIDERATIONS : None
 
 
  TSTBK Control Block Content Top of page
 

 TSTBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure TSTBK Trace Service Tool Block 0000 0 Dbl-Word 8 TSTUSER Userid of Trace Service Tool initiator 0008 8 Address 4 TSTTSABK Address of TSABK if tracing to DASD 000C 12 Address 4 TSTTSDBK Address of TSDBK chain if to DASD 0010 16 Address 4 TSTRDEV1 Address of 1st tape drive being used 0014 20 Address 4 TSTRDEV2 Address of 2nd tape drive being used 0018 24 Bitstring 1 TSTMODE Tape mode 00000007 TPECOMP X'07' TPECOMP MODE = NON-DEVICE SPECIFIC COMPACTION 00000006 TPE3490C X'06' TPE3490C MODE = 3490 COMPACTION 00000005 TPEXF X'05' TPEXF MODE = XF 00000004 TPE38K X'04' TPE38K MODE = 38K 00000003 TPE6250 X'03' TPE6250 MODE = 6250 BPI 00000002 TPE1600 X'02' TPE1600 MODE = 1600 BPI 00000001 TPE800 X'01' TPE800 MODE = 800 BPI 0019 25 Bitstring 1 TSTDISP Disposition of the tape 00000002 TSTREW X'02' TSTREW tape will be rewound when full 00000001 TSTRUN X'01' TSTRUN Tape will be rewound and unloaded 001A 26 Bitstring 1 TSTSTAT Trace Service Tool status flag 1... .... TSTON X'80' TSTON Trace Service Tool currently active .1.. .... TSTOFF X'40' TSTOFF Trace Service Tool turned off ..1. .... TSTCANCL X'20' TSTCANCL Trace Service Tool cancelled ...1 .... TSTFATAL X'10' TSTFATAL Trace Service Tool fatal I/O error .... 1... TSTABND X'08' TSTABND Trace Service Tool abend issued .... .1.. TSTDASD X'04' TSTDASD CP TRACE RECORDING ABEND ISSUED .... ..1. TSTATCMD X'02' TSTATCMD Command issued with AT command 001B 27 Bitstring 1 TSTWORK Trace Service Took work bit 1... .... TSTRECRD X'80' TSTRECRD Trace Service Tool recording on .1.. .... TSTLOST X'40' TSTLOST Data lost message issued ..1. .... TSTFFCC X'20' TSTFFCC Tod communication entry needed ...1 .... TSTINIT X'10' TSTINIT Initialize the full tod entry .... 1... TSTSUSP X'08' TSTSUSP Suspend trace saving .... .1.. TSTTRACG X'04' TSTTRACG TRACG entry recording in progress 001C 28 Signed 4 TSTBMSBK Pointer to Buffer Management Service Bk 0020 32 Dbl-Word 8 TSTTODLT Time of Day when issued lost message 0028 40 Dbl-Word 8 TSTFULTD Full Tod clock 0030 48 Signed 4 TSTFILPT Pointer to buffer currently filling 0034 52 Signed 4 TSTCURTE Pointer to next slot in buffer to be filled with a trace entry 0038 56 Bitstring 1 TSTFLG HCPTSTBK flag byte 1... .... TSTDFRIO X'80' TSTDFRIO Wrap buffers in storage 003C 60 Signed 4 * (0) 003C 60 Signed 4 TSTFRAME Number of real storage frames to hold in storage wrap 0040 64 Signed 4 TSTPARM (4) Parm list used by Trace Service Tools 0050 80 Signed 4 TSTSAVE (24) Savearea for use by TSMRG 00B0 176 Signed 4 TSTCPUS (448) 7 words of info for each CPU (64 CPUs) NOTES : This area must be the last area in this control block 07B0 1968 Signed 2 TSTCPEND (0) End of CPU info 000000F6 TSTSIZE (*-TSTBK+7)/8 TSTBK size in doublewords 0028 40 Bitstring 2 * Reserved 002A 42 Bitstring 6 TSTFUL6 Last 6 bytes of the full tod clock 0028 40 Signed 4 TSTFULF4 First 4 bytes of the full tod clock 002C 44 Signed 4 TSTFULL4 Last 4 bytes of the full tod clock 0028 40 Bitstring 2 TSTFULF2 First 2 bytes of the full TOD clock 0040 64 Signed 4 TSTCNT Number of buffers 0044 68 Address 4 TSTADDR1 Address of first buffer 0048 72 Address 4 TSTADDR2 Address of second buffer 004C 76 Address 4 TSTADDR3 Address of third buffer 00B0 176 Address 4 TSTLSTTE Address of last TT entry saved 00B4 180 Address 4 TSTNXTTE Address of next TT entry to be saved 00B8 184 Bitstring 1 TSTCPUST CPU status byte 1... .... TSTCPUON X'80' TSTCPUON CPU is operational .1.. .... TSTCPUSP X'40' TSTCPUSP CPU trace saving is suspended 00B9 185 Bitstring 1 * Reserved for IBM use 00BA 186 Bitstring 6 TSTLSTOD TOD of last entry saved to detect wrap 00C0 192 Bitstring 2 TSTCPUID Id of CPU whose information this is 00C2 194 Bitstring 6 TSTNXTOD TOD of next entry saved to detect wrap 00C8 200 Signed 4 TSTNEXT Pointer to the next operational CPU 0000001C TSTCPUSZ *-TSTCPUS 00CC 204 Signed 4 TSTNCPU (0) Pointer to the next cpu's information 00BA 186 Bitstring 1 TSTLST1 Highest byte of last tod 00BB 187 Bitstring 5 * Reserved 00C2 194 Bitstring 1 TSTNXT1 Highest byte of next tod 00C3 195 Bitstring 1 * Reserved 00C4 196 Bitstring 4 TSTNTOD4 Last 4 bytes of tod clock of next entry
 
 
  TSTBK Storage Layout Top of page
 
          
*** TSTBK - Trace Service Tool Block
*
*     +-------------------------------------------------------+
*   0 |                       TSTUSER                         |
*     +---------------------------+---------------------------+
*   8 |         TSTTSABK          |         TSTTSDBK          |
*     +---------------------------+---------------------------+
*  10 |         TSTRDEV1          |         TSTRDEV2          |
*     +------+------+------+------+---------------------------+
*  18 |:MODE |:DISP |:STAT |:WORK |         TSTBMSBK          |
*     +------+------+------+------+---------------------------+
*  20 |                       TSTTODLT                        |
*     +-------------------------------------------------------+
*  28 |                       TSTFULTD                        |
*     +---------------------------+---------------------------+
*  30 |         TSTFILPT          |         TSTCURTE          |
*     +------+--------------------+---------------------------+
*  38 |TSTFLG|////////////////////|         TSTFRAME          |
*     +------+--------------------+---------------------------+
*  40 |                       TSTPARM                         |
*     |                                                       |
*     +-------------------------------------------------------+
*  50 |                                                       |
*     =                       TSTSAVE                         =
*     |                                                       |
*     +-------------------------------------------------------+
*  B0 |                                                       |
*     =                       TSTCPUS                         =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** TSTBK - Trace Service Tool Block
          
*** Overlay for TSTFULTD in TSTBK
*
*     +-------------+-----------------------------------------+
*  28 |/////////////|                TSTFUL6                  |
*     +-------------+-----------------------------------------+
*  30
*
*** Overlay for TSTFULTD in TSTBK
          
*** Overlay for TSTFULTD in TSTBK
*
*     +---------------------------+---------------------------+
*  28 |         TSTFULF4          |         TSTFULL4          |
*     +---------------------------+---------------------------+
*  30
*
*** Overlay for TSTFULTD in TSTBK
          
*** Overlay for TSTFULTD in TSTBK
*
*     +-------------+
*  28 |  TSTFULF2   | 2A
*     +-------------+
*
*** Overlay for TSTFULTD in TSTBK
          
*** Overlay for TSTPARM in TSTBK
*
*     +---------------------------+---------------------------+
*  40 |          TSTCNT           |         TSTADDR1          |
*     +---------------------------+---------------------------+
*  48 |         TSTADDR2          |         TSTADDR3          |
*     +---------------------------+---------------------------+
*  50
*
*** Overlay for TSTPARM in TSTBK
          
*** Overlay for TSTCPUS in TSTBK
*
*     +---------------------------+---------------------------+
*  B0 |         TSTLSTTE          |         TSTNXTTE          |
*     +------+------+-------------+---------------------------+
*  B8 |:CPUST|//////|                TSTLSTOD                 |
*     +------+------+-----------------------------------------+
*  C0 |  TSTCPUID   |                TSTNXTOD                 |
*     +-------------+-------------+---------------------------+
*  C8 |         TSTNEXT           |
*     +---------------------------+
*
*** Overlay for TSTCPUS in TSTBK
          
*** Overlay for TSTLSTOD in TSTBK
*
*                   +------+----------------------------------+
*  B8 ...        BA |:LST1 |//////////////////////////////////|
*                   +------+----------------------------------+
*  C0
*
*** Overlay for TSTLSTOD in TSTBK
          
*** Overlay for TSTNXTOD in TSTBK
*
*                   +------+------+---------------------------+
*  C0 ...        C2 |:NXT1 |//////|         TSTNTOD4          |
*                   +------+------+---------------------------+
*  C8
*
*** Overlay for TSTNXTOD in TSTBK
 
 
  TSTBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
TPECOMP        0018 00000007
TPEXF          0018 00000005
TPE1600        0018 00000002
TPE3490C       0018 00000006
TPE38K         0018 00000004
TPE6250        0018 00000003
TPE800         0018 00000001
TSTABND        001A 08
TSTADDR1       0044
TSTADDR2       0048
TSTADDR3       004C
TSTATCMD       001A 02
TSTBMSBK       001C
TSTCANCL       001A 20
TSTCNT         0040
TSTCPEND       07B0
TSTCPUID       00C0
TSTCPUON       00B8 80
TSTCPUS        00B0
TSTCPUSP       00B8 40
TSTCPUST       00B8
TSTCPUSZ       00C8 0000001C
TSTCURTE       0034
TSTDASD        001A 04
TSTDFRIO       0038 80
TSTDISP        0019
TSTFATAL       001A 10
TSTFFCC        001B 20
TSTFILPT       0030
TSTFLG         0038
TSTFRAME       003C
TSTFULF2       0028
TSTFULF4       0028
TSTFULL4       002C
TSTFULTD       0028
TSTFUL6        002A
TSTINIT        001B 10
TSTLOST        001B 40
TSTLSTOD       00BA
TSTLSTTE       00B0
TSTLST1        00BA
TSTMODE        0018
TSTNCPU        00CC
TSTNEXT        00C8
TSTNTOD4       00C4
TSTNXTOD       00C2
TSTNXTTE       00B4
TSTNXT1        00C2
TSTOFF         001A 40
TSTON          001A 80
TSTPARM        0040
TSTRDEV1       0010
TSTRDEV2       0014
TSTRECRD       001B 80
TSTREW         0019 00000002
TSTRUN         0019 00000001
TSTSAVE        0050
TSTSIZE        07B0 000000F6
TSTSTAT        001A
TSTSUSP        001B 08
TSTTODLT       0020
TSTTRACG       001B 04
TSTTSABK       0008
TSTTSDBK       000C
TSTUSER        0000
TSTWORK        001B
 
This information is based on z/VM 6.3.0 Last updated on 22 May 2013 at 13:56:14 EDT.
Copyright IBM Corporation, 1990, 2013