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 TYPE IO
                  AND TYPE LAN
     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' DTFDATA TYPE DATA TRACE
              00000004       DTFIO          X'04' DTFIO TYPE IO TRACE
              00000008       DTFLAN         X'08' DTFLAN TYPE LAN TRACE
    0007    7 Bitstring    1 DTFSUBTY       Event trace record sub-type
              .... ....      DTFDFLT        0 DTFDFLT Default
              .... ...1      DTFLDEV        1 DTFLDEV IO - LDEV
    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' DTFRUNC DATA TRUNCATED
              .1.. ....      DTFUNSOL       X'40' DTFUNSOL UNSOLICITED
                                            INTERRUPT
              ..1. ....      DTFF1CCW       X'20' DTFF1CCW FORMAT 1 CCWS
              ...1 ....      DTFCSNS        X'10' DTFCSNS Concurrent Sense
                                            Data received
              .... 1...      DTFGPSW        X'08' DTFGPSW zArch-format PSW
              .... .1..      DTFF2IDA       X'04' DTFF2IDA Format-2 IDAWs
                                            active
              .... ..1.      DTF2KIDA       X'02' DTF2KIDA Format-2 IDAWs 2K
                                            boundary Code relies on CCW flags
                                            to determine presence of MIDAWs,
                                            so no flag is added here for that
                                            support.
    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       zArch: 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 BOTH IDA AND MIDA ARE 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
          The following fields are used when MIDA is on.
          The actual MIDAW layout is broken down into four words, to
          create pleasant output when passed through TRACERED.
          The DTFMIDAW field is repeated for all MIDAWs in the List,
          followed by as many DTFMIDAL/DTFMIDAT fields are needed
          (and available) to hold the MIDAW data that is pointed to.
    0088  136 Signed       2 DTFMIDAC       Count of MIDAWs for the CCW NOTE:
                                            Some high-order bits have other
                                            meanings (DTFCWHDR)
    008A  138 Signed       2 *              Reserved
    008C  140 Bitstring   16 DTFMIDAW (0)   Modified IDA Word mapping
    008C  140 Signed       4 DTFMID1H       High order word of flags/count
    0090  144 Signed       4 DTFMID1L (0)   Low order word of flags/count
    0090  144 Bitstring    1 *
    0091  145 Bitstring    1 DTFFLAGS       Flag byte
              .1.. ....      DTFMSKIP       X'40' DTFMSKIP Skip data transfer
                                            for this MIDAW
    0092  146 Bitstring    1 * (2)
    0094  148 Signed       4 DTFMID2H       High order word of data address
    0098  152 Signed       4 DTFMID2L       Low order word of data address
              00000020       DTFMIHDR       *-DTFIOCCW Length of MIDAW header
                                            section
    009C  156 Signed       2 DTFMIDAL       Length of data for the MIDAW
    009E  158 Bitstring    1 DTFMIDAT (0)   Variable length field containing
                                            data pointed to by the MIDAW(s)
                                            (ends on a word boundary)
                 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)
          The following fields are used when trace type is LAN.
    0020   32 Signed       2 DTFLANFG       LAN TYPE SPECIFIC CODE CODE
                                            DEFINED FOR DTFLANFG
              0000FFFF       DTFLFFFF       X'FFFF' = FFFF for use in
                                            IPFORMATER
    0022   34 Signed       2 DTFLEN         BYTES REQUESTED (64 < N <
                                            2096)
    0024   36 Signed       4 DTFBYTES       NUMBER OF BYTES TRANSMITTED.
    0028   40 Character    8 DTFOWNER       LAN OWNER ID
    0030   48 Character    8 DTFLANNM       LAN NAME
    0038   56 Character    8 DTFUSER        USERID
    0040   64 Signed       2 DTFVDEV        VIRTUAL DEVICE (VDEV) - NIC
    0042   66 Signed       2 DTFVLAN        VLAN; 0000 - UNTAGGED.
    0044   68 Signed       2 DTFDROP        DROPPED PACKET CODE
              00000000       DTFSUCC        X'0000' DTFSUCC PACKET WAS
                                            DELIVERED
              00000001       DTFLLEN        X'0001' DTFLLEN PACKET LENGTH TOO
                                            LONG
              00000002       DTFBHDR        X'0002' DTFBHDR MISSING HEADER
              00000004       DTFUDST        X'0004' DTFUDST UNKNOWN
                                            DESTINATION
    0046   70 Bitstring    1 DTFOSA         OSA TRUNK PORT?
              00000000       DTFOSAN        X'00' DTFOSAN NO OSA TRUNK PORT
                                            INVOLVED
              000000FF       DTFOSAI        X'FF' DTFOSAI OSA PORT INVOLVED
    0047   71 Bitstring    1 DTFIBOB        PACKET COMING INBOUND OR
                                            OUTBOUND?
              00000000       DTFIN          X'00' DTFIN PACKET CAME INBOUND
              000000FF       DTFOUT         X'FF' DTFOUT PACKET CAME OUTBOUND
    0048   72 Bitstring    1 DTFBUM         PACKET TYPE?
              000000E4       DTFUNI         C'U' DTFUNI UNICAST PACKET
              000000C2       DTFBRD         C'B' DTFBRD BROADCAST PACKET
              000000D4       DTFMCT         C'M' DTFMCT MULTICAST PACKET
    0049   73 Bitstring    7 *              RESERVED
              00000050       DTFLNHDR       *-DTFBK LEN OF HEADER OF LAN
                                            TRACE RECORD
    0050   80 Bitstring    1 DTFLDATA (0)   VARIABLE LENGTH FIELD CONTAINING
                                            THE DATA THAT WAS TRACED FOR THE
                                            LAN TRACE TYPE.

