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 : IORHLCPA.
     Created by : HCPCTNTR.
     Deleted by : HCPCTNTR, HCPCTUUN
     Notes      : CTRBKs are obtained by HCPFGST
                  CTRBKs are released by HCPFRST

#### 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 (50)  Room for CCWS and Parms
           Fixed trailer fields
    00C8  200 Bitstring   64 CTRTRLR (0)    Fixed information
    00C8  200 Signed       4 *              Reserved for IBM use
    00CC  204 Signed       4 CTREHLCP       Host Logical end of channel
                                            program
    00D0  208 Signed       4 CTREOGCP       End of guest channel program
                                            (guest absolute)
    00D4  212 Signed       4 CTREOHCP       Host absolute end of channel
                                            program
    00D8  216 Address      4 CTRGCPA        Start of guest CCWs (guest
                                            absolute address)
    00DC  220 Character   44 CTRCLEAR (0)   Area that must be cleared
    00DC  220 Signed       4 CTRSUSPA       Address where a suspend CCW was
                                            encountered (host logical)
    00E0  224 Signed       4 CTRLAST        Last CTRBK queued or addr of this
                                            CTRBK if no additional CTRBKs
                                            queued
    00E4  228 Signed       4 CTRTLB64       Anchor 64 bit TLB entrys
    00E8  232 Address      4 CTRTICAN       TIC anchor
    00EC  236 Signed       4 *              Reserved for IBM use
    00F0  240 Signed       4 *              Reserved for IBM use
    00F4  244 Signed       4 *              Reserved for IBM use
    00F8  248 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
    00F9  249 Bitstring    1 CTRSTYPE       Guest storage mode and
                                            miscellaneous bits
              .1.. ....      CTRPASS2       X'40' HCPFTR is in PASS 2
    00FA  250 Bitstring    2 *              Reserved for IBM use
    00FC  252 Signed       4 *              Reserved for IBM use
    0100  256 Signed       4 CTRNEXT        Address of next CTRBK
    0104  260 Signed       4 CTRFLEYE (0)   Word to define flag plus the
                                            eyecatcher
    0104  260 Bitstring    1 CTRFLAG2       Second flag byte
              1... ....      CTRDCHN        X'80' This CCW is data chained
    0105  261 Character    3 CTREYE         Eye catcher 'CTR'
              00000108       CTREND         *
              00000108       CTRBSIZE       *-CTRBK Size in bytes
              00000021       CTRBKDWS       (((*-CTRBK)+7)/8) Size in
                                            doublewords
              0000001F       CTRBKFSZ       CTRBKDWS-2 Size minus trailer

#### CTRBK Storage Layout

    *** CTRBK - Fast CCW Translation BlocK
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       CTRWORKA                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  C8 |///////////////////////////|         CTREHLCP          |
    *     +---------------------------+---------------------------+
    *  D0 |         CTREOGCP          |         CTREOHCP          |
    *     +---------------------------+---------------------------+
    *  D8 |         CTRGCPA           |         CTRSUSPA          |
    *     +---------------------------+---------------------------+
    *  E0 |         CTRLAST           |         CTRTLB64          |
    *     +---------------------------+---------------------------+
    *  E8 |         CTRTICAN          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  F0 |///////////////////////////|///////////////////////////|
    *     +------+------+-------------+---------------------------+
    *  F8 |:FLAG |:STYPE|/////////////|///////////////////////////|
    *     +------+------+-------------+------+--------------------+
    * 100 |         CTRNEXT           |:FLAG2|      CTREYE        |
    *     +---------------------------+------+--------------------+
    * 108
    *
    *** CTRBK - Fast CCW Translation BlocK

#### CTRBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    CTRBKDWS       0105 00000021
    CTRBKFSZ       0105 0000001F
    CTRBSIZE       0105 00000108
    CTRCLEAR       00DC
    CTRDCHN        0104 80
    CTREHLCP       00CC
    CTREND         0105 00000108
    CTREOGCP       00D0
    CTREOHCP       00D4
    CTREYE         0105
    CTRFLAG        00F8
    CTRFLAG2       0104
    CTRFLEYE       0104
    CTRFMT1        00F8 80
    CTRGCPA        00D8
    CTRIDAW2       00F8 20
    CTRIDA2K       00F8 10
    CTRLAST        00E0
    CTRNEXT        0100
    CTROVRFL       00F8 40
    CTRPASS2       00F9 40
    CTRSTYPE       00F9
    CTRSUSPA       00DC
    CTRTICAN       00E8
    CTRTLB64       00E4
    CTRTRLR        00C8
    CTRWORKA       0000

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 16:47:12 EDT.
Copyright IBM Corporation, 1990, 2005