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 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' 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.
              .... 1...      TRC3HRA        X'08' Host Real Address
    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' 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
    0039   57 Bitstring    1 TRCMODE        MODE FOR THIS TRACE
              000000C2       TRCBLO         X'C2' B - BLOCK MODE TRACE
              000000C5       TRCEVE         X'C5' 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' NO OPTIONS SET
              00000001       TRCNIC         X'01' NIC OPTION SET
              00000002       TRCTRUNK       X'02' TRUNK OPTION SET
              00000003       TRCDROP        X'03' 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
    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
    TRC3HRA        0031 08

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:34:39 EDT.
Copyright IBM Corporation, 1990, 2005