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   52  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  Unsigned     2  STOATC_RDEVDEV         Device number
 50  32  Unsigned     2  *                      Reserved and available for
                                                IBM use.
 52  34  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     52
STOATC_CALCYLNO           20      4
STOATC_CALFLAGS           1B      1
STOATC_CALSTART           24      4
STOATC_CALTYPE            1C      4
STOATC_CPVOLSER           14      6
STOATC_END                34      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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004