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