|
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM. |
DTFBK
Control Block Contents
DTFBK DSECT
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
Last updated on 5 Jun 2001 at 13:27:15 EDT.
Copyright IBM Corporation, 1990, 2001