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

DTFBK

Prolog  

Control Block Contents  
   DTFBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


DTFBK Prolog

 NAME       : HCPDTFBK
 DESCRIPTION: DATATRACE TRACE RECORD FORMAT BLOCK
              FOR TRACES OF TYPE DATA AND TYPE IO
 DSECT      : DTFBK
 FUNCTION   : OVERLAY FOR THE TRACE RECORDS CREATED BY CP
              FOR DATATRACE TRACES OF TYPE DATA AND TYPE IO
 LOCATED BY : EVTCONBF
 CREATED BY : HCPTXW
 DELETED BY : HCPTXW
 NOTES      : DTFRLNGT IS ALSO MAPPED BY MCFRLNGT
              DTFTOD   IS ALSO MAPPED BY MCFTOD
              ANY CHANGES TO HCPDTFBK THAT AFFECTS THE
              DISPLACEMENT OR FORMAT OF THESE FIELDS MUST
              ALSO BE MADE TO HCPMCFBK AND VICA VERSA
              If the length of this block increases,
              compile HCPTSR to make sure that the change
              does not cause the trace data maximum for
              any of the trace types to become invalid.

 

DTFBK Control Block Content


DTFBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DTFBK          DATATRACE TRACE RECORD FORMAT
                                        BLOCK
0000    0 Signed       2 DTFRLNGT       LENGTH OF TRACE RECORD IN BYTES
                                        ALSO MAPPED BY MCFRLNGT
0002    2 Signed       2 DTFCPUAD       PROCESSOR ADDRESS
0004    4 Signed       2 *              RESERVED - MUST BE SET TO ZEROS
0006    6 Bitstring    1 DTFTYPE        TYPE OF EVENT TRACE RECORD
          00000002       DTFDATA        X'02' TYPE DATA TRACE
          00000004       DTFIO          X'04' TYPE IO TRACE
0007    7 Bitstring    1 *              RESERVED - MUST BE SET TO ZEROS
0008    8 Dbl-Word     8 DTFTOD         TOD CLOCK VALUE ALSO MAPPED BY
                                        MCFTOD
0010   16 Dbl-Word     8 DTFDTHR (0)    START OF DATA (VARIABLE LENGTH)
0010   16 Character    8 DTFID          TRACEID THAT CREATED THIS RECORD
0018   24 Character    8 DTFSET         TRACESET OF WHICH TRACEID IS
                                        MEMBER
0020   32 Bitstring    1 DTFGEN (0)     Start of variable length data
0020   32 Bitstring    1 DTFDLNUM       NUMBER OF DATALINK STRINGS IN
                                        RECORD
0021   33 Bitstring    3 *              RESERVED - MUST BE SET TO ZEROS
0024   36 Signed       4 DTFVADDR       VIRTUAL ADDRESS OF TRACE POINT
          00000028       DTFDLSZ        *-DTFBK LENGTH OF HEADER FOR TYPE
                                        DATA THE TYPE DATA RECORD
                                        CONTAINS THE FOLLOWING FOR EACH
                                        DATALINK: THE LENGTH OF THE
                                        DATALINK STRING, THE DATALINK
                                        STRING, THE LENGTH OF THE DATA
                                        FOR THIS DATALINK, AND THE DATA.
0028   40 Bitstring    1 DTFDLLEN       LENGTH OF THE DATALINK STRING
0029   41 Bitstring    1 DTFDLINK (0)   DATALINK STRING - VARIABLE LENGTH
0029   41 Bitstring    2 DTFDDATL       LENGTH OF THE DATA ASSOCIATED
                                        WITH THIS DATALINK
          0000FFFF       DTFINVDL       X'FFFF' VALUE OF DTFDDATL IF THE
                                        DATA FOR THE DATALINK WAS AT AN
                                        INVALID ADDRESS (SO NO DATA WAS
                                        TRACED)
