RCWBK - 64-bit CP - V4R4.0

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

#### RCWBK

Prolog

Control Block Contents
RCWBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### RCWBK Prolog

     NAME       : HCPRCWBK
     DESCRIPTION: CURRENT REAL CHANNEL CONTROL WORDS
     DSECT      : RCWBK
     FUNCTION   : THIS CONTROL BLOCK IS USED AS A REAL CHANNEL WORK AREA.
                  IT CONTAINS CHANNEL PROGRAMS FOR I/O TO VARIOUS DEVICES.
     LOCATED BY : CPTRCWCH  FIELD OF HCPCPTCA
                  CPTRCWBK  FIELD OF HCPCPTCA
                  IORTASK   FIELD OF HCPIORBK
                  MNDARCW   FIELD OF HCPMNDCO  (MONITOR TAPE)
                  RCWPNT    CHAINED
                  VCTXRCW   FIELD OF HCPVCTCA  (X-SIDE)
                  VCTYRCW   FIELD OF HCPVCTCA  (Y-SIDE)
                  VDSRCW    FIELD OF HCPVDSBK  (CURRENT)
     CREATED BY : HCPCCWTR - DURING INITIALIZATION OF CHANNEL PROGRAM
                  TRANSLATION FUNCTION.
                  HCPINSCW - WHILE CREATING CHAINS OF RCWBKS WHEN
                  MANIPULATING GUEST CHANNEL PROGRAMS.
                  HCPINSTC - WHILE CREATING CHAINS OF RCWBKS WHEN
                  MANIPULATING GUEST CHANNEL PROGRAMS.
                  HCPDGDDK - FOR SIMULATION OF DIAGNOSE X'18'.
                  HCPGRSBR - BUILDS RCWBK FOR I/O TO DISPLAY DEVICES.
                  HCPTDKRL - AFTER RELEASING T-DISK SPACE TO POOL OF FREE SPACE
     DELETED BY : HCPDGDDK - FOR SIMULATION OF DIAGNOSE X'18'.
                  HCPGFSTO - TO INITIATE I/O FOR FULL SCREEN VIRTUAL MACHINE.
                  HCPGRFIC - FOR DISPLAY DEVICE I/O REQUEST.
                  HCPGRSCO - ON A FATAL I/O ERROR ON READ OF DISPLAY BUFFER.
                  HCPTDKRL - BEFORE RELEASING T-DISK SPACE TO POOL OF FREE
                  SPACE.
                  HCPUNTFR - WHILE UNLOCKING PAGES ASSOCIATED WITH A COMPLETED
                  I/O OPERATION AND RETURNING CCW CHAIN(S) TO FREE
                  STORAGE.

#### RCWBK Control Block Content

#### RCWBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      RCWBK          CURRENT REAL CHANNEL CONTROL
                                            WORDS
    0000    0 Signed       4 RCWPNT         POINTER TO NEXT RCWBK
    0004    4 Signed       4 RCWVCAW        VIRTUAL ADDRESS OF CCW CHAIN
    0008    8 Bitstring    8 RCWCTL (0)     CONTROL FLAGS FOR EACH CCW
              1... ....      RCWPFIX        X'80' I/O DATA PAGE LOCKED
              .1.. ....      RCWGEN         X'40' CP GENERATED CCW
              ..1. ....      RCWGDCP        X'20' GUEST DATA IN CP STORAGE
              ...1 ....      RCWREDR        X'10' REDRIVE REQUIRED
              .... 1...      RCWUNTRL       X'08' UNTRANSLATION REQUIRED
              .... .1..      RCWDATCH       X'04' CCW WAS REACHED VIA DATA
                                            CHAINING
              .... ..1.      RCWINVL        X'02' CCW OP CODE OR ADDRESS IS
                                            INVALID
              .... ...1      RCWSUSP        X'01' CCW had suspend on before
                                            modification
    0008    8 Bitstring    1 RCWCTL1        CONTROL FLAGS FOR CCW1
    0009    9 Bitstring    1 RCWCTL2        CONTROL FLAGS FOR CCW2
    000A   10 Bitstring    1 RCWCTL3        CONTROL FLAGS FOR CCW3
    000B   11 Bitstring    1 RCWCTL4        CONTROL FLAGS FOR CCW4
    000C   12 Bitstring    1 RCWCTL5        CONTROL FLAGS FOR CCW5
    000D   13 Bitstring    1 RCWCTL6        CONTROL FLAGS FOR CCW6
    000E   14 Bitstring    1 RCWCTL7        CONTROL FLAGS FOR CCW7
    000F   15 Bitstring    1 RCWCTL8        CONTROL FLAGS FOR CCW8
              00000010       RCWHEADL       (*-RCWBK) SIZE OF RCWBK "HEADER"
    0010   16 Dbl-Word     8 RCWCCW (0)     1 TO 8 CHANNEL COMMAND WORDS
    0010   16 Dbl-Word     8 RCWCCW1        CHANNEL COMMAND WORD 1
    0018   24 Dbl-Word     8 RCWCCW2        CHANNEL COMMAND WORD 2
    0020   32 Dbl-Word     8 RCWCCW3        CHANNEL COMMAND WORD 3
    0028   40 Dbl-Word     8 RCWCCW4        CHANNEL COMMAND WORD 4
    0030   48 Dbl-Word     8 RCWCCW5        CHANNEL COMMAND WORD 5
    0038   56 Dbl-Word     8 RCWCCW6        CHANNEL COMMAND WORD 6
    0040   64 Dbl-Word     8 RCWCCW7        CHANNEL COMMAND WORD 7
    0048   72 Dbl-Word     8 RCWCCW8        CHANNEL COMMAND WORD 8
    0050   80 Dbl-Word     8 RCWCPTIC       CP TIC (IF NEEDED AND NONE PRIOR)
    0058   88 Dbl-Word     8 RCWDATA (3)    RELOCATED DATA AREA
    0070  112 Bitstring    1 RCWBYTE5 (8)   BYTE 5 OF EACH DIAG 58 CCW IN
                                            RCWBK
    0078  120 Bitstring    8 RCWCTLA (0)    Control Flags For Each CCW
              1... ....      RCWSPBUF       X'80' Special buffer handling
    0078  120 Bitstring    1 RCWCTL1A       Control Flags For CCW1
    0079  121 Bitstring    1 RCWCTL2A       Control Flags For CCW2
    007A  122 Bitstring    1 RCWCTL3A       Control Flags For CCW3
    007B  123 Bitstring    1 RCWCTL4A       Control Flags For CCW4
    007C  124 Bitstring    1 RCWCTL5A       Control Flags For CCW5
    007D  125 Bitstring    1 RCWCTL6A       Control Flags For CCW6
    007E  126 Bitstring    1 RCWCTL7A       Control Flags For CCW7
    007F  127 Bitstring    1 RCWCTL8A       Control Flags For CCW8
              00000080       RCWSIZBY       *-RCWBK Size in bytes
              00000010       RCWSIZE        (*-RCWBK+7)/8 RCWBK SIZE IN
                                            DOUBLE WORDS
    0058   88 Dbl-Word     8 RCWDATA1       DATA AREA TO HOLD A RELOCATED
                                            ARGUMENT
    0060   96 Dbl-Word     8 RCWDATA2       DATA AREA TO HOLD A RELOCATED
                                            ARGUMENT
    0068  104 Dbl-Word     8 RCWDATA3       DATA AREA TO HOLD A RELOCATED
                                            ARGUMENT
    0058   88 Dbl-Word     8 RCWSEEK        POSSIBLE SEEK ARGUMENT OR NULL
    0058   88 Bitstring   16 RCWDXARG (0)   Define extent argument
    0058   88 Bitstring    1 RCWDXFM        Extent file mask
    0059   89 Bitstring    1 RCWDXGA        Extent global attributes
    005A   90 Signed       2 RCWDXBLK       Extent maximum blocksize
    005C   92 Signed       4 RCWDXRSV       Reserved - must be zero
    0060   96 Signed       4 RCWDXBEG (0)   Extent start - CCHH
    0060   96 Signed       2 RCWDXBCC       Extent start CC
    0062   98 Signed       2 RCWDXBHH       Extent start HH
    0064  100 Signed       4 RCWDXEND (0)   Extent end - CCHH
    0064  100 Signed       2 RCWDXECC       Extent end CC
    0066  102 Signed       2 RCWDXEHH       Extent end HH
              .... 111.      RCWDXMXH       14 Extent default maximum valid
                                            HH value
    0068  104 Character    5 RCWSRCH        DATA FOR SEARCH-ID-EQ CCW
    0068  104 Character    2 RCWSRCC        CC (cylinder) of search arg
    006A  106 Character    3 RCWSRHHR (0)   HHR (head and record)
    006A  106 Character    2 RCWSRHH        HH (head) of search argument
    006C  108 Character    1 RCWSRCHR       R (record) of search argument
    0058   88 Character    2 *
    005A   90 Character    2 RCWSEEK2       DASD ARM POSITION - CC OF BBCCHHR
    005C   92 Character    3 *              HHR
    005F   95 Character    1 RCWSEEK7       ARGUMENT OF SET SECTOR CCW
    0058   88 Character    4 RCWSEEKP       CYLINDER SPECIFICATION
    005C   92 Character    4 *
    0058   88 Signed       2 RCWSKBIN       SEEK BIN NUMBER
    005A   90 Signed       2 RCWSKCYL       SEEK CYLINDER NUMBER
    005C   92 Signed       2 RCWSKHED       SEEK HEAD NUMBER
    005E   94 Bitstring    1 RCWFMASK       FILE MASK FOR SET FILE MASK
                                            COMMAND
    005F   95 Bitstring    1 *
         THIS SECTION IS FOR TERMINAL HANDLING
    0030   48 Bitstring    1 RCW5WCC        LOC OF WRITE CONTROL CHARACTER
    0031   49 Bitstring    1 RCW5SBA        LOC OF START BUFFER ADDR ORDER
    0032   50 Character    6 *
    0058   88 Bitstring    1 RCWSWCC        LOC OF WRITE CONTROL CHARACTER
    0059   89 Character    7 *

