Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

SFXBK

Prolog  

Control Block Contents  
   SFXBK DSECT

Storage Layout  

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

This information is based on z/VM V4R2.0. Last updated on 17 Oct 2001 at 17:12:28 EDT.
Copyright IBM Corporation, 1990, 2001