| |
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
00000001 DTFPCIF X'01' DTFPCIF TYPE PCIF TRACE
0007 7 Bitstring 1 DTFSUBTY Event trace record sub-type
.... .... DTFDFLT 0 DTFDFLT Default
.... ...1 DTFLDEV 1 DTFLDEV IO - LDEV
.... ..1. DTFFCX 2 DTFFCX FCX IO trace
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
00000005 DTFNRDY X'0005' DTFNRDY LAN structures
not ready
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 1 DTFFLOW Data Flow
004A 74 Bitstring 6 * 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.
The following fields are used when trace type is PCI
0020 32 Signed 4 DTFPCIDV PCI Function that is traced
0024 36 Signed 4 DTFPCILT Number of bytes of data traced
0028 40 Dbl-Word 8 DTFPCIUR USERID for whom IO is traced
0030 48 Bitstring 1 DTFPCITY PCI record subtype
00000001 DTFPCILD X'01' DTFPCILD Subtype 01
00000002 DTFPCIST X'02' DTFPCIST Subtype 02
00000003 DTFPCISB X'03' DTFPCISB Subtype 03
00000005 DTFPCIFC X'05' DTFPCIFC Subtype 05
00000006 DTFRPCIT X'06' DTFRPCIT Subtype 06
00000007 DTFPCICL X'07' DTFPCICL Subtype 07
0031 49 Bitstring 1 * (3) Reserved
0034 52 Signed 4 * Reserved
00000038 DTFPCHDR *-DTFBK Len of header of PCI
trace record
0038 56 Bitstring 1 DTFPCIDT (0) Variable length field containing
the data that was traced for the
function
Definition for subtype 07 begins here
0038 56 Signed 4 DTFCLPRQ (8) Request block
0058 88 Signed 4 DTFCLPRP (8) Response block
00000040 DTFCLPLG *-DTFPCIDT Subtype length
Definition for subtype 01 and 02 begins here
0038 56 Dbl-Word 8 DTFLDDAT Data
0040 64 Signed 4 DTFLDHDL PCI identifier
0044 68 Signed 4 DTFLDSPL Combination field
0048 72 Dbl-Word 8 DTFLDOFF Offset
0050 80 Bitstring 1 DTFLDCC CC code result
0051 81 Bitstring 1 * (3) Reserved
0000001C DTFLDLNG *-DTFPCIDT Subtype length
Definition for subtype 03 begins here
0038 56 Signed 4 DTFSBHDL PCI identifier
003C 60 Signed 4 DTFSBSPL Combination field
0040 64 Dbl-Word 8 DTFSBOFF Offset
0048 72 Bitstring 1 DTFSBCC CC code result
0049 73 Bitstring 1 * (3) Reserved
00000014 DTFSBLNG *-DTFPCIDT Subtype length
004C 76 Bitstring 1 DTFSBDAT (0) Variable length data stored, can
take a value of 16,32,64,or 128
1... .... DTFSBLNM X'80' Maximum length 128
Definition for subtype 05 begins here
0038 56 Signed 4 DTFMFHDL PCI identifier
003C 60 Signed 4 DTFMFSDA Combination field
0040 64 Bitstring 1 DTFMFCC CC code result
0041 65 Bitstring 1 * (3) Reserved
0044 68 Signed 4 DTFMFFIB (20) Notes : The size of DTFMFFIB and
FIBBK must conform with the
architecture. Using an equate
from FIBBK was avoided here in
order to not require "COPY FIBBK"
in all parts that use the DTFBK.
A 'CKMAINT DTFMFNG,NE,FIBARSZ'
was added in an assemble part to
ensure that the size of DTFMFFIB
and FIBBK are same.
00000050 DTFMFFNG *-DTFMFFIB FIBBK length
0000005C DTFMFLNG *-DTFPCIDT Subtype length
Definition for subtype 06 begins here
0038 56 Signed 4 DTFRTHDL PCI identifier
003C 60 Signed 4 DTFRTSAT Status
0040 64 Bitstring 1 DTFRTCC CC code result
0041 65 Bitstring 1 * (3) Reserved
0044 68 Signed 4 * Reserved
0048 72 Dbl-Word 8 DTFRTBAD Address
0050 80 Dbl-Word 8 DTFRTALG Count
00000020 DTFRTLNG *-DTFPCIDT Subtype length
The following fields are used when trace type is IO and
subtype is DTFFCX.
HCPTXJ calls HCPFXRTR to parse the FCX channel program.
HCPFXRTR calls HCPFXTMG to record the data in the DTFBK.
A call is made in this order for each of the following:
TCW
TCCB or TCCB TIDAWS and data
Write data or Write data TIDAWS and data
TSB
Read data or read data TIDAWS and data
0020 32 Dbl-Word 8 DTFXUSR USERID OF WHOM IO IS TRACED
0028 40 Signed 2 DTFXDEV DEVICE THAT IS TRACED
002A 42 Signed 2 DTFXLEN TRSOURCE IODATA VALUE
0030 48 Bitstring 16 DTFXPSW zArch: I/O Old PSW
0040 64 Bitstring 32 DTFXORB ORB
0060 96 Bitstring 96 DTFXIRB IRB
00C0 192 Bitstring 1 DTFXPRTY I/O priority for channel
subsystem
00C1 193 Bitstring 1 DTFXCPRI Current priority of this I/O op
00C2 194 Bitstring 2 DTFXOPTI Times segment was out-prioritized
00C4 196 Bitstring 1 DTFXOPRI Original priority for this I/O op
00C5 197 Bitstring 1 DTFXFLGS FCX flag byte
1... .... DTFXTCWV X'80' DTFXTCWV TCW valid
.1.. .... DTFXTSBV X'40' DTFXTSBV TSB valid
..1. .... DTFXITCW X'20' DTFXITCW Interrogate TCW
.... ..11 DTFXCC X'03' DTFXCC Bit mask for XSCH CC
in DTFXFLGS
00C6 198 Bitstring 2 DTFXDLEN Length of variable data
000000C8 DTFXHDRC *-DTFBK USED FOR CLEARING HEADER
00C8 200 Bitstring 64 DTFXTCW Transport Command Word
0108 264 Bitstring 64 DTFXTSB Transport Status Block
00000148 DTFXHDR *-DTFBK LENGTH OF HEADER OF FCX
IO TRACE
0148 328 Bitstring 1 DTFXDATA (0) VARIABLE LENGTH FIELD CONTAINING
THE DATA THAT WAS TRACED (ENDS ON
A WORD BOUNDARY)
FCX data record
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure DTFXRHDR DATATRACE TRACE RECORD FORMAT BLOCK
0000 0 Bitstring 1 DTFXRTYP TYPE OF DATA - SEE HCPFXTBK
EQUATES FOR FXTTYPE
0001 1 Bitstring 3 * RESERVED
0004 4 Signed 4 DTFXROFF OFFSET OF DATA TIDAW ONLY
0008 8 Signed 4 DTFXRLEN LENGTH OF DATA
000C 12 Signed 4 DTFXRREM LENGTH OF DATA NOT DISPLAYED
00000010 DTFXRHLN *-DTFXRHDR LENGTH OF FCX RECORD
HEADER
0010 16 Bitstring 1 DTFXRDAT (0) DATA
| |