FINBK Back to Index page
 
Prolog 
Control Block Contents 
   FINBK 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.


  FINBK Prolog Top of page
 
 NAME       : HCPFINBK
 DESCRIPTION: FLOATING EXTERNAL INTERRUPT CONTROL BLOCK
 DSECT      : FINBK
 FUNCTION   : HCPFINBK MAINTAINS A GUESTS FLOATING EXTERNAL INTERRUPTS
              WHEN THE INTERRUPTS ARE PENDING.  GUEST FLOATING EXTERNAL
              INTERRUPTS ARE INTERRUPTS THAT MAY BE PRESENTED TO ANY
              CPU IN THE VIRTUAL CONFIGURATION.
 LOCATED BY : VMDFIN    FIELD OF HCPVMDBK  (FLOATING INTERRUPTIONS)
 CREATED BY : HCPBVM   FOR A BASE VMDBK.  NON-BASE VMDBKS ARE ASSIGNED
              THE ADDRESS OF THE BASE FINBK
 DELETED BY : HCPUSO   DELETES THE FINBK WHEN A BASE VMDBK LOGS OFF
 RELOCATION CONSIDERATIONS : This control block is relocated as part of a live
              guest relocation (LGR).  The bits and fields that
              need to be relocated are defined in the
              corresponding LGRFINBK COPY file.  Whenever changes
              are made to this control block, consideration must
              be given to any effects these changes will have on
              a relocation.  If any new fields or bits are
              defined, they may need to be relocated.  If
              existing bits or fields are changed, corresponding
              modifications may be required in the LGR version of
              this control block.  Consider also the effects of
              these changes on a relocation involving a back-level
              release of CP.
 SERIALIZED : All fields in the FINBK are serialized by the FINBK lock
              except for
              - FINFIUCV which is serialized by the IUCV lock
              - FINFVMCF which is serialized by the VMCF lock
              - FINPCRBZ which is serialized by
              - Compare-And-Swap
              - Being touched by NONMP modules
 
 
  FINBK Control Block Content Top of page
 

 FINBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure FINBK FLOATING EXTERNAL INTERRUPT CONTROL BLOCK 0000 0 Dbl-Word 8 FINLOCK (3) LOCKWORD FOR THIS BLOCK 0018 24 Signed 4 FINSFXQ QUEUE ANCHOR FOR SFXBKS REPRESENTING FLOATING EXTERNAL INTERRUPTIONS 001C 28 Signed 4 FINPCRBZ VMDBK ADDRESS OF VIRTUAL CPU USING PROCESSOR CONTROLLER 0020 32 Signed 4 FINPCDBA PROCESSOR CONTROLLER DATA BLOCK ADDRESS FOR PREFERRED VIRTUAL MACHINE RECOVERY FINFIPND is used as a fast interrupt polling mechanism. Currently IUCV uses byte 0 and VMCF uses byte 1 of this word. Future users should define their own byte following FINFVMCF in the two bytes reserved for this use. 0024 36 Signed 4 FINFIPND (0) Fastpath interruption pending word Each function must serialize updates to its byte. They are not necessarily serialized by the FINLOCK. 0024 36 Bitstring 1 FINFIUCV IUCV fastpath interruption flag serialized during updates by the IUCV lock 1... .... FINFPIUC X'80' FINFPIUC An IUCV interruption is pending 0025 37 Bitstring 1 FINFVMCF VMCF fastpath interruption flag serialized during updates by the VMCF lock 1... .... FINFPVMC X'80' FINFPVMC A VMCF interruption is pending 0026 38 Bitstring 1 * (2) Reserved for future interrupt use 00000005 FINSIZE (*-FINBK+7)/8 SIZE OF FINBK
 
 
  FINBK Storage Layout Top of page
 
          
*** FINBK - FLOATING EXTERNAL INTERRUPT CONTROL BLOCK
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       FINLOCK                         =
*     |                                                       |
*     +---------------------------+---------------------------+
*  18 |         FINSFXQ           |         FINPCRBZ          |
*     +---------------------------+------+------+-------------+
*  20 |         FINPCDBA          |:FIUCV|:FVMCF|/////////////|
*     +---------------------------+------+------+-------------+
*  28
*
*** FINBK - FLOATING EXTERNAL INTERRUPT CONTROL BLOCK
 
 
  FINBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
FINFIPND       0024
FINFIUCV       0024
FINFPIUC       0024 80
FINFPVMC       0025 80
FINFVMCF       0025
FINLOCK        0000
FINPCDBA       0020
FINPCRBZ       001C
FINSFXQ        0018
FINSIZE        0026 00000005
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:50:31 EDT.
Copyright IBM Corporation, 1990, 2022