TRQBK Back to Index page
 
Prolog 
Control Block Contents 
   TRQBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  TRQBK Prolog Top of page
 
 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.
 RELOCATION CONSIDERATIONS : None
 
 
  TRQBK Control Block Content Top of page
 

 TRQBK DSECT Top of page
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 When TRQBIRA gets control, R10 points to this TRQBK. 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' TRQQUED TRQBK IS QUEUED FOR CLOCK COMPARATOR ..1. .... TRQQDSP X'20' TRQQDSP TRQBK IS STACKED FOR DISPATCHING .... ...1 TRQANCH X'01' TRQANCH 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' TRQHIPRI REQUEST TO GRANT A VERY HIGH DISPATCHER/SCHEDULER PRIORITY FOR THE VMDBK IDENTIFIED BY TRQUSER (THIS BIT IS NOT CURRENTLY USED) .... ..1. TRQUCALL X'02' TRQUCALL UNSTACK TRQBK WITH CALL-LINKAGE WHEN UNSTACKED BY THE DISPATCHER .... .... TRQUGOTO X'00' TRQUGOTO UNSTACK TRQBK WITH GOTO-LINKAGE WHEN UNSTACKED BY THE DISPATCHER .... ...1 TRQIDTRQ X'01' TRQIDTRQ 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 Top of page
 
          
*** 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 Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
TRQANCH        0010 01
TRQBIRA        0004
TRQBPNT        000C
TRQBTOD        0018
TRQBVAL        0020
TRQCCPFX       002C
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 02
TRQUGOTO       0012 00
TRQUSER        0000
TRQWRK1        0030
TRQWRK2        0034
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:57:12 EDT.
Copyright IBM Corporation, 1990, 2022