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 RELOCATION CONSIDERATIONS : This control block is relocated as part of a live guest relocation (LGR). The bits and fields that need to be relocated are defined in the corresponding LGRFINBK COPY file. Whenever changes are made to this control block, consideration must be given to any effects these changes will have on a relocation. If any new fields or bits are defined, they may need to be relocated. If existing bits or fields are changed, corresponding modifications may be required in the LGR version of this control block. Consider also the effects of these changes on a relocation involving a back-level release of CP. 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, 2011