Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
SGTBK
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 * (0) DOUBLE WORD ALIGNMENT 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' ADD TO TOD CLOCK FOR RESTORE 000000FF SGTCKNEG X'FF' SUBTRACT FROM TOD CLOCK 00000080 SGTCKABS X'80' Use SGTCKRES as absolute clock value 0021 33 Bitstring 1 SGTITMST INTERVAL TIMER STATUS 00000000 SGTITMNI X'00' NO INTERVAL TIMER INTERRUPT 000000FF SGTITMIP X'FF' 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
(contains links to field and bit definitions)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
SGTLORES 0004
Last updated on 3 Aug 1999 at 12:31:53 EDT.
Copyright IBM Corporation, 1990, 1999