Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

SGTBK

Prolog  

Control Block Contents  
   SGTBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


SGTBK Prolog

 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

 

SGTBK Control Block Content


SGTBK DSECT

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

          
*** 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

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 V5R3.0. Last updated on 25 Jun 2007 at 17:26:16 EDT.
Copyright IBM Corporation, 1990, 2007