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
              and FINFVMCF which is serialized by the VMCF lock.

 

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' 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' 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 V4R2.0. Last updated on 17 Oct 2001 at 15:13:37 EDT.
Copyright IBM Corporation, 1990, 2001