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