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

CRWBK

Prolog  

Control Block Contents  
   CRWBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


CRWBK Prolog

 NAME       : HCPCRWBK
 DESCRIPTION: CHANNEL REPORT WORD BLOCK
 DSECT      : CRWBK
 FUNCTION   : THE CRWBK IS A QUEUE ELEMENT ON THE QUEUE OF PENDING
              CHANNEL REPORT WORDS AWAITING PRESENTATION (VIA A
              MACHINE CHECK INTERRUPTION) TO THE VIRTUAL MACHINE.
 LOCATED BY : CHCIORW - ANCHOR OF QUEUE IN CHCBK
              MCVCRWS - ANCHOR OF QUEUE IN MCVBK
              CRWNEXT - FORWARD POINTER IN PRECEEDING QUEUE ELEMENT
 CREATED BY : HCPVDB - WHEN A DEVICE IS DEFINED FOR A VIRTUAL ESA
              MACHINE
              HCPVOF - DURING SIMULATION OF A RCHP INSTRUCTION
              HCPRFC - TO PASS ON A CRW FOR A DEDICATED DEVICE TO
              CONCERNED VIRTUAL MACHINE
 DELETED BY : HCPMCV - WHEN A VIRTUAL MACHINE IS RESET
              - WHEN THE CRW IS STORED IN THE VIRTUAL MACHINE
              DURING SIMULATION OF A MACHINE CHECK INTERRUPT
              HCPVOF - DURING SIMULATION OF A STCRW INSTRUCTION
 RELOCATION CONSIDERATIONS : This control block is relocated as part of a live
              guest relocation (LGR).  The bits and fields that
              need to be relocated are defined in the
              corresponding LGRCRWBK COPY file.  Whenever changes
              are made to this control block, consideration must
              be given to any effects these changes will have on
              a relocation.  If any new fields or bits are
              defined, they may need to be relocated.  If
              existing bits or fields are changed, corresponding
              modifications may be required in the LGR version of
              this control block.  Consider also the effects of
              these changes on a relocation involving a back-level
              release of CP.

 

CRWBK Control Block Content


CRWBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      CRWBK          CHANNEL REPORT WORD BLOCK
0000    0 Signed       4 CRWWORD (0)    CRW REPORT WORD CONTENTS
0000    0 Bitstring    1 CRWFLAGS       CHANNEL REPORT FLAGS AND CODES
          .1.. ....      CRWSOLIC       X'40' CRWSOLIC SOLICITED - FOR
                                        EXAMPLE, CHANNEL PATH INITIALIZED
                                        IN RESPONSE TO RCHP AS OPPOSED TO
                                        CHANNEL PATH INITIALIZED DUE TO
                                        LOSS-OF-POWER.
          ..1. ....      CRWOVER        X'20' CRWOVER OVERFLOW - ONE OR
                                        MORE SUBSEQUENT CHANNEL REPORT
                                        WORDS HAVE BEEN LOST.
          ...1 ....      CRWCHAIN       X'10' CRWCHAIN SUBSEQUENT CHANNEL
                                        REPORT WORD(S) REQUIRED TO
                                        DESCRIBE ONE EVENT. IF A CHAINED
                                        CHANNEL REPORT WORD IS LOST FROM
                                        OVERFLOW, ALL OF THE CHANNEL
                                        REPORT WORDS CHAINED TO THAT
                                        CHANNEL REPORT WORD ARE LOST AS
                                        WELL.
          .... 1111      CRWRSC         X'0F' CRWRSC REPORTING SOURCE
                                        CODE (RSC) MASK
          .... ..1.      CRWMONIT       X'02' CRWMONIT SOURCE = CHANNEL
                                        MONITORING FACILITY
          .... ..11      CRWSUBCH       X'03' CRWSUBCH SOURCE =
                                        SUBCHANNEL. THE SUBCHANNEL NUMBER
                                        IS SPECIFIED IN THE REPORTING
                                        SOURCE ID.
          .... .1..      CRWCHPID       X'04' CRWCHPID SOURCE = CHANNEL
                                        PATH. THE CHANNEL PATH IDENTIFIER
                                        IS SPECIFIED IN THE REPORTING
                                        SOURCE ID.
          .... 1..1      CRWCAF         X'09' CRWCAF SOURCE =
                                        CONFIGURATION ALERT TEMPORARY
                                        ERROR. THE FAILING CHANNEL PATH
                                        IS SPECIFIED IN THE IN THE
                                        REPORTING SOURCE ID.
          .... 1.11      CRWCSS         X'0B' CRWCSS SOURCE = CHANNEL
                                        SUBSYSTEM.
