Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
TSTBK
Control Block Contents
TSTBK DSECT
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
Copyright IBM Corporation, 1990, 2001