|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CRWBK
Control Block Contents
CRWBK DSECT
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
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
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. 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
*** 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
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
Copyright IBM Corporation, 1990, 2011