SGTBK Back to Index page
 
Prolog 
Control Block Contents 
   SGTBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  SGTBK Prolog Top of page
 
 NAME       : HCPSGTBK
 DESCRIPTION: SAVED GUEST TIMERS BLOCK
 DSECT      : SGTBK
 FUNCTION   : THE SAVED GUEST TIMER CONTROL BLOCK IS CREATED
              TO SAVE THE GUEST TIMERS AT THE TIME A NAMED
              SAVED SYSTEM IS CREATED AND USED TO RESTORE
              A GUEST'S TIMERS WHENEVER THAT SAVED SYSTEM
              IS INVOKED.
 LOCATED BY : POINTED TO BY REGISTER TWO IN HCPVTM.  PASSED BY
              REGISTER ONLY
 CREATED BY : HCPVTM
 DELETED BY : HCPNSE
 RELOCATION CONSIDERATIONS : None
 
 
  SGTBK Control Block Content Top of page
 

 SGTBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SGTBK SAVED GUEST TIMERS BLOCK 0000 0 Dbl-Word 8 SGTITRES (0) Interval timer residue counter 0000 0 Signed 4 SGTHIRES SAVED GUEST HIGH ORDER INTERVAL TIMER RESIDUE COUNTER 0004 4 Signed 4 SGTLORES SAVED GUEST LOW ORDER INTERVAL TIMER RESIDUE COUNTER 0008 8 Signed 8 SGTCPUTM SAVED GUEST CPU TIMER 0010 16 Signed 8 SGTEPOCH SAVED GUEST EPOCH SAVED GUEST TIME-OF-DAY EPOCH TO DEFINE DELTA BETWEEN HOST TOD CLOCK AND GUEST TOD CLOCK 0018 24 Signed 8 SGTCKRES (0) CLOCK COMPARATOR RESIDUE SAVED CLOCK COMPARATOR RESIDUE. THE DIFFERENCE BEWTEEN THE GUEST CLOCK COMPARATOR VALUE AND THE HOST TOD CLOCK 0018 24 Signed 4 SGTCKRS0 HIGH-ORDER WORD OF RESIDUE 001C 28 Signed 4 SGTCKRS4 LOW-ORDER WORD OF RESIDUE 0020 32 Bitstring 1 SGTCKDIR DIRECTION FOR CLOCK COMPARATOR CALCULATIONS. ZEROS MEAN THE CLOCK COMPARATOR RESIDUE SHOULD BE ADDED TO THE TIME OF DAY CLOCK WHEN RESTORING GUEST CLOCK COMPARATOR VALUE. FF'S MEAN SGTCKRES SHOULD BE SUBTRACTED FROM THE TIME OF DAY CLOCK FOR RESTORING THE CLOCK COMPARATOR, and X'80' means use SGTCKRES as the absolute clock comparator value. 00000000 SGTCKPOS X'00' SGTCKPOS ADD TO TOD CLOCK FOR RESTORE 000000FF SGTCKNEG X'FF' SGTCKNEG SUBTRACT FROM TOD CLOCK 00000080 SGTCKABS X'80' SGTCKABS Use SGTCKRES as absolute clock value 0021 33 Bitstring 1 SGTITMST INTERVAL TIMER STATUS 00000000 SGTITMNI X'00' SGTITMNI NO INTERVAL TIMER INTERRUPT 000000FF SGTITMIP X'FF' SGTITMIP INTERVAL TIMER INTERRUPT PENDING 0022 34 Signed 2 * RESERVED FOR FUTURE IBM USE 0024 36 Signed 4 * RESERVED FOR FUTURE IBM USE 00000005 SGTBSIZE (*-SGTBK+7)/8 BLOCK SIZE IN DOUBLE WORDS
 
 
  SGTBK Storage Layout Top of page
 
          
*** SGTBK - SAVED GUEST TIMERS BLOCK
*
*     +---------------------------+---------------------------+
*   0 |         SGTHIRES          |         SGTLORES          |
*     +---------------------------+---------------------------+
*   8 |                       SGTCPUTM                        |
*     +-------------------------------------------------------+
*  10 |                       SGTEPOCH                        |
*     +---------------------------+---------------------------+
*  18 |         SGTCKRS0          |         SGTCKRS4          |
*     +------+------+-------------+---------------------------+
*  20 |:CKDIR|:ITMST|/////////////|///////////////////////////|
*     +------+------+-------------+---------------------------+
*  28
*
*** SGTBK - SAVED GUEST TIMERS BLOCK
 
 
  SGTBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
SGTBSIZE       0024 00000005
SGTCKABS       0020 00000080
SGTCKDIR       0020
SGTCKNEG       0020 000000FF
SGTCKPOS       0020 00000000
SGTCKRES       0018
SGTCKRS0       0018
SGTCKRS4       001C
SGTCPUTM       0008
SGTEPOCH       0010
SGTHIRES       0000
SGTITMIP       0021 000000FF
SGTITMNI       0021 00000000
SGTITMST       0021
SGTITRES       0000
SGTLORES       0004
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:55:09 EDT.
Copyright IBM Corporation, 1990, 2022