|
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM. |
TRCBK
Control Block Contents
TRCBK DSECT
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 |
* +---------------------------+---------------------------+
*
*** 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 |
* | |
* +-------------------------------------------------------+
*
*** 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|//////|///////////////////////////|
* +-------------+------+------+---------------------------+
*
*** 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
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 5 Jun 2001 at 17:01:24 EDT.
Copyright IBM Corporation, 1990, 2001