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.3.0 Last updated on 22 Jun 2022 at 15:59:14 EDT.
Copyright IBM Corporation, 1990, 2022