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

Last updated on 09 September 2022 at 13:12:05.
Copyright IBM Corporation, 1990, 2022