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

FCTBK

Prolog  

Control Block Contents  
   FCTBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


FCTBK Prolog

 Name       : HCPFCTBK
 Description: Fast CCW Translation BlocK
 DSECT      : FCTBK
 Function   : This block contains room to hold translated
              guest CCWs and control information.
 Located by : IORCPA.
 Created by : HCPFTRAN.
 Deleted by : HCPFTRAN, HCPFUNTR, HCPFUNFR
 Notes      : FCTBKs are obtained by HCPFGST for non-V=R
              guests and HCPGETST for V=R guests.
              FCTBKs are released by HCPFRST whether or
              not they are for a V=R guest.

 

FCTBK Control Block Content


FCTBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      FCTBK          Fast CCW Translation BlocK
0000    0 Signed       4 FCTWORKA (44)  Room for CCWS and Parms
     Fixed trailer fields for (E)CKD and FBA.
00B0  176 Bitstring   72 FCTTRLR (0)    Fixed information
     FBA Only trailer fields -
00B0  176 Signed       4 FCTSEXT        Starting Record
00B4  180 Signed       4 FCTLOCF        First host block # from most
                                        recent LOCATE
00B8  184 Signed       4 FCTLOCL        Last host block # from most
                                        recent LOCATE
     (E)CKD Only trailer fields -
00B0  176 Signed       4 FCTEOTR        End of track
00B4  180 Signed       4 *              Reserved
00B8  184 Signed       4 *              Reserved
     Common (E)CKD and FBA trailer fields -
00BC  188 Signed       4 FCTEOGCP       End of guest channel program
00C0  192 Signed       4 FCTEOHCP       End of host channel program
00C4  196 Address      4 FCTGCPA        Start of guest CCWs
00C8  200 Character   44 FCTCLEAR (0)   Area that must be cleared
00C8  200 Signed       4 FCTFLB64       Queue of 64 bit TLBs
00CC  204 Signed       4 FCTTCHBK       Address of TCHBK
00D0  208 Signed       4 FCTLAST        Last FCTBK queued or addr of this
                                        FCTBK if no additional FCTBKs
                                        queued
00D4  212 Address      4 FCTTICAN       TIC anchor
00D8  216 Signed       4 FCTUTRAN       Untrans Entry anchor
00DC  220 Signed       4 FCTTLBNX       Addr of next TLB entry
00E0  224 Signed       4 FCTTLBGA       TLB entry Guest address
00E4  228 Signed       4 FCTTLBHA       TLB entry host address
     Redefinition of LOCF as used by HCPFTR
00B4  180 Signed       4 FCTBLKAP       Blocks per "cylinder"
     Redefinition of TLB area for Full Track Caching
00DC  220 Signed       2 FCTBKSZ (0)    ECKD block size
00DC  220 Signed       2 FCTRDSZ        Size of read
00DE  222 Signed       2 FCTHH          Head of seek arg
00E0  224 Signed       2 FCTTCKEY (0)   MDC device ID
     FCTNCE is used to turn on the high order byte of FCTTCKEY. When
     FCTTCKEY is negative or zero, caching is bypassed.
00E0  224 Bitstring    1 FCTMDCFL       1st byte of FCTTCKEY
          1... ....      FCTNCE         X'80' Not eligible for MDC
00E1  225 Bitstring    1 *              2nd byte of FCTTCKEY
00E2  226 Signed       2 FCTTPCYL       Tracks per cylinder
00E4  228 Signed       2 FCTDL          Current record's length
00E6  230 Signed       2 FCTRESID       Residual count
00E8  232 Bitstring    1 FCTFLAG
          1... ....      FCTFMT1        X'80' Using format 1 CCWs
          1... ....      FCTPCI         X'80' Redefined for FTS: PCI
                                        encountered in CP
          .1.. ....      FCTOVRFL       X'40' We have overflowed
          ..1. ....      FCTNOSEK       X'20' No seeks allowed
          ...1 ....      FCTSEEKD       X'10' Seek or locate done
          .... 1...      FCTWRITE       X'08' CP has a write CCW
          .... .1..      FCTREAD        X'04' CP has a "read" CCW
          .... .1..      FCTBADLN       X'04' Redefined for FTS: Bad
                                        length on last CCW
          .... ..1.      FCTMULTI       X'02' Multitrack CCW
          .... ...1      FCTMSEEK       X'01' Multiple seeks
00E9  233 Bitstring    1 FCTSTYPE       Guest storage mode and
                                        miscellaneous bits
          1... ....      FCTVV          X'80' V=V guest
          .1.. ....      FCTPASS2       X'40' HCPFTR is in PASS 2
          ..1. ....      FCTSPLIT       X'20' Used by FUN when it gets
                                        split status to avoid puging MDC
                                        if ok
          ...1 ....      FCTF2IDA       X'10' Guest using Fmt-2 IDAWs
00EA  234 Bitstring    2 FCTHCC         Host cylinder address
00EC  236 Signed       4 FCTVCCHH       Virtual track address
00F0  240 Signed       4 FCTNEXT        Address of next FCTBK
00F4  244 Signed       4 FCTFLEYE (0)   Word to define flag plus the
                                        eyecatcher
