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 DSECT
Top of page

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
          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 - SOFTWARE EXTERNAL INTERRUPT CONTROL BLOCK
*
*     +---------------------------+------+------+------+------+
*   0 |         SFXINEXT          |:ISFMB|:ICR0B|:IEXCL|:IEXCT|
*     +---------------------------+------+------+------+------+
*   8 |         SFXIPARM          |         SFXICALL          |
*     +---------------------------+---------------------------+
*  10
*
*** SFXBK - SOFTWARE EXTERNAL INTERRUPT CONTROL BLOCK

 
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
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