|
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).
RELOCATION CONSIDERATIONS : None
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' TRCACTIV TRACEID IS ENABLED .1.. .... TRCENAB X'40' TRCENAB Traceid enabled at least once ..1. .... TRCLDEV X'20' TRCLDEV Tracing logical devices 0007 7 Bitstring 1 TRCSSM Work byte for STOSM/SSM 0008 8 Character 8 TRCTYPE TRACE TYPE OF TRACEID VALID VALUES FOR TRCTYPE ARE; BLANKS, 'DATA', 'GT'_'IO' AND 'LAN' 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 Address 8 * Reserved for IBM use 0030 48 Signed 2 TRCTYPDE (0) Start of variable length data 00000030 TRCSIZE (*-TRCBK) TRCBK SIZE IN BYTES 00000006 TRCSIZED (*-TRCBK+7)/8 TRCBK SIZE IN DOUBLEWORDS Type DATA Dependent Information 0030 48 Signed 2 TRCDATA (0) Type data dependent information 0030 48 Bitstring 1 TRCDNUM NUMBER OF DATALINK STRINGS 0031 49 Bitstring 1 TRCFLAG3 FLAG BYTE 1... .... TRCVADSP X'80' TRCVADSP VIRTUAL ADDRESS SPECIFIED .1.. .... TRCMODSP X'40' TRCMODSP MODNAME + DISPLACEMENT SPECIFIED ..1. .... TRCUPICL X'20' TRCUPICL Set if this TRSOURCE command invocation updated an ICLBK. If an error is found later during this command, the ICLBK must be reset. 0032 50 Signed 2 TRCDLEN LENGTH OF DATA TO BE COLLECTED 0034 52 Address 4 TRCHLA Host Logical Address of the instruction to trap 0038 56 Character 8 TRCMODNA MODULE NAME OF TRACE POINT 0040 64 Signed 2 TRCDISP DISPLACEMENT FROM MODULE ORIGIN 0042 66 Character 6 TRCINST INSTRUCTION OVERLAID BY SVC 28 0048 72 Address 4 TRCDTLBK POINTER TO PRINTABLE DL SOURCE 004C 76 Address 4 TRCDLS Pointer to DL state information 0050 80 Address 4 TRCTMDLS Pointer to temp DL state info. 0054 84 Bitstring 16 TRCCPXL CPXLOADed module information 0064 100 Signed 4 TRCVARY (0) DATALINKS: Start of variable length data 00000034 TRCDTSIZ (*-TRCDATA) Type DATA extension byte size 00000007 TRCDTSZD (*-TRCDATA+7)/8 DATA extension in doublewords Redefine the TRCCPXL area 0054 84 Character 8 TRCCSECT CPXLOADed csect containing the trace point 005C 92 Address 4 TRCADDRL The ICLBK for TRCCSECT 0060 96 Signed 4 * Reserved for IBM use Type IO Dependent Information 0030 48 Signed 2 TRCIO (0) Type IO dependent information 0030 48 Character 8 TRCUSRID USERID OF WHOM IO IS TRACED 0038 56 Signed 2 TRCLEN NUMBER OF BYTES TRACED FOR EACH CCW 003A 58 Bitstring 1 TRCNUM NUMBER OF DEV OR DEV RANGES TRACED 003B 59 Bitstring 1 * RESERVED 003C 60 Signed 4 * RESERVED 0040 64 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 0030 48 Signed 2 TRCGT (0) Type GT Dependent information 0030 48 Character 8 TRCGNAME EITHER USERID OR GROUPNAME 0038 56 Bitstring 1 TRCFLAG2 FLAG BYTE 1... .... TRCALLOW X'80' TRCALLOW TRCGNAME CONTAINS USERID .1.. .... TRCGROUP X'40' TRCGROUP TRCGNAME CONTAINS GROUP NAME .... 1... TRCGINCL X'08' TRCGINCL INCLUDE LIST EXISTS .... .1.. TRCGEXCL X'04' TRCGEXCL EXCLUDE LIST EXISTS 0039 57 Bitstring 1 TRCMODE MODE FOR THIS TRACE 000000C2 TRCBLO X'C2' TRCBLO B - BLOCK MODE TRACE 000000C5 TRCEVE X'C5' TRCEVE E - EVENT MODE TRACE 003A 58 Signed 2 TRCGLCNT NUMBER OF ENTRIES IN INCLUDE/EXCLUDE LIST 003C 60 Address 4 TRCGLIST ADDRESS OF INCLUDE/EXCLUDE LIST 0040 64 Signed 2 * RESERVED 0042 66 Signed 2 TRCGUCNT NUMBER OF ENTRIES IN GROUP TRACE LIST OF ENABLED USERIDS 0044 68 Address 4 TRCGULST ADDRESS OF GROUP TRACE LIST OF ENABLED USERIDS 0048 72 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 Type LAN Dependent Information 0030 48 Signed 2 TRCLN (0) Type LAN Dependent information 0030 48 Address 4 TRCLNXT PTR to Next LAN TRCBK 0034 52 Address 4 * Reserved 0038 56 Character 16 TRCLANID (0) LAN ID 0038 56 Character 8 TRCOWNER LAN OWNER 0040 64 Character 8 TRCLANNM LAN NAME 0048 72 Character 8 TRCUSER USER ID 0050 80 Signed 2 TRCVLAN1 VLAN ID 1 - IF 0000 THEN ALL VLANS 0052 82 Signed 2 TRCVLAN2 VLAN ID 2 0054 84 Signed 2 TRCVLAN3 VLAN ID 3 0056 86 Signed 2 TRCVLAN4 VLAN ID 4 0058 88 Signed 2 TRCVDEV Virtual Device (VDEV) - NIC 005A 90 Signed 2 TRCLENG Number of bytes (64 < N < 2096) 005C 92 Bitstring 1 TRCOPTNS OPTIONS BYTE 00000000 TRCNONE X'00' TRCNONE NO OPTIONS SET 00000001 TRCNIC X'01' TRCNIC NIC OPTION SET 00000002 TRCTRUNK X'02' TRCTRUNK TRUNK OPTION SET 00000003 TRCDROP X'03' TRCDROP DROPPED OPTION SET 0000002D TRCLNSIZ (*-TRCLN) Type LAN extension Byte size 00000006 TRCLNSZD (*-TRCLN+7)/8 LAN extension in doublewords
TRCBK Storage Layout
*** TRCBK - Traceid block
*
* +---------------------------+-------------+------+------+
* 0 | TRCNEXT | TRCLNG |:FLAG1|TRCSSM|
* +---------------------------+-------------+------+------+
* 8 | TRCTYPE |
* +-------------------------------------------------------+
* 10 | TRCSET |
* +-------------------------------------------------------+
* 18 | TRCID |
* +---------------------------+---------------------------+
* 20 | TRCTSABK | TRCTSDBK |
* +---------------------------+---------------------------+
* 28 |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
*
*** TRCBK - Traceid block
*** Overlay for TRCTYPDE in TRCBK
*
* +------+------+-------------+---------------------------+
* 30 |:DNUM |:FLAG3| TRCDLEN | TRCHLA |
* +------+------+-------------+---------------------------+
* 38 | TRCMODNA |
* +-------------+-----------------------------------------+
* 40 | TRCDISP | TRCINST |
* +-------------+-------------+---------------------------+
* 48 | TRCDTLBK | TRCDLS |
* +---------------------------+---------------------------+
* 50 | TRCTMDLS | |
* +---------------------------+ |
* | TRCCPXL |
* | +---------------------------+
* | |
* +---------------------------+
*
*** Overlay for TRCTYPDE in TRCBK
*** Overlay for TRCCPXL in TRCBK
*
* +---------------------------+
* ... 54 | TRCCSECT- |
* +---------------------------+---------------------------+
* 58 | -(054) | TRCADDRL |
* +---------------------------+---------------------------+
* 60 |///////////////////////////| 64
* +---------------------------+
*
*** Overlay for TRCCPXL in TRCBK
*** Overlay for TRCTYPDE in TRCBK
*
* +-------------------------------------------------------+
* 30 | TRCUSRID |
* +-------------+------+------+---------------------------+
* 38 | TRCLEN |TRCNUM|//////|///////////////////////////|
* +-------------+------+------+---------------------------+
*
*** Overlay for TRCTYPDE in TRCBK
*** Overlay for TRCTYPDE in TRCBK
*
* +-------------------------------------------------------+
* 30 | TRCGNAME |
* +------+------+-------------+---------------------------+
* 38 |:FLAG2|:MODE | TRCGLCNT | TRCGLIST |
* +------+------+-------------+---------------------------+
* 40 |/////////////| TRCGUCNT | TRCGULST |
* +-------------+-------------+---------------------------+
* 48 | TRCGENID |
* +-------------------------------------------------------+
* 50
*
*** Overlay for TRCTYPDE in TRCBK
*** Overlay for TRCTYPDE in TRCBK
*
* +---------------------------+---------------------------+
* 30 | TRCLNXT |///////////////////////////|
* +---------------------------+---------------------------+
* 38 | TRCOWNER |
* +-------------------------------------------------------+
* 40 | TRCLANNM |
* +-------------------------------------------------------+
* 48 | TRCUSER |
* +-------------+-------------+-------------+-------------+
* 50 | TRCVLAN1 | TRCVLAN2 | TRCVLAN3 | TRCVLAN4 |
* +-------------+-------------+------+------+-------------+
* 58 | TRCVDEV | TRCLENG |:OPTNS| 5D
* +-------------+-------------+------+
*
*** Overlay for TRCTYPDE in TRCBK
TRCBK Cross Reference
Symbol Dspl Value -------------- ---- ----- TRCACTIV 0006 80 TRCADDRL 005C TRCALLOW 0038 80 TRCBLO 0039 000000C2 TRCCPXL 0054 TRCCSECT 0054 TRCDATA 0030 TRCDEVAD 0040 TRCDISP 0040 TRCDLEN 0032 TRCDLS 004C TRCDNUM 0030 TRCDROP 005C 00000003 TRCDTLBK 0048 TRCDTSIZ 0064 00000034 TRCDTSZD 0064 00000007 TRCENAB 0006 40 TRCEVE 0039 000000C5 TRCFLAG1 0006 TRCFLAG2 0038 TRCFLAG3 0031 TRCGENID 0048 TRCGEXCL 0038 04 TRCGINCL 0038 08 TRCGLCNT 003A TRCGLIST 003C TRCGNAME 0030 TRCGROUP 0038 40 TRCGT 0030 TRCGTSIZ 0048 00000020 TRCGTSZD 0048 00000004 TRCGUCNT 0042 TRCGULST 0044 TRCHLA 0034 TRCID 0018 TRCINST 0042 TRCIO 0030 TRCIOSIZ 0040 00000010 TRCIOSZD 0040 00000002 TRCLANID 0038 TRCLANNM 0040 TRCLDEV 0006 20 TRCLEN 0038 TRCLENG 005A TRCLN 0030 TRCLNG 0004 TRCLNSIZ 005C 0000002D TRCLNSZD 005C 00000006 TRCLNXT 0030 TRCMODE 0039 TRCMODNA 0038 TRCMODSP 0031 40 TRCNEXT 0000 TRCNIC 005C 00000001 TRCNONE 005C 00000000 TRCNUM 003A TRCOPTNS 005C TRCOWNER 0038 TRCSET 0010 TRCSIZE 0030 00000030 TRCSIZED 0030 00000006 TRCSSM 0007 TRCTMDLS 0050 TRCTRUNK 005C 00000002 TRCTSABK 0020 TRCTSDBK 0024 TRCTYPDE 0030 TRCTYPE 0008 TRCUPICL 0031 20 TRCUSER 0048 TRCUSRID 0030 TRCVADSP 0031 80 TRCVARY 0064 TRCVDEV 0058 TRCVLAN1 0050 TRCVLAN2 0052 TRCVLAN3 0054 TRCVLAN4 0056
Copyright IBM Corporation, 1990, 2011