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

#### MRSTOREM

Prolog
Control Block Contents
Cross Reference

#### MRSTOREM Prolog

     DSECT NAME - STOREM
     FUNCTION - Map a Monitor record.
     LOCATED By -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTOREM
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 3 - Storage Domain
                        Record 23 - Central Storage Remove
     DESCRIPTION - Generated whenever central storage is removed
                   from the real memory configuration
     NOTES:

#### MRSTOREM Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   148  STOREM                 Start of monitor record
       0   0  Character     0  STOREM_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  Bitstring     1  STOREM_DSRFLAG0        Flag byte identifying
                                                      charactistics of the SET
                                                      STORAGE operation.
              1... ....        *
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        STOREM_DSRF0MAXF       MAXPAGEFULL operand
                                                      specified.
              .... ..1.        STOREM_DSRF0FORC       FORCE operand specified.
                                                      Valid only if the reconfig is
                                                      a remove operation.
              .... ...1        *
      21  15  Unsigned      1  STOREM_CALHALTFLAG     Halt byte sourced
                                                      from DSRcode0:
                                                      3 - Halted by system
                                                      4 - Halted by user
                                                      5 - Internal failure
      22  16  Character     1  STOREM_DSRWARNPC       MAXPAGEFULL percent used
                                                      for a storage removal
                                                      operation. This value was
                                                      requested using the
                                                      MAXPAGEFULL operand on the
                                                      SET STORAGE command, or
                                                      defaulted to the
                                                      paging-warning percent
                                                      established by the PAGING
                                                      WARNING system config
                                                      statement or a previous SET
                                                      PAGING WARNING command.
      23  17  Character     8  STOREM_DSRUSERID       Userid who issued the SET
                                                      STORAGE command to initiate
                                                      the reconfiguration.
      31  1F  Character     8  STOREM_DSRHALTID       Userid who issued the SET
                                                      STORAGE HALT command
                                                      terminating the
                                                      reconfiguration.
      39  27  Character     1  STOREM_DSRHALTPC       The anticipated paging-full
                                                      percent calculated by the
                                                      system causing the system to
                                                      halt the storage removal
                                                      operation prior to
                                                      completion.
      40  28  Character     8  STOREM_CALRECONFREQ    Amount of reconfigurable
                                                      storage to remove in bytes
      48  30  Character     8  STOREM_CALRECONFREM    Amount of reconfig storage
                                                      removed
      56  38  Character     8  STOREM_SYSRECNF        Total amount of reconfig
                                                      storage after the
                                                      reconfiguration completed.
      64  40  Unsigned      8  STOREM_CALWALLTOD      Cumulative amount of
                                                      wall-clock time CP spent
                                                      communicating with the
                                                      machine to deconfigure
                                                      partition storage for this
                                                      storage removal operation.
      72  48  Unsigned      4  STOREM_RSAPZONESACTIVEB2G Resulting number
                                                      of available list zones in
                                                      storage < 2G.
      76  4C  Unsigned      4  STOREM_RSAPZONESACTIVEA2G Resulting number
                                                      of available list zones in
                                                      storage < 2G.
      80  50  Unsigned      4  STOREM_RSARZONESACTIVEA2G Resulting number
                                                      of available reconfigurable
                                                      list zones in storage > 2G.
      84  54  Character     8  STOREM_DSRAVAILZONESVAC Number of available
                                                      list zones vacated
      92  5C  Unsigned      8  STOREM_DSRPAGESMOVED   Number of pages whose
                                                      content was moved out of a
                                                      vacating zone.
     100  64  Unsigned      8  STOREM_DSRPGSKPSER     Number of times pages were
                                                      skipped when vacating storage
                                                      because the necessary
                                                      serialization could not be
                                                      obtained.
     108  6C  Unsigned      8  STOREM_DSRPGSKPPIN     Number of times pages were
                                                      skipped because they were
                                                      pinned in storage.
     116  74  Unsigned      8  STOREM_DSRPGSKPFRM     Number of times pages were
                                                      skipped because there were no
                                                      frames available to move the
                                                      page content.
     124  7C  Unsigned      8  STOREM_DSRTOTVCFBKS    Number of Vacator Frame
                                                      Blocks (VCFBKs) obtained
                                                      during the storage removal
                                                      operation.
     132  84  Unsigned      8  STOREM_CALSXSTOTAL     Total amount of SXS
                                                      storage.
     140  8C  Character     8  STOREM_SYSPERMA        Total amount of PERM storage
                                                      after reconfiguration.
     148  94  Character     0  STOREM_END

#### MRSTOREM 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
    STOREM                     0    148
    STOREM_CALHALTFLAG        15      1
    STOREM_CALRECONFREM       30      8
    STOREM_CALRECONFREQ       28      8
    STOREM_CALSXSTOTAL        84      8
    STOREM_CALWALLTOD         40      8
    STOREM_DSRAVAILZONESVAC   54      8
    STOREM_DSRFLAG0           14      1
    STOREM_DSRF0FORC          14           02
    STOREM_DSRF0MAXF          14           04
    STOREM_DSRHALTID          1F      8
    STOREM_DSRHALTPC          27      1
    STOREM_DSRPAGESMOVED      5C      8
    STOREM_DSRPGSKPFRM        74      8
    STOREM_DSRPGSKPPIN        6C      8
    STOREM_DSRPGSKPSER        64      8
    STOREM_DSRTOTVCFBKS       7C      8
    STOREM_DSRUSERID          17      8
    STOREM_DSRWARNPC          16      1
    STOREM_END                94      0
    STOREM_MRHDR               0      0
    STOREM_RSAPZONESACTIVEA2G 4C      4
    STOREM_RSAPZONESACTIVEB2G 48      4
    STOREM_RSARZONESACTIVEA2G 50      4
    STOREM_SYSPERMA           8C      8
    STOREM_SYSRECNF           38      8

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

    Last updated on 06 August 2021 at 17:52:07.

    Copyright IBM Corporation, 1990, 2021