Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

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

(contains links to field and bit definitions)
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 VM/ESA 2.4.0.
Last updated on 3 Aug 1999 at 11:55:35 EDT.
Copyright IBM Corporation, 1990, 1999