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