Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SGTBK
Control Block Contents
SGTBK DSECT
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
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
Copyright IBM Corporation, 1990, 2001