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

CTRBK

Prolog  

Control Block Contents  
   CTRBK DSECT

Storage Layout  

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

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