CRWBK - 32-bit CP - V4R4.0

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 V4R4.0. Last updated on 29 Jul 2003 at 15:21:45 EDT.
Copyright IBM Corporation, 1990, 2003