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 V5R2.0. Last updated on 12 Apr 2006 at 17:36:10 EDT.
Copyright IBM Corporation, 1990, 2005