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
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    68  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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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  Unsigned      4  STOATC_CALCYLNO        Deprecated: Use
                                                      STOATC_CALCYLNOG. Space
                                                      allocation. Number of
                                                      cylinders for a non-FBA DASD,
                                                      or number of pages for a FBA
                                                      DASD. If the value is too
                                                      large to fit in this 32-bit
                                                      field, then set to
                                                      x'FFFFFFFF'. See STOATC_FBA.
      36  24  Unsigned      4  STOATC_CALSTART        Deprecated: Use
                                                      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. If the value is too
                                                      large to fit in this 32-bit
                                                      field, then set to
                                                      x'FFFFFFFF'. 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  Unsigned      2  STOATC_RDEVDEV         Device number
      50  32  Unsigned      2  *                      Reserved and available for
                                                      IBM use.
      52  34  Unsigned      8  STOATC_CALCYLNOG       Space allocation. Number of
                                                      cylinders for a non-FBA DASD,
                                                      or number of pages for a FBA
                                                      DASD. See STOATC_FBA.
      52  34  Unsigned      4  STOATC_CALCYLNOG_HI
      56  38  Unsigned      4  STOATC_CALCYLNOG_LO
      60  3C  Unsigned      8  STOATC_CALSTARTG       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.
      60  3C  Unsigned      4  STOATC_CALSTARTG_HI
      64  40  Unsigned      4  STOATC_CALSTARTG_LO
      68  44  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     68
    STOATC_CALCYLNO           20      4
    STOATC_CALCYLNOG          34      8
    STOATC_CALCYLNOG_HI       34      4
    STOATC_CALCYLNOG_LO       38      4
    STOATC_CALFLAGS           1B      1
    STOATC_CALSTART           24      4
    STOATC_CALSTARTG          3C      8
    STOATC_CALSTARTG_HI       3C      4
    STOATC_CALSTARTG_LO       40      4
    STOATC_CALTYPE            1C      4
    STOATC_CPVOLSER           14      6
    STOATC_END                44      0
    STOATC_FBA                1B           80
    STOATC_MRHDR               0      0
    STOATC_RDCPCYL            28      4
    STOATC_RDEVDEV            30      2
    STOATC_RDEVSID            2C      4

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

    Last updated on 08 August 2020 at 21:31:32.

    Copyright IBM Corporation, 1990, 2020