|
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. |
DFIR
Cross Reference (Contains links to field and bit definitions)
DFIR Prolog
NAME : HCPDFIR
DESCRIPTION: DUMP FILE INFORMATION RECORD
DSECT : DFIR
FUNCTION : HCPDFIR CONTAINS VITAL SYSTEM REGISTER AND STORAGE
LOCATION VALUES NECESSARY TO PROCESS A DUMP TO TAPE
DASD
LOCATED BY : THE DFIR IS THE THIRD RECORD OF A SYSTEM ABEND DUMP
TO TAPE OR DASD, OF A STANDALONE DUMP TO TAPE, OR OF
AN VM/Enterprise Systems Architecture format VMDUMP
SPOOL FILE.
CREATED BY : HCPDMP (SYSTEM ABEND DUMP PROCESSOR) DURING A SYSTEM
ABEND DUMP
HCPEDM (DUMP PROCESSOR) WHEN PROCESSING A SYSTEM ABEND
OR STANDALONE DUMP
HCPSAD (STANDALONE DUMP PROCESSOR) DURING A STANDALONE
DUMP
HCPVDU (VIRTUAL MACHINE DUMP PROCESSOR) DURING A VIRTUAL
MACHINE DUMP
DELETED BY : NOT APPLICABLE
COMMENTS : THE HCPDFIR IS USED BY HCPEDM TO PROCESS A DUMP FROM
TAPE OR DASD.
THE DFIR IS 5 4K BYTES IN LENGTH AND CAN CONTAIN
INFORMATION FOR UP TO 63 PROCESSORS.
HCPDMP BUILDS THE DFIR IN THE WORK PAGES HCPWRKA1,
HCPWRKA2, HCPWRKA3, HCPWRKA4 and HCPWRKA5.
HCPSAD BUILDS THE DFIR IN REAL STORAGE PAGES 3 THRU 7.
THE DISPLACEMENT OF DFIDVF CANNOT CHANGE BECAUSE
DFIDVF IS USED BY DVF TO DETERMINE IF THE DUMP RELEASE
MATCHES THE DUMPSCAN RELEASE.
DFIR Control Block Content
DFIR DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure DFIR DUMP FILE INFORMATION RECORD 0000 0 Bitstring 64 DFIGPRS 16 GENERAL PURPOSE REGISTERS 0040 64 Bitstring 64 DFICRS 16 CONTROL REGISTERS 0080 128 Bitstring 32 DFIFPRS 4 FLOATING POINT REGISTERS 00A0 160 Dbl-Word 8 DFITODCK TIME OF DAY CLOCK 00A8 168 Dbl-Word 8 DFICPUTM CPU TIMER 00B0 176 Dbl-Word 8 DFICKCOM CLOCK COMPARATOR 00B8 184 Bitstring 1 DFIFLAG FLAG BYTE 1... .... DFIHALF X'80' Obsolete. No longer used by VM/ESA. .1.. .... DFI370 X'40' Obsolete. No longer used by VM/ESA ..1. .... DFIXA X'20' Format of dump is 'XA'. All dumps by .VM/ESA are in this format. ...1 .... DFIMASI X'10' MAS INSTALLED ON DUMPED SYSTEM .... 1... DFIMXC X'08' Virtual machine was in XC mode. This .is set for VMDUMPs only. .... .1.. DFIMESA X'04' Virtual machine was in ESA or XA mode. .This is set for VMDUMPs only. .... ..1. DFIM370 X'02' Virtual machine was in 370 mode. This .is set for VMDUMPs only. 00B9 185 Bitstring 1 DFITYPE TYPE OF DUMP FLAG 00000000 DFICP X'00' CP ABEND OR STAND-ALONE DUMP 00000001 DFICPSA X'01' CP SOFT ABEND DUMP 00000080 DFIVM X'80' VIRTUAL MACHINE DUMP 00BA 186 Bitstring 1 DFICOMP DUMP COMPLETION FLAG 00000000 DFIDONE X'00' DUMP IS COMPLETE 00000040 DFINOLOD X'40' DUMP WAS NOT COMPLETELY LOADED BY THE DUMPLOAD COMMAND 00000080 DFIINC X'80' DUMP WAS NOT COMPLETE WHEN CREATED 00BB 187 Bitstring 1 * RESERVED FOR FUTURE IBM USE 00BC 188 Signed 4 DFISYSRV SYSTEM GENERATED STORAGE SIZE DFISYSRV is not used in VMDUMPs, ASISYSRV is used instead. 00C0 192 Bitstring 1 DFILCORE (256) LOCATIONS 0-255 OF REAL MEMORY 01C0 448 Signed 4 DFIPFX PREFIX ADDR FOR DUMPED SYSTEM 01C4 452 Signed 2 DFICPUNO NUMBER OF ON-LINE ALTERNATE CPUS 01C6 454 Bitstring 1 DFICONT CONT MODE FLAGS 1... .... DFICNTMD X'80' DUMP IS IN CONT FORMAT 01C7 455 Bitstring 1 DFICDX Crypto Domain Index Register 01C8 456 Bitstring 1 DFIVCPI Virtual CPU information .Used in VMDUMPs only. 1... .... DFIVCF X'80' This vCPU has a vCF defined. 01C9 457 Bitstring 1 * Reserved for future IBM use. 01CA 458 Signed 2 * RESERVED FOR FUTURE IBM USE 01CC 460 Signed 4 * Reserved for future IBM use. 01D0 464 Signed 4 DFISAMBK ADDRESS OF THE SNAP AREA MAP BLOCK 01D4 468 Signed 4 * (2) Reserved for future IBM use. 01DC 476 Signed 4 DFISYSAD Address of HCPSYS at the time of dump 01E0 480 Signed 4 DFIDVF (20) RESERVED FOR USE BY THE DUMP VIEWING FACILITY 0230 560 Dbl-Word 8 DFIPSW PSW OF THE VIRTUAL MACHINE ONLY USED FOR VMDUMPS 0238 568 Signed 2 DFIADCPU CPU ADDRESS 023A 570 Signed 2 DFIVFSSZ SECTION SIZE FOR THE VECTOR FACILITY 023C 572 Bitstring 64 DFIARS 16 ACCESS REGISTERS 027C 636 Bitstring 8 DFIASITP eASIT OF PRIMARY ADDRESS SPACE - USED IN VMDUMPS ONLY 0284 644 Bitstring 33 DFISPACP SPACEID OF PRIMARY ADDRESS SPACE - USED IN VMDUMPS ONLY 02A5 677 Bitstring 1 * (131) RESERVED FOR FUTURE IBM USE OTHER ON-LINE CPU HAS THE FOLLOWING INFORMATION 0328 808 Bitstring 312 DFICPU (0) OTHER CPU INFORMATION 0328 808 Signed 2 DFICPUAD CPU ADDRESS 032A 810 Signed 2 DFIVFSIZ SECTION SIZE FOR THE VECTOR FACILITY 032C 812 Signed 4 DFIPFXPG ADDRESS OF PREFIX PAGE FOR CPU 0330 816 Bitstring 1 DFICDXOP Crypto Domain Index Register 0331 817 Bitstring 1 DFIVCPUI Virtual CPU information .Used in VMDUMPs only. 1... .... DFIVCF X'80' This vCPU has a vCF defined. 0332 818 Signed 2 * Reserved for future IBM use 0334 820 Signed 4 * Reserved for future IBM use 0338 824 Dbl-Word 8 * (0) 0338 824 Bitstring 296 DFICPUIF CPU'S REAL STORAGE LOC. 216-511 00000138 DFICPULN *-DFICPUAD LENGTH OF OTHER PROCESSOR INFO 0000008C DFISIZE (*-DFIR+7)/8 SIZE OF DUMP INFO. RECORD 00000000 DFIMCPUT 0,8 CPU TIMER LOGOUT 00000008 DFIMCKCP DFIMCPUT+L'DFIMCPUT,8 TOD COMPARATOR LOGOUT 00000010 DFIMCHIN DFIMCKCP+L'DFIMCKCP,8 MACHINE CHECK INTERRUPT CODE 00000018 DFISPAR1 DFIMCHIN+L'DFIMCHIN,8 RESERVED FOR FUTURE HARDWARE USE 00000020 DFIMCFSA DFISPAR1+L'DFISPAR1,4 MACHINE CHECK FAILING STORAGE ADDRESS 00000024 DFIMCHRD DFIMCFSA+L'DFIMCFSA,4 MACHINE DEPENDENT REQION CODE 00000028 DFIFXLOG DFIMCHRD+L'DFIMCHRD,16 MACHINE DEPENDENT FIXED LOGOUT AREA 00000038 DFISPAR2 DFIFXLOG+L'DFIFXLOG,16 RESERVED FOR FUTURE HARDWARE USE 00000048 DFIARLG DFISPAR2+L'DFISPAR2,64 ACCESS REGISTERS 00000088 DFIFPRLG DFIARLG+L'DFIARLG,32 FLOATING POINT REGS 000000A8 DFIGPRLG DFIFPRLG+L'DFIFPRLG,64 GENERAL REGISTERS 000000E8 DFICRLG DFIGPRLG+L'DFIGPRLG,64 CONTROL REGISTERS
DFIR Storage Layout
*** DFIR - DUMP FILE INFORMATION RECORD * * +-------------------------------------------------------+ * 0 | | * = DFIGPRS = * | | * +-------------------------------------------------------+ * 40 | | * = DFICRS = * | | * +-------------------------------------------------------+ * 80 | | * = DFIFPRS = * | | * +-------------------------------------------------------+ * A0 | DFITODCK | * +-------------------------------------------------------+ * A8 | DFICPUTM | * +-------------------------------------------------------+ * B0 | DFICKCOM | * +------+------+------+------+---------------------------+ * B8 |:FLAG |:TYPE |:COMP |//////| DFISYSRV | * +------+------+------+------+---------------------------+ * C0 | | * = DFILCORE = * | | * +---------------------------+-------------+------+------+ * 1C0 | DFIPFX | DFICPUNO |:CONT |DFICDX| * +------+------+-------------+-------------+------+------+ * 1C8 |:VCPI |//////|/////////////|///////////////////////////| * +------+------+-------------+---------------------------+ * 1D0 | DFISAMBK |///////////////////////////| * +---------------------------+---------------------------+ * 1D8 |///////////////////////////| DFISYSAD | * +---------------------------+---------------------------+ * 1E0 | | * = DFIDVF = * | | * +-------------------------------------------------------+ * 230 | DFIPSW | * +-------------+-------------+---------------------------+ * 238 | DFIADCPU | DFIVFSSZ | | * +-------------+-------------+ | * 240 | | * = DFIARS = * | +---------------------------+ * | | DFIASITP- | * +---------------------------+---------------------------+ * 280 | -(27C) | | * +---------------------------+ | * 288 | | * = DFISPACP = * | +--------------------+ * | |////////////////////| * +----------------------------------+////////////////////| * 2A8 |///////////////////////////////////////////////////////| * =///////////////////////////////////////////////////////= * |///////////////////////////////////////////////////////| * +-------------+-------------+---------------------------+ * 328 | DFICPUAD | DFIVFSIZ | DFIPFXPG | * +------+------+-------------+---------------------------+ * 330 |:CDXOP|:VCPUI|/////////////|///////////////////////////| * +------+------+-------------+---------------------------+ * 338 | | * = DFICPUIF = * | | * +-------------------------------------------------------+ * 460 * *** DFIR - DUMP FILE INFORMATION RECORD
DFIR Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----DFIADCPU 0238
DFIARLG 0338 00000048
DFIARS 023C
DFIASITP 027C
DFICDX 01C7
DFICDXOP 0330
DFICKCOM 00B0
DFICNTMD 01C6 80
DFICOMP 00BA
DFICONT 01C6
DFICP 00B9 00000000
DFICPSA 00B9 00000001
DFICPU 0328
DFICPUAD 0328
DFICPUIF 0338
DFICPULN 0338 00000138
DFICPUNO 01C4
DFICPUTM 00A8
DFICRLG 0338 000000E8
DFICRS 0040
DFIDONE 00BA 00000000
DFIDVF 01E0
DFIFLAG 00B8
DFIFPRLG 0338 00000088
DFIFPRS 0080
DFIFXLOG 0338 00000028
DFIGPRLG 0338 000000A8
DFIGPRS 0000
DFIHALF 00B8 80
DFIINC 00BA 00000080
DFILCORE 00C0
DFIMASI 00B8 10
DFIMCFSA 0338 00000020
DFIMCHIN 0338 00000010
DFIMCHRD 0338 00000024
DFIMCKCP 0338 00000008
DFIMCPUT 0338 00000000
DFIMESA 00B8 04
DFIMXC 00B8 08
DFIM370 00B8 02
DFINOLOD 00BA 00000040
DFIPFX 01C0
DFIPFXPG 032C
DFIPSW 0230
DFISAMBK 01D0
DFISIZE 0338 0000008C
DFISPACP 0284
DFISPAR1 0338 00000018
DFISPAR2 0338 00000038
DFISYSAD 01DC
DFISYSRV 00BC
DFITODCK 00A0
DFITYPE 00B9
DFIVCF 01C8 80
DFIVCF 0331 80
DFIVCPI 01C8
DFIVCPUI 0331
DFIVFSIZ 032A
DFIVFSSZ 023A
DFIVM 00B9 00000080
DFIXA 00B8 20
DFI370 00B8 40
Last updated on 3 Aug 1999 at 11:50:43 EDT.
Copyright IBM Corporation, 1990, 1999