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

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.      OBR9042        X'3A' IBM 9042
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. ) Expect "IEV0
                                        75" if OBRURSZX GT OBRMAXSZ )
                                        Expect "IEV0 75" if OBR35SZX GT
                                        OBRMAXSZ ) Expect "IEV0 75" if
                                        OBR32SZX GT OBRMAXSZ
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
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
OBR9042        0004 3A
OBR99SNS       0080

This information is based on z/VM V3R1.0.
Last updated on 30 Mar 2001 at 09:20:23 EDT.
Copyright IBM Corporation, 1990, 2001