|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
SCABK
Cross Reference (Contains links to field and bit definitions)
SCABK Prolog
Name : HCPSCABK
Description: System Control Area for Interpretive
Execution
DSECT : SCABK
Function : Map SCA for SIE virtual MP support
Located by : VMDISCAA in all VMDBKs of the virtual configuration
points to label SCASTART in this block.
*** NOTES : VMDISCAA does NOT point to
the front of the block.
Created by : HCPBIESC
Deleted by : HCPBIESC, HCPBIESR
Serialized :
The existence of the SCABK, and the contents of
its pointer, VMDISCAA, are serialized by console
function mode. SCAIPLOK is a formal lock.
SCAMCN is updated under Console-Function Mode.
SCAXCALL is updated either in Console-Function
Mode, or by compare-and-swap exclusive from CFM.
Comments :
The SCABK maps the architected System Control
Area for SIE, used in support of virtual
multiprocessing. In addition to the architected
block, the SCABK contains a header for CP use.
The size of the block is variable, depending on
the maximum CPU address defined in the virtual
configuration. Because architecture requires a
quadword boundary for the SCA, an extra
doubleword is allocated, and the SCABK is
installed beginning either 0 or 8 bytes into
the free-storage area, as needed to satisfy the
boundary requirement. To simplify storage
allocation, the actual start of the block is saved
in the CP prefix portion of the SCABK.
The SCABK is located by pointer VMDISCAA in all
VMDBKs of the virtual configuration. VMDISCAA
points to the architected SCA, at label SCASTART,
NOT to the CP header at the front of the SCABK,
nor to the start of the free-storage block.
SCABK Control Block Content
SCABK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SCABK System Control Area for Interpretive Header for CP software use Notes : This area must be an integral number of doublewords. 0000 0 Address 4 SCAFSADR Start address of containing free storage block 0004 4 Signed 2 SCAMXCPU Maximum virtual CPU address in configuration 0006 6 Signed 2 * Reserved for future IBM use 0008 8 Signed 4 * (2) Reserved for future IBM use Architected System Control Area 0010 16 Unknown ? SCASTART (0) *** True SCA begins here *** 0010 16 Bitstring 1 SCAIPLK0 (0) Redefinition of IPTE Interlock (below): 1... .... SCAIPLKH X'80' IPTE interlock is held 0010 16 Dbl-Word 8 SCAIPLOK (3) IPTE interlock 0028 40 Dbl-Word 8 * Reserved for future IBM use 0030 48 Dbl-Word 8 * (2) Reserved for future IBM use 0040 64 Dbl-Word 8 SCAMCN Mask of valid virtual CPU addrs for SIGP interpretation (may be a subset of defined virtual CPUs) 0048 72 Dbl-Word 8 * Reserved for future IBM use 0000000B SCAFSIZE (*-SCABK+15)/8 Fixed size for free-storage allocation (includes CP header, architected header, and an extra doubleword to allow quadword alignment) 0050 80 Unknown ? SCACPU (0) CPU descriptor (one slot per virtual CPU addr): 0050 80 Signed 4 SCAXCWRD (0) Word for Compare-and-Swap 0050 80 Bitstring 1 * Reserved for future IBM use 0051 81 Bitstring 1 SCAXCALL External-call state: 1... .... SCAXCPND X'80' ..external call pending ..11 1111 SCAXCCPU X'3F' ..mask to isolate sending CPU addr 0052 82 Bitstring 1 * (2) Reserved for future IBM use 00000010 SCAXCSHF 8*(*-SCAXCALL-1) Number of bits to shift SCAXCALL left to install it into SCAXCWRD 0054 84 Address 4 SCASDESC Pointer to state description, or zero if virtual CPU not defined 0058 88 Signed 4 * (2) Reserved for future IBM use 00000010 SCACLEN *-SCACPU Length of one SCACPU entry 00000002 SCACSIZE (SCACLEN+7)/8 Size in doublewords 00000004 SCACPUSB 4 Shift-count to convert CPU addr to offset into SCACPU array (SCACLEN = 2**SCACPUSB) 00000001 SCACPUSD SCACPUSB-3 Shift count to convert CPU addr to number of doublewords (SCACSIZE = 2**SCACPUSD)
SCABK Storage Layout
*** SCABK - System Control Area for Interpretive * * +---------------------------+-------------+-------------+ * 0 | SCAFSADR | SCAMXCPU |/////////////| * +---------------------------+-------------+-------------+ * 8 |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 10 | | * = SCAIPLOK = * | | * +-------------------------------------------------------+ * 28 |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 30 |///////////////////////////////////////////////////////| * |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 40 | SCAMCN | * +-------------------------------------------------------+ * 48 |///////////////////////////////////////////////////////| * +------+------+-------------+---------------------------+ * 50 |//////|:XCALL|/////////////| SCASDESC | * +------+------+-------------+---------------------------+ * 58 |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 60 * *** SCABK - System Control Area for Interpretive
SCABK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----SCACLEN 0058 00000010
SCACPU 0050
SCACPUSB 0058 00000004
SCACPUSD 0058 00000001
SCACSIZE 0058 00000002
SCAFSADR 0000
SCAFSIZE 0048 0000000B
SCAIPLKH 0010 80
SCAIPLK0 0010
SCAIPLOK 0010
SCAMCN 0040
SCAMXCPU 0004
SCASDESC 0054
SCASTART 0010
SCAXCALL 0051
SCAXCCPU 0051 3F
SCAXCPND 0051 80
SCAXCSHF 0052 00000010
SCAXCWRD 0050
Last updated on 3 Aug 1999 at 12:29:09 EDT.
Copyright IBM Corporation, 1990, 1999