Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

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 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 *** SEE SDMOBR FOR ADDITIONAL DEFINITIONS 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 00000010 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 00000001 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 00000001 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. 0052 82 Address 4 * (0) IEV075 will result if OBRURSZX GT OBRMAXSZ @P3714FM 0052 82 Address 4 * (0) IEV075 will result if OBR35SZX GT OBRMAXSZ @P3714FM 0052 82 Address 4 * (0) IEV075 will result if OBR32SZX GT OBRMAXSZ @P3714FM 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                        |
*     +-------------------------------------------------------+
*  18 |                                                       |
*     =                       OBRVRFMT                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** 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   |
*     +------+--------------------+-------------+-------------+
*  40 |                                                       |
*     =                       OBROVLAY                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** 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)        |//////////////////////////////////|
*     +--------------------+----------------------------------+
*  80 |                                                       |
*     =                       OBR99SNS                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** Overlay for OBROVLAY in OBRREC
*** Overlay for OBROVLAY in OBRREC
*
*     +-------------------------------------------------------+
*  40 |                       OBRURST                         |
*     |             +-----------------------------------------+
*     |             |                                         |
*     +-------------+                                         |
*  50 |                                                       |
*     =                       OBRURSNS                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** Overlay for OBROVLAY in OBRREC
*** Overlay for OBROVLAY in OBRREC
*
*     +-------------------------------------------------------+
*  40 |                                                       |
*     =                       OBR35SNS                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** Overlay for OBROVLAY in OBRREC
*** Overlay for OBROVLAY in OBRREC
*
*     +------+------------------------------------------------+
*  40 |:CORL |////////////////////////////////////////////////|
*     +------+------------------------------------------------+
*  48 |                       OBRSDR32                        |
*     |             +-----------------------------------------+
*     |             | 52
*     +-------------+
*
*** Overlay for OBROVLAY in OBRREC
*** Overlay for OBRVRFMT in OBRREC
*
*     +---------------------------+------+--------------------+
*  18 |         OBRDEVSH          |:SDRSH|      OBRCUA        |
*     +---------------------------+------+--------------------+
*  20 |                                                       |
*     =                       OBRSDRCT                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** Overlay for OBRVRFMT in OBRREC
*** Overlay for OBRCUA in OBRREC
*
*                                        +------+-------------+
*  18 ...                             1D |//////|  OBRDVNSH   |
*                                        +------+-------------+
*  20
*
*** Overlay for OBRCUA in OBRREC

 

OBRREC Cross Reference

(contains links to field and bit definitions)
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 00000010

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 00000001

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 00000001

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 VM/ESA 2.4.0.
Last updated on 3 Aug 1999 at 13:52:07 EDT.
Copyright IBM Corporation, 1990, 1999