TRWBK Back to Index page
 
Prolog 
Control Block Contents 
   TRWBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  TRWBK Prolog Top of page
 
 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.
 RELOCATION CONSIDERATIONS : None
 
 
  TRWBK Control Block Content Top of page
 

 TRWBK DSECT Top of page
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. 64-bit addresses will be saved. 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 Instr range, lower bound 64-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. 64-bit addresses will be saved. 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 Target range, lower bound 64-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 0020 32 Signed 4 * Upper half of MASK 0024 36 Signed 4 TRWMASK MASK FOR GREG DATA TRAPS (low) 0028 40 Dbl-Word 8 TRWGDATL (0) Lower data range 0028 40 Signed 4 * 002C 44 Signed 4 TRWDATAL Lower data range (low) 0030 48 Dbl-Word 8 TRWGDATU (0) Upper data range 0030 48 Signed 4 * 0034 52 Signed 4 TRWDATAU Upper data range (low) 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 0098 152 Dbl-Word 8 TRWASCE ASCE BRANCH/STORE INTO rng 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' TRWIASNF TRWIASN contains a valid ASN .... ..1. TRWASNF X'02' TRWASNF TRWASN contains a valid ASN 1... .... TRWIADSP X'80' TRWIADSP Trap is restricted to instr.... fetched from a specific add sp .1.. .... TRWBADSP X'40' TRWBADSP Trap is restricted to branch ... events into a specific add sp ..1. .... TRWSADSP X'20' TRWSADSP Trap is restricted to storage ... alts in a specific addr space 111. .... TRWADSP TRWIADSP+TRWBADSP+TRWSADSP TRWADSP ...1 .... TRWIODDX X'10' TRWIODDX 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 00E0 224 Dbl-Word 8 TRWTDW2 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 Top of page
 
          
*** TRWBK - TRACE Work Block
*
*     +-------------------------------------------------------+
*   0 |                      TRWGIRANG                        |
*     +-------------------------------------------------------+
*   8 |                      TRWGIRANH                        |
*     +-------------------------------------------------------+
*  10 |                      TRWGTRANG                        |
*     +-------------------------------------------------------+
*  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 |                       TRWTDW1                         |
*     +-------------------------------------------------------+
*  E0 |                       TRWTDW2                         |
*     +-------------------------------------------------------+
*  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 Top of page
 
 
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
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
TRWTOTRP       0068
TRWTRNGL       00D8
TRWTRNGU       00E0
TRWTSTO        00E4
TRWTSTOR       00D8
TRWTYPE        0040
TRWTYPE1       0041
 
This information is based on z/VM 6.3.0 Last updated on 22 May 2013 at 13:56:10 EDT.
Copyright IBM Corporation, 1990, 2013