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 V7R3.0.

Last updated on 09 September 2022 at 13:17:05.
Copyright IBM Corporation, 1990, 2022