IBM: XCRBK

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

XCRBK

Prolog

Control Block Contents

XCRBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

XCRBK Prolog

 Name       : HCPXCRBK
 Description: CP Exit Call Request Block
 DSECT      : XCRBK
 STATUS     : VM/ESA VERSION 2, RELEASE 1.0
 Function   : This control block contains information used to
              authorize user exit routines to find their entry
              points.
 Located by : XITBK.XITXCRBK
              XCRBK.XCRFWD
 Created by : HCPZIX
 Deleted by : HCPZIX
 References : HCPICRBK - Indirect Call Request Block

XCRBK Control Block Content


XCRBK DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      XCRBK          CP Exit Call Request Block
     These fields map the Indirect Call Request Block. These fields must
     match the analogous fields in the ICRBK. The fields are defined
     explicitly here in order that BLOCKDEF can correctly describe them.
     CKMAINT is used in the hope that an assembly error will alert one to
     any possible inconsistencies between the definitions here and the ICRBK
     definitions.
0000    0 Dbl-Word     8 XCRICRBK (0)   ICRBK fields
0000    0 Character    8 XCREPNAM       Name of exit routine ep
0008    8 Address      4 XCRADDRL       Address of the ICLBK, or 0.
000C   12 Bitstring    1 XCRATTR        Attributes for call
          ...1 ....      ICRESTA        X'10' callee uses static savearea
          .... 1...      ICRRMP         X'08' caller MP capable
          .... .1..      ICRERES        X'04' callee Resident
          .... ..1.      ICREMP         X'02' callee MP capable
          .... ...1      ICRTRC         X'01' issue TRACE instruction
000D   13 Bitstring    1 *              Reserved
000E   14 Bitstring    1 *              Reserved
000F   15 Bitstring    1 *              Reserved
0010   16 Address      4 * (0)          ICRSIZE*8)))) IEV075 will result
                                        if ICRSIZE*8 NE *-XCRBK @P3714FM
     Thus ends the Indirect Call Request Block fields
0010   16 Dbl-Word     8 XCRUSRD1       Reserved for non-IBM use
0018   24 Dbl-Word     8 XCRUSRD2       Reserved for non-IBM use
0020   32 Signed       4 XCRUSRF1       Reserved for non-IBM use
0024   36 Signed       4 XCRUSRF2       Reserved for non-IBM use
0028   40 Signed       2 XCRUSRH1       Reserved for non-IBM use
002A   42 Signed       2 XCRUSRH2       Reserved for non-IBM use
002C   44 Bitstring    1 XCRUSRX1       Reserved for non-IBM use
002D   45 Bitstring    1 XCRUSRX2       Reserved for non-IBM use
002E   46 Bitstring    1 XCRUSRX3       Reserved for non-IBM use
002F   47 Bitstring    1 XCRUSRX4       Reserved for non-IBM use
0030   48 Address      4 XCRFWD         Address of next XCRBK
0034   52 Signed       4 XCRATMPT       Count of attempts to call this
                                        routine
0038   56 Signed       4 XCRCALLS       Count of calls to this exit
003C   60 Signed       4 *              Reserved
0040   64 Dbl-Word     8 XCRMSACT       Time (in micro-seconds) that .
                                        this routine was active.
0048   72 Dbl-Word     8 XCR$END (0)    The end

XCRBK Storage Layout

*** XCRBK - CP Exit Call Request Block
*
*     +-------------------------------------------------------+
*   0 |                       XCREPNAM                        |
*     +---------------------------+------+------+------+------+
*   8 |         XCRADDRL          |:ATTR |//////|//////|//////|
*     +---------------------------+------+------+------+------+
*  10 |                       XCRUSRD1                        |
*     +-------------------------------------------------------+
*  18 |                       XCRUSRD2                        |
*     +---------------------------+---------------------------+
*  20 |         XCRUSRF1          |         XCRUSRF2          |
*     +-------------+-------------+------+------+------+------+
*  28 |  XCRUSRH1   |  XCRUSRH2   |:USRX1|:USRX2|:USRX3|:USRX4|
*     +-------------+-------------+------+------+------+------+
*  30 |          XCRFWD           |         XCRATMPT          |
*     +---------------------------+---------------------------+
*  38 |         XCRCALLS          |///////////////////////////|
*     +---------------------------+---------------------------+
*  40 |                       XCRMSACT                        |
*     +-------------------------------------------------------+
*  48 |                                                       |
*     =                       XCR$END                         =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** XCRBK - CP Exit Call Request Block