OBRREC | Back to Index page

| Prolog Control Block Contents OBRREC 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.

OBRREC Prolog | Top of page

     NAME       : OBRREC
     DESCRIPTION: OUTBOARD RECORDING RECORD
     DSECT      : OBRREC
     FUNCTION   : OBRREC PROVIDES ERROR, SENSE, AND OTHER
                  STATISTICAL DATA NEEDED FOR ERROR RECORDING
                  ON A SPECIFIED CHANNEL-ATTACHED I/O DEVICE.
                  SDMOBR MAPS THE STORAGE DEVICE SPECIFIC PORTION
                  OF THE OBRREC.  MODULES WHICH BUILD ALERT
                  RECORDS MUST COPY BOTH THE SDMOBR & OBRREC
                  CONTROL BLOCKS.
     LOCATED BY : N/A
     CREATED BY : HCPIOE, HCPDUC, HCPPUC, HCPSUN OR A
                  GUEST.  COPIED TO FREE STORAGE BY HCPVER.
     DELETED BY : HCPIOE AFTER HCPREC HAS COPIED IT INTO
                  A GSDBK.
     RELOCATION CONSIDERATIONS : None

OBRREC Control Block Content | Top of page

     OBRREC DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      OBRREC         OUTBOARD RECORDING RECORD
           THIS CONTROL BLOCK IS AN INTER-OPERATING-SYSTEM BLOCK
           WHICH IS DEFINED BY IBM CORPORATE STANDARDS. THEREFORE
           VM/XA 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 OBRHTYPE       CLASS/SOURCE
              0000003A       OBRTDPA        58 OBRTDPA DYNAMIC PATHING
                                            AVAILABLE RECORD
              00000036       OBRTVTAM       54 OBRTVTAM TP ACCESS METHOD
                                            (VTAM) RECORD
              00000034       OBRTTPAM       52 OBRTTPAM TP ACCESS METHOD
                                            (TCAM(OS)/ BTAM(DOS)) RECORD
              00000032       OBRTCVTR       50 OBRTCVTR CONVERTED OBR RECORD
                                            (NOT FOR VS)
              00000030       OBRTOBRR       48 OBRTOBRR OBR (UNIT CHECK)
                                            RECORD
    0001    1 Bitstring    1 OBRSW0         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 OBRSWS1        SWITCH BYTE ONE
              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 OBRSWS2        SWITCH BYTE TWO *** SEE SDMOBR
                                            FOR ADDITIONAL DEFINITIONS
              1... ....      OBREOD         X'80' OBREOD SDR COUNTERS DUMPED
                                            AT END OF DAY
              .1.. ....      OBRTEMP        X'40' OBRTEMP TEMPORARY ERROR
              ..1. ....      OBRSHOBR       X'20' OBRSHOBR SHORT OBR RECORD
              ...1 ....      OBRSWMP        X'10' OBRSWMP MP SYSTEM
              .... 1...      OBRCPUB        X'08' OBRCPUB CPU B ISSUED LAST
                                            SIO (370 MP ONLY)
              .... .1..      OBRDEMNT       X'04' OBRDEMNT VOLUME DEMOUNT
              .... ...1      OBRSWPOL       X'01' OBRSWPOL SECUA CONTAINS
                                            POLLING CHARS. (NOT CUA). ONLY
                                            SET FOR TP RECORDS
    0004    4 Bitstring    1 OBRSWS3        SWITCH BYTE 3
              1... ....      OBRCHPVA       X'80' OBRCHPVA CHPID VALID
              ..11 1.1.      OBR9033        X'3A' OBR9033 IBM 9033
              ..11 1.1.      OBR9032        X'3A' OBR9032 IBM 9032
              ..11 1.1.      OBR2032        X'3A' OBR2032 2032 FICON Switch
    0005    5 Bitstring    1 OBRCSID        CHANNEL SET ID FOR FAILING
                                            CHANNEL
    0006    6 Bitstring    1 OBRRDCNT       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 OBRSFTOD       TOD OF SYSTEM FAILURE
    0010   16 Dbl-Word     8 OBRCPUID       CPUID AND SERIAL NUMBER
    0018   24 Dbl-Word     8 OBRVRFMT (0)   START OF VARIABLE LENGTH DATA
    0008    8 Signed       4 OBRDTEN        DATE OF SYSTEM FAILURE
    000C   12 Signed       4 OBRTMEN        TIME OF SYSTEM FAILURE
    0010   16 Bitstring    1 OBRVERNO       MACHINE VERSION CODE
    0011   17 Bitstring    3 OBRCPSER       CPU SERIAL NUMBER
    0014   20 Bitstring    2 OBRCPMOD       CPU MACHINE MODEL NUMBER
    0016   22 Bitstring    2 OBRCPMEL       MAX LENGTH OF MACHINE-DEPENDENT
                                            MACHINE CHECK EXTENDED LOGOUT
                                            AREA
    0018   24 Character    8 OBRPRGID       PROGRAM IDENTIFICATION/USERID
    0020   32 Dbl-Word     8 OBRFLCCW       FAILING CHANNEL COMMAND WORD
    0028   40 Dbl-Word     8 OBRFLCSW       CHANNEL STATUS WORD (370 ONLY)
    0030   48 Bitstring    1 OBRDCNT        DEV-DEP AREA SIZE IN DBL-WDS
    0031   49 Bitstring    3 OBRCUAD        FAILING DEVICE ADDRESS (370 ONLY)
    0034   52 Signed       4 OBRDVTYP (0)   DEVICE TYPE CODE
    0034   52 Bitstring    1 OBRSYS         SYSTEM IDENTIFICATION
              1... ....      OBRCUON        X'80' OBRCUON Indicate Control
                                            Unit ID exists
    0035   53 Bitstring    1 OBRCUTC        CONTROL UNIT TYPE CODE
              1... ....      OBRFICON       X'80' OBRFICON Indicate FICON
                                            Switch, OBRCUON=OFF
    0036   54 Bitstring    1 OBRDEVC        VS DEVICE CLASS CODE
    0037   55 Bitstring    1 OBRDTYP        VS DEVICE TYPE CODE
    0038   56 Bitstring    1 OBRSDRSZ       SDR WORK AREA SIZE IN BYTES
    0039   57 Bitstring    3 OBRCUAP        DEVICE ADDRESS - PRIMARY PATH
    003C   60 Signed       2 OBRIORTY       NUMBER OF RETRIES EXECUTED
    003E   62 Signed       2 OBRSNSCT       COUNT OF SENSE BTYES PRESENT
              00000040       OBRLONG        (*-OBRREC) LENGTH IN BYTES OF
                                            LONG OBR BASE
              00000008       OBRLSIZE       (*-OBRREC+7)/8 LONG OBRREC SIZE
                                            IN DBL WORDS
    0040   64 Dbl-Word     8 OBROVLAY (0)   START OF VARIABLE LENGTH DATA
                                            LENGTH OF LONG OBR RECORD:
                                            OBRLONG*8 + OBRDCNT*8 + OBRSDRSZ
                                            + OBRSNSCT IF 370/XA MODE, +
                                            OBRIRBSZ IF SWITCH DEVICE +
                                            OBRNEDSZ IF FCX DEVICE + OBRDEXTS
    0039   57 Bitstring    1 OBRSS          Device subchannel set identifier
    003A   58 Bitstring    2 OBRDVNO        DEVICE ADDRESS - PRIMARY PATH
    0031   49 Bitstring    1 OBRCHPID       CHANNEL PATH ID
    0032   50 Bitstring    2 OBRDEVNO       DEVICE ADDRESS
              ...1 ....      OBRIRBSZ       16 OBRIRBSZ NUMBER BYTES OF IRB
                                            DATA (370/XA)
    0040   64 Bitstring   32 OBRTNED (0)    RCD CCW Token NED
    0040   64 Signed       4 OBRFLAG        Token NED flag
    0044   68 Bitstring    6 OBRMACH        Machine number
    004A   74 Bitstring    3 OBRMODEL       Model number
    004D   77 Character    3 OBRPLANT       "IBM"
    0050   80 Character   14 OBRSERNO       Serial number
    005E   94 Signed       2 OBRTAG         Device tag
    0060   96 Bitstring   32 OBRGNEQ (0)    RCD CCW General NEQ
    0060   96 Bitstring   20 *              Reserved for future IBM use
    0074  116 Bitstring    7 OBRECLVL       Box EC level
    007B  123 Bitstring    5 *              Reserved for future IBM use
              00000008       OBRNEDSZ       (*-OBROVLAY+7)/8 Number of
                                            doublewords of switch device
                                            dependent data
    0080  128 Bitstring    1 OBR99SNS (0)   Start of Sense Data
              00000000       OBRURDCT       (*-*)/8 DOUBLE-WORDS DEV. DEP.
                                            DATA
    0040   64 Bitstring   10 OBRURST        SDR WORK AREA
              0000000A       OBRURSDR       (*-OBRURST) NUMBER BYTES SDR WORK
                                            AREA
    004A   74 Bitstring    1 OBRURSNS (0)   START OF VARIABLE LENGTH DATA
              .... ...1      OBRURSCT       1 OBRURSCT MAXIMUM NUMBER BYTES
                                            SENSE DATA
              0000004B       OBRURSZ3       (OBRURSNS-OBRREC)+OBRURSCT 370
                                            MAX. SIZE
                 THE FIRST OBRIRBSZ BYTES OF IRB DATA FOLLOWS THE
                 SENSE DATA AT OBRURSNS+VALUE-OF-OBRSNSCT (370/XA)
              0000005B       OBRURSZX       (OBRURSNS-OBRREC)+OBRURSCT+OBRIRB
                                            SZ MAX. SIZE 25XX/14XX RECORD
              00000000       OBR35DCT       (*-*)/8 DOUBLE-WORDS DEV. DEP.
                                            DATA
              00000000       OBR35SDR       (*-*) NUMBER BYTES SDR WORK AREA
    0040   64 Bitstring    1 OBR35SNS (0)   START OF VARIABLE LENGTH DATA
              .... ...1      OBR35SCT       1 OBR35SCT MAXIMUM NUMBER BYTES
                                            SENSE DATA
              00000041       OBR35SZ3       (OBR35SNS-OBRREC)+OBR35SCT 370
                                            MAX. SIZE
                 THE FIRST OBRIRBSZ BYTES OF IRB DATA FOLLOWS THE
                 SENSE DATA AT OBR35SNS+VALUE-OF-OBRSNSCT (370/XA)
              00000051       OBR35SZX       (OBR35SNS-OBRREC)+OBR35SCT+OBRIRB
                                            SZ MAX. SIZE 3505/3525 RECORD
    0040   64 Bitstring    1 OBRCORL        CORRELATION NUMBER
    0041   65 Bitstring    7 *              RESERVED FOR FUTURE IBM USE
              00000001       OBR32DCT       (*-OBROVLAY)/8 DBL-WDS DEV. DEP.
                                            DATA
    0048   72 Bitstring   10 OBRSDR32       SDR WORK AREA
              0000000A       OBR32SDR       (*-OBRSDR32) NUMBER BYTES SDR
                                            WORK AREA
    0052   82 Bitstring    1 OBR32SNS (0)   START OF VARIABLE LENGTH DATA
              00000018       OBR32SCT       24 MAXIMUM NUMBER BYTES SENSE
                                            DATA
              0000006A       OBR32SZ3       (OBR32SNS-OBRREC)+OBR32SCT 370
                                            MAX. SIZE
                 THE FIRST OBRIRBSZ BYTES OF IRB DATA FOLLOWS THE
                 SENSE DATA AT OBR32SNS+VALUE-OF-OBRSNSCT (370/XA)
              0000007A       OBR32SZX       (OBR32SNS-OBRREC)+OBR32SCT+OBRIRB
                                            SZ MAX. SIZE 3211/2303 RECORD
              0000007A       OBRMAXSZ       OBR32SZX LARGEST OBRREC DEFINED
                                            WHEN SDMOBR IS NOT DEFINED ENSURE
                                            NONE OF THE RECORD TYPES ARE
                                            LARGER THAN MAX.
    0018   24 Signed       4 OBRDEVSH       DEVICE TYPE
    001C   28 Bitstring    1 OBRSDRSH       NUMBER OF SDR WORK AREA BYTES
    001D   29 Bitstring    3 OBRCUA         DEVICE ADDRESS
              00000020       OBRSHORT       (*-OBRREC) LENGTH IN BYTES OF
                                            SHORT OBR BASE
              00000004       OBRSHSZ        (*-OBRREC+7)/8 SHORT REC. SIZE
                                            DBL-WDS
    0020   32 Bitstring    1 OBRSDRCT (0)   START OF VARIABLE LENGTH DATA SDR
                                            WORK AREA
                 LENGTH OF SHORT RECORD:
                   8*OBRSHORT + OBRSDRSH
    001D   29 Bitstring    1 *              RESERVED FOR FUTURE IBM USE
    001E   30 Bitstring    2 OBRDVNSH       DEVICE ADDRESS

