DUCT Back to Index page
 
Prolog 
Control Block Contents 
   DUCT 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.


  DUCT Prolog Top of page
 
 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 Top of page
 

 DUCT DSECT Top of page
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 Top of page
 
 
*** 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 Top of page
 
 
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
 
This information is based on z/VM 6.4.0 Last updated on 24 Aug 2016 at 09:24:25 EDT.
Copyright IBM Corporation, 1990, 2016