CRWBK Back to Index page
 
Prolog 
Control Block Contents 
   CRWBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  CRWBK Prolog Top of page
 
 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 Top of page
 

 CRWBK DSECT Top of page
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 Top of page
 
          
*** 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 Top of page
 
 
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 7.2.0 Last updated on 24 Jun 2020 at 09:27:29 EDT.
Copyright IBM Corporation, 1990, 2020