|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
DTFBK
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 002D 45 Bitstring 3 * RESERVED - MUST BE SET TO ZEROS 0030 48 Dbl-Word 8 DTFIOPSW I/O OLD PSW 0038 56 Signed 4 DTFIOCSW (3) SUBCHANNEL CSW FROM IRB 0044 68 Signed 4 DTFIOESW First word of ESW from IRB 0048 72 Signed 4 DTFIOERW Extended Report Word from IRB 004C 76 Bitstring 32 DTFIOCSN Concurrent sense data from IRB 0000006C 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. 006C 108 Signed 4 DTFIOCCW FIRST WORD OF CCW 0070 112 Signed 4 DTFIOCW2 SECOND WORD OF CCW 0074 116 Signed 4 DTFIOCWA REAL ADDRESS OF CCW THE FOLLOWING FIELDS ARE USED IF IDA IS OFF: 0078 120 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. 007A 122 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: 0078 120 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. 007A 122 Signed 2 * RESERVED 007C 124 Signed 4 DTFILIST (0) BEGINNING OF LIST OF IDAWS (EACH MAPPED BY DTFIDAW) 007C 124 Signed 4 DTFIDAW IDAW 0080 128 Signed 2 DTFILSTD (0) BEGINNING OF DATA FIELDS - ONE FOR EACH IDAW IN DTFILIST - EACH DATA FIELD MAPPED BY DTFIDATL AND DTFIDATA 0080 128 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 0082 130 Bitstring 1 DTFIDATA (0) VARIABLE LENGTH FIELD CONTAINING THE DATA THAT WAS TRACED FOR THE IDAW (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)
DTFBK Storage Layout
*** DTFBK - DATATRACE TRACE RECORD FORMAT BLOCK * * +-------------+-------------+-------------+------+------+ * 0 | DTFRLNGT | DTFCPUAD |/////////////|:TYPE |//////| * +-------------+-------------+-------------+------+------+ * 8 | DTFTOD | * +-------------------------------------------------------+ * 10 | DTFID | * +-------------------------------------------------------+ * 18 | DTFSET | * +-------------------------------------------------------+ * 20 | | * = DTFGEN = * | | * +-------------------------------------------------------+ * *** DTFBK - DATATRACE TRACE RECORD FORMAT BLOCK *** Overlay for DTFGEN in DTFBK * * +------+--------------------+---------------------------+ * 20 |:DLNUM|////////////////////| DTFVADDR | * +------+-------------+------+---------------------------+ * 28 |:DLLEN| DTFDDATL | | * +------+-------------+ | * 30 | | * = DTFDDATA = * | | * +-------------------------------------------------------+ * *** Overlay for DTFGEN in DTFBK *** Overlay for DTFGEN in DTFBK * * +-------------------------------------------------------+ * 20 | DTFIOUSR | * +-------------+-------------+------+--------------------+ * 28 | DTFIODEV | DTFIOLEN |:IOFLG|////////////////////| * +-------------+-------------+------+--------------------+ * 30 | DTFIOPSW | * +-------------------------------------------------------+ * 38 | DTFIOCSW | * | +---------------------------+ * 40 | | DTFIOESW | * +---------------------------+---------------------------+ * 48 | DTFIOERW | | * +---------------------------+ | * 50 | | * = DTFIOCSN = * | +---------------------------+ * 68 | | DTFIOCCW | * +---------------------------+---------------------------+ * 70 | DTFIOCW2 | DTFIOCWA | * +-------------+-------------+---------------------------+ * 78 | DTFCDATL | | * +-------------+ | * 80 | | * = DTFCDATA = * | | * +-------------------------------------------------------+ * *** Overlay for DTFGEN in DTFBK *** Overlay for DTFCDATL in DTFBK * * +-------------+-------------+---------------------------+ * 78 | DTFIDACT |/////////////| DTFIDAW | * +-------------+-------------+---------------------------+ * 80 | DTFIDATL | | * +-------------+ | * 88 | | * = DTFIDATA = * | | * +-------------------------------------------------------+ * *** Overlay for DTFCDATL in DTFBK
DTFBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----DTFCDATA 007A
DTFCDATL 0078
DTFCPUAD 0002
DTFCSNS 002C 10
DTFCWHDR 0078 0000000E
DTFDATA 0006 00000002
DTFDDATA 002B
DTFDDATL 0029
DTFDLINK 0029
DTFDLLEN 0028
DTFDLNUM 0020
DTFDLSZ 0024 00000028
DTFDTHR 0010
DTFF1CCW 002C 20
DTFGEN 0020
DTFID 0010
DTFIDACT 0078
DTFIDATA 0082
DTFIDATL 0080
DTFIDAW 007C
DTFILIST 007C
DTFILSTD 0080
DTFINVAD 0082 80
DTFINVDL 0029 0000FFFF
DTFIO 0006 00000004
DTFIOCCW 006C
DTFIOCSN 004C
DTFIOCSW 0038
DTFIOCWA 0074
DTFIOCW2 0070
DTFIODEV 0028
DTFIOERW 0048
DTFIOESW 0044
DTFIOFLG 002C
DTFIOHDR 004C 0000006C
DTFIOLEN 002A
DTFIOPSW 0030
DTFIOUSR 0020
DTFIWHDR 0080 00000016
DTFRLNGT 0000
DTFRUNC 002C 80
DTFSET 0018
DTFSKIPV 0082 40
DTFTOD 0008
DTFTYPE 0006
DTFUNSOL 002C 40
DTFVADDR 0024
Last updated on 3 Aug 1999 at 11:53:20 EDT.
Copyright IBM Corporation, 1990, 1999