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' 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.
              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

#### 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
    CRWIPR         0001 0000000A
    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 V6R1.0. Last updated on 18 Feb 2010 at 08:30:59 EDT.
Copyright IBM Corporation, 1990, 2008