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

#### MRSTOADD

Prolog
Control Block Contents
Cross Reference

#### MRSTOADD Prolog

     DSECT NAME - STOADD
     FUNCTION - Map a Monitor record.
     LOCATED By -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTOADD
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 3 - Storage Domain
                        Record 21 - Add Central Storage
     DESCRIPTION - Generated whenever central storage is added to the
                   real memory configuration
     NOTES:

#### MRSTOADD Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   132  STOADD                 Start of monitor record
       0   0  Character     0  STOADD_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     8  STOADD_CALMEMAD        Amount of additional
                                                      permanent plus reconfigurable
                                                      storage in bytes
      28  1C  Character     8  STOADD_CALSXSAD        Number of bytes of
                                                      additional SXS storage
      36  24  Unsigned      8  STOADD_CALSXSTOTAL     Total amount of SXS
                                                      storage.
      44  2C  Unsigned      1  STOADD_CALHALTFLAG     Halt flag byte sourced
                                                      from DSRcode0:
                                                      3 - Halted by system
                                                      4 - Halted by user
                                                      5 - Internal failure
      45  2D  Character     3  *                      Reserved for IBM use
      48  30  Character     8  STOADD_DSRUSERID       Userid who issued the SET
                                                      STORAGE command to initiate
                                                      the reconfiguration.
      56  38  Character     8  STOADD_DSRHALTID       Userid who issued the SET
                                                      STORAGE HALT command
                                                      terminating the
                                                      reconfiguration.
      64  40  Unsigned      8  STOADD_CALPERMREQ      Amount of additional
                                                      permanent storage requested
                                                      in bytes
      72  48  Unsigned      8  STOADD_CALPERMADD      Amount of permanent storage
                                                      added in bytes
      80  50  Character     8  STOADD_SYSPERMA        Total amount of perm
                                                      storage after the
                                                      reconfiguration completed.
      88  58  Unsigned      8  STOADD_CALRECONFREQ    Amount of additional
                                                      reconfig storage requested in
                                                      bytes
      96  60  Unsigned      8  STOADD_CALRECONFADD    Amount of reconfig storage
                                                      added in bytes
     104  68  Character     8  STOADD_SYSRECNF        Total amount of reconfig
                                                      storage after the
                                                      reconfiguration completed.
     112  70  Character     8  STOADD_CALWALLTOD      Cumulative amount of
                                                      wall-clock time CP spent
                                                      communicating with the
                                                      machine to configure
                                                      partition storage for this
                                                      storage add operation.
     120  78  Unsigned      4  STOADD_RSAPZONESACTIVEB2G Resulting number of
                                                      perm available list zones in
                                                      storage < 2G.
     124  7C  Unsigned      4  STOADD_RSAPZONESACTIVEA2G Resulting number of
                                                      perm available list zones in
                                                      storage < 2G.
     128  80  Unsigned      4  STOADD_RSARZONESACTIVEA2G Resulting number of
                                                      reconf available list zones in
                                                      storage > 2G.
     132  84  Character     0  STOADD_END

#### MRSTOADD 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
    STOADD                     0    132
    STOADD_CALHALTFLAG        2C      1
    STOADD_CALMEMAD           14      8
    STOADD_CALPERMADD         48      8
    STOADD_CALPERMREQ         40      8
    STOADD_CALRECONFADD       60      8
    STOADD_CALRECONFREQ       58      8
    STOADD_CALSXSAD           1C      8
    STOADD_CALSXSTOTAL        24      8
    STOADD_CALWALLTOD         70      8
    STOADD_DSRHALTID          38      8
    STOADD_DSRUSERID          30      8
    STOADD_END                84      0
    STOADD_MRHDR               0      0
    STOADD_RSAPZONESACTIVEA2G 7C      4
    STOADD_RSAPZONESACTIVEB2G 78      4
    STOADD_RSARZONESACTIVEA2G 80      4
    STOADD_SYSPERMA           50      8
    STOADD_SYSRECNF           68      8

    This information is
    based on z/VM V7R2.0.

    Last updated on 06 August 2021 at 17:51:43.

    Copyright IBM Corporation, 1990, 2021