DTFBK - 32-bit CP - V4R4.0

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   16 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
    0074  116 Bitstring    1 DTFPRTY        I/O priority for channel
                                            subsystem
    0075  117 Bitstring    1 DTFCPRI        Current priority of this I/O op
    0076  118 Bitstring    2 DTFOPTI        Times segment was out-prioritized
    0078  120 Bitstring    1 DTFOPRI        Original priority for this I/O op
    0079  121 Bitstring    3 *              Reserved
    007C  124 Signed       4 * (0)          DTFIOHDR must start on fullword
              0000007C       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.
    007C  124 Signed       4 DTFIOCCW       FIRST WORD OF CCW
    0080  128 Signed       4 DTFIOCW2       SECOND WORD OF CCW
    0084  132 Signed       4 DTFIOCWA       REAL ADDRESS OF CCW
         THE FOLLOWING FIELDS ARE USED IF IDA IS OFF:
    0088  136 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.
    008A  138 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:
    0088  136 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.
    008A  138 Signed       2 *              RESERVED
    008C  140 Signed       4 DTFILIST (0)   BEGINNING OF LIST OF IDAWS (EACH
                                            MAPPED BY DTFIDAW)
    008C  140 Signed       4 DTFIDAW        IDAW
    0090  144 Signed       2 DTFILSTD (0)   BEGINNING OF DATA FIELDS - ONE
                                            FOR EACH IDAW IN DTFILIST - EACH
                                            DATA FIELD MAPPED BY DTFIDATL AND
                                            DTFIDATA
    0090  144 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
    0092  146 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
    008C  140 Bitstring    8 DTF2IDAW (0)   8 Byte format-2 IDAW
    008C  140 Signed       4 DTF2IDW0       High order word of a fmt-2 IDAW
    0090  144 Signed       4 DTF2IDW1       Low order word of a fmt-2 IDAW
    0094  148 Signed       2 DTF2IDLN       Length of data for this fmt2 IDAW
    0096  150 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                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40 |                       DTFIOCSW                        |
    *     |                           +---------------------------+
    *  48 |                           |         DTFIOESW          |
    *     +---------------------------+---------------------------+
    *  50 |         DTFIOERW          |                           |
    *     +---------------------------+                           |
    *  58 |                                                       |
    *     =                       DTFIOCSN                        =
    *     |                           +------+------+-------------+
    *  70 |                           |:PRTY |:CPRI |  DTFOPTI    |
    *     +------+--------------------+------+------+-------------+
    *  78 |:OPRI |////////////////////|         DTFIOCCW          |
    *     +------+--------------------+---------------------------+
    *  80 |         DTFIOCW2          |         DTFIOCWA          |
    *     +-------------+-------------+---------------------------+
    *  88 |  DTFCDATL   |
    *     +-------------+
    *
    *** Overlay for DTFIOPSW in DTFBK

    *** Overlay for DTFCDATL in DTFBK
    *
    *     +-------------+-------------+---------------------------+
    *  88 |  DTFIDACT   |/////////////|         DTFIDAW           |
    *     +-------------+-------------+---------------------------+
    *  90 |  DTFIDATL   |
    *     +-------------+
    *
    *** Overlay for DTFCDATL in DTFBK

    *** Overlay for DTFIDAW in DTFBK
    *
    *                                 +---------------------------+
    *  88 ...                      8C |         DTF2IDW0          |
    *     +---------------------------+-------------+-------------+
    *  90 |         DTF2IDW1          |  DTF2IDLN   |
    *     +---------------------------+-------------+
    *
    *** Overlay for DTFIDAW in DTFBK

#### DTFBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DTFCDATA       008A
    DTFCDATL       0088
    DTFCPRI        0075
    DTFCPUAD       0002
    DTFCSNS        002C 10
    DTFCWHDR       0088 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       0088
    DTFIDATA       0092
    DTFIDATL       0090
    DTFIDAW        008C
    DTFIGPSW       0030
    DTFILIST       008C
    DTFILSTD       0090
    DTFINVAD       0096 80
    DTFINVDL       0029 0000FFFF
    DTFIO          0006 00000004
    DTFIOCCW       007C
    DTFIOCSN       0054
    DTFIOCSW       0040
    DTFIOCWA       0084
    DTFIOCW2       0080
    DTFIODEV       0028
    DTFIOERW       0050
    DTFIOESW       004C
    DTFIOFLG       002C
    DTFIOHDR       007C 0000007C
    DTFIOLEN       002A
    DTFIOPSW       0030
    DTFIOUSR       0020
    DTFIWHDR       0090 00000016
    DTFOPRI        0078
    DTFOPTI        0076
    DTFPRTY        0074
    DTFRLNGT       0000
    DTFRUNC        002C 80
    DTFSET         0018
    DTFSKIPV       0096 40
    DTFTOD         0008
    DTFTYPE        0006
    DTFUNSOL       002C 40
    DTFVADDR       0024
    DTF2IDAT       0096
    DTF2IDAW       008C
    DTF2IDLN       0094
    DTF2IDW0       008C
    DTF2IDW1       0090
    DTF2KIDA       002C 02

This information is based on z/VM V4R4.0. Last updated on 29 Jul 2003 at 15:28:42 EDT.
Copyright IBM Corporation, 1990, 2003