IBM: ALTREC

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