#### DTFBK Storage Layout

    *** DTFBK - DATATRACE TRACE RECORD FORMAT BLOCK
    *
    *     +-------------+-------------+-------------+------+------+
    *   0 |  DTFRLNGT   |  DTFCPUAD   |/////////////|:TYPE |:SUBTY|
    *     +-------------+-------------+-------------+------+------+
    *   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

    *** Overlay for DTFCDATL in DTFBK
    *
    *     +-------------+-------------+---------------------------+
    *  88 |  DTFMIDAC   |/////////////|         DTFMID1H          |
    *     +------+------+-------------+---------------------------+
    *  90 |//////|:FLAGS|/////////////|         DTFMID2H          |
    *     +------+------+-------------+-------------+-------------+
    *  98 |         DTFMID2L          |  DTFMIDAL   |
    *     +---------------------------+-------------+
    *
    *** Overlay for DTFCDATL in DTFBK

    *** Overlay for DTFGEN in DTFBK
    *
    *     +-------------+-------------+---------------------------+
    *  20 |  DTFLANFG   |   DTFLEN    |         DTFBYTES          |
    *     +-------------+-------------+---------------------------+
    *  28 |                       DTFOWNER                        |
    *     +-------------------------------------------------------+
    *  30 |                       DTFLANNM                        |
    *     +-------------------------------------------------------+
    *  38 |                       DTFUSER                         |
    *     +-------------+-------------+-------------+------+------+
    *  40 |  DTFVDEV    |  DTFVLAN    |  DTFDROP    |DTFOSA|:IBOB |
    *     +------+------+-------------+-------------+------+------+
    *  48 |DTFBUM|////////////////////////////////////////////////|
    *     +------+------------------------------------------------+
    *
    *** Overlay for DTFGEN in DTFBK

#### DTFBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DTFBHDR        0044 00000002
    DTFBRD         0048 000000C2
    DTFBUM         0048
    DTFBYTES       0024
    DTFCDATA       008A
    DTFCDATL       0088
    DTFCPRI        0075
    DTFCPUAD       0002
    DTFCSNS        002C 10
    DTFCWHDR       0088 0000000E
    DTFDATA        0006 00000002
    DTFDDATA       002B
    DTFDDATL       0029
    DTFDFLT        0007 00
    DTFDLINK       0029
    DTFDLLEN       0028
    DTFDLNUM       0020
    DTFDLSZ        0024 00000028
    DTFDROP        0044
    DTFDTHR        0010
    DTFFLAGS       0091
    DTFF1CCW       002C 20
    DTFF2IDA       002C 04
    DTFGEN         0020
    DTFGPSW        002C 08
    DTFIBOB        0047
    DTFID          0010
    DTFIDACT       0088
    DTFIDATA       0092
    DTFIDATL       0090
    DTFIDAW        008C
    DTFIGPSW       0030
    DTFILIST       008C
    DTFILSTD       0090
    DTFIN          0047 00000000
    DTFINVAD       009E 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
    DTFLAN         0006 00000008
    DTFLANFG       0020
    DTFLANNM       0030
    DTFLDATA       0050
    DTFLDEV        0007 01
    DTFLEN         0022
    DTFLFFFF       0020 0000FFFF
    DTFLLEN        0044 00000001
    DTFLNHDR       0049 00000050
    DTFMCT         0048 000000D4
    DTFMIDAC       0088
    DTFMIDAL       009C
    DTFMIDAT       009E
    DTFMIDAW       008C
    DTFMID1H       008C
    DTFMID1L       0090
    DTFMID2H       0094
    DTFMID2L       0098
    DTFMIHDR       0098 00000020
    DTFMSKIP       0091 40
    DTFOPRI        0078
    DTFOPTI        0076
    DTFOSA         0046
    DTFOSAI        0046 000000FF
    DTFOSAN        0046 00000000
    DTFOUT         0047 000000FF
    DTFOWNER       0028
    DTFPRTY        0074
    DTFRLNGT       0000
    DTFRUNC        002C 80
    DTFSET         0018
    DTFSKIPV       009E 40
    DTFSUBTY       0007
    DTFSUCC        0044 00000000
    DTFTOD         0008
    DTFTYPE        0006
    DTFUDST        0044 00000004
    DTFUNI         0048 000000E4
    DTFUNSOL       002C 40
    DTFUSER        0038
    DTFVADDR       0024
    DTFVDEV        0040
    DTFVLAN        0042
    DTF2IDAT       0096
    DTF2IDAW       008C
    DTF2IDLN       0094
    DTF2IDW0       008C
    DTF2IDW1       0090
    DTF2KIDA       002C 02

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:36:37 EDT.
Copyright IBM Corporation, 1990, 2008