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 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 - FLOATING EXTERNAL INTERRUPT CONTROL BLOCK
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       FINLOCK                         =
*     |                                                       |
*     +---------------------------+---------------------------+
*  18 |         FINSFXQ           |         FINPCRBZ          |
*     +---------------------------+------+------+-------------+
*  20 |         FINPCDBA          |:FIUCV|:FVMCF|/////////////|
*     +---------------------------+------+------+-------------+
*  28
*
*** FINBK - FLOATING EXTERNAL INTERRUPT CONTROL BLOCK

 
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