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 V4R3.0. Last updated on 30 Apr 2002 at 18:26:10 EDT.
Copyright IBM Corporation, 1990, 2002