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
 RELOCATION CONSIDERATIONS : None
 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' CTRFMT1 Using format 1 CCWs
          .1.. ....      CTROVRFL       X'40' CTROVRFL We have overflowed
          ..1. ....      CTRIDAW2       X'20' CTRIDAW2 Format-2 IDAWs
                                        used
          ...1 ....      CTRIDA2K       X'10' CTRIDA2K Format-2 2K IDAWs
                                        used
00F9  249 Bitstring    1 CTRSTYPE       Guest storage mode and
                                        miscellaneous bits
          .1.. ....      CTRPASS2       X'40' CTRPASS2 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' CTRDCHN 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 V6R2.0. Last updated on 21 Nov 2011 at 10:57:03 EDT.
Copyright IBM Corporation, 1990, 2011