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 V6R1.0. Last updated on 18 Feb 2010 at 09:04:26 EDT.
Copyright IBM Corporation, 1990, 2008