|
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 CRW RECORD
0001 1 Bitstring 1 CRDHSYS SYSTEM/RELEASE LEVEL
111. .... HDRHSSYS X'E0' SYSTEM MASK
1... .... HDRHSOS2 X'80' OS/VS2
.11. .... HDRHSVM X'60' VM
.1.. .... HDRHSOS1 X'40' OS/VS1
..1. .... HDRHSDOS X'20' DOS
...1 1111 HDRHSLVL X'1F' SYSTEM LEVEL MASK (INCLUDES
VERSION AND RELEASE LEVEL)
...1 11.. HDRHSVRS X'1C' VERSION NUMBER MASK
.... ..11 HDRHSREL X'03' RELEASE LEVEL MASK
0002 2 Bitstring 1 CRDHSW0 RECORD INDEPENDENT SWITCHES
1... .... HDRHSWMR X'80' MORE RECORDS FOLLOW
.1.. .... HDRHSWCI X'40' TOD CLOCK INSTRUCTION
ISSUED
..1. .... HDRHSWRT X'20' RECORD TRUNCATED
...1 .... HDRHSWPK X'10' 370/XA MODE
.... 1... HDRHSWTI X'08' TIME MACRO ISSUED
.... .1.. HDRHSWPS X'04' 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' RECORD SEQUENCE NUMBER MASK
.... 1111 HDRRCPHY X'0F' 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 UCB DATA FORMAT RECORD
00000002 CRDRECMC 2 MCIC FORMAT RECORD
0021 33 Bitstring 1 CRDFLAG1 FLAG BYTE 1
1... .... CRDF1HCC X'80' HARDWARE CREATED CRW
.1.. .... CRDF1SCC X'40' SOFTWARE CREATED CRW
.... ...1 CRDF1INV X'01' INVALID CRW RECORDING
0022 34 Bitstring 1 CRDFLAG2 FLAG BYTE 2
0023 35 Bitstring 1 CRDCODE CODE BYTE
00000001 CRDCOCPM 1 CRW PENDING MCH
00000002 CRDCOSDM 2 SYSTEM DAMAGE MCH
00000003 CRDCOACR 3 ALTERNATE CPU RECOVERY
00000006 CRDCOIRC 6 HOT I/O RECOVER CHAN PATH
00000007 CRDCOIRM 7 HOT I/O REMOVE CHAN PATH
00000008 CRDCOVCP 8 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' VALID DEVICE ASSOCIATED
WITH SUBCH
.1.. .... RDEVEMUL X'40' DEVICE IS IN EMULATION MODE
..1. .... RDEVBOX X'20' BOXED DEVICE
...1 .... RDEVINRQ X'10' DEVICE INTERVENTION
REQUIRED WAIT
.... 1... RDEVLOFF X'08' OWNER IS IN LOGOFF
PROCESSING
.... .1.. RDEVEXOF X'04' OPERATOR VARIED DEVICE
OFFLINE
.... ..1. RDEVVPOF X'02' VARY PATH VARIED THE DEVICE
OFFLINE
.... ...1 RDEVSBSY X'01' Device is busy with a
system function
0039 57 Bitstring 1 CRDAFLG DEVICE ALLOCATION CONTROL FLAG
FROM RDEV
1... .... RDEVOFFL X'80' DEVICE IS OFFLINE
.1.. .... RDEVSYS X'40' DEVICE ATTACHED TO SYSTEM
..1. .... RDEVFREE X'20' DEVICE IS NOT IN USE
...1 .... RDEVCPVL X'10' CP VOLUME IS ATTACHED
(RDEVVOL)
.... 1... RDEVDED X'08' DEVICE ATTACHED TO USER
(RDEVUSER)
.... .1.. RDEVSPL X'04' DEVICE FOR SPOOLING
(RDEVRSP)
.... ..1. RDEVMNT X'02' VOLUME IS MOUNTED BUT NOT
ATTACHED
.... ...1 RDEVXVOL X'01' XVOLID SPECIFIED FOR DASD
OR TAPE
003A 58 Bitstring 1 CRDRFLG DEVICE ERROR RECOVERY CONTROL
FLAG FROM RDEV
1... .... RDEVWTDE X'80' MESSAGE HANDLER WAIT FOR
DEVICE END
.1.. .... RDEVIRM X'40' INTENSIVE RECORDING MODE
ACTIVE
..1. .... RDEVINTR X'20' DEVICE IS INTERVENTION
REQUIRED
...1 .... RDEVRSET X'10' DEVICE IS BEING RESET
.... 1... RDEVCONC X'08' CONTINGENT CONNECTION FOR
SENSE
.... .1.. RDEVRSVD X'04' DEVICE HAS BEEN RESERVED
.... ..1. RDEVUDEI X'02' UNSOLICITED DEVICE END IN
ERP
.... ...1 RDEVMIHM X'01' 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' INTERRUPTION SUBCLASS
EXTRACT MASK
1... .... CSWQDIO X'80' QDIO Facility (Q) Available
.... .1.. CSWIOINC X'04' I/O Initiation Control bit
.... ..1. CSWHDVA X'02' HALT DEVICE (HDV) Assist
Control bit
.... ...1 CSWABC X'01' ALTERNATE BLOCK CONTROL BIT
1... .... CSWPATH X'80' MODEL DEPENDENT PATH FOR
MSG SUBCHANL
..11 111. CSWMSV X'3E' MESSAGE SUBCHANNEL VALID
BITS
.1.. .... CSWMINS X'40' 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 RDEVCONC 003A 08 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 RDEVSYS 0039 40 RDEVUDEI 003A 02 RDEVVPOF 0038 02 RDEVWTDE 003A 80 RDEVXVOL 0039 01
Copyright IBM Corporation, 1990, 2003