Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CTRBK
Control Block Contents
CTRBK DSECT
Cross Reference (Contains links to field and bit definitions)
CTRBK Prolog
Name : HCPCTRBK Description: Fast CCW Translation BlocK DSECT : CTRBK Function : This block contains room to hold translated guest CCWs and control information. Located by : IORCPA. Created by : HCPCTNTR. Deleted by : HCPCTNTR, HCPCTUUN Notes : CTRBKs are obtained by HCPFGST for non-V=R guests and HCPGETST for V=R guests. CTRBKs are released by HCPFRST whether or not they are for a V=R guest.
CTRBK Control Block Content
CTRBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure CTRBK Fast CCW Translation BlocK 0000 0 Signed 4 CTRWORKA (46) Room for CCWS and Parms Fixed trailer fields 00B8 184 Bitstring 64 CTRTRLR (0) Fixed information 00B8 184 Signed 4 * Reserved for IBM use 00BC 188 Signed 4 * Reserved for IBM use 00C0 192 Signed 4 CTREOGCP End of guest channel program 00C4 196 Signed 4 CTREOHCP End of host channel program 00C8 200 Address 4 CTRGCPA Start of guest CCWs 00CC 204 Character 44 CTRCLEAR (0) Area that must be cleared 00CC 204 Signed 4 CTRSUSPA Address where a suspend CCW was encountered 00D0 208 Signed 4 CTRLAST Last CTRBK queued or addr of this CTRBK if no additional CTRBKs queued 00D4 212 Signed 4 CTRTLB64 Anchor 64 bit TLB entrys 00D8 216 Address 4 CTRTICAN TIC anchor 00DC 220 Signed 4 CTRTLBNX Addr of next TLB entry 00E0 224 Signed 4 CTRTLBGA TLB entry Guest address 00E4 228 Signed 4 CTRTLBHA TLB entry host address 00E8 232 Bitstring 1 CTRFLAG 1... .... CTRFMT1 X'80' Using format 1 CCWs .1.. .... CTROVRFL X'40' We have overflowed ..1. .... CTRIDAW2 X'20' Format-2 IDAWs used ...1 .... CTRIDA2K X'10' Format-2 2K IDAWs used 00E9 233 Bitstring 1 CTRSTYPE Guest storage mode and miscellaneous bits 1... .... CTRVV X'80' V=V guest (must be X'80') .1.. .... CTRPASS2 X'40' HCPFTR is in PASS 2 00EA 234 Bitstring 2 * Reserved for IBM use 00EC 236 Signed 4 * Reserved for IBM use 00F0 240 Signed 4 CTRNEXT Address of next CTRBK 00F4 244 Signed 4 CTRFLEYE (0) Word to define flag plus the eyecatcher 00F4 244 Bitstring 1 CTRFLAG2 Second flag byte 1... .... CTRDCHN X'80' This CCW is data chained 00F5 245 Character 3 CTREYE Eye catcher 'CTR' 000000F8 CTREND * 000000F8 CTRBSIZE *-CTRBK Size in bytes 0000001F CTRBKDWS (((*-CTRBK)+7)/8) Size in doublewords 0000001D CTRBKFSZ CTRBKDWS-2 Size minus trailer
CTRBK Storage Layout
*** CTRBK - Fast CCW Translation BlocK * * +-------------------------------------------------------+ * 0 | | * = CTRWORKA = * | | * +---------------------------+---------------------------+ * B8 |///////////////////////////|///////////////////////////| * +---------------------------+---------------------------+ * C0 | CTREOGCP | CTREOHCP | * +---------------------------+---------------------------+ * C8 | CTRGCPA | CTRSUSPA | * +---------------------------+---------------------------+ * D0 | CTRLAST | CTRTLB64 | * +---------------------------+---------------------------+ * D8 | CTRTICAN | CTRTLBNX | * +---------------------------+---------------------------+ * E0 | CTRTLBGA | CTRTLBHA | * +------+------+-------------+---------------------------+ * E8 |:FLAG |:STYPE|/////////////|///////////////////////////| * +------+------+-------------+------+--------------------+ * F0 | CTRNEXT |:FLAG2| CTREYE | * +---------------------------+------+--------------------+ * F8 * *** CTRBK - Fast CCW Translation BlocK
CTRBK Cross Reference
Symbol Dspl Value -------------- ---- ----- CTRBKDWS 00F5 0000001F CTRBKFSZ 00F5 0000001D CTRBSIZE 00F5 000000F8 CTRCLEAR 00CC CTRDCHN 00F4 80 CTREND 00F5 000000F8 CTREOGCP 00C0 CTREOHCP 00C4 CTREYE 00F5 CTRFLAG 00E8 CTRFLAG2 00F4 CTRFLEYE 00F4 CTRFMT1 00E8 80 CTRGCPA 00C8 CTRIDAW2 00E8 20 CTRIDA2K 00E8 10 CTRLAST 00D0 CTRNEXT 00F0 CTROVRFL 00E8 40 CTRPASS2 00E9 40 CTRSTYPE 00E9 CTRSUSPA 00CC CTRTICAN 00D8 CTRTLBGA 00E0 CTRTLBHA 00E4 CTRTLBNX 00DC CTRTLB64 00D4 CTRTRLR 00B8 CTRVV 00E9 80 CTRWORKA 0000
Copyright IBM Corporation, 1990, 2001