|
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
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)
1111 1111 SFXIBNON 255 NO SOFTWARE ENABLE BIT
.... 1... SFXIBVMC 8 VMCF INTERRUPTION BIT NO
.... 11.. SFXIBTZN 12 Normal timezone interruption
bit number
.... 11.1 SFXIBTZC 13 Control program timezone
interruption bit number
0005 5 Address 1 SFXICR0B CR0 MASK BIT NUMBER (1-31)
1111 1111 SFXI0NON 255 NO CR0 ENABLEMENT BIT
...1 ..11 SFXI0SYN 19 TOD SYNCH CHECK CR0 MASK BIT
...1 ..11 SFXI0TZN 19 Dynamic timezone CR0 mask bit
...1 .11. SFXI0MSF 22 SERVICE PROCESSOR CR0 MASK BIT
...1 .11. SFXI0XC 22 ESA/XC external interruption
CR0 mask bit
...1 1111 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 and other
VM external interrupts
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
plus the last bit is used as a
flag to indicate whether the
routine whose address is in this
field is fullreg or not
000C 12 Bitstring 3 * First three bytes of call addr
000F 15 Bitstring 1 SFXICAL3 Last byte of call address
.... ...1 SFXICALF X'01' Indicates that the routine
whose address is in SFXICALL is a
fullreg routine. This bit must be
turned off before using the
address
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
*** Overlay for SFXICALL in SFXBK
*
* +--------------------+------+
* 8 ... C |////////////////////|:ICAL3|
* +--------------------+------+
* 10
*
*** Overlay for SFXICALL in SFXBK
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 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 SFXICALF 000F 01 SFXICALL 000C SFXICAL3 000F SFXICMSK 0004 SFXICODE 0006 SFXICR0B 0005 SFXIEXCL 0006 SFXIEXCT 0007 SFXINEXT 0000 SFXIPARM 0008 SFXISFMB 0004 SFXISIZE 000F 00000002 SFXI0MSF 0005 16 SFXI0NON 0005 FF SFXI0SYN 0005 13 SFXI0TZN 0005 13 SFXI0VMC 0005 1F SFXI0XC 0005 16
Copyright IBM Corporation, 1990, 2001