002B   43 Bitstring    1 DTFDDATA (0)   DATA ASSOCIATED WITH THIS
                                        DATALINK - VARIABLE LENGTH
0020   32 Dbl-Word     8 DTFIOUSR       USERID OF WHOM IO IS TRACED
0028   40 Signed       2 DTFIODEV       DEVICE THAT IS TRACED
002A   42 Signed       2 DTFIOLEN       NUMBER OF BYTES OF DATA TRACED
                                        FOR EACH CCW
002C   44 Bitstring    1 DTFIOFLG       FLAG BYTE
          1... ....      DTFRUNC        X'80' DATA TRUNCATED
          .1.. ....      DTFUNSOL       X'40' UNSOLICITED INTERRUPT
          ..1. ....      DTFF1CCW       X'20' FORMAT 1 CCWS
          ...1 ....      DTFCSNS        X'10' Concurrent Sense Data
                                        received
          .... 1...      DTFGPSW        X'08' ESAME-format PSW
          .... .1..      DTFF2IDA       X'04' Format-2 IDAWs active
          .... ..1.      DTF2KIDA       X'02' Format-2 IDAWs 2K boundary
002D   45 Bitstring    3 *              RESERVED - MUST BE SET TO ZEROS
0030   48 Dbl-Word     8 DTFIOPSW       ESA 390: I/O Old PSW
0030   48 Bitstring    8 DTFIGPSW       ESAME: I/O Old PSW
0040   64 Signed       4 DTFIOCSW (3)   SUBCHANNEL CSW FROM IRB
004C   76 Signed       4 DTFIOESW       First word of ESW from IRB
0050   80 Signed       4 DTFIOERW       Extended Report Word from IRB
0054   84 Bitstring   32 DTFIOCSN       Concurrent sense data from IRB
          00000074       DTFIOHDR       *-DTFBK LENGTH OF HEADER OF IO
                                        TRACE RECORD THE IO TRACE ENTRY
                                        CONTAINS ONE OR MORE CCW
                                        SUBSECTIONS, EACH COMPOSED OF A
                                        CCW, AN IDAW LIST IF IDA IS
                                        INDICATED, AND CCW DATA.
0074  116 Signed       4 DTFIOCCW       FIRST WORD OF CCW
0078  120 Signed       4 DTFIOCW2       SECOND WORD OF CCW
007C  124 Signed       4 DTFIOCWA       REAL ADDRESS OF CCW
     THE FOLLOWING FIELDS ARE USED IF IDA IS OFF:
0080  128 Signed       2 DTFCDATL       LENGTH OF DATA FOR THE CCW NOTE:
                                        SOME HIGH-ORDER BITS OF THIS
                                        FIELD HAVE ANOTHER USE
          0000000E       DTFCWHDR       *-DTFIOCCW CCW HEADER SECTION.
                                        THIS IS THE MINIMUM INFORMATION
                                        COLLECTED FOR A CCW. THIS
                                        INFORMATION INCLUDES THE CCW
                                        ITSELF, ITS ADDRESS AND EITHER
                                        THE CCW DATA LENGTH (FOR NON-IDA
                                        CCW) OR IDAW COUNT (FOR IDA CCW).
                                        NOTE THE DEPENDENCY ON DTFCWHDR
                                        BEING LARGE ENOUGH TO INCLUDE
                                        EITHER DTFCDATL OR DTFIDACT. AN
                                        OFFSET OR LENGHT CHANGE TO EITHER
                                        OF THESE FIELDS AFFECTS THE
                                        LOCATION OF DTFCWHDR.
0082  130 Bitstring    1 DTFCDATA (0)   VARIABLE LENGTH FIELD CONTAINING
                                        THE DATA THAT WAS TRACED FOR THE
                                        CCW (ENDS ON A WORD BOUNDARY)
     THE FOLLOWING FIELDS ARE USED IF IDA IS ON:
