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


  FXTBK Prolog Top of page
 
 NAME       : HCPFXTBK
 DESCRIPTION: FcX channel program Translation BlocK
 DSECT      : FXTBK
 FUNCTION   : This block contains room to hold translated
              guest DCWs and control information.
 LOCATED BY : IORCPA
 CREATED BY : HCPFXRAN
 DELETED BY : HCPFXRAN, HCPFXRUN
 NOTES      : FXTBKs are ALIGNED 1024 byte (128 DWD) blocks
              FXTBKs are obtained by HCPGETST with ALIGNED parm
              FXTBKs are released by HCPRELST with ALIGNED parm
              DEBUG fields are provided as debugging aids only and
              are not used for FCX translation support.
 
 
  FXTBK Control Block Content Top of page
 

 FXTBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure FXTBK FcX channel program Translation BlocK 0000 0 Dbl-Word 8 FXTFREES (126) Free storage area 000003F0 FXTFRESZ *-FXTBK Free storage size in bytes Fixed fields common to all FXTBKs 03F0 1008 Dbl-Word 8 FXTTRLR (2) FXTBK trailer 03F0 1008 Signed 4 * Reserved for IBM use 03F4 1012 Signed 4 FXTFIRST DEBUG: HLA(first FXTBK) 03F8 1016 Signed 4 FXTNEXT HLA(next FXTBK) 03FC 1020 Bitstring 1 * Reserved for IBM use 03FD 1021 Character 3 FXTEYE Eye catcher 'FXT' 00000400 FXTBYSZ *-FXTBK Size in bytes 00000080 FXTDWSZ (((*-FXTBK)+7)/8) Size in doublewords Fixed fields in the *first* FXTBK. The architected FCX control blocks are all neatly defined at the top of the first FXTBK to aid in debugging and to simplify coding. The TCW must be on a 64-byte boundary. That is why this control block is allocated as ALIGNED storage. 0000 0 Dbl-Word 8 FXTTCW (8) Host TCW (64 byte boundary) 0040 64 Address 8 FXTGATSB 64b GAA(TSB assoc with this TCW) 0048 72 Address 4 * RESERVED 004C 76 Bitstring 4 * Reserved for IBM use 0050 80 Dbl-Word 8 * (8) Reserved for IBM use Enforce a quadword boundary for 2 host TIDAWs to point to the host TCCB. 00000090 FXTQW *-FXTBK 0090 144 Unknown 0 * Force QWord bdy 0090 144 Dbl-Word 8 FXTTCCB1 (2) First Host TCCB TIDAW 00A0 160 Dbl-Word 8 FXTTCCB2 (2) Second Host TCCB TIDAW 00B0 176 Dbl-Word 8 FXTTCCB (34) Host TCCB (max length) DWord boundary Status fields 01C0 448 Bitstring 1 FXTFCXST FCX Status byte 1... .... FXTITCWA X'80' FXTITCWA Invalid TCW Address .1.. .... FXTITCW X'40' FXTITCW Invalid TCW ..1. .... FXTITCBA X'20' FXTITCBA Invalid TCCB Address ...1 .... FXTITCCB X'10' FXTITCCB Invalid TCCB .... 1... FXTITSBA X'08' FXTITSBA Invalid TSB Address .... .1.. FXTIIDAT X'04' FXTIIDAT Invalid Input Data Address .... ..1. FXTIODAT X'02' FXTIODAT Invalid Output Data Address 01C1 449 Bitstring 1 FXTFCXPF FCX Process Flags byte 1... .... FXTINPUT X'80' FXTINPUT This is an input operation .1.. .... FXTCCB X'40' FXTCCB Processing a TCCB ..1. .... FXTGTIC X'20' FXTGTIC Prev TIDAW = guest TIC .... .1.. FXTINVT X'04' FXTINVT Invalid TIDAW found .... ..1. FXTPROGC X'02' FXTPROGC Program Check .... ...1 FXTPROTC X'01' FXTPROTC Protection Exception 01C2 450 Bitstring 1 FXTRANST FCX Translation Status byte 1... .... FXTDCWTR X'80' FXTDCWTR DCW(s) translated Indicates non-FP mdisk. .1.. .... FXTSEEK X'40' FXTSEEK SEEK address was translated ..1. .... FXTSEEKV X'20' FXTSEEKV SEEK address is valid ...1 .... FXTXRC X'10' FXTXRC XRC processing required .... 1... FXTHPAVV X'08' FXTHPAVV PREFIX valid for HPAV I/O 01C3 451 Bitstring 1 * Reserved for IBM use Extraneous static fields in the first FXTBK 01C4 452 Address 4 FXTHLINT HLA(Host Interrogate TCW) 01C8 456 Address 4 FXTGCPA GAA(Guest TCW) 01CC 460 Address 4 FXTMDEXT Total minidisk cylinders - 1 01D0 464 Address 4 FXTSEEKG Guest SEEK address 01D4 468 Address 4 FXTUTXAN HLA(UTX Entry anchor) 01D8 472 Signed 4 FXTEOTR End of track 01DC 476 Signed 4 FXTVCCHH Virtual track address 01E0 480 Address 4 FXTFLB64 HLA(Queue of 64 bit TLBs) 01E4 484 Address 4 FXTEHLCP HLA(End of host CP) 01E8 488 Address 4 FXTLAST HLA(Last FXTBK queued or this FXTBK if no other FXTBKs) 01EC 492 Address 4 FXTVDEV HLA(VDEV) 01F0 496 Address 4 FXTRDEV DEBUG: HLA(RDEV) 01F4 500 Address 4 FXTIORBK HLA(IORBK) 01F8 504 Address 4 FXTVMDBK DEBUG: HLA(VMDBK) Common fields shared among the EPs in FXT. 01FC 508 Address 4 FXTNXFRE HLA(Next free stg in FXTBK) 0200 512 Address 4 FXTEOFRE HLA(End of free stg area) 0204 516 Address 4 FXTLOG@ HL page addr of last translated FXTBK address 0208 520 Address 4 FXTABS@ HA page addr of last translated FXTBK address 0210 528 Dbl-Word 8 FXTWORK1 (0) Work area (eg. for TIDAWs) These equates are not directly related to the FXTBK. They are part of the FCX trace support and are passed to various HCPFXT trace routines to indicate the type of data being traced.
 
 
  FXTBK Storage Layout Top of page
 
          
