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

 

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' 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' OVERFLOW - ONE OR MORE
                                        SUBSEQUENT CHANNEL REPORT WORDS
                                        HAVE BEEN LOST.
          ...1 ....      CRWCHAIN       X'10' 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' REPORTING SOURCE CODE (RSC)
                                        MASK
          .... ..1.      CRWMONIT       X'02' SOURCE = CHANNEL MONITORING
                                        FACILITY
          .... ..11      CRWSUBCH       X'03' SOURCE = SUBCHANNEL. THE
                                        SUBCHANNEL NUMBER IS SPECIFIED IN
                                        THE REPORTING SOURCE ID.
          .... .1..      CRWCHPID       X'04' SOURCE = CHANNEL PATH. THE
                                        CHANNEL PATH IDENTIFIER IS
                                        SPECIFIED IN THE REPORTING SOURCE
                                        ID.
          .... 1..1      CRWCAF         X'09' SOURCE = CONFIGURATION
                                        ALERT TEMPORARY ERROR. THE
                                        FAILING CHANNEL PATH IS SPECIFIED
                                        IN THE IN THE REPORTING SOURCE
                                        ID.
          .... 1.11      CRWCSS         X'0B' SOURCE = CHANNEL SUBSYSTEM.
0001    1 Bitstring    1 CRWEFLD        CRW Error Recovery Information
          00000000       CRWCHPIP       X'00' Channel Path Information
                                        Pending
          00000080       CRWAR          X'80' Ancillary Report Indicator
          0000003F       CRWERCMK       X'3F' Mask for location of ERC
                                        Field
          00000001       CRWAVAIL       X'01' 000001 - ERC = Available
          00000002       CRWINIT        X'02' 000010 - ERC = Initialized,
                                        Parameters not Changed
          00000003       CRWTEMP        X'03' 000011 - ERC = Temporary
                                        Error
          00000004       CRWALERT       X'04' 000100 - ERC = installed,
                                        Parameters Initialized. The
                                        device valid BIT AND ANY OTHER
                                        FIELD within the subchannel may
                                        be changed.
          00000005       CRWTERM        X'05' 000101 - ERC = Terminal
          00000006       CRWPERM        X'06' 000110 - ERC = Permanent
                                        Error not Initialized
          00000007       CRWPERMI       X'07' 000111 - ERC = Permanent,
                                        Initialized
          00000008       CRWIPM         X'08' 001000 - ERC = Installed
                                        Parameters Modified. The PIM
                                        and/or PAM and/or CHPIDS may be
                                        changed.
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

 

CRWBK Storage Layout

          
*** CRWBK - CHANNEL REPORT WORD BLOCK
*
*     +------+------+-------------+---------------------------+
*   0 |:FLAGS|:EFLD |  CRWRSID    |         CRWNEXT           |
*     +------+------+-------------+---------------------------+
*   8 |         CRWRDEV           |///////////////////////////|
*     +---------------------------+---------------------------+
*  10
*
*** CRWBK - CHANNEL REPORT WORD BLOCK

 

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
CRWCSS         0000 0B
CRWEFLD        0001
CRWERCMK       0001 0000003F
CRWFLAGS       0000
CRWINIT        0001 00000002
CRWIPM         0001 00000008
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
CRWSUBCH       0000 03
CRWTEMP        0001 00000003
CRWTERM        0001 00000005
CRWWORD        0000

This information is based on z/VM V5R1.0. Last updated on 8 Sep 2004 at 13:11:38 EDT.
Copyright IBM Corporation, 1990, 2004