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. 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' 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
    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 V5R2.0. Last updated on 12 Apr 2006 at 17:34:50 EDT.
Copyright IBM Corporation, 1990, 2005