Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRSTOATC

Prolog
Control Block Contents
Storage Layout
Cross Reference

#### MRSTOATC Prolog

####

####

     DSECT NAME - STOATC
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTOATC
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 3 - Storage Domain
                        Record 7 - Page/Spool Area of a CP Volume
     DESCRIPTION - Describes a paging or spooling area in a CP volume
                   that had just been attached.  A separate record is
                   generated for each paging area and each spooling area
                   on the volume.
     NOTES:
       - The CP volume, as a device, is described in MRIODATD (Domain 6,
         Record 5).  MRSTOATC describes the storage area on it.

    MRSTOATC Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   48  STOATC              Start of monitor record
      0   0  Character    0  STOATC_MRHDR        Record header. See MRRECHDR for
                                                 details.
      0   0  Character   20  MRHDR
      0   0  Unsigned     2  MRHDRLEN            record length in bytes
      2   2  Unsigned     2  MRHDRZER            field of zeros
      4   4  Unsigned     1  MRHDRDM             domain identifier
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC             record identifier
      8   8  Character    8  MRHDRTOD            Time at which this record was
                                                 built. In time-of-day (TOD) clock
                                                 format. See IBM System 370 XA
                                                 Principle of Operation for
                                                 explanation of format.
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END           End of header
     20  14  Character    6  STOATC_CPVOLSER     Volume serial identifier
     26  1A  Character    1  *                   Reserved for IBM use
     27  1B  Bitstring    1  STOATC_CALFLAGS     Flag byte
              1... ....      STOATC_FBA          When on, this device is a FBA
                                                 (Fixed Block Access) DASD.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     28  1C  Character    4  STOATC_CALTYPE      'PAGE' = paging space. 'SPOL' =
                                                 spooling space.
     32  20  Signed       4  STOATC_CALCYLNO     Space allocation. Number of
                                                 cylinders for a non-FBA DASD, or
                                                 number of pages for a FBA DASD.
                                                 See STOATC_FBA
     36  24  Signed       4  STOATC_CALSTART     Start of the paging or spooling
                                                 area. A cylinder number for a
                                                 non-FBA DASD, or a page number for
                                                 a FBA DASD. See STOATC_FBA
     40  28  Signed       4  STOATC_RDCPCYL      Number of pages per cylinder.
                                                 Not applicable for FBA devices.
                                                 See STOATC_FBA
     44  2C  Unsigned     4  STOATC_RDEVSID      Host subchannel id
     48  30  Character    0  STOATC_END

    MRSTOATC Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    MRHDR                   0     20
    MRHDR_END              14      0
    MRHDRDM                 4      1
    MRHDRLEN                0      2
    MRHDRRC                 6      2
    MRHDRTOD                8      8
    MRHDRZER                2      2
    STOATC                  0     48
    STOATC_CALCYLNO        20      4
    STOATC_CALFLAGS        1B      1
    STOATC_CALSTART        24      4
    STOATC_CALTYPE         1C      4
    STOATC_CPVOLSER        14      6
    STOATC_END             30      0
    STOATC_FBA             1B           80
    STOATC_MRHDR            0      0
    STOATC_RDCPCYL         28      4
    STOATC_RDEVSID         2C      4

    This information is
    based on z/VM V4R3.0.

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002