|
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. |
TRCBK
Cross Reference (Contains links to field and bit definitions)
TRCBK Prolog
NAME : HCPTRCBK
DESCRIPTION: Traceid block
DSECT : TRCBK
FUNCTION : Contains trace information and status of
a traceid
LOCATED BY : TXCTRCBK, RDEVTRC
CREATED BY : HCPTXP : TRSOURCE command parser
DELETED BY : HCPTXP : TRSOURCE command parser
SERIALIZED : This control block is serialized by the
TXCLOCKC (Trace services command lock).
TRCBK Control Block Content
TRCBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure TRCBK Traceid block 0000 0 Signed 4 TRCNEXT POINTER TO NEXT TRCBK IN CHAIN 0004 4 Signed 2 TRCLNG LENGTH OF TRCBK WITH EXTENSIONS 0006 6 Bitstring 1 TRCFLAG1 TRCBK FLAGS 1... .... TRCACTIV X'80' TRACEID IS ENABLED .1.. .... TRCENAB X'40' Traceid enabled at least once 0007 7 Bitstring 1 * RESERVED 0008 8 Character 8 TRCTYPE TRACE TYPE OF TRACEID VALID VALUES FOR TRCTYPE ARE; BLANKS, 'DATA', 'GT' AND 'IO' 0010 16 Character 8 TRCSET TRACE SET OF TRACEID 0018 24 Character 8 TRCID TRACEID FOR THE TRCBK 0020 32 Address 4 TRCTSABK Address of TSABK 0024 36 Address 4 TRCTSDBK ADDRESS OF TSDBK 0028 40 Signed 2 TRCTYPDE (0) Start of variable length data 00000028 TRCSIZE (*-TRCBK) TRCBK SIZE IN BYTES 00000005 TRCSIZED (*-TRCBK+7)/8 TRCBK SIZE IN DOUBLEWORDS Type DATA Dependent Information 0028 40 Signed 2 TRCDATA (0) Type data dependent information 0028 40 Bitstring 1 TRCDNUM NUMBER OF DATALINK STRINGS 0029 41 Bitstring 1 TRCFLAG3 FLAG BYTE 1... .... TRCVADSP X'80' VIRTUAL ADDRESS SPECIFIED .1.. .... TRCMODSP X'40' MODNAME + DISPLACEMENT SPECIFIED ..1. .... TRCUPICL X'20' Set if this TRSOURCE command invocation updated an ICLBK. If an error is found later during this command, the ICLBK must be reset. 002A 42 Signed 2 TRCDLEN LENGTH OF DATA TO BE COLLECTED 002C 44 Address 4 TRCVADDR VIRTUAL ADDRESS OF TRACE POINT 0030 48 Character 8 TRCMODNA MODULE NAME OF TRACE POINT 0038 56 Signed 2 TRCDISP DISPLACEMENT FROM MODULE ORIGIN 003A 58 Character 6 TRCINST INSTRUCTION OVERLAID BY SVC 28 0040 64 Address 4 TRCRADDR REAL ADDRESS OF TRACE POINT 0044 68 Address 4 TRCDTLBK POINTER TO PRINTABLE DL SOURCE 0048 72 Address 4 TRCDLS Pointer to DL state information 004C 76 Address 4 TRCTMDLS Pointer to temp DL state info. 0050 80 Bitstring 16 TRCCPXL CPXLOADed module information 0060 96 Signed 4 TRCVARY (0) DATALINKS: Start of variable length data 00000038 TRCDTSIZ (*-TRCDATA) Type DATA extension byte size 00000007 TRCDTSZD (*-TRCDATA+7)/8 DATA extension in doublewords Redefine the TRCCPXL area 0050 80 Character 8 TRCCSECT CPXLOADed csect containing the trace point 0058 88 Address 4 TRCADDRL The ICLBK for TRCCSECT 005C 92 Signed 4 * Reserved for IBM use Type IO Dependent Information 0028 40 Signed 2 TRCIO (0) Type IO dependent information 0028 40 Character 8 TRCUSRID USERID OF WHOM IO IS TRACED 0030 48 Signed 2 TRCLEN NUMBER OF BYTES TRACED FOR EACH CCW 0032 50 Bitstring 1 TRCNUM NUMBER OF DEV OR DEV RANGES TRACED 0033 51 Bitstring 1 * RESERVED 0034 52 Signed 4 * RESERVED 0038 56 Signed 4 TRCDEVAD (0) START OF DEVADDR/RANGES AREA 00000010 TRCIOSIZ (*-TRCIO) Type IO extension byte size 00000002 TRCIOSZD (*-TRCIO+7)/8 IO extension in doublewords Type GT Dependent Information 0028 40 Signed 2 TRCGT (0) Type GT Dependent information 0028 40 Character 8 TRCGNAME EITHER USERID OR GROUPNAME 0030 48 Bitstring 1 TRCFLAG2 FLAG BYTE 1... .... TRCALLOW X'80' TRCGNAME CONTAINS USERID .1.. .... TRCGROUP X'40' TRCGNAME CONTAINS GROUP NAME .... 1... TRCGINCL X'08' INCLUDE LIST EXISTS .... .1.. TRCGEXCL X'04' EXCLUDE LIST EXISTS 0031 49 Bitstring 1 TRCMODE MODE FOR THIS TRACE 000000C2 TRCBLO X'C2' B - BLOCK MODE TRACE 000000C5 TRCEVE X'C5' E - EVENT MODE TRACE 0032 50 Signed 2 TRCGLCNT NUMBER OF ENTRIES IN INCLUDE/EXCLUDE LIST 0034 52 Address 4 TRCGLIST ADDRESS OF INCLUDE/EXCLUDE LIST 0038 56 Signed 2 * RESERVED 003A 58 Signed 2 TRCGUCNT NUMBER OF ENTRIES IN GROUP TRACE LIST OF ENABLED USERIDS 003C 60 Address 4 TRCGULST ADDRESS OF GROUP TRACE LIST OF ENABLED USERIDS 0040 64 Character 8 TRCGENID USERID WHO ENABLED THE TRACE 00000020 TRCGTSIZ (*-TRCGT) Type GT extension Byte size 00000004 TRCGTSZD (*-TRCGT+7)/8 GT extension in doublewords
TRCBK Storage Layout
*** TRCBK - Traceid block * * +---------------------------+-------------+------+------+ * 0 | TRCNEXT | TRCLNG |:FLAG1|//////| * +---------------------------+-------------+------+------+ * 8 | TRCTYPE | * +-------------------------------------------------------+ * 10 | TRCSET | * +-------------------------------------------------------+ * 18 | TRCID | * +---------------------------+---------------------------+ * 20 | TRCTSABK | TRCTSDBK | * +---------------------------+---------------------------+ * 28 | | * = TRCTYPDE = * | | * +-------------------------------------------------------+ * *** TRCBK - Traceid block *** Overlay for TRCTYPDE in TRCBK * * +------+------+-------------+---------------------------+ * 28 |:DNUM |:FLAG3| TRCDLEN | TRCVADDR | * +------+------+-------------+---------------------------+ * 30 | TRCMODNA | * +-------------+-----------------------------------------+ * 38 | TRCDISP | TRCINST | * +-------------+-------------+---------------------------+ * 40 | TRCRADDR | TRCDTLBK | * +---------------------------+---------------------------+ * 48 | TRCDLS | TRCTMDLS | * +---------------------------+---------------------------+ * 50 | TRCCPXL | * | | * +-------------------------------------------------------+ * 60 | | * = TRCVARY = * | | * +-------------------------------------------------------+ * *** Overlay for TRCTYPDE in TRCBK *** Overlay for TRCCPXL in TRCBK * * +-------------------------------------------------------+ * 50 | TRCCSECT | * +---------------------------+---------------------------+ * 58 | TRCADDRL |///////////////////////////| * +---------------------------+---------------------------+ * 60 * *** Overlay for TRCCPXL in TRCBK *** Overlay for TRCTYPDE in TRCBK * * +-------------------------------------------------------+ * 28 | TRCUSRID | * +-------------+------+------+---------------------------+ * 30 | TRCLEN |TRCNUM|//////|///////////////////////////| * +-------------+------+------+---------------------------+ * 38 | | * = TRCDEVAD = * | | * +-------------------------------------------------------+ * *** Overlay for TRCTYPDE in TRCBK *** Overlay for TRCTYPDE in TRCBK * * +-------------------------------------------------------+ * 28 | TRCGNAME | * +------+------+-------------+---------------------------+ * 30 |:FLAG2|:MODE | TRCGLCNT | TRCGLIST | * +------+------+-------------+---------------------------+ * 38 |/////////////| TRCGUCNT | TRCGULST | * +-------------+-------------+---------------------------+ * 40 | TRCGENID | * +-------------------------------------------------------+ * 48 * *** Overlay for TRCTYPDE in TRCBK
TRCBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----TRCACTIV 0006 80
TRCADDRL 0058
TRCALLOW 0030 80
TRCBLO 0031 000000C2
TRCCPXL 0050
TRCCSECT 0050
TRCDATA 0028
TRCDEVAD 0038
TRCDISP 0038
TRCDLEN 002A
TRCDLS 0048
TRCDNUM 0028
TRCDTLBK 0044
TRCDTSIZ 0060 00000038
TRCDTSZD 0060 00000007
TRCENAB 0006 40
TRCEVE 0031 000000C5
TRCFLAG1 0006
TRCFLAG2 0030
TRCFLAG3 0029
TRCGENID 0040
TRCGEXCL 0030 04
TRCGINCL 0030 08
TRCGLCNT 0032
TRCGLIST 0034
TRCGNAME 0028
TRCGROUP 0030 40
TRCGT 0028
TRCGTSIZ 0040 00000020
TRCGTSZD 0040 00000004
TRCGUCNT 003A
TRCGULST 003C
TRCID 0018
TRCINST 003A
TRCIO 0028
TRCIOSIZ 0038 00000010
TRCIOSZD 0038 00000002
TRCLEN 0030
TRCLNG 0004
TRCMODE 0031
TRCMODNA 0030
TRCMODSP 0029 40
TRCNEXT 0000
TRCNUM 0032
TRCRADDR 0040
TRCSET 0010
TRCSIZE 0028 00000028
TRCSIZED 0028 00000005
TRCTMDLS 004C
TRCTSABK 0020
TRCTSDBK 0024
TRCTYPDE 0028
TRCTYPE 0008
TRCUPICL 0029 20
TRCUSRID 0028
TRCVADDR 002C
TRCVADSP 0029 80
TRCVARY 0060
Last updated on 3 Aug 1999 at 13:39:40 EDT.
Copyright IBM Corporation, 1990, 1999