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