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.2.0 Last updated on 24 Jun 2020 at 09:31:22 EDT.
Copyright IBM Corporation, 1990, 2020