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 V4R3.0. Last updated on 1 May 2002 at 08:40:46 EDT.
Copyright IBM Corporation, 1990, 2002