Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
ADRBK
Control Block Contents
ADRBK DSECT
Cross Reference (Contains links to field and bit definitions)
ADRBK Prolog
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
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
Copyright IBM Corporation, 1990, 2011