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