|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CRDREC
Control Block Contents
CRDREC DSECT
Cross Reference (Contains links to field and bit definitions)
CRDREC Prolog
NAME : CRDREC
DESCRIPTION: CHANNEL REPORT WORD ERROR RECORD
DSECT : CRDREC
FUNCTION : CRDREC PROVIDES STATISTICAL DATA FOR ERROR
RECOVERY AND/OR ERROR RECORDING RELATED TO
PREVIOUSLY PERFORMED CHANNEL OPERATION THAT
DID NOT SUCCESSFULLY COMPLETE.
LOCATED BY : GPR6 IN HCPRFC AND HCPIOE. THE ADDRESS
IS PASSED TO HCPREC IN GPR1.
CREATED BY : HCPRFC
DELETED BY : HCPIOE AFTER HCPREC HAS COPIED IT INTO
A GSDBK.
CRDREC Control Block Content
CRDREC DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure CRDREC CHANNEL REPORT WORD ERROR RECORD
THIS CONTROL BLOCK IS AN INTER-OPERATING-SYSTEM BLOCK
WHICH IS DEFINED BY IBM CORPORATE STANDARDS. THEREFORE
VM/ESA DOES NOT CONTROL THE DEFINITIONS NOR DOES IT
NECESSARILY USE ALL THE FIELDS DEFINED OR ALL THE BITS
DEFINED WITHIN A FIELD.
0000 0 Bitstring 1 CRDHTYPE CLASS/SOURCE
00000025 CRDHTYCR 37 CRDHTYCR CRW RECORD
0001 1 Bitstring 1 CRDHSYS SYSTEM/RELEASE LEVEL
111. .... HDRHSSYS X'E0' HDRHSSYS SYSTEM MASK
1... .... HDRHSOS2 X'80' HDRHSOS2 OS/VS2
.11. .... HDRHSVM X'60' HDRHSVM VM
.1.. .... HDRHSOS1 X'40' HDRHSOS1 OS/VS1
..1. .... HDRHSDOS X'20' HDRHSDOS DOS
...1 1111 HDRHSLVL X'1F' HDRHSLVL SYSTEM LEVEL MASK
(INCLUDES VERSION AND RELEASE
LEVEL)
...1 11.. HDRHSVRS X'1C' HDRHSVRS VERSION NUMBER
MASK
.... ..11 HDRHSREL X'03' HDRHSREL RELEASE LEVEL MASK
0002 2 Bitstring 1 CRDHSW0 RECORD INDEPENDENT SWITCHES
1... .... HDRHSWMR X'80' HDRHSWMR MORE RECORDS
FOLLOW
.1.. .... HDRHSWCI X'40' HDRHSWCI TOD CLOCK
INSTRUCTION ISSUED
..1. .... HDRHSWRT X'20' HDRHSWRT RECORD TRUNCATED
...1 .... HDRHSWPK X'10' HDRHSWPK 370/XA MODE
.... 1... HDRHSWTI X'08' HDRHSWTI TIME MACRO ISSUED
.... .1.. HDRHSWPS X'04' HDRHSWPS ERROR WAS PASSED
(REFLECTED) TO A GUEST
0003 3 Bitstring 1 CRDHSW1 RESERVED REC DEPENDENT SWITCH 1
0004 4 Bitstring 1 CRDHSW2 RESERVED REC DEPENDENT SWITCH 2
0005 5 Bitstring 1 CRDHSW3 RESERVED REC DEPENDENT SWITCH 3
0006 6 Bitstring 1 CRDHCNT RECORD COUNT
1111 .... HDRRCSEQ X'F0' HDRRCSEQ RECORD SEQUENCE
NUMBER MASK
.... 1111 HDRRCPHY X'0F' HDRRCPHY TOTAL NUM. OF
PHYSICAL RECORDS IN LOGICAL
RECORD BIT MASK
0007 7 Bitstring 1 * RESERVED FOR FUTURE IBM USE
0008 8 Dbl-Word 8 CRDHTOD TOD OF SYSTEM FAILURE
0010 16 Dbl-Word 8 CRDCPUID CPU ID
0018 24 Character 8 CRDMODUL CSECT NAME OF MODULE/USERID
0020 32 Bitstring 1 CRDRECCD CRW RECORD FORMAT CODE
00000001 CRDRECUC 1 CRDRECUC UCB DATA FORMAT RECORD
00000002 CRDRECMC 2 CRDRECMC MCIC FORMAT RECORD
0021 33 Bitstring 1 CRDFLAG1 FLAG BYTE 1
1... .... CRDF1HCC X'80' CRDF1HCC HARDWARE CREATED
CRW
.1.. .... CRDF1SCC X'40' CRDF1SCC SOFTWARE CREATED
CRW
.... ...1 CRDF1INV X'01' CRDF1INV INVALID CRW
RECORDING
0022 34 Bitstring 1 CRDFLAG2 FLAG BYTE 2
0023 35 Bitstring 1 CRDCODE CODE BYTE
00000001 CRDCOCPM 1 CRDCOCPM CRW PENDING MCH
00000002 CRDCOSDM 2 CRDCOSDM SYSTEM DAMAGE MCH
00000003 CRDCOACR 3 CRDCOACR ALTERNATE CPU RECOVERY
00000006 CRDCOIRC 6 CRDCOIRC HOT I/O RECOVER CHAN
PATH
00000007 CRDCOIRM 7 CRDCOIRM HOT I/O REMOVE CHAN
PATH
00000008 CRDCOVCP 8 CRDCOVCP VARY CHAN PATH - FORCE
0024 36 Signed 2 CRDCP PROCESSOR ADDRESS CRW RETRIEVED
0026 38 Signed 2 * RESERVED FOR FUTURE IBM USE
0028 40 Signed 4 CRDCRW CRW
002C 44 Bitstring 2 CRDDEV DEVICE NUMBER
002E 46 Bitstring 2 * RESERVED FOR FUTURE IBM USE
0030 48 Dbl-Word 8 CRDVDATA (0) START OF VARIABLE LENGTH DATA
0030 48 Signed 4 CRDSEQEN CRW SEQUENCE NUMBER
0034 52 Signed 4 CRDASEQ CRW ASSOCIATED SEQ NBR
0038 56 Bitstring 2 CRDDEVST UCB DEVICE STATUS FLAGS
003A 58 Bitstring 2 CRDPMCW PATH MANAGEMENT CONTROL WORD FROM
THE UCB
003C 60 Bitstring 1 CRDCHPCT CHANNEL PATH RECOVERY COUNT FROM
THE UCB
003D 61 Bitstring 1 CRDLEVEL UCB LEVEL VALUE
003E 62 Bitstring 4 CRDLVMSK UCB LEVEL BIT MASK
0042 66 Bitstring 2 * RESERVED FOR FUTURE IBM USE
0044 68 Signed 4 CRDSCHRC UCB SUBCHANNEL RECOVERY ANCHOR
0048 72 Bitstring 1 CRDCHPF CHANNEL PATH FLAGS
0049 73 Bitstring 1 CRDICHPT ICHPT FLAGS ASSOCIATED WITH THE
CRW CHANNEL PATH ID
004A 74 Bitstring 8 CRDISDT COPY OF THE IOSVISDT
00000052 CRDLENUC *-CRDREC LENGTH OF UCB FORMAT
CRDREC
0000000B CRDSIZUC (*-CRDREC+7)/8 UCB CRDREC SIZE IN
DBL WDS
0030 48 Bitstring 8 CRDMCIC MCIC, IF AVAILABLE
0038 56 Bitstring 1 CRDSTAT DEVICE OPERATION STATUS FLAG FROM
RDEV
1... .... RDEVALID X'80' RDEVALID VALID DEVICE
ASSOCIATED WITH SUBCH
.1.. .... RDEVEMUL X'40' RDEVEMUL DEVICE IS IN
EMULATION MODE
..1. .... RDEVBOX X'20' RDEVBOX BOXED DEVICE
...1 .... RDEVINRQ X'10' RDEVINRQ DEVICE
INTERVENTION REQUIRED WAIT
.... 1... RDEVLOFF X'08' RDEVLOFF OWNER IS IN LOGOFF
PROCESSING
.... .1.. RDEVEXOF X'04' RDEVEXOF OPERATOR VARIED
DEVICE OFFLINE
.... ..1. RDEVVPOF X'02' RDEVVPOF VARY PATH VARIED
THE DEVICE OFFLINE
.... ...1 RDEVSBSY X'01' RDEVSBSY Device is busy
with a system function
0039 57 Bitstring 1 CRDAFLG DEVICE ALLOCATION CONTROL FLAG
FROM RDEV
1... .... RDEVOFFL X'80' RDEVOFFL DEVICE IS OFFLINE
.1.. .... RDEVSYS X'40' RDEVSYS DEVICE ATTACHED TO
SYSTEM
..1. .... RDEVFREE X'20' RDEVFREE DEVICE IS NOT IN
USE
...1 .... RDEVCPVL X'10' RDEVCPVL CP VOLUME IS
ATTACHED (RDEVVOL)
.... 1... RDEVDED X'08' RDEVDED DEVICE ATTACHED TO
USER (RDEVUSER)
.... .1.. RDEVSPL X'04' RDEVSPL DEVICE FOR SPOOLING
(RDEVRSP)
.... ..1. RDEVMNT X'02' RDEVMNT VOLUME IS MOUNTED
BUT NOT ATTACHED
.... ...1 RDEVXVOL X'01' RDEVXVOL XVOLID SPECIFIED
FOR DASD OR TAPE
003A 58 Bitstring 1 CRDRFLG DEVICE ERROR RECOVERY CONTROL
FLAG FROM RDEV
1... .... RDEVSUDV X'80' RDEVSUDV Summary UC
received on this device
.1.. .... RDEVIRM X'40' RDEVIRM INTENSIVE RECORDING
MODE ACTIVE
..1. .... RDEVINTR X'20' RDEVINTR DEVICE IS
INTERVENTION REQUIRED
...1 .... RDEVRSET X'10' RDEVRSET DEVICE IS BEING
RESET
.... 1... RDEVSUDF X'08' RDEVSUDF Summary UC
recovery deferred for dev
.... .1.. RDEVRSVD X'04' RDEVRSVD DEVICE HAS BEEN
RESERVED
.... ..1. RDEVSUDQ X'02' RDEVSUDQ Summary UC proc
has applied UC status to a DQUNS
IORBK for this device
.... ...1 RDEVMIHM X'01' RDEVMIHM MISSING INTERRUPT
MESSAGE SENT
003B 59 Bitstring 1 * RESERVED FOR FUTURE IBM USE
003C 60 Bitstring 1 CRDIRCF INTERRUPT REQUEST CODE FROM SCHIB
..11 1... CSWIRC X'38' CSWIRC INTERRUPTION
SUBCLASS EXTRACT MASK
1... .... CSWQDIO X'80' CSWQDIO QDIO Facility (Q)
Available
.... .1.. CSWIOINC X'04' CSWIOINC I/O Initiation
Control bit
.... ..1. CSWHDVA X'02' CSWHDVA HALT DEVICE (HDV)
Assist Control bit
.... ...1 CSWABC X'01' CSWABC ALTERNATE BLOCK
CONTROL BIT
1... .... CSWPATH X'80' CSWPATH MODEL DEPENDENT
PATH FOR MSG SUBCHANL
..11 111. CSWMSV X'3E' CSWMSV MESSAGE SUBCHANNEL
VALID BITS
.1.. .... CSWMINS X'40' CSWMINS MESSAGE DEVICE MAY
BE INSTALLED
003D 61 Bitstring 1 CRDCTL CONTROL FLAGS FROM SCHIB
003E 62 Bitstring 2 * RESERVED FOR FUTURE IBM USE
0040 64 Bitstring 1 CRDLPM LOGICAL PATH MASK FROM SCHIB
0041 65 Bitstring 1 CRDPNOM PATH NOT OPERATIONAL MASK FROM
SCHIB
0042 66 Bitstring 1 CRDLPUM LAST PATH USED MASK FROM SCHIB
0043 67 Bitstring 1 CRDPIM PATH INVALID MASK FROM SCHIB
0044 68 Bitstring 2 * RESERVED FOR FUTURE IBM USE
0046 70 Bitstring 1 CRDPOM PATH OPERATIONAL MASK FROM SCHIB
0047 71 Bitstring 1 CRDPAM PATH AVAILABLE MASK FROM SCHIB
0048 72 Bitstring 8 CRDCHPID CHANNEL PATH IDS FROM SCHIB
00000050 CRDLENMC *-CRDREC LENGTH OF MCIC FORMAT
CRDREC
0000000A CRDSIZMC (*-CRDREC+7)/8 MCIC CRDREC SIZE
IN DBL WDS
0008 8 Signed 4 CRDHDATE SYSTEM DATE OF FAILURE
000C 12 Signed 4 CRDHTIME SYSTEM TIME OF FAILURE
0010 16 Bitstring 1 CRDHCPID MACHINE VERSION CODE
0011 17 Bitstring 3 CRDHSER CPU SERIAL NUMBER
0014 20 Bitstring 2 CRDHMDL CPU MACHINE MODEL NUMBER
0016 22 Bitstring 2 CRDHMCEL RESERVED FOR FUTURE IBM USE
0030 48 Bitstring 1 CRDMCIC0 COPY OF MCIC BYTE 0.
0031 49 Bitstring 1 CRDMCIC1 COPY OF MCIC BYTE 1.
0032 50 Bitstring 1 CRDMCIC2 COPY OF MCIC BYTE 2.
0033 51 Bitstring 1 CRDMCIC3 COPY OF MCIC BYTE 3.
0034 52 Bitstring 1 CRDMCIC4 COPY OF MCIC BYTE 4.
0035 53 Bitstring 1 CRDMCIC5 COPY OF MCIC BYTE 5.
0036 54 Bitstring 1 CRDMCIC6 COPY OF MCIC BYTE 6.
0037 55 Bitstring 1 CRDMCIC7 COPY OF MCIC BYTE 7.
CRDREC Storage Layout
*** CRDREC - CHANNEL REPORT WORD ERROR RECORD
*
* +------+------+------+------+------+------+------+------+
* 0 |:HTYPE|:HSYS |:HSW0 |:HSW1 |:HSW2 |:HSW3 |:HCNT |//////|
* +------+------+------+------+------+------+------+------+
* 8 | CRDHTOD |
* +-------------------------------------------------------+
* 10 | CRDCPUID |
* +-------------------------------------------------------+
* 18 | CRDMODUL |
* +------+------+------+------+-------------+-------------+
* 20 |:RECCD|:FLAG1|:FLAG2|:CODE | CRDCP |/////////////|
* +------+------+------+------+-------------+-------------+
* 28 | CRDCRW | CRDDEV |/////////////|
* +---------------------------+-------------+-------------+
*
*** CRDREC - CHANNEL REPORT WORD ERROR RECORD
*** Overlay for CRDVDATA in CRDREC
*
* +---------------------------+---------------------------+
* 30 | CRDSEQEN | CRDASEQ |
* +-------------+-------------+------+------+-------------+
* 38 | CRDDEVST | CRDPMCW |:CHPCT|:LEVEL| CRDLVMSK- |
* +-------------+-------------+------+------+-------------+
* 40 | -(03E) |/////////////| CRDSCHRC |
* +------+------+-------------+---------------------------+
* 48 |:CHPF |:ICHPT| CRDISDT- |
* +------+------+-----------------------------------------+
* 50 | -(04A) | 52
* +-------------+
*
*** Overlay for CRDVDATA in CRDREC
*** Overlay for CRDVDATA in CRDREC
*
* +-------------------------------------------------------+
* 30 | CRDMCIC |
* +------+------+------+------+------+------+-------------+
* 38 |:STAT |:AFLG |:RFLG |//////|:IRCF |CRDCTL|/////////////|
* +------+------+------+------+------+------+------+------+
* 40 |CRDLPM|:PNOM |:LPUM |CRDPIM|/////////////|CRDPOM|CRDPAM|
* +------+------+------+------+-------------+------+------+
* 48 | CRDCHPID |
* +-------------------------------------------------------+
* 50
*
*** Overlay for CRDVDATA in CRDREC
*** Overlay for CRDHTOD in CRDREC
*
* +---------------------------+---------------------------+
* 8 | CRDHDATE | CRDHTIME |
* +---------------------------+---------------------------+
* 10
*
*** Overlay for CRDHTOD in CRDREC
*** Overlay for CRDCPUID in CRDREC
*
* +------+--------------------+-------------+-------------+
* 10 |:HCPID| CRDHSER | CRDHMDL | CRDHMCEL |
* +------+--------------------+-------------+-------------+
* 18
*
*** Overlay for CRDCPUID in CRDREC
*** Overlay for CRDMCIC in CRDREC
*
* +------+------+------+------+------+------+------+------+
* 30 |:MCIC0|:MCIC1|:MCIC2|:MCIC3|:MCIC4|:MCIC5|:MCIC6|:MCIC7|
* +------+------+------+------+------+------+------+------+
* 38
*
*** Overlay for CRDMCIC in CRDREC
CRDREC Cross Reference
Symbol Dspl Value -------------- ---- ----- CRDAFLG 0039 CRDASEQ 0034 CRDCHPCT 003C CRDCHPF 0048 CRDCHPID 0048 CRDCOACR 0023 00000003 CRDCOCPM 0023 00000001 CRDCODE 0023 CRDCOIRC 0023 00000006 CRDCOIRM 0023 00000007 CRDCOSDM 0023 00000002 CRDCOVCP 0023 00000008 CRDCP 0024 CRDCPUID 0010 CRDCRW 0028 CRDCTL 003D CRDDEV 002C CRDDEVST 0038 CRDFLAG1 0021 CRDFLAG2 0022 CRDF1HCC 0021 80 CRDF1INV 0021 01 CRDF1SCC 0021 40 CRDHCNT 0006 CRDHCPID 0010 CRDHDATE 0008 CRDHMCEL 0016 CRDHMDL 0014 CRDHSER 0011 CRDHSW0 0002 CRDHSW1 0003 CRDHSW2 0004 CRDHSW3 0005 CRDHSYS 0001 CRDHTIME 000C CRDHTOD 0008 CRDHTYCR 0000 00000025 CRDHTYPE 0000 CRDICHPT 0049 CRDIRCF 003C CRDISDT 004A CRDLENMC 0048 00000050 CRDLENUC 004A 00000052 CRDLEVEL 003D CRDLPM 0040 CRDLPUM 0042 CRDLVMSK 003E CRDMCIC 0030 CRDMCIC0 0030 CRDMCIC1 0031 CRDMCIC2 0032 CRDMCIC3 0033 CRDMCIC4 0034 CRDMCIC5 0035 CRDMCIC6 0036 CRDMCIC7 0037 CRDMODUL 0018 CRDPAM 0047 CRDPIM 0043 CRDPMCW 003A CRDPNOM 0041 CRDPOM 0046 CRDRECCD 0020 CRDRECMC 0020 00000002 CRDRECUC 0020 00000001 CRDRFLG 003A CRDSCHRC 0044 CRDSEQEN 0030 CRDSIZMC 0048 0000000A CRDSIZUC 004A 0000000B CRDSTAT 0038 CRDVDATA 0030 CSWABC 003C 01 CSWHDVA 003C 02 CSWIOINC 003C 04 CSWIRC 003C 38 CSWMINS 003C 40 CSWMSV 003C 3E CSWPATH 003C 80 CSWQDIO 003C 80 HDRHSDOS 0001 20 HDRHSLVL 0001 1F HDRHSOS1 0001 40 HDRHSOS2 0001 80 HDRHSREL 0001 03 HDRHSSYS 0001 E0 HDRHSVM 0001 60 HDRHSVRS 0001 1C HDRHSWCI 0002 40 HDRHSWMR 0002 80 HDRHSWPK 0002 10 HDRHSWPS 0002 04 HDRHSWRT 0002 20 HDRHSWTI 0002 08 HDRRCPHY 0006 0F HDRRCSEQ 0006 F0 RDEVALID 0038 80 RDEVBOX 0038 20 RDEVCPVL 0039 10 RDEVDED 0039 08 RDEVEMUL 0038 40 RDEVEXOF 0038 04 RDEVFREE 0039 20 RDEVINRQ 0038 10 RDEVINTR 003A 20 RDEVIRM 003A 40 RDEVLOFF 0038 08 RDEVMIHM 003A 01 RDEVMNT 0039 02 RDEVOFFL 0039 80 RDEVRSET 003A 10 RDEVRSVD 003A 04 RDEVSBSY 0038 01 RDEVSPL 0039 04 RDEVSUDF 003A 08 RDEVSUDQ 003A 02 RDEVSUDV 003A 80 RDEVSYS 0039 40 RDEVVPOF 0038 02 RDEVXVOL 0039 01
Copyright IBM Corporation, 1990, 2007