0001    1 Bitstring    1 CRWEFLD        CRW Error Recovery Information
          00000000       CRWCHPIP       X'00' CRWCHPIP Channel Path
                                        Information Pending
          00000080       CRWAR          X'80' CRWAR Ancillary Report
                                        Indicator
          0000003F       CRWERCMK       X'3F' CRWERCMK Mask for location
                                        of ERC Field
          00000001       CRWAVAIL       X'01' CRWAVAIL 000001 - ERC =
                                        Available
          00000002       CRWINIT        X'02' CRWINIT 000010 - ERC =
                                        Initialized, Parameters not
                                        Changed
          00000003       CRWTEMP        X'03' CRWTEMP 000011 - ERC =
                                        Temporary Error
          00000004       CRWALERT       X'04' CRWALERT 000100 - ERC =
                                        installed, Parameters
                                        Initialized. The device valid BIT
                                        AND ANY OTHER FIELD within the
                                        subchannel may be changed.
          00000005       CRWTERM        X'05' CRWTERM 000101 - ERC =
                                        Terminal
          00000006       CRWPERM        X'06' CRWPERM 000110 - ERC =
                                        Permanent Error not Initialized
          00000007       CRWPERMI       X'07' CRWPERMI 000111 - ERC =
                                        Permanent, Initialized
          00000008       CRWIPM         X'08' CRWIPM 001000 - ERC =
                                        Installed Parameters Modified.
                                        The PIM and/or PAM and/or CHPIDS
                                        may be changed.
          00000009       CRWISOL        X'09' CRWISOL 001001 - ERC =
                                        Configuration Isolated
          0000000A       CRWIPR         X'0A' CRWIPR 001010 - ERC =
                                        Installed Parameters Restored.
0002    2 Signed       2 CRWRSID        RESOURCE IDENTIFIER CODE
0004    4 Signed       4 CRWNEXT        NEXT CRW IF ANY
0008    8 Signed       4 CRWRDEV        ASSOCIATED RDEVBLOK IF ANY
000C   12 Signed       4 *              RESERVED FOR FUTURE IBM USE
          00000002       CRWSIZE        (*-CRWBK+7)/8 CRWBK SIZE IN
                                        DOUBLE WORDS
0002    2 Bitstring    1 CRWIID         MIF-image identifier (IID)
0003    3 Bitstring    1 CRWSSCSS       Subchannel Set/Channel Subsystem
                                        ID
          ..11 ....      CRWSSMSK       X'30' CRWSSMSK Mask for
                                        Subchannel set bits
          .... 1111      CRWCSMSK       X'0F' CRWCSMSK Mask for Channel
                                        Subsystem ID bits

 

CRWBK Storage Layout

          
*** CRWBK - CHANNEL REPORT WORD BLOCK
*
*     +------+------+-------------+---------------------------+
*   0 |:FLAGS|:EFLD |  CRWRSID    |         CRWNEXT           |
*     +------+------+-------------+---------------------------+
*   8 |         CRWRDEV           |///////////////////////////|
*     +---------------------------+---------------------------+
*  10
*
*** CRWBK - CHANNEL REPORT WORD BLOCK
          
*** Overlay for CRWRSID in CRWBK
*
*                   +------+------+
*   0 ...         2 |CRWIID|:SSCSS| 4
*                   +------+------+
*
*** Overlay for CRWRSID in CRWBK

 

CRWBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
CRWALERT       0001 00000004
CRWAR          0001 00000080
CRWAVAIL       0001 00000001
CRWCAF         0000 09
CRWCHAIN       0000 10
CRWCHPID       0000 04
CRWCHPIP       0001 00000000
CRWCSMSK       0003 0F
CRWCSS         0000 0B
CRWEFLD        0001
CRWERCMK       0001 0000003F
CRWFLAGS       0000
CRWIID         0002
CRWINIT        0001 00000002
CRWIPM         0001 00000008
CRWIPR         0001 0000000A
CRWISOL        0001 00000009
CRWMONIT       0000 02
CRWNEXT        0004
CRWOVER        0000 20
CRWPERM        0001 00000006
CRWPERMI       0001 00000007
CRWRDEV        0008
CRWRSC         0000 0F
CRWRSID        0002
CRWSIZE        000C 00000002
CRWSOLIC       0000 40
CRWSSCSS       0003
CRWSSMSK       0003 30
CRWSUBCH       0000 03
CRWTEMP        0001 00000003
CRWTERM        0001 00000005
CRWWORD        0000

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 10:56:36 EDT.
Copyright IBM Corporation, 1990, 2011