|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
OBRREC
Control Block Contents
OBRREC DSECT
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
Copyright IBM Corporation, 1990, 2002