|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
TRQBK
Control Block Contents
TRQBK DSECT
Cross Reference (Contains links to field and bit definitions)
TRQBK Prolog
NAME : HCPTRQBK
DESCRIPTION: TIMER REQUEST BLOCK
DSECT : TRQBK
FUNCTION : HCPTRQBK REPRESENTS A REQUEST FOR NOTIFICATION OF
A ROUTINE WHEN A PARTICULAR TOD CLOCK VALUE IS REACHED.
The un-expired TRQBKs are maintained by module HCPTRQ
enqueued in chains whose anchors reside in a "hash"
table.
See HCPTRQ prolog for serialization information.
LOCATED BY : TRQFPNT DOUBLY CHAINED (FORWARD)
TRQBPNT DOUBLY CHAINED (BACKWARD)
HCPTRQQ Start of "index" table, pointing to pages
of hash table containing pointers to TRQBKs.
BASETRQS ANCHOR IN MODULE HCPMIH (MIH TRQBKS ONLY)
GSRTRQBK FIELD OF HCPGSRBK (GUEST RECOVERY TIMER REQUEST)
PCSTIADD FIELD OF HCPPCSBK (PROCESSOR CONTROLLER INTERVAL)
RDEVTRQ FIELD OF HCPRDEV (CONTROL)
VMDTRQPT FIELD OF HCPVMDBK (GUEST TIMERS)
VMDTRQDL FIELD OF HCPVMDBK (DELAYED SLEEP OR LOGOFF)
VMDTRQQS FIELD OF HCPVMDBK (SCHEDULING)
VMDQIORF FIELD OF HCPVMDBK (PUSH-THRU STACK)
PFXCCTRQ FIELD OF HCPPFXPG (TRQBK for clock comp.)
Notes : The above list is probably not exhaustive.
CREATED BY : HCPBVM GUEST TIMER MANAGEMENT TRQBK DURING LOGON
HCPCFM TIMEOUT TO FORCE OFF DISCONNECTED USER
HCPCHM WAIT FOR CHANNEL TIMER TO SYNCHRONIZE WITH TOD
CLOCK
HCPCMX START SLEEP INTERVAL FOR SLEEP COMMAND
HCPGFS REDRIVE FULLSCREEN GRAPHICS TIMER
HCPGRF RESET ANY ACTIVE GRAPHICS TIMER
HCPGRF REDISPLAY LOGO AFTER LOGOFF
HCPIIO DEVICE INITIALIZATION TIMEOUT
HCPIOP MONITOR SYSTEM PERFORMANCE AT INTERVALS
(RESET IN HCPSTP)
HCPITM INTERVAL TO SEND MIDNIGHT MESSAGE
(RESET IN HCPMID)
HCPMIH DEVICE MISSING INTERRUPT DETECTION
HCPMPC PURGE STORAGE FOR PROCESSOR VARIED OFF
HCPMPC UNRESPONSIVE PROCESSOR DETECTION
HCPPCR UNRESPONSIVE PROCESSOR CONTROLLER DETECTION
HCPRDI MISSING I/O REQUEST DETECTION
HCPSTK SCHEDULING TRQBK DURING LOGON
Notes : The above list is probably not exhaustive.
DELETED BY : HCPCFM TIMEOUT TO FORCE OFF DISCONNECTED USER
HCPCHM WAIT FOR CHANNEL TIMER TO SYNCHRONIZE WITH TOD
CLOCK
HCPCMX END SLEEP INTERVAL FOR SLEEP COMMAND
HCPGRF DELETE ANY ACTIVE GRAPHICS TIMER
HCPIIO DEVICE INITIALIZATION TIMEOUT
HCPMPS PURGE STORAGE FOR PROCESSOR VARIED OFF
HCPMPC UNRESPONSIVE PROCESSOR DETECTION
HCPPCR UNRESPONSIVE PROCESSOR CONTROLLER DETECTION
HCPSTK SCHEDULING TRQBK DURING LOGOFF
HCPUSO GUEST TIMER MANAGEMENT TRQBK DURING LOGOFF
Notes : The above list is probably not exhaustive.
TRQBK Control Block Content
TRQBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure TRQBK TIMER REQUEST BLOCK
THIS BLOCK REPRESENTS A REQUEST FOR NOTIFICATION OF A ROUTINE WHEN A
PARTICULAR TOD CLOCK VALUE IS REACHED.
WARNING - THE FIRST THREE DOUBLE WORDS MUST BE IDENTICAL TO THE IORBK
COPY FILE.
0000 0 Signed 4 TRQUSER ADDRESS OF VMD BLOCK FOR USER
0004 4 Signed 4 TRQBIRA INTERRUPT RETURN ADDRESS
0008 8 Dbl-Word 8 TRQFBPNT (0) FOR REFERENCING BOTH POINTERS
0008 8 Signed 4 TRQFPNT POINTER TO NEXT TRQBK
000C 12 Signed 4 TRQBPNT POINTER TO PREVIOUS TRQBK
0010 16 Bitstring 1 TRQQSTAT TRQBK QUEUEING STATUS
1... .... TRQQUED X'80' TRQBK IS QUEUED FOR CLOCK
COMPARATOR
.1.. .... TRQACTIV X'40' TRQBK IS ACTIVE IN CLOCK
COMPARATOR
..1. .... TRQQDSP X'20' TRQBK IS STACKED FOR
DISPATCHING
.... ...1 TRQANCH X'01' THIS IS A TRQBK ANCHOR
0011 17 Bitstring 1 * RESERVED FOR FUTURE IBM USE
0012 18 Bitstring 1 TRQSCHED TRQBK SCHEDULING, UNSTACK FLAGS
1... .... TRQHIPRI X'80' REQUEST TO GRANT A VERY
HIGH DISPATCHER/SCHEDULER
PRIORITY FOR THE VMDBK IDENTIFIED
BY TRQUSER (THIS BIT IS NOT
CURRENTLY USED)
.1.. .... TRQUCALL X'40' UNSTACK TRQBK WITH
CALL-LINKAGE WHEN UNSTACKED BY
THE DISPATCHER
..1. .... TRQFULLR X'20' Target IRA is a fullreg
entry point.
.... ...1 TRQIDTRQ X'01' TRQBK IDENTIFIER (1=TRQBK,
0=IORBK)
0013 19 Bitstring 1 * RESERVED FOR FUTURE IBM USE
0014 20 Signed 4 * RESERVED FOR FUTURE IBM USE (END
OF IORBK/TRQBK COMMON FIELDS)
0018 24 Dbl-Word 8 TRQBTOD TOD CLOCK VALUE WHEN QUEUED (SET
BY THE CALLER IF DESIRED)
0020 32 Dbl-Word 8 TRQBVAL TOD CLOCK COMPARATOR VALUE FOR
TIME OF INTERRUPTION (REQUEST
VALUE SET BY CALLER).
0028 40 Dbl-Word 8 TRQDQTOD TOD CLOCK VALUE WHEN DEQUEUED
(Not stored until HCPTRQ dequeues
the TRQBK.)
0030 48 Signed 4 TRQWRK1 WORK AREA FOR REQUESTOR
0034 52 Signed 4 TRQWRK2 WORK AREA FOR REQUESTOR
00000007 TRQSIZE (*-TRQBK+7)/8 TRQBK SIZE IN
DOUBLE-WORDS
0028 40 Address 4 TRQQANCH Pointer to anchor of queue this
TRQBK is presently queued in.
002C 44 Signed 4 TRQCCPFX Absolute address of PFXPG when
clock comparator is committed to
this TRQBK.
TRQBK Storage Layout
*** TRQBK - TIMER REQUEST BLOCK
*
* +---------------------------+---------------------------+
* 0 | TRQUSER | TRQBIRA |
* +---------------------------+---------------------------+
* 8 | TRQFPNT | TRQBPNT |
* +------+------+------+------+---------------------------+
* 10 |:QSTAT|//////|:SCHED|//////|///////////////////////////|
* +------+------+------+------+---------------------------+
* 18 | TRQBTOD |
* +-------------------------------------------------------+
* 20 | TRQBVAL |
* +-------------------------------------------------------+
* 28 | TRQDQTOD |
* +---------------------------+---------------------------+
* 30 | TRQWRK1 | TRQWRK2 |
* +---------------------------+---------------------------+
* 38
*
*** TRQBK - TIMER REQUEST BLOCK
*** Overlay for TRQDQTOD in TRQBK
*
* +---------------------------+---------------------------+
* 28 | TRQQANCH | TRQCCPFX |
* +---------------------------+---------------------------+
* 30
*
*** Overlay for TRQDQTOD in TRQBK
TRQBK Cross Reference
Symbol Dspl Value -------------- ---- ----- TRQACTIV 0010 40 TRQANCH 0010 01 TRQBIRA 0004 TRQBPNT 000C TRQBTOD 0018 TRQBVAL 0020 TRQCCPFX 002C TRQDQTOD 0028 TRQFBPNT 0008 TRQFPNT 0008 TRQFULLR 0012 20 TRQHIPRI 0012 80 TRQIDTRQ 0012 01 TRQQANCH 0028 TRQQDSP 0010 20 TRQQSTAT 0010 TRQQUED 0010 80 TRQSCHED 0012 TRQSIZE 0034 00000007 TRQUCALL 0012 40 TRQUSER 0000 TRQWRK1 0030 TRQWRK2 0034
Copyright IBM Corporation, 1990, 2002