|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
DUCT
Control Block Contents
DUCT DSECT
Cross Reference (Contains links to field and bit definitions)
DUCT Prolog
NAME : HCPDUCT
DESCRIPTION: Dispatchable Unit Control Table
DSECT : DUCT
FUNCTION : The DUCT maps the storage associated with the
Dispatchable Unit Control Table
LOCATED BY : The DUCTO in CR2
CREATED BY : None.
DELETED BY : None.
REFERENCES : None.
SERIALIZED : When used to map a guest DUCT, the DUCT is serialized by
instruction stream serialization.
RELOCATION CONSIDERATIONS : None
COMPATIBILITY AND MIGRATION CONCERNS : None.
DUCT Control Block Content
DUCT DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure DUCT Dispatchable Unit Control Table 0000 0 Signed 4 DUIBM1 Reserved for IBM use 0004 4 Signed 4 DUIBM2 Reserved for IBM use 0008 8 Signed 4 * Reserved for IBM use 000C 12 Signed 4 DUIBM4 Reserved for IBM use 0010 16 Signed 4 DUALD Dispatchable-Unit Access- List Designation ** From this point on, the DUCT varies by guest mode ** (ESA/390 vs z/Arch) and by addressing mode (24-bit, ** 31-bit or 64-bit). * ESA/390 mode guest 0014 20 Bitstring 44 DUBSA515 (0) Words 5-15 for ESA/390 guest 0014 20 Bitstring 8 * Reserved for IBM use 001C 28 Signed 4 DUPRGM For use by programming 0020 32 Signed 4 DUBSAADR BSA addr mode & return addr First bit of the DUBSAADR field 1... .... DUBSAADM X'80' BSA address mode bit 0024 36 Signed 4 DUBSAPSW PSW info for BSA instruction 0028 40 Bitstring 4 * Reserved for IBM use 002C 44 Address 4 DUTRPCTL Trap-Control-Block address 0030 48 Bitstring 16 * Reserved for IBM use * z/Arch mode guest 0014 20 Bitstring 44 DUG515 (0) Words 5-15 for z/Arch guest 0014 20 Signed 4 DUGSAPSW PSW info for BSA instruction 0018 24 Bitstring 4 * Reserved for IBM use 001C 28 Signed 4 DUGPRGM For use by programming 0020 32 Address 8 DUG64ADR (0) Bits 0-63 of 64-bit addr in 64-bit addressing mode 0020 32 Bitstring 4 DUG64AHI Bits 0-31 of 64-bit addr in 64-bit addressing mode Zeros in 24-bit or 31-bit addressing modes 0024 36 Signed 4 DUGSAADR BSA addr mode & return addr in 24-bit or 31-bit addressing modes Bits 32-63 of 64-bit addr in 64-bit addressing mode First bit of the DUGSAADR field 1... .... DUGSAADM X'80' BSA address mode bit 0028 40 Bitstring 4 * Reserved for IBM use 002C 44 Address 4 DUGTRPCT Trap-Control-Block address 0030 48 Bitstring 16 * Reserved for IBM use 00000040 DUCTLEN *-DUCT Length in bytes 00000008 DUCTSIZE (*-DUCT+7)/8 Length in doublewords Redefinition of DUBSAPSW 0024 36 Bitstring 2 DUBSAPKM PSW key mask 0026 38 Bitstring 1 * Reserved for IBM use 0027 39 Bitstring 1 DUBSAPS1 Misc PSW stuff 1111 .... DUBSAPSK X'F0' DUBSAPSK PSW key .... 1... DUBSARA X'08' DUBSARA Reduced authority bit .... ...1 DUBSAPSB X'01' DUBSAPSB Problem state bit Redefinition of DUGSAPSW 0014 20 Bitstring 2 DUGSAPKM PSW key mask 0016 22 Bitstring 1 * Reserved for IBM use 0017 23 Bitstring 1 DUGSAPS1 Misc PSW stuff 1111 .... DUGSAPSK X'F0' DUGSAPSK PSW key .... 1... DUGSARA X'08' DUGSARA Reduced authority bit .... ...1 DUGSAPSB X'01' DUGSAPSB Problem state bit
DUCT Storage Layout
*** DUCT - Dispatchable Unit Control Table
*
* +---------------------------+---------------------------+
* 0 | DUIBM1 | DUIBM2 |
* +---------------------------+---------------------------+
* 8 |///////////////////////////| DUIBM4 |
* +---------------------------+---------------------------+
* 10 | DUALD |///////////////////////////|
* +---------------------------+---------------------------+
* 18 |///////////////////////////| DUPRGM |
* +---------------------------+---------------------------+
* 20 | DUBSAADR | DUBSAPSW |
* +---------------------------+---------------------------+
* 28 |///////////////////////////| DUTRPCTL |
* +---------------------------+---------------------------+
* 30 |///////////////////////////////////////////////////////|
* |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 40
*
*** DUCT - Dispatchable Unit Control Table
*** Overlay for DUBSA515 in DUCT
*
* +---------------------------+
* 10 ... 14 | DUGSAPSW |
* +---------------------------+---------------------------+
* 18 |///////////////////////////| DUGPRGM |
* +---------------------------+---------------------------+
* 20 | DUG64AHI | DUGSAADR |
* +---------------------------+---------------------------+
* 28 |///////////////////////////| DUGTRPCT |
* +---------------------------+---------------------------+
* 30 |///////////////////////////////////////////////////////|
* |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 40
*
*** Overlay for DUBSA515 in DUCT
*** Overlay for DUBSAPSW in DUCT
*
* +-------------+------+------+
* 20 ... 24 | DUBSAPKM |//////|:SAPS1|
* +-------------+------+------+
* 28
*
*** Overlay for DUBSAPSW in DUCT
*** Overlay for DUGSAPSW in DUCT
*
* +-------------+------+------+
* 10 ... 14 | DUGSAPKM |//////|:SAPS1|
* +-------------+------+------+
* 18
*
*** Overlay for DUGSAPSW in DUCT
DUCT Cross Reference
Symbol Dspl Value -------------- ---- ----- DUALD 0010 DUBSAADM 0020 80 DUBSAADR 0020 DUBSAPKM 0024 DUBSAPSB 0027 01 DUBSAPSK 0027 F0 DUBSAPSW 0024 DUBSAPS1 0027 DUBSARA 0027 08 DUBSA515 0014 DUCTLEN 0030 00000040 DUCTSIZE 0030 00000008 DUGPRGM 001C DUGSAADM 0024 80 DUGSAADR 0024 DUGSAPKM 0014 DUGSAPSB 0017 01 DUGSAPSK 0017 F0 DUGSAPSW 0014 DUGSAPS1 0017 DUGSARA 0017 08 DUGTRPCT 002C DUG515 0014 DUG64ADR 0020 DUG64AHI 0020 DUIBM1 0000 DUIBM2 0004 DUIBM4 000C DUPRGM 001C DUTRPCTL 002C
Copyright IBM Corporation, 1990, 2011