00F4  244 Bitstring    1 FCTFLAG2       Second flag byte
          1... ....      FCTFBA         X'80' This is an FBA program
          .1.. ....      FCTDX          X'40' DX or SFM has been done
          ..1. ....      FCTR0          X'20' Oriented to Record zero
          ...1 ....      FCTDED         X'10' Dedicated device
          .... 1...      FCTDIDIO       X'08' I/O was done during MDC
                                        simulation
          .... .1..      FCTDCHN        X'04' This CCW is data chained
          .... ..1.      FCTCKDCN       X'02' CKD conversion mode
          .... ...1      FCTREGDF       X'01' Regular data format mode
00F5  245 Character    3 FCTEYE         Eye catcher 'FCT'
          000000F8       FCTEND         *
          000000F8       FCTBSIZE       *-FCTBK Size in bytes
          0000001F       FCTBKDWS       (((*-FCTBK)+7)/8) Size in
                                        doublewords
          0000001D       FCTBKFSZ       FCTBKDWS-2 Size minus trailer

 

FCTBK Storage Layout

          
*** FCTBK - Fast CCW Translation BlocK
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       FCTWORKA                        =
*     |                                                       |
*     +---------------------------+---------------------------+
*  B0 |         FCTSEXT           |         FCTLOCF           |
*     +---------------------------+---------------------------+
*  B8 |         FCTLOCL           | BC
*     +---------------------------+
*
*** FCTBK - Fast CCW Translation BlocK
          
*** Overlay for FCTTRLR in FCTBK
*
*     +---------------------------+---------------------------+
*  B0 |         FCTEOTR           |///////////////////////////|
*     +---------------------------+---------------------------+
*  B8 |///////////////////////////|         FCTEOGCP          |
*     +---------------------------+---------------------------+
*  C0 |         FCTEOHCP          |         FCTGCPA           |
*     +---------------------------+---------------------------+
*  C8 |         FCTFLB64          |         FCTTCHBK          |
*     +---------------------------+---------------------------+
*  D0 |         FCTLAST           |         FCTTICAN          |
*     +---------------------------+---------------------------+
*  D8 |         FCTUTRAN          |         FCTTLBNX          |
*     +---------------------------+---------------------------+
*  E0 |         FCTTLBGA          |         FCTTLBHA          |
*     +---------------------------+---------------------------+
*  E8
*
*** Overlay for FCTTRLR in FCTBK
          
*** Overlay for FCTLOCF in FCTBK
*
*                                 +---------------------------+
*  B0 ...                      B4 |         FCTBLKAP          |
*                                 +---------------------------+
*  B8
*
*** Overlay for FCTLOCF in FCTBK
          
*** Overlay for FCTTLBNX in FCTBK
*
*                                 +-------------+-------------+
*  D8 ...                      DC |  FCTRDSZ    |   FCTHH     |
*     +------+------+-------------+-------------+-------------+
*  E0 |:MDCFL|//////|  FCTTPCYL   |   FCTDL     |  FCTRESID   |
*     +------+------+-------------+-------------+-------------+
*  E8 |:FLAG |:STYPE|   FCTHCC    |         FCTVCCHH          |
*     +------+------+-------------+------+--------------------+
*  F0 |         FCTNEXT           |:FLAG2|      FCTEYE        |
*     +---------------------------+------+--------------------+
*  F8
*
*** Overlay for FCTTLBNX in FCTBK

 

FCTBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
FCTBADLN       00E8 04
FCTBKDWS       00F5 0000001F
FCTBKFSZ       00F5 0000001D
FCTBKSZ        00DC
FCTBLKAP       00B4
FCTBSIZE       00F5 000000F8
FCTCKDCN       00F4 02
FCTCLEAR       00C8
FCTDCHN        00F4 04
FCTDED         00F4 10
FCTDIDIO       00F4 08
FCTDL          00E4
FCTDX          00F4 40
FCTEND         00F5 000000F8
FCTEOGCP       00BC
FCTEOHCP       00C0
FCTEOTR        00B0
FCTEYE         00F5
FCTFBA         00F4 80
FCTFLAG        00E8
FCTFLAG2       00F4
FCTFLB64       00C8
FCTFLEYE       00F4
FCTFMT1        00E8 80
FCTF2IDA       00E9 10
FCTGCPA        00C4
FCTHCC         00EA
FCTHH          00DE
FCTLAST        00D0
FCTLOCF        00B4
FCTLOCL        00B8
FCTMDCFL       00E0
FCTMSEEK       00E8 01
FCTMULTI       00E8 02
FCTNCE         00E0 80
FCTNEXT        00F0
FCTNOSEK       00E8 20
FCTOVRFL       00E8 40
FCTPASS2       00E9 40
FCTPCI         00E8 80
FCTRDSZ        00DC
FCTREAD        00E8 04
FCTREGDF       00F4 01
FCTRESID       00E6
FCTR0          00F4 20
FCTSEEKD       00E8 10
FCTSEXT        00B0
FCTSPLIT       00E9 20
FCTSTYPE       00E9
FCTTCHBK       00CC
FCTTCKEY       00E0
FCTTICAN       00D4
FCTTLBGA       00E0
FCTTLBHA       00E4
FCTTLBNX       00DC
FCTTPCYL       00E2
FCTTRLR        00B0
FCTUTRAN       00D8
FCTVCCHH       00EC
FCTVV          00E9 80
FCTWORKA       0000
FCTWRITE       00E8 08

This information is based on z/VM V4R2.0. Last updated on 17 Oct 2001 at 15:13:06 EDT.
Copyright IBM Corporation, 1990, 2001