TRCBK Back to Index page
 
Prolog 
Control Block Contents 
   TRCBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  TRCBK Prolog Top of page
 
 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 Top of page
 

 TRCBK DSECT Top of page
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'_'LAN' and 'PCI' 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 Type PCI reuses type IO structure definition 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 <= 2048) 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 Top of page
 
          
*** 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 Top of page
 
 
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
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:57:10 EDT.
Copyright IBM Corporation, 1990, 2022