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

#### MRMTRSTP

Prolog
Control Block Contents
Cross Reference

#### MRMTRSTP Prolog

     DSECT NAME - MTRSTP
     FUNCTION - Map a Monitor record.
     LOCATED By -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRSTP
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 1 - Monitor Domain
                        Record 22 - Server Time Protocol Event Record
     DESCRIPTION - Record of an STP state change event
     NOTES:
       The value of MTRSTP_STIEVENT specificies what STP event is taking
       place. These values are defined as follows:
       x'01' -  An STP Synch Check occurred.  As a result, STP is now
                in suspended mode, and I/O requiring a timestamp will
                be delayed until re-sync (unless XRC_OPTIONAL was
                specified in the configuration file).
                MTRSTP_STITODOF represents the old TOD offset that
                must be replaced by a re-sync.
       x'02' -  An STP Clock Source error occurred.  As a result, STP
                is now in suspended mode, and I/O requiring a timestamp
                will be delayed until re-sync (unless XRC_OPTIONAL was
                specified in the configuration file).
                MTRSTP_STITODOF represents the old TOD offset that
                must be replaced by a re-sync.
       x'03' -  A Timing Status change event occurred.  STP will remain
                active when this event occurs.
                MTRSTP_STITODOF represents the TOD offset that will
                continue to be used for timestamping.
       x'04' -  A Link Availability Change has been detected.  STP will
                remain active when this event occurs.  If the last link
                goes away, a machine check will follow.
                MTRSTP_STITODOF represents the TOD offset that will
                continue to be used for timestamping.
       x'05' -  Time Control Parameter Change event occurred.  STP will
                remain active when this event occurs, but this will
                cause a timezone change event (x'07') in the very
                near future.
                MTRSTP_STITODOF represents the TOD offset that will
                continue to be used for timestamping.
       x'06' -  STP synchronization has completed.  If any I/O has been
                delayed due to the suspended STP state, it will now be
                dequeued.
                MTRSTP_STITODOF represents the new TOD offset to
                be used for timestamping.
       x'07' -  STP time zone change occurred.
                MTRSTP_STIOLDTZ and MTRSTP_STIOLDOF represent the old
                timezone that has been replaced.
                MTRSTP_NEWTZNID and MTRSTP_NEWOFFST represent the new
                timezone that is now effect for the system.

#### MRMTRSTP Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    68  MTRSTP                 Start of monitor record
       0   0  Character     0  MTRSTP_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     1  MTRSTP_STIEVENT        Type of STP Event
      21  15  Character     7  *                      Reserved for IBM use
      28  1C  Character     8  MTRSTP_STITODOF        STP TOD offset
      36  24  Character     4  MTRSTP_STIOLDTZ        Old timzeone identifier
      40  28  Unsigned      4  MTRSTP_STIOLDOF        Old timezone offset
      44  2C  Character     4  MTRSTP_NEWTZNID        New timezone identifier
      48  30  Unsigned      4  MTRSTP_NEWOFFST        New timezone offset
      52  34  Character    16  *                      Reserved for IBM use
      68  44  Character     0  MTRSTP_END

#### MRMTRSTP 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
    MTRSTP                     0     68
    MTRSTP_END                44      0
    MTRSTP_MRHDR               0      0
    MTRSTP_NEWOFFST           30      4
    MTRSTP_NEWTZNID           2C      4
    MTRSTP_STIEVENT           14      1
    MTRSTP_STIOLDOF           28      4
    MTRSTP_STIOLDTZ           24      4
    MTRSTP_STITODOF           1C      8

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

    Last updated on 09 August 2020 at 14:24:23.

    Copyright IBM Corporation, 1990, 2020