|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
ALTREC
Control Block Contents
ALTREC DSECT
Cross Reference (Contains links to field and bit definitions)
ALTREC Prolog
NAME : ALTREC
DESCRIPTION: ALERT RECORDING RECORD
DSECT : ALTREC
FUNCTION : ALTREC PROVIDES ERROR, SENSE, AND OTHER
STATISTICAL DATA NEEDED FOR ERROR RECORDING
ON A SPECIFIED CHANNEL-ATTACHED I/O DEVICE.
ALTREC MAPS THE NON-DEVICE SPECIFIC INFORMATION
AND SDMALT MAPS THE STORAGE DEVICE SPECIFIC
INFORMATION. MODULES WHICH BUILD ALERT RECORDS
FOR STORAGE DEVICES MUST COPY BOTH THE SDMALT &
ALTREC CONTROL BLOCKS.
LOCATED BY : N/A
CREATED BY : HCPDUC
DELETED BY : HCPIOE AFTER HCPREC HAS COPIED IT INTO
A GSDBK.
ALTREC Control Block Content
ALTREC DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure ALTREC ALERT 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 16 ALTHDR (0) ALERT RECORD HEADER
0000 0 Bitstring 1 ALTHTYPE RECORD TYPE
000000A3 ALTRECRD 163 ALERT RECORD TYPE CODE
(X'A3')
0001 1 Bitstring 1 ALTSYS 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 ALTSWS0 SWITCH BYTE ZERO (0)
0003 3 Bitstring 1 ALTSWS1 SWITCH BYTE ONE (1)
...1 .... ALTDASIM X'10' SERVICE INFORMATIONAL
MESSAGE (SIM)
0004 4 Bitstring 1 ALTSWS2 SWITCH BYTE TWO (2)
1... .... ALTCHPVA X'80' DASD SERVICE INFORMATIONAL
MESSAGE (SIM)
0005 5 Bitstring 1 ALTSWS3 SWITCH BYTE THREE (3)
0006 6 Bitstring 1 ALTRDCNT 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 ALTSFTOD TOD OF SYSTEM FAILURE
0010 16 Dbl-Word 8 ALTCPUID CPUID AND SERIAL NUMBER
BEGINNING OF ALERT RECORD SPECIFIC INFORMATION
0018 24 Bitstring 76 ALTSPEC LENGTH OF SPECIFIC INFORMATION
00000064 ALTLENG (*-ALTREC) LENGTH IN BYTES OF
ALTREC
0000000D ALTSIZE (*-ALTREC+7)/8 DOUBLEWORD LENGTH
OF ALTREC
REDEFINITIONS OF ALERT RECORD FIELDS
0008 8 Signed 4 ALTDTEN DATE OF SYSTEM FAILURE
000C 12 Signed 4 ALTTMEN TIME OF SYSTEM FAILURE
0010 16 Bitstring 1 ALTVERNO MACHINE VERSION CODE
0011 17 Bitstring 3 ALTCPSER CPU SERIAL NUMBER
0014 20 Bitstring 2 ALTCPMOD CPU MACHINE MODEL NUMBER
0016 22 Bitstring 2 ALTCPMEL MAX LENGTH OF MACHINE-DEPENDENT
MACHINE CHECK EXTENDED LOGOUT
AREA
ALTREC Storage Layout
*** ALTREC - ALERT RECORDING RECORD
*
* +------+------+------+------+------+------+------+------+
* 0 |:HTYPE|ALTSYS|:SWS0 |:SWS1 |:SWS2 |:SWS3 |:RDCNT|//////|
* +------+------+------+------+------+------+------+------+
* 8 | ALTSFTOD |
* +-------------------------------------------------------+
* 10 | ALTCPUID |
* +-------------------------------------------------------+
* 18 | |
* = ALTSPEC =
* | +---------------------------+
* | | 64
* +---------------------------+
*
*** ALTREC - ALERT RECORDING RECORD
*** Overlay for ALTSFTOD in ALTREC
*
* +---------------------------+---------------------------+
* 8 | ALTDTEN | ALTTMEN |
* +---------------------------+---------------------------+
* 10
*
*** Overlay for ALTSFTOD in ALTREC
*** Overlay for ALTCPUID in ALTREC
*
* +------+--------------------+-------------+-------------+
* 10 |:VERNO| ALTCPSER | ALTCPMOD | ALTCPMEL |
* +------+--------------------+-------------+-------------+
* 18
*
*** Overlay for ALTCPUID in ALTREC
ALTREC Cross Reference
Symbol Dspl Value -------------- ---- ----- ALTCHPVA 0004 80 ALTCPMEL 0016 ALTCPMOD 0014 ALTCPSER 0011 ALTCPUID 0010 ALTDASIM 0003 10 ALTDTEN 0008 ALTHDR 0000 ALTHTYPE 0000 ALTLENG 0018 00000064 ALTRDCNT 0006 ALTRECRD 0000 000000A3 ALTSFTOD 0008 ALTSIZE 0018 0000000D ALTSPEC 0018 ALTSWS0 0002 ALTSWS1 0003 ALTSWS2 0004 ALTSWS3 0005 ALTSYS 0001 ALTTMEN 000C ALTVERNO 0010 HDRHSDOS 0001 20 HDRHSLVL 0001 1F HDRHSOS1 0001 40 HDRHSOS2 0001 80 HDRHSREL 0001 03 HDRHSSYS 0001 E0 HDRHSVM 0001 60 HDRHSVRS 0001 1C HDRRCPHY 0006 0F HDRRCSEQ 0006 F0
Copyright IBM Corporation, 1990, 2002