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

MRSTOASC

Prolog
Control Block Contents
Storage Layout
Cross Reference

MRSTOASC Prolog

 DSECT NAME - STOASC
 FUNCTION - This is an event record that is created when
          an address space is created.
 LOCATED BY -
      Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
      MRRECHDR    Monitor Record Header
 NAME - MRSTOASC
 DESCRIPTIVE NAME - Monitor Event Record
                  Domain 3  - Storage Domain
                  Record 12 - Address Space Created
 DESCRIPTION - Generated when an address space is created.


MRSTOASC Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)         Description
 
  0   0  Structure   64  STOASC              Start of monitor record
  0   0  Character    0  STOASC_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    8  STOASC_ASCUSRID     Owning userid, padded on the
                                             right with blanks.
 28  1C  Character   24  STOASC_ASCNAME      Address space name, padded on
                                             the right with blanks.
 52  34  Signed       4  STOASC_ASCSSIZE     Size of address space, in bytes.
                                             This field is kept for
                                             compatability reasons, but may not
                                             be accurate for 64-bit systems
                                             where larger address spaces are
                                             valid. The preferred field is
                                             STOASC_ASCDEFSZ.
 56  38  Character    8  STOASC_ASCDEFSZ     Defined address space size in
                                             addressable bytes, minus one. The
                                             minus one notation is used so that
                                             a total size of 16 Exabytes may be
                                             represented without ambiguity (as
                                             x'FFFFFFFF_FFFFFFFF').
 56  38  Character    4  STOASC_CALDEFHI     high four bytes
 60  3C  Character    4  STOASC_CALDEFLO     low four bytes
 64  40  Character    0  STOASC_END          

MRSTOASC 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
STOASC                  0     64
STOASC_ASCDEFSZ        38      8
STOASC_ASCNAME         1C     24
STOASC_ASCSSIZE        34      4
STOASC_ASCUSRID        14      8
STOASC_CALDEFHI        38      4
STOASC_CALDEFLO        3C      4
STOASC_END             40      0
STOASC_MRHDR            0      0

This information is based on z/VM V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001