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.
|
ALTREC
Prolog
Control Block Contents
ALTREC DSECT
Storage Layout
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 (contains links to field and bit definitions)
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
This information is
based on VM/ESA 2.4.0.
Last updated on 3 Aug 1999 at 11:35:33 EDT.
Copyright IBM Corporation, 1990, 1999
|
