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