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 ALTRECRD ALERT RECORD TYPE
                                        CODE (X'A3')
0001    1 Bitstring    1 ALTSYS         SYSTEM/RELEASE LEVEL
          111. ....      HDRHSSYS       X'E0' HDRHSSYS SYSTEM MASK
          1... ....      HDRHSOS2       X'80' HDRHSOS2 OS/VS2
          .11. ....      HDRHSVM        X'60' HDRHSVM VM
          .1.. ....      HDRHSOS1       X'40' HDRHSOS1 OS/VS1
          ..1. ....      HDRHSDOS       X'20' HDRHSDOS DOS
          ...1 1111      HDRHSLVL       X'1F' HDRHSLVL SYSTEM LEVEL MASK
                                        (INCLUDES VERSION AND RELEASE
                                        LEVEL)
          ...1 11..      HDRHSVRS       X'1C' HDRHSVRS VERSION NUMBER
                                        MASK
          .... ..11      HDRHSREL       X'03' HDRHSREL 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' ALTDASIM SERVICE
                                        INFORMATIONAL MESSAGE (SIM)
0004    4 Bitstring    1 ALTSWS2        SWITCH BYTE TWO (2)
          1... ....      ALTCHPVA       X'80' ALTCHPVA 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' HDRRCSEQ RECORD SEQUENCE
                                        NUMBER MASK
          .... 1111      HDRRCPHY       X'0F' HDRRCPHY 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 V6R1.0. Last updated on 18 Feb 2010 at 08:17:40 EDT.
Copyright IBM Corporation, 1990, 2008