|
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. |
TRQBK
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.
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)
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 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 * RESERVED FOR FUTURE IBM USE
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 |///////////////////////////| * +---------------------------+---------------------------+ * 30 * *** Overlay for TRQDQTOD in TRQBK
TRQBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----TRQACTIV 0010 40
TRQANCH 0010 01
TRQBIRA 0004
TRQBPNT 000C
TRQBTOD 0018
TRQBVAL 0020
TRQDQTOD 0028
TRQFBPNT 0008
TRQFPNT 0008
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
Last updated on 3 Aug 1999 at 13:40:10 EDT.
Copyright IBM Corporation, 1990, 1999