OBRREC Storage Layout | Top of page

    *** OBRREC - OUTBOARD RECORDING RECORD
    *
    *     +------+------+------+------+------+------+------+------+
    *   0 |:HTYPE|OBRSW0|:SWS1 |:SWS2 |:SWS3 |:CSID |:RDCNT|//////|
    *     +------+------+------+------+------+------+------+------+
    *   8 |                       OBRSFTOD                        |
    *     +-------------------------------------------------------+
    *  10 |                       OBRCPUID                        |
    *     +-------------------------------------------------------+
    *
    *** OBRREC - OUTBOARD RECORDING RECORD

    *** Overlay for OBRSFTOD in OBRREC
    *
    *     +---------------------------+---------------------------+
    *   8 |         OBRDTEN           |         OBRTMEN           |
    *     +---------------------------+---------------------------+
    *  10
    *
    *** Overlay for OBRSFTOD in OBRREC

    *** Overlay for OBRCPUID in OBRREC
    *
    *     +------+--------------------+-------------+-------------+
    *  10 |:VERNO|     OBRCPSER       |  OBRCPMOD   |  OBRCPMEL   |
    *     +------+--------------------+-------------+-------------+
    *  18
    *
    *** Overlay for OBRCPUID in OBRREC

    *** Overlay for OBRVRFMT in OBRREC
    *
    *     +-------------------------------------------------------+
    *  18 |                       OBRPRGID                        |
    *     +-------------------------------------------------------+
    *  20 |                       OBRFLCCW                        |
    *     +-------------------------------------------------------+
    *  28 |                       OBRFLCSW                        |
    *     +------+--------------------+------+------+------+------+
    *  30 |:DCNT |      OBRCUAD       |OBRSYS|:CUTC |:DEVC |:DTYP |
    *     +------+--------------------+------+------+------+------+
    *  38 |:SDRSZ|      OBRCUAP       |  OBRIORTY   |  OBRSNSCT   |
    *     +------+--------------------+-------------+-------------+
    *
    *** Overlay for OBRVRFMT in OBRREC

    *** Overlay for OBRCUAP in OBRREC
    *
    *            +------+-------------+
    *  38 ..  39 |OBRSS |  OBRDVNO    | 3C
    *            +------+-------------+
    *
    *** Overlay for OBRCUAP in OBRREC

    *** Overlay for OBRCUAD in OBRREC
    *
    *            +------+-------------+
    *  30 ..  31 |:CHPID|  OBRDEVNO   | 34
    *            +------+-------------+
    *
    *** Overlay for OBRCUAD in OBRREC

    *** Overlay for OBROVLAY in OBRREC
    *
    *     +---------------------------+---------------------------+
    *  40 |         OBRFLAG           |         OBRMACH-          |
    *     +-------------+-------------+------+--------------------+
    *  48 |   -(044)    |     OBRMODEL       |     OBRPLANT       |
    *     +-------------+--------------------+--------------------+
    *  50 |                       OBRSERNO                        |
    *     |                                         +-------------+
    *  58 |                                         |   OBRTAG    |
    *     +-----------------------------------------+-------------+
    *  60 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////+---------------------------+
    *     |///////////////////////////|        OBRECLVL-          |
    *     +--------------------+------+---------------------------+
    *  78 |      -(074)        |//////////////////////////////////|
    *     +--------------------+----------------------------------+
    *
    *** Overlay for OBROVLAY in OBRREC

    *** Overlay for OBROVLAY in OBRREC
    *
    *     +-------------------------------------------------------+
    *  40 |                       OBRURST                         |
    *     |             +-----------------------------------------+
    *     |             |
    *     +-------------+
    *
    *** Overlay for OBROVLAY in OBRREC

    *** Overlay for OBROVLAY in OBRREC
    *
    *
    *** Overlay for OBROVLAY in OBRREC

    *** Overlay for OBROVLAY in OBRREC
    *
    *     +------+------------------------------------------------+
    *  40 |:CORL |////////////////////////////////////////////////|
    *     +------+------------------------------------------------+
    *  48 |                       OBRSDR32                        |
    *     |             +-----------------------------------------+
    *     |             |
    *     +-------------+
    *
    *** Overlay for OBROVLAY in OBRREC

    *** Overlay for OBRVRFMT in OBRREC
    *
    *     +---------------------------+------+--------------------+
    *  18 |         OBRDEVSH          |:SDRSH|      OBRCUA        |
    *     +---------------------------+------+--------------------+
    *
    *** Overlay for OBRVRFMT in OBRREC

    *** Overlay for OBRCUA in OBRREC
    *
    *                                        +------+-------------+
    *  18 ...                             1D |//////|  OBRDVNSH   |
    *                                        +------+-------------+
    *  20
    *
    *** Overlay for OBRCUA in OBRREC

