Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

TRCBK

Prolog  

Control Block Contents  
   TRCBK DSECT

Storage Layout  

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

This information is based on z/VM V4R2.0. Last updated on 17 Oct 2001 at 17:00:15 EDT.
Copyright IBM Corporation, 1990, 2001