| TDBK | Back to Index page |
|
Prolog Control Block Contents TDBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
|
| TDBK Prolog | Top of page |
NAME : HCPTDBK
DESCRIPTION: Transaction Diagnostic Block
DSECT : TDBK
FUNCTION : Transaction Diagnostic Block as defined by
the Transactional Execution facility of z
architecture.
LOCATED BY : SIEITDBA, VMDITDBA also embedded in the
guest prefix area at UOPPITDB, and optionally
presented as a operand of the TBEGIN
instruction.
CREATED BY : HCPVTX and HCPWVS
DELETED BY : HCPRST
SERIALIZED : i-stream when referencing the ITDB or
guest PITDB
COMPATIBILITY AND MIGRATION CONCERNS : N/A
OTES - None.
RELOCATION CONSIDERATIONS :
HCPTDBK maps the TBEGIN TDB, the Interception
TDB and the Program Interruption TDB. Guest
TBEGINB TDBs are not referenced by CP and have no
relocation considerations. (This would also apply
to a second level CP should it choose to exploit
transactional execution). The host references the
ITDB pointed to by VMDITDBA and SIEITDBA and the
PITDB embedded in the guest's prefix area. Both
of these have relocation considerations arising
from the fact that translated addressed are
obtained for both types. On relocation, locked
translations of the PITDB must be released. The
ITDB is not relocated but instead is eventually
released when the source VMDBK is released.
However TX is deactivated by setting ECB.3=0
under the source VMDBK.
The target system must retranslate and lock the
PITDB and allocate a new ITDB on successful
relocation. This is achieved by forcing
the guest through TX initialization by leaving
ECB.3=0 (the default) value for each VMDBK
at the target system.
When the guest next issues a TX instruction, that
instruction will be intercepted and TX will be
re-initialized at the target system, which
includes locking the guest's prefix area,
saving the host logical translated address for
page 1, allocating an ITDB and saving the logical
and real addresses of the ITDB in the VMDITDBA
and SIEITDBA respectively. Then, finally, seting
ECB.3=1
If relocation fails, the guest resumes execution
under the source VMDBKs. TX will have been
deactivated prior to relocation (ECB.3 set to 0).
Subsequent use of a TX instructions will force the
source system through TX initialization where it
is recognised in HCPVTX that an ITDB is already
allocated and a short cut to re-initialization
employed.
|
| TDBK Control Block Content | Top of page |
|
| TDBK Storage Layout | Top of page |
*** TDBK - Transaction Diagnostic Block
*
* +------+------+---------------------------+-------------+
* 0 |TDBFMT|:FLAGS|///////////////////////////| TDBTND |
* +------+------+---------------------------+------+------+
* 8 |////////////////////////////////////////////////|:ACODE|
* +------------------------------------------------+------+
* 10 | TDBCT |
* +-------------------------------------------------------+
* 18 | TDBATIA |
* +------+------+-------------+---------------------------+
* 20 |:EAID |TDBDXC|/////////////| TDBPII |
* +------+------+-------------+---------------------------+
* 28 | TDBTEI |
* +-------------------------------------------------------+
* 30 | TDBBEA |
* +-------------------------------------------------------+
* 38 |///////////////////////////////////////////////////////|
* =///////////////////////////////////////////////////////=
* |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 80 | |
* = TDBGPRS =
* | |
* +-------------------------------------------------------+
* 100
*
*** TDBK - Transaction Diagnostic Block
*** Overlay for TDBGPRS in TDBK
*
* +-------------------------------------------------------+
* 80 | TDBGPR0 |
* +-------------------------------------------------------+
* 88 | TDBGPR1 |
* +-------------------------------------------------------+
* 90 | TDBGPR2 |
* +-------------------------------------------------------+
* 98 | TDBGPR3 |
* +-------------------------------------------------------+
* A0 | TDBGPR4 |
* +-------------------------------------------------------+
* A8 | TDBGPR5 |
* +-------------------------------------------------------+
* B0 | TDBGPR6 |
* +-------------------------------------------------------+
* B8 | TDBGPR7 |
* +-------------------------------------------------------+
* C0 | TDBGPR8 |
* +-------------------------------------------------------+
* C8 | TDBGPR9 |
* +-------------------------------------------------------+
* D0 | TDBGPR10 |
* +-------------------------------------------------------+
* D8 | TDBGPR11 |
* +-------------------------------------------------------+
* E0 | TDBGPR12 |
* +-------------------------------------------------------+
* E8 | TDBGPR13 |
* +-------------------------------------------------------+
* F0 | TDBGPR14 |
* +-------------------------------------------------------+
* F8 | TDBGPR15 |
* +-------------------------------------------------------+
* 100
*
*** Overlay for TDBGPRS in TDBK
|
| TDBK Cross Reference | Top of page |
Symbol Dspl Value -------------- ---- ----- TDBACODE 000F TDBATIA 0018 TDBBEA 0030 TDBBSIZE 00F8 00000100 TDBCFTCH 000F 0000000E TDBCOTHR 000F 00000010 TDBCSTOR 000F 0000000F TDBCT 0010 TDBCTI 0001 00000040 TDBCTV 0001 00000080 TDBDXC 0021 TDBEAID 0020 TDBEXTIN 000F 00000002 TDBFLAGS 0001 TDBFMT 0000 TDBFMT0 0000 00000000 TDBFMT1 0000 00000001 TDBFTCHC 000F 00000009 TDBFTCHO 000F 00000007 TDBGPRS 0080 TDBGPR0 0080 TDBGPR1 0088 TDBGPR10 00D0 TDBGPR11 00D8 TDBGPR12 00E0 TDBGPR13 00E8 TDBGPR14 00F0 TDBGPR15 00F8 TDBGPR2 0090 TDBGPR3 0098 TDBGPR4 00A0 TDBGPR5 00A8 TDBGPR6 00B0 TDBGPR7 00B8 TDBGPR8 00C0 TDBGPR9 00C8 TDBIOINT 000F 00000006 TDBKLEN 00F8 00000100 TDBKSIZE 00F8 00000020 TDBMCHCK 000F 00000005 TDBMISC 000F 000000FF TDBNDPTH 000F 0000000D TDBPGMIN 000F 00000004 TDBPII 0024 TDBPRGEX 000F 0000000C TDBRSTDI 000F 0000000B TDBSTORC 000F 0000000A TDBSTORO 000F 00000008 TDBTAC 0008 TDBTAC17 000F 00000011 TDBTAC18 000F 00000012 TDBTEI 0028 TDBTND 0006 |
Copyright IBM Corporation, 1990, 2022