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