0080  128 Signed       2 DTFIDACT       COUNT OF IDAWS FOR THE CCW NOTE:
                                        SOME HIGH-ORDER BITS OF THIS
                                        FIELD HAVE ANOTHER USE. NOTE: SEE
                                        DEPENDENCY ON DTFCWHDR.
0082  130 Signed       2 *              RESERVED
0084  132 Signed       4 DTFILIST (0)   BEGINNING OF LIST OF IDAWS (EACH
                                        MAPPED BY DTFIDAW)
0084  132 Signed       4 DTFIDAW        IDAW
0088  136 Signed       2 DTFILSTD (0)   BEGINNING OF DATA FIELDS - ONE
                                        FOR EACH IDAW IN DTFILIST - EACH
                                        DATA FIELD MAPPED BY DTFIDATL AND
                                        DTFIDATA
0088  136 Signed       2 DTFIDATL       LENGTH OF DATA FOR THE IDAW NOTE:
                                        SOME HIGH-ORDER BITS OF THIS
                                        FIELD HAVE ANOTHER USE. NOTE: A
                                        DTFIDATL VALUE OF 0 INDICATES
                                        THERE IS NO DATA FOR THE
                                        CORRESPONDING IDAW AND THAT THERE
                                        IS NO DATA FOR ANY OF THE
                                        SUBSEQUENT IDAWS IN DTFILIST
          00000016       DTFIWHDR       *-DTFIOCCW IDAW header section
008A  138 Bitstring    1 DTFIDATA (0)   VARIABLE LENGTH FIELD CONTAINING
                                        THE DATA THAT WAS TRACED FOR THE
                                        IDAW (ENDS ON A WORD BOUNDARY)
     Start of Format-2 IDAW definition
0084  132 Bitstring    8 DTF2IDAW (0)   8 Byte format-2 IDAW
0084  132 Signed       4 DTF2IDW0       High order word of a fmt-2 IDAW
0088  136 Signed       4 DTF2IDW1       Low order word of a fmt-2 IDAW
008C  140 Signed       2 DTF2IDLN       Length of data for this fmt2 IDAW
008E  142 Bitstring    1 DTF2IDAT (0)   Data from the fmt-2 IDA End of
                                        Format-2 IDAW definition
     VALUE DEFINED FOR FIRST BYTE OF DTFCDATL, DTFIDATL, AND DTFIDACT
          1... ....      DTFINVAD       X'80' FOR DATA LENGTH FIELDS:
                                        INDICATES THE DATA ADDRESS WAS
                                        INVALID. FOR THE IDAW COUNT
                                        FIELD: INDICATES THE IDAW ADDRESS
                                        POINTED TO BY THE CCW IS INVALID.
          .1.. ....      DTFSKIPV       X'40' SKIP BIT IS INVALID FOR
                                        THIS CCW (ONLY DEFINED FOR FIRST
                                        BYTE OF DTFCDATL AND DTFIDACT)

 

DTFBK Storage Layout

          
*** DTFBK - DATATRACE TRACE RECORD FORMAT BLOCK
*
*     +-------------+-------------+-------------+------+------+
*   0 |  DTFRLNGT   |  DTFCPUAD   |/////////////|:TYPE |//////|
*     +-------------+-------------+-------------+------+------+
*   8 |                        DTFTOD                         |
*     +-------------------------------------------------------+
*  10 |                        DTFID                          |
*     +-------------------------------------------------------+
*  18 |                        DTFSET                         |
*     +-------------------------------------------------------+
*
*** DTFBK - DATATRACE TRACE RECORD FORMAT BLOCK
          
*** Overlay for DTFGEN in DTFBK
*
*     +------+--------------------+---------------------------+
*  20 |:DLNUM|////////////////////|         DTFVADDR          |
*     +------+-------------+------+---------------------------+
*  28 |:DLLEN|  DTFDDATL   |
*     +------+-------------+
*
*** Overlay for DTFGEN in DTFBK
          