*** FXTBK - FcX channel program Translation BlocK
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       FXTFREES                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 3F0 |                       FXTTRLR                         |
*     |                                                       |
*     +-------------------------------------------------------+
* 400
*
*** FXTBK - FcX channel program Translation BlocK
          
*** Overlay for FXTTRLR in FXTBK
*
*     +---------------------------+---------------------------+
* 3F0 |///////////////////////////|         FXTFIRST          |
*     +---------------------------+------+--------------------+
* 3F8 |         FXTNEXT           |//////|      FXTEYE        |
*     +---------------------------+------+--------------------+
* 400
*
*** Overlay for FXTTRLR in FXTBK
          
*** Overlay for FXTFREES in FXTBK
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                        FXTTCW                         =
*     |                                                       |
*     +-------------------------------------------------------+
*  40 |                       FXTGATSB                        |
*     +---------------------------+---------------------------+
*  48 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  50 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  90 |                       FXTTCCB1                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  A0 |                       FXTTCCB2                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  B0 |                                                       |
*     =                       FXTTCCB                         =
*     |                                                       |
*     +------+------+------+------+---------------------------+
* 1C0 |:FCXST|:FCXPF|:RANST|//////|         FXTHLINT          |
*     +------+------+------+------+---------------------------+
* 1C8 |         FXTGCPA           |         FXTMDEXT          |
*     +---------------------------+---------------------------+
* 1D0 |         FXTSEEKG          |         FXTUTXAN          |
*     +---------------------------+---------------------------+
* 1D8 |         FXTEOTR           |         FXTVCCHH          |
*     +---------------------------+---------------------------+
* 1E0 |         FXTFLB64          |         FXTEHLCP          |
*     +---------------------------+---------------------------+
* 1E8 |         FXTLAST           |         FXTVDEV           |
*     +---------------------------+---------------------------+
* 1F0 |         FXTRDEV           |         FXTIORBK          |
*     +---------------------------+---------------------------+
* 1F8 |         FXTVMDBK          |         FXTNXFRE          |
*     +---------------------------+---------------------------+
* 200 |         FXTEOFRE          |         FXTLOG@           |
*     +---------------------------+---------------------------+
* 208 |         FXTABS@           |///////////////////////////|
*     +---------------------------+---------------------------+
*
*** Overlay for FXTFREES in FXTBK
 
 
  FXTBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
FXTABS@        0208
FXTBYSZ        03FD 00000400
FXTCCB         01C1 40
FXTDCWTR       01C2 80
FXTDWSZ        03FD 00000080
FXTEHLCP       01E4
FXTEOFRE       0200
FXTEOTR        01D8
FXTEYE         03FD
FXTFCXPF       01C1
FXTFCXST       01C0
FXTFIRST       03F4
FXTFLB64       01E0
FXTFREES       0000
FXTFRESZ       0000 000003F0
FXTGATSB       0040
FXTGCPA        01C8
FXTGTIC        01C1 20
FXTHLINT       01C4
FXTHPAVV       01C2 08
FXTIIDAT       01C0 04
FXTINPUT       01C1 80
FXTINVT        01C1 04
FXTIODAT       01C0 02
FXTIORBK       01F4
FXTITCBA       01C0 20
FXTITCCB       01C0 10
FXTITCW        01C0 40
FXTITCWA       01C0 80
FXTITSBA       01C0 08
FXTLAST        01E8
FXTLOG@        0204
FXTMDEXT       01CC
FXTNEXT        03F8
FXTNXFRE       01FC
FXTPROGC       01C1 02
FXTPROTC       01C1 01
FXTQW          0050 00000090
FXTRANST       01C2
FXTRDEV        01F0
FXTSEEK        01C2 40
FXTSEEKG       01D0
FXTSEEKV       01C2 20
FXTTCCB        00B0
FXTTCCB1       0090
FXTTCCB2       00A0
FXTTCW         0000
FXTTRLR        03F0
FXTUTXAN       01D4
FXTVCCHH       01DC
FXTVDEV        01EC
FXTVMDBK       01F8
FXTWORK1       0210
FXTXRC         01C2 10
 
This information is based on z/VM 7.1.0 Last updated on 22 Jun 2018 at 11:49:49 EDT.
Copyright IBM Corporation, 1990, 2018