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

Prolog  

Control Block Contents  

TRPBK DSECT

Storage Layout  

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


This information is based on VM/ESA 2.4.0.
Last updated on 3 Aug 1999 at 13:40:06 EDT.
Copyright IBM Corporation, 1990, 1999