Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
TRWBK
Control Block Contents
TRWBK DSECT
Cross Reference (Contains links to field and bit definitions)
TRWBK Prolog
NAME : HCPTRWBK DESCRIPTION: TRACE Work Block DSECT : TRWBK FUNCTION : HCPTRWBK is a work area used by TRACE command processing. LOCATED BY : Pointed to by registers in the modules that use this work area. HCPTRA, HCPTRN, HCPTRJ, HCPTRI, and HCPTRT. CREATED BY : HCPTRACE DELETED BY : HCPTRACE SERIALIZED : CREATED AND DELETED IN CONSOLE FUNCTION MODE.
TRWBK Control Block Content
TRWBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure TRWBK TRACE Work Block The instruction range is specified after the FROM option on the TRACE command. 31-bit addresses will be saved when CP is in ESA/390 mode, and 64-bit addresses will be saved when CP is in ESAME mode. When we have determined that the trace command is valid, these addresses are saved in TRPIRNG. 0000 0 Bitstring 16 TRWGIRNG (0) Instruction range (FROM range) 0000 0 Dbl-Word 8 TRWGIRANG (0) Instr range, lower bound 64-bit 0000 0 Signed 4 TRWIRANG Instr range, lower bound 31-bit 0004 4 Signed 4 TRWIRANH Instr range, upper bound 31-bit 0008 8 Dbl-Word 8 TRWGIRANH Instr range, upper bound 64-bit The target range is specified after the INTO option on the TRACE command. 31-bit addresses will be saved when CP is in ESA/390 mode, and 64-bit addresses will be saved when CP is in ESAME mode. When we have determined that the trace command is valid, these addresses are saved in TRPBRNG for BRANCH traps or TRPSRNG for STORE traps. 0010 16 Bitstring 16 TRWGTRNG (0) Target range (INTO range) 0010 16 Dbl-Word 8 TRWGTRANG (0) Target range, lower bound 64-bit 0010 16 Signed 4 TRWTRANG Target range, lower bound 31-bit 0014 20 Signed 4 TRWTRANH Target range, upper bound 31-bit 0018 24 Dbl-Word 8 TRWGTRANH Target range, upper bound 64-bit TRWGMASK and TRWMASK must be defined with the same format as TRPGGPRM and TRPARM. There is code that is dependent on these fields being defined so that they can overlay each other. 0020 32 Dbl-Word 8 TRWGMASK (0) MASK FOR GREG DATA TRAPS ESAME 0020 32 Signed 4 * Upper half of MASK - ESAME 0024 36 Signed 4 TRWMASK MASK FOR GREG DATA TRAPS -390 0028 40 Dbl-Word 8 TRWGDATL (0) Lower data range (ESAME) 0028 40 Signed 4 * 002C 44 Signed 4 TRWDATAL Lower data range (390) 0030 48 Dbl-Word 8 TRWGDATU (0) Upper data range (ESAME) 0030 48 Signed 4 * 0034 52 Signed 4 TRWDATAU Upper data range (390) 0038 56 Signed 4 TRWINCMP INCOMPATIBLE OPTION FLAGS 003C 60 Signed 4 TRWIDENT IDENTIFICATION (IF ANY) 0040 64 Bitstring 1 TRWTYPE TRPTYPE BYTE - ZERO IF NONE 0041 65 Bitstring 1 TRWTYPE1 TRPTYPE1 byte - bits defined in... .TRPTYPE1 0042 66 Bitstring 1 TRWCTRL1 BITS TO SET IN TRPCNTRL 0043 67 Bitstring 1 TRWCTRL0 BITS TO ZERO IN TRPCNTRL 0044 68 Address 4 TRWCPCMD ADDRESS OF CP CMND BLOCK 0048 72 Address 4 TRWADATA ADDR OF STRING DATA BLOCK(IF ANY) 004C 76 Address 4 TRWAMASK ADDR OF STRING MASK BLOCK (IF ANY) 0050 80 Signed 4 TRWCODRN (0) CODE RANGE BOUNDS 0050 80 Signed 2 TRWCLOWR CODE RANGE LOWER BOUND 0052 82 Signed 2 TRWCUPPR CODE RANGE UPPER BOUND 0054 84 Signed 4 TRWDEVRN (0) DEVICE RANGE BOUNDS 0054 84 Signed 2 TRWDLOWR DEVICE RANGE LOWER BOUND 0056 86 Signed 2 TRWDUPPR DEVICE RANGE UPPER BOUND 0058 88 Signed 2 TRWSKIP SKIP COUNT 005A 90 Signed 2 TRWSTOP STOP COUNT 005C 92 Signed 2 TRWPASS PASS COUNT 005E 94 Signed 2 TRWSTEP STEP COUNT 0060 96 Signed 4 TRWIDATA ADDRESS OF DATA TO FILL TRPIDATA 0064 100 Signed 4 TRWFRMTR ADDRESS OF TRAP TO APPEND 0068 104 Signed 4 TRWTOTRP ADDRESS OF (NEW) APPENDED TRAP 006C 108 Character 8 TRWAPP NAME OF SET BEING APPENDED 0074 116 Signed 4 TRWOPTNS CUMULATIVE OPTION MASKS 0078 120 Signed 4 TRWFIELD SAVE AREA FOR SCNFD FIELD 007C 124 Signed 4 TRWFLD1 SECOND WORD OF SCNFD FIELD 0080 128 Bitstring 1 TRWFENCE (4) FENCE FOR MESSAGE DELIMITERS 0084 132 Signed 4 TRWISTO STO FOR IFETCH RANGE 0088 136 Signed 4 TRWSTO STO FOR STORE.BRANCH RANGE 008C 140 Signed 2 TRWIASN ASN for IFETCH range 008E 142 Signed 2 TRWASN ASN for BRANCH/STORE INTO range 0090 144 Dbl-Word 8 TRWIASCE ASCE for IFETCH RANGE ESAME 0098 152 Dbl-Word 8 TRWASCE ASCE BRANCH/STORE INTO rng ESAME TRWIASIT, TRWEASIT, and TRWSPCID will only be used for traps that are restricted to ESA/XC mode spaces 00A0 160 Dbl-Word 8 TRWIASIT i-ASIT for STORE INTO range 00A8 168 Dbl-Word 8 TRWEASIT e-ASIT for STORE INTO range 00B0 176 Character 33 TRWSPCID Spaceid for STORE INTO range 00D1 209 Bitstring 1 TRWIO I/O OPTION BITS 00D2 210 Bitstring 1 TRWFLAG TRWSECT flag byte .... ...1 TRWIASNF X'01' TRWIASN contains a valid ASN .... ..1. TRWASNF X'02' TRWASN contains a valid ASN 1... .... TRWIADSP X'80' Trap is restricted to instr.... .fetched from a specific add sp .1.. .... TRWBADSP X'40' Trap is restricted to branch ... .events into a specific add sp ..1. .... TRWSADSP X'20' Trap is restricted to storage ... .alts in a specific addr space 111. .... TRWADSP TRWIADSP+TRWBADSP+TRWSADSP 00D3 211 Bitstring 1 * (5) Reserved The following storage is being defined for use by TRACE. It is intended to be used to hold information accross calls to modules to avoid the use of 64-bit registers. ORGs should be used to redefine this space for specific purposes. 00D8 216 Dbl-Word 8 TRWTSTOR (2) 00D8 216 Dbl-Word 8 TRWTDW1 (0) 00D8 216 Signed 4 TRWTFW1 00DC 220 Signed 4 TRWTFW2 00E0 224 Dbl-Word 8 TRWTDW2 (0) 00E0 224 Signed 4 TRWTFW3 00E4 228 Signed 4 TRWTFW4 The following definitions are used for the interface between HCPTRN/HCPTRJNL/HCPARI. 00D8 216 Dbl-Word 8 TRWTRNGL 00E0 224 Dbl-Word 8 TRWTRNGU The following definitions are used for the interface between HCPTRJAS and HCPTRN. 00D8 216 Signed 4 * 00DC 220 Signed 4 TRWTEMP1 (0) 00DC 220 Signed 2 * Temporary place for ASN. An ASN... 00DE 222 Signed 2 TRWTASN ...is only 2 bytes, but a FW is .needed for GREG macro 00E0 224 Dbl-Word 8 TRWTEMP2 (0) 00E0 224 Dbl-Word 8 TRWTASCE (0) Temporary place for ASCE 00E0 224 Signed 4 * 00E4 228 Signed 4 TRWTSTO Temporary place for STO 000000E8 TRWBKLEN *-TRWBK Length of TRWBK 0000001D TRWSIZE (*-TRWBK+7)/8 Length in doublewords Redefinition of TRWSPCID 000000B0 TRWSPCD0 TRWSPCID Pointer to first byte of TRWSPCID 000000B8 TRWSPCD8 TRWSPCID+8 Pointer to 8th byte of TRWSPCID 00000021 TRWSPCDL L'TRWSPCID Length of TRWSPCID field
TRWBK Storage Layout
*** TRWBK - TRACE Work Block * * +---------------------------+---------------------------+ * 0 | TRWIRANG | TRWIRANH | * +---------------------------+---------------------------+ * 8 | TRWGIRANH | * +---------------------------+---------------------------+ * 10 | TRWTRANG | TRWTRANH | * +---------------------------+---------------------------+ * 18 | TRWGTRANH | * +---------------------------+---------------------------+ * 20 |///////////////////////////| TRWMASK | * +---------------------------+---------------------------+ * 28 |///////////////////////////| TRWDATAL | * +---------------------------+---------------------------+ * 30 |///////////////////////////| TRWDATAU | * +---------------------------+---------------------------+ * 38 | TRWINCMP | TRWIDENT | * +------+------+------+------+---------------------------+ * 40 |:TYPE |:TYPE1|:CTRL1|:CTRL0| TRWCPCMD | * +------+------+------+------+---------------------------+ * 48 | TRWADATA | TRWAMASK | * +-------------+-------------+-------------+-------------+ * 50 | TRWCLOWR | TRWCUPPR | TRWDLOWR | TRWDUPPR | * +-------------+-------------+-------------+-------------+ * 58 | TRWSKIP | TRWSTOP | TRWPASS | TRWSTEP | * +-------------+-------------+-------------+-------------+ * 60 | TRWIDATA | TRWFRMTR | * +---------------------------+---------------------------+ * 68 | TRWTOTRP | TRWAPP- | * +---------------------------+---------------------------+ * 70 | -(06C) | TRWOPTNS | * +---------------------------+---------------------------+ * 78 | TRWFIELD | TRWFLD1 | * +---------------------------+---------------------------+ * 80 | TRWFENCE | TRWISTO | * +---------------------------+-------------+-------------+ * 88 | TRWSTO | TRWIASN | TRWASN | * +---------------------------+-------------+-------------+ * 90 | TRWIASCE | * +-------------------------------------------------------+ * 98 | TRWASCE | * +-------------------------------------------------------+ * A0 | TRWIASIT | * +-------------------------------------------------------+ * A8 | TRWEASIT | * +-------------------------------------------------------+ * B0 | | * = TRWSPCID = * | +------+------+----------------------------------+ * D0 | |TRWIO |:FLAG |//////////////////////////////////| * +------+------+------+----------------------------------+ * D8 | TRWTSTOR | * | | * +-------------------------------------------------------+ * E8 * *** TRWBK - TRACE Work Block *** Overlay for TRWTSTOR in TRWBK * * +---------------------------+---------------------------+ * D8 | TRWTFW1 | TRWTFW2 | * +---------------------------+---------------------------+ * E0 | TRWTFW3 | TRWTFW4 | * +---------------------------+---------------------------+ * E8 * *** Overlay for TRWTSTOR in TRWBK *** Overlay for TRWTSTOR in TRWBK * * +-------------------------------------------------------+ * D8 | TRWTRNGL | * +-------------------------------------------------------+ * E0 | TRWTRNGU | * +-------------------------------------------------------+ * E8 * *** Overlay for TRWTSTOR in TRWBK *** Overlay for TRWTSTOR in TRWBK * * +---------------------------+-------------+-------------+ * D8 |///////////////////////////|/////////////| TRWTASN | * +---------------------------+-------------+-------------+ * E0 |///////////////////////////| TRWTSTO | * +---------------------------+---------------------------+ * E8 * *** Overlay for TRWTSTOR in TRWBK
TRWBK Cross Reference
Symbol Dspl Value -------------- ---- ----- TRWADATA 0048 TRWADSP 00D2 E0 TRWAMASK 004C TRWAPP 006C TRWASCE 0098 TRWASN 008E TRWASNF 00D2 02 TRWBADSP 00D2 40 TRWBKLEN 00E4 000000E8 TRWCLOWR 0050 TRWCODRN 0050 TRWCPCMD 0044 TRWCTRL0 0043 TRWCTRL1 0042 TRWCUPPR 0052 TRWDATAL 002C TRWDATAU 0034 TRWDEVRN 0054 TRWDLOWR 0054 TRWDUPPR 0056 TRWEASIT 00A8 TRWFENCE 0080 TRWFIELD 0078 TRWFLAG 00D2 TRWFLD1 007C TRWFRMTR 0064 TRWGDATL 0028 TRWGDATU 0030 TRWGIRANG 0000 TRWGIRANH 0008 TRWGIRNG 0000 TRWGMASK 0020 TRWGTRANG 0010 TRWGTRANH 0018 TRWGTRNG 0010 TRWIADSP 00D2 80 TRWIASCE 0090 TRWIASIT 00A0 TRWIASN 008C TRWIASNF 00D2 01 TRWIDATA 0060 TRWIDENT 003C TRWINCMP 0038 TRWIO 00D1 TRWIRANG 0000 TRWIRANH 0004 TRWISTO 0084 TRWMASK 0024 TRWOPTNS 0074 TRWPASS 005C TRWSADSP 00D2 20 TRWSIZE 00E4 0000001D TRWSKIP 0058 TRWSPCDL 00E4 00000021 TRWSPCD0 00E4 000000B0 TRWSPCD8 00E4 000000B8 TRWSPCID 00B0 TRWSTEP 005E TRWSTO 0088 TRWSTOP 005A TRWTASCE 00E0 TRWTASN 00DE TRWTDW1 00D8 TRWTDW2 00E0 TRWTEMP1 00DC TRWTEMP2 00E0 TRWTFW1 00D8 TRWTFW2 00DC TRWTFW3 00E0 TRWTFW4 00E4 TRWTOTRP 0068 TRWTRANG 0010 TRWTRANH 0014 TRWTRNGL 00D8 TRWTRNGU 00E0 TRWTSTO 00E4 TRWTSTOR 00D8 TRWTYPE 0040 TRWTYPE1 0041
Copyright IBM Corporation, 1990, 2001