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 - 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
Copyright IBM Corporation, 1990, 2008