Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

TRWBK

Prolog  

Control Block Contents  
   TRWBK DSECT

Storage Layout  

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

This information is based on z/VM V4R2.0. Last updated on 17 Oct 2001 at 17:01:31 EDT.
Copyright IBM Corporation, 1990, 2001