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

    Last updated on 24 November 2010 at 10:59:41.

    Copyright IBM Corporation, 1990, 2010