|
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. |
WSDIRECT
Cross Reference (Contains links to field and bit definitions)
WSDIRECT Prolog
Name : HCPWSDIR
Description: vSIE shadow-table directory mapping
DSECT : WSDIRECT
Function : This copy file contains a DSECT used to map the vSIE
shadow-table directories.
Located by : VMDWSDIR in the vSIE VMDBK contains a vector of
anchors, each pointing to a directory for a
different type of shadow structure.
Created by : HCPWLB when a shadow structure is created.
Deleted by : HCPWLB when the shadow structures are destroyed.
Notes :
A shadow-table directory consists of a header and a fixed
number of entries, each entry describing one shadow
structure. The number of entries in a directory is fixed,
but may be different for each type of directory. See the
general comments in the prolog of HCPWLB for information
on how the number of entries was chosen.
References to the header are expected to be based on the
WSDIRHDR label. References to an entry are expected to be
based on the WSDIRENT label.
A directory exists for the following types of shadow
structures:
ALDS - access-list-designation source (DUCT or PASTE)
AL - access list
ASTE - ASN-second-table entry
ST - segment table
PT - page table
Each anchor word at VMDWSDIR in the vSIE VMDBK points to
the directory for one of these types of structures. The
first word points to the ALDS directory, the second word
points to the AL directory, etc.
No directory exists for frames.
The contents of a directory are serialized by CPU-level
serialization or higher on the Rguest VMDBK.
A different set of shadow structures are maintained for
each Rguest VMDBK.
WSDIRECT Control Block Content
WSDIRECT DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure WSDIRECT vSIE shadow-table directory mapping The following area maps the directory header. Code which references the header is expected to do a USING on the WSDIRHDR label. 0000 0 Dbl-Word 8 WSDIRHDR (0) Mapping for directory header 0000 0 Bitstring 1 WSDTYPE Code indicating type of directory 00000001 WLBALDS 1 Access-list-designation source 00000002 WLBAL 2 Access list 00000003 WLBASTE 3 ASN-second-table entry 00000004 WLBST 4 Segment table 00000005 WLBPT 5 Page table 00000006 WLBFRAME 6 Frame 0001 1 Bitstring 1 WSDHFLGS Header flags 1... .... WSDVMDSG X'80' Segment table in vSIE VMDBK is being used. Only meaningful in ST directory. 0002 2 Signed 2 WSDLLRSN Last last-reference-sequence-number (16-bit unsigned integer). 0004 4 Signed 4 WSDCTENT Count of entries in directory 0008 8 Signed 4 WSDCTUSE Count of entries in use 000C 12 Signed 4 * Reserved for IBM use 00000010 WSDHDLEN *-WSDIRHDR Length in bytes of the directory header. The following area maps an individual directory entry. Code which references an entry is expected to do a USING on the WSDIRENT label. 0010 16 Dbl-Word 8 WSDIRENT (0) Mapping of a single entry 0010 16 Bitstring 1 WSDFLAGS Flags defining state of entry 1... .... WSDFUSED X'80' Entry is in use EQU X'04' Defined below for ST directories EQU X'02' Defined below for ST directories EQU X'01' Defined below for ST directories 0011 17 Bitstring 1 * Reserved for IBM use 0012 18 Signed 2 WSDLRSN Last-reference sequence number 0014 20 Address 4 WSDHEADR Address of directory header 0018 24 Signed 4 WSDRGDES Rguest designation for entry 001C 28 Signed 4 WSDSHDES Shadow equivalent of designation 0020 32 Signed 4 WSDMISC (4) Miscellaneous information, different for different types of entries. 0030 48 Signed 2 WSDSHSIZ Size, in doublewords, of free-storage area used to contain shadow structure. For ST directory entries, this is the number of frames used for the segment table. 0032 50 Signed 2 WSDCTATT Count of higher-level shadow structures to which this structure is attached. 0034 52 Address 4 WSDREFID If nonzero, address of directory entry of higher-level structure to which this structure is attached. 0038 56 Address 4 WSDENTAD If WSDREFID is nonzero, address of entry in shadow structure to which this structure is attached. 003C 60 Signed 2 WSDCTVAL For structures which have multiple entries, the number of entries which are valid (in use). For structures which don't have multiple entties, a zero or one indicating whether there is a lower-level structure attached. 003E 62 Signed 2 * Reserved for IBM use 00000030 WSDENTLN *-WSDIRENT Length in bytes of a directory entry. Remapping of entry to define ALDS-specific fields. 0018 24 Signed 4 WSDRALDS Rguest ALDSO 001C 28 Signed 4 WSDSALDS Shadow ALDSO The WSDMISC, WSDCTATT, WSDREFID, and WSDENTAD fields are not significant in an ALDS directory entry. 00000005 WSDNMALD 5 Number of ALDSs to shadow 00000020 WSDSZALD (WSDHDLEN+WSDNMALD*WSDENTLN+7)/8 Size, in doublewords, of directory Remapping of entry to define AL-specific fields. 0018 24 Signed 4 WSDRALOL Rguest ALO and ALL combined as in ALD 001C 28 Signed 4 WSDSALOL Shadow ALO and ALL combined as in ALD The WSDMISC and WSDENTAD fields are not significant in an AL directory entry. 00000005 WSDNMAL 5 Number of ALs to shadow 00000020 WSDSZAL (WSDHDLEN+WSDNMAL*WSDENTLN+7)/8 Size, in doublewords, of directory Remapping of entry to define ASTE-specific fields. 0018 24 Signed 4 WSDRASTE Rguest ASTEO 001C 28 Signed 4 WSDSASTE Shadow ASTEO 0020 32 Signed 4 WSDRSTD Rguest STD from Rguest ASTE 0024 36 Signed 4 WSDRATO Rguest ATO from Rguest ASTE. The ATO in this field is aligned as it would be in the word that contains the ATO in an ASTE. 0028 40 Signed 4 WSDRATL Rguest ATL from Rguest ASTE. The ATL in this field is aligned as it would be in the word that contains the ATL in an ASTE. 002C 44 Signed 4 * Rest of WSDMISC not used 00000005 WSDNMAST 5 Number of ASTEs to shadow 00000020 WSDSZAST (WSDHDLEN+WSDNMAST*WSDENTLN+7)/8 Size, in doublewords, of directory Remapping of entry to define ST-specific fields. .... ...1 WSDFSTDC X'01' Entry was formed from a STD in an Rguest control register. .... ..1. WSDFSTDA X'02' Entry was formed from a STD in an Rguest ASTE. .... .1.. WSDFVMDS X'04' Segment table in vSIE VMDBK is being used as the shadow segment table for this directory entry. 0018 24 Signed 4 WSDRSTOL Rguest STO and STL combined as in STD 001C 28 Signed 4 WSDSSTOL Shadow STO and STL combined as in STD The WSDMISC and WSDENTAD fields are not significant in an ST directory entry. 00000005 WSDNMST 5 Number of STs to shadow 00000020 WSDSZST (WSDHDLEN+WSDNMST*WSDENTLN+7)/8 Size, in doublewords, of directory Remapping of entry to define PT-specific fields. 0018 24 Signed 4 WSDRPTOL Rguest PTO and PTL combined as in STE 001C 28 Signed 4 WSDSPTOL Shadow PTO and PTL combined as in STE The WSDMISC field is not significant in a PT directory entry. 00000023 WSDNMPT 35 Number of PTs to shadow 000000D4 WSDSZPT (WSDHDLEN+WSDNMPT*WSDENTLN+7)/8 Size, in doublewords, of directory
WSDIRECT Storage Layout
*** WSDIRECT - vSIE shadow-table directory mapping * * +------+------+-------------+---------------------------+ * 0 |:TYPE |:HFLGS| WSDLLRSN | WSDCTENT | * +------+------+-------------+---------------------------+ * 8 | WSDCTUSE |///////////////////////////| * +------+------+-------------+---------------------------+ * 10 |:FLAGS|//////| WSDLRSN | WSDHEADR | * +------+------+-------------+---------------------------+ * 18 | WSDRGDES | WSDSHDES | * +---------------------------+---------------------------+ * 20 | WSDMISC | * | | * +-------------+-------------+---------------------------+ * 30 | WSDSHSIZ | WSDCTATT | WSDREFID | * +-------------+-------------+-------------+-------------+ * 38 | WSDENTAD | WSDCTVAL |/////////////| * +---------------------------+-------------+-------------+ * 40 * *** WSDIRECT - vSIE shadow-table directory mapping *** Overlay for WSDRGDES in WSDIRECT * * +---------------------------+---------------------------+ * 18 | WSDRALDS | WSDSALDS | * +---------------------------+---------------------------+ * 20 * *** Overlay for WSDRGDES in WSDIRECT *** Overlay for WSDRGDES in WSDIRECT * * +---------------------------+---------------------------+ * 18 | WSDRALOL | WSDSALOL | * +---------------------------+---------------------------+ * 20 * *** Overlay for WSDRGDES in WSDIRECT *** Overlay for WSDRGDES in WSDIRECT * * +---------------------------+---------------------------+ * 18 | WSDRASTE | WSDSASTE | * +---------------------------+---------------------------+ * 20 | WSDRSTD | WSDRATO | * +---------------------------+---------------------------+ * 28 | WSDRATL |///////////////////////////| * +---------------------------+---------------------------+ * 30 * *** Overlay for WSDRGDES in WSDIRECT *** Overlay for WSDRGDES in WSDIRECT * * +---------------------------+---------------------------+ * 18 | WSDRSTOL | WSDSSTOL | * +---------------------------+---------------------------+ * 20 * *** Overlay for WSDRGDES in WSDIRECT *** Overlay for WSDRGDES in WSDIRECT * * +---------------------------+---------------------------+ * 18 | WSDRPTOL | WSDSPTOL | * +---------------------------+---------------------------+ * 20 * *** Overlay for WSDRGDES in WSDIRECT
WSDIRECT Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----WLBAL 0000 00000002
WLBALDS 0000 00000001
WLBASTE 0000 00000003
WLBFRAME 0000 00000006
WLBPT 0000 00000005
WLBST 0000 00000004
WSDCTATT 0032
WSDCTENT 0004
WSDCTUSE 0008
WSDCTVAL 003C
WSDENTAD 0038
WSDENTLN 003E 00000030
WSDFLAGS 0010
WSDFSTDA 002C 02
WSDFSTDC 002C 01
WSDFUSED 0010 80
WSDFVMDS 002C 04
WSDHDLEN 000C 00000010
WSDHEADR 0014
WSDHFLGS 0001
WSDIRENT 0010
WSDIRHDR 0000
WSDLLRSN 0002
WSDLRSN 0012
WSDMISC 0020
WSDNMAL 001C 00000005
WSDNMALD 001C 00000005
WSDNMAST 002C 00000005
WSDNMPT 001C 00000023
WSDNMST 001C 00000005
WSDRALDS 0018
WSDRALOL 0018
WSDRASTE 0018
WSDRATL 0028
WSDRATO 0024
WSDREFID 0034
WSDRGDES 0018
WSDRPTOL 0018
WSDRSTD 0020
WSDRSTOL 0018
WSDSALDS 001C
WSDSALOL 001C
WSDSASTE 001C
WSDSHDES 001C
WSDSHSIZ 0030
WSDSPTOL 001C
WSDSSTOL 001C
WSDSZAL 001C 00000020
WSDSZALD 001C 00000020
WSDSZAST 002C 00000020
WSDSZPT 001C 000000D4
WSDSZST 001C 00000020
WSDTYPE 0000
WSDVMDSG 0001 80
Last updated on 3 Aug 1999 at 13:49:21 EDT.
Copyright IBM Corporation, 1990, 1999