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

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005