|
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. |
SFXBK
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
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) 000000FF SFXIBNON 255 NO SOFTWARE ENABLE BIT 00000008 SFXIBVMC 8 VMCF INTERRUPTION BIT NO 0000000C SFXIBTZN 12 Normal timezone interruption bit number 0000000D SFXIBTZC 13 Control program timezone interruption bit number 0005 5 Address 1 SFXICR0B CR0 MASK BIT NUMBER (1-31) 000000FF SFXI0NON 255 NO CR0 ENABLEMENT BIT 00000013 SFXI0SYN 19 TOD SYNCH CHECK CR0 MASK BIT 00000013 SFXI0TZN 19 Dynamic timezone CR0 mask bit 00000016 SFXI0MSF 22 SERVICE PROCESSOR CR0 MASK BIT 00000016 SFXI0XC 22 ESA/XC external interruption CR0 mask bit 0000001F SFXI0VMC 31 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 CLASS 00 EXTERNAL INTERRUPTS (INTERRUPT KEY, INTERVAL TIMER) 00000010 EXTICL10 16 CLASS 10 EXTERNAL INTERRUPTS (TIMER, COMPARATOR, TOD SYNCH) 00000012 EXTICL12 18 CLASS 12 EXTERNAL INTERRUPTS (MULTI-CPU SIGNALS) 00000014 EXTICL14 20 CLASS 14 EXTERNAL INTERRUPTS (ETR INTERRUPTS) 00000020 EXTICL20 32 Class 20 external interrupts (Time zone transition) 00000024 EXTICL24 36 CLASS 24 EXTERNAL INTERRUPTS (SERVICE SIGNALS) 00000026 EXTICL26 38 CLASS 26 EXTERNAL INTERRUPTS (ESA/XC INTERRUPTS) 00000040 EXTICL40 64 CLASS 40 EXTERNAL INTERRUPTS (VMCF AND IUCV COMMUNICATION) 0007 7 Bitstring 1 SFXIEXCT EXTERNAL INTERRUPTION CLASS 00000040 EXTIKEY 64 CODE X'0040' INTERRUPT KEY 00000080 EXTITMR 128 CODE X'0080' 370 INTERVAL TIMER 00000003 EXTITSYN 03 CODE X'1003' TOD SYNCH CHECK 00000004 EXTICKC 04 CODE X'1004' CLOCK COMPARATOR 00000005 EXTICPU 05 CODE X'1005' CPU TIMER 00000000 EXTIMALF 00 CODE X'1200' MALFUNCTION ALERT 00000001 EXTIEMGS 01 CODE X'1201' EMERGENCY SIGNAL 00000002 EXTICALL 02 CODE X'1202' EXTERNAL CALL 00000006 EXTIETR 06 CODE X'1406' ETR INTERRUPT 00000004 EXTITZCH 04 CODE X'2004' Time Zone Change 00000001 EXTISVSG 01 CODE X'2401' SERVICE SIGNAL 00000002 EXTIPVM 02 CODE X'2402' PVM LOGICAL DEVICE 00000003 EXTIXC 03 CODE X'2603' ESA/XC INTERRUPTIONS 00000000 EXTIIUCV 00 CODE X'4000' IUCV INTERRUPTION 00000001 EXTIVMCF 01 CODE X'4001' VMCF INTERRUPTION 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
(contains links to field and bit definitions)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
EXTIPVM 0007 00000002
EXTISVSG 0007 00000001
EXTITMR 0007 00000080
EXTITSYN 0007 00000003
EXTITZCH 0007 00000004
EXTIVMCF 0007 00000001
EXTIXC 0007 00000003
SFXIBNON 0004 000000FF
SFXIBTZC 0004 0000000D
SFXIBTZN 0004 0000000C
SFXIBVMC 0004 00000008
SFXICALL 000C
SFXICMSK 0004
SFXICODE 0006
SFXICR0B 0005
SFXIEXCL 0006
SFXIEXCT 0007
SFXINEXT 0000
SFXIPARM 0008
SFXISFMB 0004
SFXISIZE 000C 00000002
SFXI0MSF 0005 00000016
SFXI0NON 0005 000000FF
SFXI0SYN 0005 00000013
SFXI0TZN 0005 00000013
SFXI0VMC 0005 0000001F
SFXI0XC 0005 00000016
Last updated on 3 Aug 1999 at 13:46:39 EDT.
Copyright IBM Corporation, 1990, 1999