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