Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### 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

    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 z/VM V5R2.0. Last updated on 12 Apr 2006 at 16:36:57 EDT.
Copyright IBM Corporation, 1990, 2005