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