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
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 z/Arch 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 V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003