Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
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 ContentsOffsets 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 ReferenceHex 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