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 V4R3.0. Last updated on 30 Apr 2002 at 18:11:18 EDT.
Copyright IBM Corporation, 1990, 2002