|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
TSTBK
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 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 = * | | * +-------------------------------------------------------+ * 7B0 | | * = TSTCPEND = * | | * +-------------------------------------------------------+ * *** 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 | | * +---------------------------+ | * D0 | | * = TSTNCPU = * | | * +-------------------------------------------------------+ * *** 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
(contains links to field and bit definitions)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
TSTTSABK 0008
TSTTSDBK 000C
TSTUSER 0000
TSTWORK 001B
Last updated on 3 Aug 1999 at 13:41:36 EDT.
Copyright IBM Corporation, 1990, 1999