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

#### OBRREC

Prolog

Control Block Contents
OBRREC DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### OBRREC Prolog

     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.

#### OBRREC Control Block Content

#### OBRREC DSECT

    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 DYNAMIC PATHING AVAILABLE
                                            RECORD
              00000036       OBRTVTAM       54 TP ACCESS METHOD (VTAM) RECORD
              00000034       OBRTTPAM       52 TP ACCESS METHOD (TCAM(OS)/
                                            BTAM(DOS)) RECORD
              00000032       OBRTCVTR       50 CONVERTED OBR RECORD (NOT FOR
                                            VS)
              00000030       OBRTOBRR       48 OBR (UNIT CHECK) RECORD
    0001    1 Bitstring    1 OBRSW0         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 OBRSWS1        SWITCH BYTE ONE
              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 OBRSWS2        SWITCH BYTE TWO *** SEE SDMOBR
                                            FOR ADDITIONAL DEFINITIONS
              1... ....      OBREOD         X'80' SDR COUNTERS DUMPED AT END
                                            OF DAY
              .1.. ....      OBRTEMP        X'40' TEMPORARY ERROR
              ..1. ....      OBRSHOBR       X'20' SHORT OBR RECORD
              ...1 ....      OBRSWMP        X'10' MP SYSTEM
              .... 1...      OBRCPUB        X'08' CPU B ISSUED LAST SIO (370
                                            MP ONLY)
              .... .1..      OBRDEMNT       X'04' VOLUME DEMOUNT
              .... ...1      OBRSWPOL       X'01' SECUA CONTAINS POLLING
                                            CHARS. (NOT CUA). ONLY SET FOR TP
                                            RECORDS
    0004    4 Bitstring    1 OBRSWS3        SWITCH BYTE 3
              1... ....      OBRCHPVA       X'80' CHPID VALID
              ..11 1.1.      OBR9033        X'3A' IBM 9033
              ..11 1.1.      OBR9032        X'3A' IBM 9032
              ..11 1.1.      OBR2032        X'3A' 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' 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 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' Indicate Control Unit ID
                                            exists
    0035   53 Bitstring    1 OBRCUTC        CONTROL UNIT TYPE CODE
              1... ....      OBRFICON       X'80' 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
    0039   57 Bitstring    1 *              RESERVED FOR FUTURE IBM USE
    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 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 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 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

    *** 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 |//////|  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

    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
    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 V4R3.0. Last updated on 1 May 2002 at 11:13:31 EDT.
Copyright IBM Corporation, 1990, 2002