|
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
...1 .... TRWIODDX X'10' IODATA was specified on
TRACE cmd
00D3 211 Bitstring 1 * Reserved
00D4 212 Signed 2 TRWIODNN Number of bytes for TRACE IO
00D6 214 Bitstring 1 * (2) 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 |//////| TRWIODNN |/////////////|
* +------+------+------+------+-------------+-------------+
* 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 TRWIODDX 00D2 10 TRWIODNN 00D4 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, 2002