Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

TRQBK

Prolog  

Control Block Contents  
   TRQBK DSECT

Storage Layout  

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.
 RELOCATION CONSIDERATIONS : None

 

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 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

          
*** 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
-------------- ---- -----
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 V6R2.0. Last updated on 21 Nov 2011 at 11:28:00 EDT.
Copyright IBM Corporation, 1990, 2011