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.
 RELOCATION CONSIDERATIONS : None

 

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. 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

          
*** 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

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 V6R2.0. Last updated on 21 Nov 2011 at 11:28:05 EDT.
Copyright IBM Corporation, 1990, 2011