|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
FCTBK
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 (45) Room for CCWS and Parms The FBA extension to the fixed trailer begins here. For (E)CKD, the following 3 words are not part of the fixed trailer but are available to hold CCWS and stuff. 00B4 180 Signed 4 FCTTRFBA (0) FBA only trailer 00B4 180 Signed 4 FCTSEXT Starting Record 00B8 184 Signed 4 FCTLOCF First host block # from most recent LOCATE 00BC 188 Signed 4 FCTLOCL Last host block # from most recent LOCATE The fixed fields for (E)CKD and FBA follow: | 00C0 192 Bitstring 56 FCTTRLR (0) Fixed information 00C0 192 Signed 4 FCTEOGCP End of guest channel program 00C4 196 Signed 4 FCTEOHCP End of host channel program 00C8 200 Address 4 FCTGCPA Start of guest CCWs 00CC 204 Character 40 FCTCLEAR (0) Area that must be cleared 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 00B8 184 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 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 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 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 | * +---------------------------+---------------------------+ * B8 | FCTLOCF | FCTLOCL | * +---------------------------+---------------------------+ * C0 | FCTEOGCP | FCTEOHCP | * +---------------------------+---------------------------+ * C8 | FCTGCPA | FCTTCHBK | * +---------------------------+---------------------------+ * D0 | FCTLAST | FCTTICAN | * +---------------------------+---------------------------+ * D8 | FCTUTRAN | FCTTLBNX | * +---------------------------+---------------------------+ * E0 | FCTTLBGA | FCTTLBHA | * +---------------------------+---------------------------+ * E8 * *** FCTBK - Fast CCW Translation BlocK *** Overlay for FCTLOCF in FCTBK * * +---------------------------+ * B8 | FCTBLKAP | BC * +---------------------------+ * *** 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
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----FCTBKDWS 00F5 0000001F
FCTBKFSZ 00F5 0000001D
FCTBKSZ 00DC
FCTBLKAP 00B8
FCTBSIZE 00F5 000000F8
FCTCLEAR 00CC
FCTDL 00E4
FCTEND 00F5 000000F8
FCTEOGCP 00C0
FCTEOHCP 00C4
FCTEYE 00F5
FCTFLAG 00E8
FCTFLAG2 00F4
FCTFLEYE 00F4
FCTGCPA 00C8
FCTHCC 00EA
FCTHH 00DE
FCTLAST 00D0
FCTLOCF 00B8
FCTLOCL 00BC
FCTMDCFL 00E0
FCTNCE 00E0 80
FCTNEXT 00F0
FCTPASS2 00E9 40
FCTRDSZ 00DC
FCTRESID 00E6
FCTSEXT 00B4
FCTSPLIT 00E9 20
FCTSTYPE 00E9
FCTTCHBK 00CC
FCTTCKEY 00E0
FCTTICAN 00D4
FCTTLBGA 00E0
FCTTLBHA 00E4
FCTTLBNX 00DC
FCTTPCYL 00E2
FCTTRFBA 00B4
FCTTRLR 00C0
FCTUTRAN 00D8
FCTVCCHH 00EC
FCTVV 00E9 80
FCTWORKA 0000
Last updated on 3 Aug 1999 at 11:55:18 EDT.
Copyright IBM Corporation, 1990, 1999