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

This information is based on z/VM V4R3.0. Last updated on 1 May 2002 at 10:43:06 EDT.
Copyright IBM Corporation, 1990, 2002