SFXBK | Back to Index page

| Prolog Control Block Contents SFXBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

SFXBK Prolog | Top of page

     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 Control Block Content | Top of page

     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 Storage Layout | Top of page

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

    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

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:31:47 EDT.
Copyright IBM Corporation, 1990, 2020