|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SFXBK
Control Block Contents
SFXBK DSECT
Cross Reference (Contains links to field and bit definitions)
SFXBK Prolog
NAME : HCPSFXBK
DESCRIPTION: SOFTWARE EXTERNAL INTERRUPT CONTROL BLOCK
DSECT : SFXBK
FUNCTION : HCPSFXBK MAINTAINS THE DATA REQUIRED FOR A GUEST EXTERNAL
INTERRUPT WHEN THE INTERRUPT IS PENDING. THERE ARE
THREE WAYS AN EXTERNAL INTERRUPT MAY REQUIRE THE USE
OF AN SFXBK.
1. WHEN AN EXTERNAL INTERRUPT IS GENERATED AS A RESULT
OF THE GUEST 'EXTERNAL' COMMAND.
2. WHEN CP GENERATES A SERVICE PROCESSOR EXTERNAL
INTERRUPT TO BE REFLECTED TO THE GUEST.
3. WHEN CP GENERATES A SOFTWARE EXTERNAL INTERRUPT
TO BE REFLECTED TO THE GUEST. A SOFTWARE INTERRUPT
IS ONE DEFINED BY THE ARCHITECTURE THAT IS ONLY
GENERATED BY THE SOFTWARE. IT IS NEVER HARDWARE
GENERATED.
LOCATED BY : SFXINEXT FORWARD CHAIN
VMDXTSFI FIELD OF HCPVMDBK (SOFTWARE EXTERNAL INTERRUPTS
AND INTERRUPTS FROM THE
EXTERNAL COMMAND)
(NON-FLOATING INTERRUPTS)
FINSFXQ FIELD OF HCPFINBK (FLOATING INTERRUPTS)
CREATED BY : HCPPCM FOR SERVICE PROCESSOR EXTERNAL INTERRUPTS
HCPSFI FOR SOFTWARE EXTERNAL INTERRUPTS
HCPVEX FOR EXTERNAL INTERRUPTS FROM THE EXTERNAL COMMAND
DELETED BY : HCPRST DELETES SFXBKS ANCHORED FROM VMDXTSFI FOR
SYSTEM RESET AND SIGP RESET FUNCTIONS
HCPSFI DELETES SFXBKS FROM EITHER CHAIN UPON
REQUEST
HCPPCM CALLED BY HCPRST TO DELETE SFXBKS ANCHORED
FROM FINSFXQ FOR THE SYSTEM RESET FUNCTION
HCPUSP DELETES ALL SFXBKS ANCHORED FROM FINSFXQ AS
PART OF THE LOGOFF FUNCTION
HCPVIX DELETES SFXBKS FROM EITHER CHAIN AS PART OF
REFLECTING THE INTERRUPT TO THE GUEST
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 LGRSFXBK 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.
SFXBK Control Block Content
SFXBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SFXBK SOFTWARE EXTERNAL INTERRUPT CONTROL BLOCK 0000 0 Signed 4 SFXINEXT POINTER TO NEXT SFXBK 0004 4 Signed 4 SFXICMSK (0) INTERRUPT CODES AND MASK VALUES 0004 4 Address 1 SFXISFMB SOFTWARE MASK BIT NUMBER (1-31) (Notes : These bits define flags that may be set in VMDSFIP1) 1111 1111 SFXIBNON 255 SFXIBNON NO SOFTWARE ENABLE BIT .... 1... SFXIBVMC 8 SFXIBVMC VMCF INTERRUPTION BIT NO .... 11.. SFXIBTZN 12 SFXIBTZN Normal timezone interruption bit number .... 11.1 SFXIBTZC 13 SFXIBTZC Control program timezone interruption bit number 0005 5 Address 1 SFXICR0B CR0 MASK BIT NUMBER (1-31) 1111 1111 SFXI0NON 255 SFXI0NON NO CR0 ENABLEMENT BIT ...1 ..11 SFXI0SYN 19 SFXI0SYN TOD SYNCH CHECK CR0 MASK BIT ...1 ..11 SFXI0TZN 19 SFXI0TZN Dynamic timezone CR0 mask bit ...1 .11. SFXI0MSF 22 SFXI0MSF SERVICE PROCESSOR CR0 MASK BIT ...1 .11. SFXI0XC 22 SFXI0XC ESA/XC external interruption CR0 mask bit ...1 1111 SFXI0VMC 31 SFXI0VMC VMCF CR0 MASK BIT 0006 6 Signed 2 SFXICODE (0) SOFTWARE EXTERNAL INTERRUPT CODE 0006 6 Bitstring 1 SFXIEXCL EXTERNAL INTERRUPTION CLASS 00000000 EXTICL00 00 EXTICL00 CLASS 00 EXTERNAL INTERRUPTS (INTERRUPT KEY, INTERVAL TIMER) 00000010 EXTICL10 16 EXTICL10 CLASS 10 EXTERNAL INTERRUPTS (TIMER, COMPARATOR, TOD SYNCH) 00000012 EXTICL12 18 EXTICL12 CLASS 12 EXTERNAL INTERRUPTS (MULTI-CPU SIGNALS) 00000014 EXTICL14 20 EXTICL14 CLASS 14 EXTERNAL INTERRUPTS (ETR INTERRUPTS) 00000020 EXTICL20 32 EXTICL20 Class 20 external interrupts (Time zone transition) 00000024 EXTICL24 36 EXTICL24 CLASS 24 EXTERNAL INTERRUPTS (SERVICE SIGNALS) 00000026 EXTICL26 38 EXTICL26 CLASS 26 EXTERNAL INTERRUPTS (ESA/XC INTERRUPTS) 00000040 EXTICL40 64 EXTICL40 CLASS 40 EXTERNAL INTERRUPTS (VMCF AND IUCV COMMUNICATION) 0007 7 Bitstring 1 SFXIEXCT EXTERNAL INTERRUPTION CLASS 00000040 EXTIKEY 64 EXTIKEY CODE X'0040' INTERRUPT KEY 00000080 EXTITMR 128 EXTITMR CODE X'0080' 370 INTERVAL TIMER 00000003 EXTITSYN 03 EXTITSYN CODE X'1003' TOD SYNCH CHECK 00000004 EXTICKC 04 EXTICKC CODE X'1004' CLOCK COMPARATOR 00000005 EXTICPU 05 EXTICPU CODE X'1005' CPU TIMER 00000000 EXTIMALF 00 EXTIMALF CODE X'1200' MALFUNCTION ALERT 00000001 EXTIEMGS 01 EXTIEMGS CODE X'1201' EMERGENCY SIGNAL 00000002 EXTICALL 02 EXTICALL CODE X'1202' EXTERNAL CALL 00000006 EXTIETR 06 EXTIETR CODE X'1406' ETR INTERRUPT 00000007 EXTIMEAS 07 EXTIMEAS Code X'1407' Measurement Alert 00000004 EXTITZCH 04 EXTITZCH CODE X'2004' Time Zone Change 00000001 EXTISVSG 01 EXTISVSG CODE X'2401' SERVICE SIGNAL 00000002 EXTIPVM 02 EXTIPVM CODE X'2402' PVM LOGICAL DEVICE 00000003 EXTIXC 03 EXTIXC CODE X'2603' ESA/XC and other VM external interrupts 00000000 EXTIIUCV 00 EXTIIUCV CODE X'4000' IUCV INTERRUPTION 00000001 EXTIVMCF 01 EXTIVMCF CODE X'4001' VMCF INTERRUPTION Important note concerning Guest Relocation: The next two fields, SFXIPARM and SFXICALL, have a special relationship which is relied upon for the purposes of guest relocation. If you are adding new function which will cause an address to be stored in SFXICALL, please first refer to the detailed explanation in the prologue of entry point RLGFSFX in module HCPRLG. 0008 8 Signed 4 SFXIPARM PARAMETER TO PASS CALLED ROUTINE 000C 12 Address 4 SFXICALL ADDRESS OF ROUTINE TO BE CALLED 00000002 SFXISIZE (*-SFXBK+7)/8 SIZE OF BLOCK IN DOUBLEWORDS
SFXBK Storage Layout
*** SFXBK - SOFTWARE EXTERNAL INTERRUPT CONTROL BLOCK
*
* +---------------------------+------+------+------+------+
* 0 | SFXINEXT |:ISFMB|:ICR0B|:IEXCL|:IEXCT|
* +---------------------------+------+------+------+------+
* 8 | SFXIPARM | SFXICALL |
* +---------------------------+---------------------------+
* 10
*
*** SFXBK - SOFTWARE EXTERNAL INTERRUPT CONTROL BLOCK
SFXBK Cross Reference
Symbol Dspl Value -------------- ---- ----- EXTICALL 0007 00000002 EXTICKC 0007 00000004 EXTICL00 0006 00000000 EXTICL10 0006 00000010 EXTICL12 0006 00000012 EXTICL14 0006 00000014 EXTICL20 0006 00000020 EXTICL24 0006 00000024 EXTICL26 0006 00000026 EXTICL40 0006 00000040 EXTICPU 0007 00000005 EXTIEMGS 0007 00000001 EXTIETR 0007 00000006 EXTIIUCV 0007 00000000 EXTIKEY 0007 00000040 EXTIMALF 0007 00000000 EXTIMEAS 0007 00000007 EXTIPVM 0007 00000002 EXTISVSG 0007 00000001 EXTITMR 0007 00000080 EXTITSYN 0007 00000003 EXTITZCH 0007 00000004 EXTIVMCF 0007 00000001 EXTIXC 0007 00000003 SFXIBNON 0004 FF SFXIBTZC 0004 0D SFXIBTZN 0004 0C SFXIBVMC 0004 08 SFXICALL 000C SFXICMSK 0004 SFXICODE 0006 SFXICR0B 0005 SFXIEXCL 0006 SFXIEXCT 0007 SFXINEXT 0000 SFXIPARM 0008 SFXISFMB 0004 SFXISIZE 000C 00000002 SFXI0MSF 0005 16 SFXI0NON 0005 FF SFXI0SYN 0005 13 SFXI0TZN 0005 13 SFXI0VMC 0005 1F SFXI0XC 0005 16
Copyright IBM Corporation, 1990, 2011