ADRBK | Back to Index page

| Prolog Control Block Contents ADRBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

ADRBK Prolog | Top of page

                  Description: Automatic Device Recovery Block
                  DSECT      : ADRBK
                  Function   : This control block saves device information
                  during an IPI Delete.  If another machine
                  check should announce the return of a device
                  within a given time period, this will hold
                  enough information to reattach the device.
                  Located by : ADRNEXT field of ADRBK (PTR to next ADRBK)
                  SYSADRBK field of SYSCM (PTR to first ADRBK)
                  Created by : HCPGETST in HCPADRAD
                  Deleted by : HCPRELST in HCPADRDL (timer expiration)
                  HCPRELST in HCPADRRS (machine check)
     RELOCATION CONSIDERATIONS : None
                  Comments   : The unique fields are used to determine the
                  identity of a device over an IPI Delete and
                  subsequent IPI Add.  The specific fields are
                  used during an IPI Add to determine how the
                  device will actually be re-attached.

ADRBK Control Block Content | Top of page

     ADRBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      ADRBK          Automatic Device Recovery Block
    0000    0 Signed       4 ADRNEXT        Pointer to next ADRBK
    0004    4 Bitstring   44 ADRGEN (0)     Basic ADRBK container
    0004    4 Signed       2 ADRRDEV        RDEV Number
    0006    6 Signed       2 ADRCODE (0)    Device Identification Code
    0006    6 Bitstring    1 ADRCLAS        Device Class
    0007    7 Bitstring    1 ADRTYPE        Device Type
    0008    8 Bitstring   32 ADRDNED        Device NED
    0028   40 Bitstring    2 ADRCUID        Control Unit ID
    002A   42 Bitstring    1 ADRCUMN        Control Unit Model Number
    002B   43 Bitstring    2 ADRDVID        Device ID
    002D   45 Bitstring    1 ADRDVMN        Device Model Number
    002E   46 Bitstring    2 *              Reserved for future IBM use
                                            -------------- ADRBK instance
                                            specific fields --------------
    0030   48 Bitstring   28 ADRSPEC (0)    Extended ADRBK container
    0030   48 Signed       4 ADRTIMER       HCPTIMER TimerID for block
    0034   52 Address      4 ADRENTRY       Reattach handler entry point
    0038   56 Signed       4 ADRSID         Host Subchannel ID
    003C   60 Character    8 ADRUSER        Target guest's userid
    0044   68 Signed       2 ADRVDEV        VDEV Number
    0046   70 Bitstring    1 ADRFLGA        Flags for DDEVFLGA
    0047   71 Bitstring    1 ADRFLGB        Flags for DDEVFLGB
    0048   72 Bitstring    1 ADRFLGC        Flags for DDEVFLGC
    0049   73 Bitstring    1 ADRFLGD        Flags for DDEVFLGD
    004A   74 Signed       2 *              Reserved for future IBM use
    004C   76 Signed       4 *              Reserved for future IBM use
    0050   80 Bitstring   16 ADRFOID        Fabric Owner ID or Zero
                                            -------------- End of comparable
                                            ADRBK fields --------------
    0060   96 Dbl-Word     8 * (0)          End of the ADRBK
              0000000C       ADRSIZE        (*-ADRBK+7)/8 Size of ADRBK in
                                            doublewords
              00000060       ADRBSIZE       ADRSIZE*8 Size of ADRBK in bytes

ADRBK Storage Layout | Top of page

    *** ADRBK - Automatic Device Recovery Block
    *
    *     +---------------------------+-------------+------+------+
    *   0 |         ADRNEXT           |  ADRRDEV    |:CLAS |:TYPE |
    *     +---------------------------+-------------+------+------+
    *   8 |                                                       |
    *     =                       ADRDNED                         =
    *     |                                                       |
    *     +-------------+------+-------------+------+-------------+
    *  28 |  ADRCUID    |:CUMN |  ADRDVID    |:DVMN |/////////////|
    *     +-------------+------+------+------+------+-------------+
    *  30 |         ADRTIMER          |         ADRENTRY          |
    *     +---------------------------+---------------------------+
    *  38 |          ADRSID           |         ADRUSER-          |
    *     +---------------------------+-------------+------+------+
    *  40 |          -(03C)           |  ADRVDEV    |:FLGA |:FLGB |
    *     +------+------+-------------+-------------+------+------+
    *  48 |:FLGC |:FLGD |/////////////|///////////////////////////|
    *     +------+------+-------------+---------------------------+
    *  50 |                       ADRFOID                         |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  60
    *
    *** ADRBK - Automatic Device Recovery Block

ADRBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    ADRBSIZE       0060 00000060
    ADRCLAS        0006
    ADRCODE        0006
    ADRCUID        0028
    ADRCUMN        002A
    ADRDNED        0008
    ADRDVID        002B
    ADRDVMN        002D
    ADRENTRY       0034
    ADRFLGA        0046
    ADRFLGB        0047
    ADRFLGC        0048
    ADRFLGD        0049
    ADRFOID        0050
    ADRGEN         0004
    ADRNEXT        0000
    ADRRDEV        0004
    ADRSID         0038
    ADRSIZE        0060 0000000C
    ADRSPEC        0030
    ADRTIMER       0030
    ADRTYPE        0007
    ADRUSER        003C
    ADRVDEV        0044

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:26:49 EDT.
Copyright IBM Corporation, 1990, 2020