Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM. |
FINBK
Control Block Contents
FINBK DSECT
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
Last updated on 5 Jun 2001 at 13:36:31 EDT.
Copyright IBM Corporation, 1990, 2001