Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### ADRBK

Prolog

Control Block Contents
ADRBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### ADRBK Prolog

     Name       : HCPADRBK
     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)
     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

#### ADRBK DSECT

    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 Bitstring    2 *              Reserved for future IBM use
                                            -------------- End of comparable
                                            ADRBK fields --------------
    0050   80 Dbl-Word     8 * (0)          End of the ADRBK
              0000000A       ADRSIZE        (*-ADRBK+7)/8 Size of ADRBK in
                                            doublewords
              00000050       ADRBSIZE       ADRSIZE*8 Size of ADRBK in bytes

#### ADRBK Storage Layout

    *** 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
    *
    *** ADRBK - Automatic Device Recovery Block

#### ADRBK Cross Reference

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

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 16:39:06 EDT.
Copyright IBM Corporation, 1990, 2005