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

TSTBK

Prolog  

Control Block Contents  
   TSTBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


TSTBK Prolog

 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).

 

TSTBK Control Block Content


TSTBK DSECT

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' MODE = NON-DEVICE SPECIFIC
                                        COMPACTION
          00000006       TPE3490C       X'06' MODE = 3490 COMPACTION
          00000005       TPEXF          X'05' MODE = XF
          00000004       TPE38K         X'04' MODE = 38K
          00000003       TPE6250        X'03' MODE = 6250 BPI
          00000002       TPE1600        X'02' MODE = 1600 BPI
          00000001       TPE800         X'01' MODE = 800 BPI
0019   25 Bitstring    1 TSTDISP        Disposition of the tape
          00000002       TSTREW         X'02' tape will be rewound when
                                        full
          00000001       TSTRUN         X'01' Tape will be rewound and
                                        unloaded
001A   26 Bitstring    1 TSTSTAT        Trace Service Tool status flag
          1... ....      TSTON          X'80' Trace Service Tool
                                        currently active
          .1.. ....      TSTOFF         X'40' Trace Service Tool turned
                                        off
          ..1. ....      TSTCANCL       X'20' Trace Service Tool
                                        cancelled
          ...1 ....      TSTFATAL       X'10' Trace Service Tool fatal
                                        I/O error
          .... 1...      TSTABND        X'08' Trace Service Tool abend
                                        issued
          .... .1..      TSTDASD        X'04' CP TRACE RECORDING ABEND
                                        ISSUED
001B   27 Bitstring    1 TSTWORK        Trace Service Took work bit
          1... ....      TSTRECRD       X'80' Trace Service Tool
                                        recording on
          .1.. ....      TSTLOST        X'40' Data lost message issued
          ..1. ....      TSTFFCC        X'20' Tod communication entry
                                        needed
          ...1 ....      TSTINIT        X'10' Initialize the full tod
                                        entry
          .... 1...      TSTSUSP        X'08' Suspend trace saving
          .... .1..      TSTTRACG       X'04' 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' 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' CPU is operational
          .1.. ....      TSTCPUSP       X'40' 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

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

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
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 V4R3.0. Last updated on 30 Apr 2002 at 18:15:59 EDT.
Copyright IBM Corporation, 1990, 2002