#### RCWBK Storage Layout

    *** RCWBK - CURRENT REAL CHANNEL CONTROL WORDS
    *
    *     +---------------------------+---------------------------+
    *   0 |          RCWPNT           |         RCWVCAW           |
    *     +------+------+------+------+------+------+------+------+
    *   8 |:CTL1 |:CTL2 |:CTL3 |:CTL4 |:CTL5 |:CTL6 |:CTL7 |:CTL8 |
    *     +------+------+------+------+------+------+------+------+
    *  10 |                       RCWCCW1                         |
    *     +-------------------------------------------------------+
    *  18 |                       RCWCCW2                         |
    *     +-------------------------------------------------------+
    *  20 |                       RCWCCW3                         |
    *     +-------------------------------------------------------+
    *  28 |                       RCWCCW4                         |
    *     +-------------------------------------------------------+
    *  30 |                       RCWCCW5                         |
    *     +-------------------------------------------------------+
    *  38 |                       RCWCCW6                         |
    *     +-------------------------------------------------------+
    *  40 |                       RCWCCW7                         |
    *     +-------------------------------------------------------+
    *  48 |                       RCWCCW8                         |
    *     +-------------------------------------------------------+
    *  50 |                       RCWCPTIC                        |
    *     +-------------------------------------------------------+
    *  58 |                                                       |
    *     =                       RCWDATA                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  70 |                       RCWBYTE5                        |
    *     +------+------+------+------+------+------+------+------+
    *  78 |:CTL1A|:CTL2A|:CTL3A|:CTL4A|:CTL5A|:CTL6A|:CTL7A|:CTL8A|
    *     +------+------+------+------+------+------+------+------+
    *  80
    *
    *** RCWBK - CURRENT REAL CHANNEL CONTROL WORDS

    *** Overlay for RCWDATA in RCWBK
    *
    *     +-------------------------------------------------------+
    *  58 |                       RCWDATA1                        |
    *     +-------------------------------------------------------+
    *  60 |                       RCWDATA2                        |
    *     +-------------------------------------------------------+
    *  68 |                       RCWDATA3                        |
    *     +-------------------------------------------------------+
    *  70
    *
    *** Overlay for RCWDATA in RCWBK

    *** Overlay for RCWDATA in RCWBK
    *
    *     +-------------------------------------------------------+
    *  58 |                       RCWSEEK                         |
    *     +-------------------------------------------------------+
    *  60
    *
    *** Overlay for RCWDATA in RCWBK

    *** Overlay for RCWSEEK in RCWBK
    *
    *     +------+------+-------------+---------------------------+
    *  58 |:DXFM |:DXGA |  RCWDXBLK   |         RCWDXRSV          |
    *     +------+------+-------------+-------------+-------------+
    *  60 |  RCWDXBCC   |  RCWDXBHH   |  RCWDXECC   |  RCWDXEHH   |
    *     +-------------+-------------+------+------+-------------+
    *  68 |             RCWSRCH              | 6D
    *     +----------------------------------+
    *
    *** Overlay for RCWSEEK in RCWBK

    *** Overlay for RCWSRCH in RCWBK
    *
    *     +-------------+-------------+------+
    *  68 |  RCWSRCC    |  RCWSRHH    |:SRCHR| 6D
    *     +-------------+-------------+------+
    *
    *** Overlay for RCWSRCH in RCWBK

    *** Overlay for RCWSEEK in RCWBK
    *
    *     +-------------+-------------+--------------------+------+
    *  58 |/////////////|  RCWSEEK2   |////////////////////|:SEEK7|
    *     +-------------+-------------+--------------------+------+
    *  60
    *
    *** Overlay for RCWSEEK in RCWBK

    *** Overlay for RCWSEEK in RCWBK
    *
    *     +---------------------------+---------------------------+
    *  58 |         RCWSEEKP          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  60
    *
    *** Overlay for RCWSEEK in RCWBK

    *** Overlay for RCWSEEK in RCWBK
    *
    *     +-------------+-------------+-------------+------+------+
    *  58 |  RCWSKBIN   |  RCWSKCYL   |  RCWSKHED   |:FMASK|//////|
    *     +-------------+-------------+-------------+------+------+
    *  60
    *
    *** Overlay for RCWSEEK in RCWBK

    *** Overlay for RCWCCW5 in RCWBK
    *
    *     +------+------+-----------------------------------------+
    *  30 |:5WCC |:5SBA |/////////////////////////////////////////|
    *     +------+------+-----------------------------------------+
    *  38
    *
    *** Overlay for RCWCCW5 in RCWBK

    *** Overlay for RCWSEEK in RCWBK
    *
    *     +------+------------------------------------------------+
    *  58 |:SWCC |////////////////////////////////////////////////|
    *     +------+------------------------------------------------+
    *  60
    *
    *** Overlay for RCWSEEK in RCWBK

#### RCWBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    RCWBYTE5       0070
    RCWCCW         0010
    RCWCCW1        0010
    RCWCCW2        0018
    RCWCCW3        0020
    RCWCCW4        0028
    RCWCCW5        0030
    RCWCCW6        0038
    RCWCCW7        0040
    RCWCCW8        0048
    RCWCPTIC       0050
    RCWCTL         0008
    RCWCTLA        0078
    RCWCTL1        0008
    RCWCTL1A       0078
    RCWCTL2        0009
    RCWCTL2A       0079
    RCWCTL3        000A
    RCWCTL3A       007A
    RCWCTL4        000B
    RCWCTL4A       007B
    RCWCTL5        000C
    RCWCTL5A       007C
    RCWCTL6        000D
    RCWCTL6A       007D
    RCWCTL7        000E
    RCWCTL7A       007E
    RCWCTL8        000F
    RCWCTL8A       007F
    RCWDATA        0058
    RCWDATA1       0058
    RCWDATA2       0060
    RCWDATA3       0068
    RCWDATCH       0008 04
    RCWDXARG       0058
    RCWDXBCC       0060
    RCWDXBEG       0060
    RCWDXBHH       0062
    RCWDXBLK       005A
    RCWDXECC       0064
    RCWDXEHH       0066
    RCWDXEND       0064
    RCWDXFM        0058
    RCWDXGA        0059
    RCWDXMXH       0066 0E
    RCWDXRSV       005C
    RCWFMASK       005E
    RCWGDCP        0008 20
    RCWGEN         0008 40
    RCWHEADL       000F 00000010
    RCWINVL        0008 02
    RCWPFIX        0008 80
    RCWPNT         0000
    RCWREDR        0008 10
    RCWSEEK        0058
    RCWSEEKP       0058
    RCWSEEK2       005A
    RCWSEEK7       005F
    RCWSIZBY       007F 00000080
    RCWSIZE        007F 00000010
    RCWSKBIN       0058
    RCWSKCYL       005A
    RCWSKHED       005C
    RCWSPBUF       0078 80
    RCWSRCC        0068
    RCWSRCH        0068
    RCWSRCHR       006C
    RCWSRHH        006A
    RCWSRHHR       006A
    RCWSUSP        0008 01
    RCWSWCC        0058
    RCWUNTRL       0008 08
    RCWVCAW        0004
    RCW5SBA        0031
    RCW5WCC        0030

This information is based on z/VM V4R4.0. Last updated on 30 Jul 2003 at 13:08:38 EDT.
Copyright IBM Corporation, 1990, 2003