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 V5R3.0. Last updated on 25 Jun 2007 at 16:24:36 EDT.
Copyright IBM Corporation, 1990, 2007