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 V4R3.0. Last updated on 1 May 2002 at 07:45:19 EDT.
Copyright IBM Corporation, 1990, 2002