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

#### FINBK

Prolog

Control Block Contents
FINBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### FINBK Prolog

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

#### FINBK DSECT

    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

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

    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 V6R1.0. Last updated on 18 Feb 2010 at 08:40:19 EDT.
Copyright IBM Corporation, 1990, 2008