OBRREC Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    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
    OBRCHPID       0031
    OBRCHPVA       0004 80
    OBRCORL        0040
    OBRCPMEL       0016
    OBRCPMOD       0014
    OBRCPSER       0011
    OBRCPUB        0003 08
    OBRCPUID       0010
    OBRCSID        0005
    OBRCUA         001D
    OBRCUAD        0031
    OBRCUAP        0039
    OBRCUON        0034 80
    OBRCUTC        0035
    OBRDCNT        0030
    OBRDEMNT       0003 04
    OBRDEVC        0036
    OBRDEVNO       0032
    OBRDEVSH       0018
    OBRDTEN        0008
    OBRDTYP        0037
    OBRDVNO        003A
    OBRDVNSH       001E
    OBRDVTYP       0034
    OBRECLVL       0074
    OBREOD         0003 80
    OBRFICON       0035 80
    OBRFLAG        0040
    OBRFLCCW       0020
    OBRFLCSW       0028
    OBRGNEQ        0060
    OBRHTYPE       0000
    OBRIORTY       003C
    OBRIRBSZ       0032 10
    OBRLONG        003E 00000040
    OBRLSIZE       003E 00000008
    OBRMACH        0044
    OBRMAXSZ       0052 0000007A
    OBRMODEL       004A
    OBRNEDSZ       007B 00000008
    OBROVLAY       0040
    OBRPLANT       004D
    OBRPRGID       0018
    OBRRDCNT       0006
    OBRSDRCT       0020
    OBRSDRSH       001C
    OBRSDRSZ       0038
    OBRSDR32       0048
    OBRSERNO       0050
    OBRSFTOD       0008
    OBRSHOBR       0003 20
    OBRSHORT       001D 00000020
    OBRSHSZ        001D 00000004
    OBRSNSCT       003E
    OBRSS          0039
    OBRSWMP        0003 10
    OBRSWPOL       0003 01
    OBRSWS1        0002
    OBRSWS2        0003
    OBRSWS3        0004
    OBRSW0         0001
    OBRSYS         0034
    OBRTAG         005E
    OBRTCVTR       0000 00000032
    OBRTDPA        0000 0000003A
    OBRTEMP        0003 40
    OBRTMEN        000C
    OBRTNED        0040
    OBRTOBRR       0000 00000030
    OBRTTPAM       0000 00000034
    OBRTVTAM       0000 00000036
    OBRURDCT       0080 00000000
    OBRURSCT       004A 01
    OBRURSDR       0040 0000000A
    OBRURSNS       004A
    OBRURST        0040
    OBRURSZX       004A 0000005B
    OBRURSZ3       004A 0000004B
    OBRVERNO       0010
    OBRVRFMT       0018
    OBR2032        0004 3A
    OBR32DCT       0041 00000001
    OBR32SCT       0052 00000018
    OBR32SDR       0048 0000000A
    OBR32SNS       0052
    OBR32SZX       0052 0000007A
    OBR32SZ3       0052 0000006A
    OBR35DCT       004A 00000000
    OBR35SCT       0040 01
    OBR35SDR       004A 00000000
    OBR35SNS       0040
    OBR35SZX       0040 00000051
    OBR35SZ3       0040 00000041
    OBR9032        0004 3A
    OBR9033        0004 3A
    OBR99SNS       0080

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:32:20 EDT.
Copyright IBM Corporation, 1990, 2020