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.3.0 Last updated on 22 Jun 2022 at 15:57:56 EDT.
Copyright IBM Corporation, 1990, 2022