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

DUCT

Prolog  

Control Block Contents  
   DUCT DSECT

Storage Layout  

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

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:00:47 EDT.
Copyright IBM Corporation, 1990, 2011