Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### CRDREC

Prolog

Control Block Contents
CRDREC DSECT

Storage Layout

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... ....      RDEVSUDV       X'80' Summary UC received on this
                                            device
              .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...      RDEVSUDF       X'08' Summary UC recovery
                                            deferred for dev
              .... .1..      RDEVRSVD       X'04' DEVICE HAS BEEN RESERVED
              .... ..1.      RDEVSUDQ       X'02' Summary UC proc has applied
                                            UC status to a DQUNS IORBK for
                                            this device
              .... ...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
    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

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 16:37:46 EDT.
Copyright IBM Corporation, 1990, 2005