*** Overlay for DTFGEN in DTFBK
*
*     +-------------------------------------------------------+
*  20 |                       DTFIOUSR                        |
*     +-------------+-------------+------+--------------------+
*  28 |  DTFIODEV   |  DTFIOLEN   |:IOFLG|////////////////////|
*     +-------------+-------------+------+--------------------+
*  30 |                       DTFIOPSW                        |
*     +-------------------------------------------------------+
*  38
*
*** Overlay for DTFGEN in DTFBK
          
*** Overlay for DTFIOPSW in DTFBK
*
*     +-------------------------------------------------------+
*  30 |                       DTFIGPSW                        |
*     +-------------------------------------------------------+
*  38 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  40 |                       DTFIOCSW                        |
*     |                           +---------------------------+
*  48 |                           |         DTFIOESW          |
*     +---------------------------+---------------------------+
*  50 |         DTFIOERW          |                           |
*     +---------------------------+                           |
*  58 |                                                       |
*     =                       DTFIOCSN                        =
*     |                           +---------------------------+
*  70 |                           |         DTFIOCCW          |
*     +---------------------------+---------------------------+
*  78 |         DTFIOCW2          |         DTFIOCWA          |
*     +-------------+-------------+---------------------------+
*  80 |  DTFCDATL   |
*     +-------------+
*
*** Overlay for DTFIOPSW in DTFBK
          
*** Overlay for DTFCDATL in DTFBK
*
*     +-------------+-------------+---------------------------+
*  80 |  DTFIDACT   |/////////////|         DTFIDAW           |
*     +-------------+-------------+---------------------------+
*  88 |  DTFIDATL   |
*     +-------------+
*
*** Overlay for DTFCDATL in DTFBK
          
*** Overlay for DTFIDAW in DTFBK
*
*                                 +---------------------------+
*  80 ...                      84 |         DTF2IDW0          |
*     +---------------------------+-------------+-------------+
*  88 |         DTF2IDW1          |  DTF2IDLN   |
*     +---------------------------+-------------+
*
*** Overlay for DTFIDAW in DTFBK

 

DTFBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
DTFCDATA       0082
DTFCDATL       0080
DTFCPUAD       0002
DTFCSNS        002C 10
DTFCWHDR       0080 0000000E
DTFDATA        0006 00000002
DTFDDATA       002B
DTFDDATL       0029
DTFDLINK       0029
DTFDLLEN       0028
DTFDLNUM       0020
DTFDLSZ        0024 00000028
DTFDTHR        0010
DTFF1CCW       002C 20
DTFF2IDA       002C 04
DTFGEN         0020
DTFGPSW        002C 08
DTFID          0010
DTFIDACT       0080
DTFIDATA       008A
DTFIDATL       0088
DTFIDAW        0084
DTFIGPSW       0030
DTFILIST       0084
DTFILSTD       0088
DTFINVAD       008E 80
DTFINVDL       0029 0000FFFF
DTFIO          0006 00000004
DTFIOCCW       0074
DTFIOCSN       0054
DTFIOCSW       0040
DTFIOCWA       007C
DTFIOCW2       0078
DTFIODEV       0028
DTFIOERW       0050
DTFIOESW       004C
DTFIOFLG       002C
DTFIOHDR       0054 00000074
DTFIOLEN       002A
DTFIOPSW       0030
DTFIOUSR       0020
DTFIWHDR       0088 00000016
DTFRLNGT       0000
DTFRUNC        002C 80
DTFSET         0018
DTFSKIPV       008E 40
DTFTOD         0008
DTFTYPE        0006
DTFUNSOL       002C 40
DTFVADDR       0024
DTF2IDAT       008E
DTF2IDAW       0084
DTF2IDLN       008C
DTF2IDW0       0084
DTF2IDW1       0088
DTF2KIDA       002C 02

This information is based on z/VM V4R1.0.
Last updated on 5 Jun 2001 at 13:27:15 EDT.
Copyright IBM Corporation, 1990, 2001