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. |
TRPBK
Cross Reference (Contains links to field and bit definitions)
TRPBK Prolog
NAME : HCPTRPBK DESCRIPTION: TRACE TRAP BLOCK DSECT : TRPBK FUNCTION : HCPTRPBK CONTAINS ALL DESCRIPTIVE INFORMATION ABOUT A PARTICULAR TRACE TRAP CURRENTLY DEFINED BY THE TRACE COMMAND. LOCATED BY : TRPNEXT CHAINED TRSANCHR FIELD OF HCPTRSBK CREATED BY : HCPTRIP DELETED BY : HCPTRICL, HCPTRITD, HCPTRIX SERIALIZED : CREATED AND DELETED UNDER CONSOLE FUNCTION MODE, READ UNDER VMDBK DISPATCH LOCK.
TRPBK Control Block Content
TRPBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure TRPBK TRACE TRAP BLOCK 0000 0 Address 4 TRPNEXT POINTER TO NEXT TRAP BLOCK IN LIST 0004 4 Signed 4 TRPIDENT FOUR CHARACTER TRAP IDENTIFIER 0008 8 Signed 2 TRPSKIP COUNT REMAINING IN CURRENT SKIP COUNT 000A 10 Signed 2 TRPSTOP DISPLAYS REMAINING UNTIL CONSOLE STOP 000C 12 Signed 2 TRPPASS PASS COUNT (REFRESHES TRPPASS IF PRESENT) 000E 14 Signed 2 TRPSTEP STEP COUNT 0010 16 Address 4 TRPCPNXT POINTER TO NEXT CP COMMAND IN CHAIN 0014 20 Address 4 TRPCPCMD POINTER TO THIS CP COMMAND 0018 24 Address 4 TRPINEXT POINTER TO NEXT RANGE AFTER THIS IRANGE. 001C 28 Signed 4 TRPIRANG LOWER IFETCH ADDRESS BOUNDS 0020 32 Signed 4 TRPIRANH UPPER IFETCH ADDRESS BOUNDS 0024 36 Signed 4 TRPISTO SEGMENT TABLE ORIGN FOR ADDRESS SPACE OF IFETCH ADDRESS 'FFFFFFFE': INDICATE LOGICAL ADDRESS 0028 40 Signed 2 TRPIASN Address Space Number for address space of IFETCH range. This field is only valid when the TRPIASNF bit is on. 002A 42 Bitstring 1 * (6) Reserved for future IBM use 0030 48 Signed 2 TRPDBW NUMBER OF DOUBLEWORDS IN THIS BLOCK 0032 50 Bitstring 1 TRPCNTRL TRACING SCREENING/OUTPUT CONTROL 1... .... TRPPROB X'80' RESTRICT TO PROBLEM MODE ONLY .1.. .... TRPSUPV X'40' RESTRICT TO SUPERVISOR MODE ONLY ..1. .... TRPDAT X'20' RESTRICT TO D.A.T. MODE ONLY ...1 .... TRPNODAT X'10' RESTRICT TO NON-D.A.T. MODE ONLY .... 1... TRPPRINT X'08' SEND DISPLAY (IF ANY) TO PRINTER .... .1.. TRPTERM X'04' SEND DISPLAY (IF ANY) TO TERMINAL .... ..1. TRPNOSIM X'02' DELETE INSTRUCTION SIMULATION .... ...1 TRPHIT X'01' TRAP HAS DEFERRED PROCESSING 0033 51 Bitstring 1 TRPCTL2 1... .... TRPIDSET X'80' TRAP ID WAS SET VIA 'ID' OPTION .1.. .... TRPIDATP X'40' INSTRUCTION DATA PRESENT. ..1. .... TRPIASNF X'20' TRPIASN contains the ASN of an address space. ...1 .... TRPASNF X'10' TRPBASN or TRPSASN contains the ASN of an address space. .... 1... TRP370 X'08' Trap is restricted to 370 mode addr sp .... .1.. TRPESA X'04' Trap is restricted to ESA mode addr sp .... ..1. TRPXC X'02' Trap is restricted to XC mode addr sp 0034 52 Bitstring 1 TRPTYPE TRACE TRAP TYPE DEFINITION .... 1... TRPIOACT X'08' I/O ACTIVITY TRAP (SIO IMPLICIT) .... .1.. TRPIOINT X'04' I/O INTERRUPTIONS (PSW FLIPS) .... ..1. TRPIOINS X'02' I/O INSTRUCTIONS .... ...1 TRPIOCCW X'01' CCW CHAINS FOR GIVEN DEVICE(S) 0035 53 Bitstring 1 TRPTYPE1 TRACE TRAP TYPE DEFINITION 1... .... TRPBAC X'80' Branch-address-control .... 1... TRPAR X'08' ACCESS REGISTER ALTERATION TRAP 0036 54 Bitstring 1 TRPSFLAG STORAGE ALTERATION TRAP FLAG 1... .... TRPSPDAT X'80' STORAGE ALTERATION DATA PRESENT .1.. .... TRPS1ST X'40' FIRST DATA SECTION EQUAL LAST INT. ..1. .... TRPS2ND X'20' SECOND DATA SECTION EQUAL LAST INT ...1 .... TRPSLAST X'10' BOTH SECTIONS EQUAL LAST INTERRUPT .... 1... TRPSDISP X'08' DISPLAY THIS DATA TRAP .... .1.. TRPSPMAS X'04' STORAGE ALTERATION MASK PRESENT 0037 55 Bitstring 1 * RESERVED FOR FUTURE IBM USE (REFRESHES TRPSTOP IF PRESENT) (ZERO IF NONE) 0038 56 Dbl-Word 8 TRPOVRLY (8) OVERLAY REGION For Instruction traps and Storage alteration traps, if the DATA option is specified, the data will be stored in the control block after the fields in the overlay region. So, this control block could have up to 256 extra bytes which contain data. Overlay region for STANDARD (code range format) trap information 0038 56 Bitstring 2 TRPCLOWR (0) OPCODE LOWER BOUND 0038 56 Bitstring 1 TRPCLWR0 OPCODE BYTE 0 0039 57 Bitstring 1 TRPCLWR1 OPCODE BYTE 1 003A 58 Bitstring 2 TRPCUPPR (0) OPCODE UPPER BOUND 003A 58 Bitstring 1 TRPCUPR0 OPCODE BYTE 0 003B 59 Bitstring 1 TRPCUPR1 OPCODE BYTE 1 003C 60 Signed 2 TRPDLOWR DEVICE LOWER BOUND 003E 62 Signed 2 TRPDUPPR DEVICE UPPER BOUND 00000008 TRPCDDBW (*-TRPBK+7)/8 NUMBER OF DOUBLEWORDS Here is the 'TRACE INSTRUCTION DATA' data area. 0040 64 Signed 2 TRPDATAL LENGTH OF 'TRACE INSTRUCTION' DATA 00000042 TRPINLEN *-TRPBK FIXED PORTION OF INSTRUCTION TRAP 0042 66 Character 256 TRPIDATA (0) 'TRACE INSTRUCTION' DATA Overlay region for GPR alteration trap information 0038 56 Signed 4 TRPGPRM MASK FOR GENERAL REGISTER DATA COMPARE 003C 60 Signed 4 TRPGPRL LOWER DATA BOUND FOR GPR ALTERATION 0040 64 Signed 4 TRPGPRU UPPER BOUND FOR GPR ALTERATION 0044 68 Signed 2 TRPGPRS MASK FOR GENERAL REGISTER ALTERATION 00000009 TRPGRDBW (*-TRPBK+7)/8 NUMBER OF DOUBLEWORDS Overlay region for AR alteration trap information 0038 56 Signed 4 TRPARM MASK FOR ACCESS REGISTER DATA COMPARE 003C 60 Signed 4 TRPARL LOWER DATA BOUND FOR AR ALTERATION 0040 64 Signed 4 TRPARU UPPER BOUND FOR AR ALTERATION 0044 68 Signed 2 TRPARS MASK FOR ACCESS REGISTER ALTERATION 00000009 TRPARDBW (*-TRPBK+7)/8 NUMBER OF DOUBLEWORDS Overlay region for BRANCH trap information Notes : The TRPBSTO and TRPSSTO fields must always have the same offset because HCPTRR refers to both fields using TRPSSTO. 0038 56 Address 4 TRPBNEXT Link ptr for branch target range 003C 60 Signed 4 TRPBRANG BRANCH TRAP TARGET LOWER RANGE 0040 64 Signed 4 TRPBRANH BRANCH TRAP TARGET UPPER RANGE 0044 68 Signed 4 TRPBSTO SEGMENT TABLE ORIGN FOR ADDRESS SPACE OF BRANCH TARGET RANGE 'FFFFFFFE': INDICATE LOGICAL ADDRESS 0048 72 Signed 2 TRPBASN Address Space Number for the subspace of BRANCH INTO range. This field is only valid when the TRPASNF bit is on. 0000000A TRPBRDBW (*-TRPBK+7)/8 NUMBER OF DOUBLEWORDS Overlay region for STORE (storage alteration) trap information 0038 56 Address 4 TRPSNEXT LINK PTR FOR STORAGE RANGE 003C 60 Signed 4 TRPSRANG LOWER STORE ADDRESS BOUNDS 0040 64 Signed 4 TRPSRANH UPPER STORE ADDRESS BOUNDS 0044 68 Signed 4 TRPSSTO SEGMENT TABLE ORIGN FOR ADDRESS SPACE OF STORE RANGES 'FFFFFFFE': INDICATE LOGICAL ADDRESS TRPSASIT, TRPSPCID, and TRPXCFLG are used only for traps set by an ESA/XC mode guest. 0048 72 Dbl-Word 8 TRPSASIT i-ASIT for STORE INTO range 0050 80 Character 33 TRPSPCID Spaceid for STORE INTO range of 0071 113 Bitstring 1 TRPXCFLG XC mode flag byte 1... .... TRPXCPRI X'80' This trap is restricted to primary .... 1... TRPXCCFY X'08' Used in HCPTRY to indicate that this trap's i-ASIT has been recertified 0072 114 Signed 2 TRPSASN Address Space Number for the subspace of STORE INTO range. This field is only valid when the TRPASNF bit is on 0074 116 Character 256 TRPSDATA (0) STORAGE ALTERATION DATA 00000074 TRPSTLEN *-TRPBK BASE LENGTH FOR STORE TRAPS
TRPBK Storage Layout
*** TRPBK - TRACE TRAP BLOCK * * +---------------------------+---------------------------+ * 0 | TRPNEXT | TRPIDENT | * +-------------+-------------+-------------+-------------+ * 8 | TRPSKIP | TRPSTOP | TRPPASS | TRPSTEP | * +-------------+-------------+-------------+-------------+ * 10 | TRPCPNXT | TRPCPCMD | * +---------------------------+---------------------------+ * 18 | TRPINEXT | TRPIRANG | * +---------------------------+---------------------------+ * 20 | TRPIRANH | TRPISTO | * +-------------+-------------+---------------------------+ * 28 | TRPIASN |/////////////////////////////////////////| * +-------------+------+------+------+------+------+------+ * 30 | TRPDBW |:CNTRL|:CTL2 |:TYPE |:TYPE1|:SFLAG|//////| * +-------------+------+------+------+------+------+------+ * 38 | | * = TRPOVRLY = * | | * +-------------------------------------------------------+ * 78 * *** TRPBK - TRACE TRAP BLOCK *** Overlay for TRPOVRLY in TRPBK * * +------+------+------+------+-------------+-------------+ * 38 |:CLWR0|:CLWR1|:CUPR0|:CUPR1| TRPDLOWR | TRPDUPPR | * +------+------+------+------+-------------+-------------+ * 40 | TRPDATAL | | * +-------------+ | * 48 | | * = TRPIDATA = * | | * +-------------------------------------------------------+ * *** Overlay for TRPOVRLY in TRPBK *** Overlay for TRPOVRLY in TRPBK * * +---------------------------+---------------------------+ * 38 | TRPGPRM | TRPGPRL | * +---------------------------+-------------+-------------+ * 40 | TRPGPRU | TRPGPRS | 46 * +---------------------------+-------------+ * *** Overlay for TRPOVRLY in TRPBK *** Overlay for TRPOVRLY in TRPBK * * +---------------------------+---------------------------+ * 38 | TRPARM | TRPARL | * +---------------------------+-------------+-------------+ * 40 | TRPARU | TRPARS | 46 * +---------------------------+-------------+ * *** Overlay for TRPOVRLY in TRPBK *** Overlay for TRPOVRLY in TRPBK * * +---------------------------+---------------------------+ * 38 | TRPBNEXT | TRPBRANG | * +---------------------------+---------------------------+ * 40 | TRPBRANH | TRPBSTO | * +-------------+-------------+---------------------------+ * 48 | TRPBASN | 4A * +-------------+ * *** Overlay for TRPOVRLY in TRPBK *** Overlay for TRPOVRLY in TRPBK * * +---------------------------+---------------------------+ * 38 | TRPSNEXT | TRPSRANG | * +---------------------------+---------------------------+ * 40 | TRPSRANH | TRPSSTO | * +---------------------------+---------------------------+ * 48 | TRPSASIT | * +-------------------------------------------------------+ * 50 | | * = TRPSPCID = * | +------+-------------+---------------------------+ * 70 | |:XCFLG| TRPSASN | | * +------+------+-------------+ | * 78 | | * = TRPSDATA = * | | * +-------------------------------------------------------+ * *** Overlay for TRPOVRLY in TRPBK
TRPBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----TRPAR 0035 08
TRPARDBW 0044 00000009
TRPARL 003C
TRPARM 0038
TRPARS 0044
TRPARU 0040
TRPASNF 0033 10
TRPBAC 0035 80
TRPBASN 0048
TRPBNEXT 0038
TRPBRANG 003C
TRPBRANH 0040
TRPBRDBW 0048 0000000A
TRPBSTO 0044
TRPCDDBW 003E 00000008
TRPCLOWR 0038
TRPCLWR0 0038
TRPCLWR1 0039
TRPCNTRL 0032
TRPCPCMD 0014
TRPCPNXT 0010
TRPCTL2 0033
TRPCUPPR 003A
TRPCUPR0 003A
TRPCUPR1 003B
TRPDAT 0032 20
TRPDATAL 0040
TRPDBW 0030
TRPDLOWR 003C
TRPDUPPR 003E
TRPESA 0033 04
TRPGPRL 003C
TRPGPRM 0038
TRPGPRS 0044
TRPGPRU 0040
TRPGRDBW 0044 00000009
TRPHIT 0032 01
TRPIASN 0028
TRPIASNF 0033 20
TRPIDATA 0042
TRPIDATP 0033 40
TRPIDENT 0004
TRPIDSET 0033 80
TRPINEXT 0018
TRPINLEN 0040 00000042
TRPIOACT 0034 08
TRPIOCCW 0034 01
TRPIOINS 0034 02
TRPIOINT 0034 04
TRPIRANG 001C
TRPIRANH 0020
TRPISTO 0024
TRPNEXT 0000
TRPNODAT 0032 10
TRPNOSIM 0032 02
TRPOVRLY 0038
TRPPASS 000C
TRPPRINT 0032 08
TRPPROB 0032 80
TRPSASIT 0048
TRPSASN 0072
TRPSDATA 0074
TRPSDISP 0036 08
TRPSFLAG 0036
TRPSKIP 0008
TRPSLAST 0036 10
TRPSNEXT 0038
TRPSPCID 0050
TRPSPDAT 0036 80
TRPSPMAS 0036 04
TRPSRANG 003C
TRPSRANH 0040
TRPSSTO 0044
TRPSTEP 000E
TRPSTLEN 0074 00000074
TRPSTOP 000A
TRPSUPV 0032 40
TRPS1ST 0036 40
TRPS2ND 0036 20
TRPTERM 0032 04
TRPTYPE 0034
TRPTYPE1 0035
TRPXC 0033 02
TRPXCCFY 0071 08
TRPXCFLG 0071
TRPXCPRI 0071 80
TRP370 0033 08
Last updated on 3 Aug 1999 at 13:40:06 EDT.
Copyright IBM Corporation, 1990, 1999