|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SXODABK
Control Block Contents
SXODABK DSECT
Cross Reference (Contains links to field and bit definitions)
SXODABK Prolog
NAME : HCPSXOBK
DESCRIPTION: DIAGNOSE X'64' SEGMENT EXTENDED OUTPUT AREA
DSECT : SXODABK
FUNCTION : THIS BLOCK WILL MAP THE SEGMENT EXTENDED OUTPUT AREA
FOR DIAGNOSE X'64' SUBCODES X'18' and X'38'.
LOCATED BY : THE POINTER TO THIS AREA IS PROVIDED BY THE
SXIOAREA FIELD OF HCPSXIBK COPY. IT IS A USER SUPPLIED
AREA THAT MUST BE ON A DOUBLEWORD BOUNDARY AND CANNOT
CROSS A PAGE BOUNDARY.
CREATED BY : THE RX REGISTER OF DIAGNOSE X'64' SUBCODES
X'18' AND X'38' IS SETUP BY THE USER TO POINT
TO A USER SUPPLIED BUFFER. WITHIN THAT USER
SUPPLIED BUFFER, THE USER PROVIDES THE ADDRESS
OF THIS AREA WITHIN THE SXIOAREA FIELD OF
HCPSXIBK COPY.
- THIS BUFFER MUST RESIDE ON A DOUBLEWORD BOUNDARY AND
CANNOT CROSS A PAGE BOUNDARY.
DELETED BY : THIS AREA IS USER SUPPLIED AND USER DELETED.
RELOCATION CONSIDERATIONS : None
COMMENTS : The old SXOBK format (with 32-bit wide address
fields) can only be used by the subcode X'18',
which can only be used to obtain information on
below 2G segments/spaces. The new format (with
64-bit wide address fields) and corresponding
subcode X'38' must be used for above 2G DCSSs.
(However, the new subcode X'38' and format
can of course be used to obtain information on
below 2G segments/spaces)
SXODABK Control Block Content
SXODABK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SXODABK DIAGNOSE X'64' SEGMENT EXTENDED OUTPUT AREA 0000 0 Dbl-Word 8 * (0) 0000 0 Signed 4 SXOLSBA BEGINNING ADDRESS OF THE SEGMENT SPACE. THE ADDRESS OF THE MEGABYTE BOUNDARY CONTAINING THE LOWEST PAGE DEFINITION OF THE SEGMENT SPACE IS RETURNED. 0004 4 Signed 4 SXOLSEA ENDING ADDRESS OF THE SEGMENT SPACE. THE LAST ADDRESS OF THE MEGABYTE IN WHICH THE PAGE WITH THE HIGHEST DEFINITION RESIDES IS RETURNED. 0008 8 Character 8 SXOLSNAM NAME OF THE SEGMENT SPACE THAT CONTAINS THE REQUESTED SAVED SEGMENT 0010 16 Dbl-Word 8 SXOASM2 (128) PAGE RANGE INFORMATION 1... .... SXOPRMAX 128 SXOPRMAX THE MAXIMUM NUMBER OF PAGE RANGE ENTRYS THIS IS THE START OF A 1024 BYTE PAGE RANGE INFORMATION TABLE THAT CONTAINS DOUBLE WORD ENTRIES THAT ARE BROKEN DOWN INTO A START AND END ADDRESS RANGE DEFINITION. THE ATTRIBUTE OF THE PAGE RANGE DEFINITION IS CONTAINED IN THE 4TH BYTE OF THE ENTRY. THE PAGE RANGE ENTRIES ARE ORDERED FROM LOWEST VALUE TO HIGHEST VALUE. A MAXIMUM OF 128 PAGE RANGE ENTRIES MAY BE PLACED IN THIS TABLE. *** REDEFINITION 0010 16 Signed 4 SXORANS FIRST RANGE OF THE PAIR THIS FIELD WILL CONTAIN A FLAG RIGHTMOST BYTE. 0010 16 Bitstring 3 SXORGST THE HIGH ORDER THREE BYTES OF THE START PAGE RANGE ENTRY DEFINITION. TO PRODUCE A VALID START PAGE ADDRESS, THIS VALUE MUST BE PLACED IN THE HIGH ORDER 3 BYTES OF A REGISTER AND THE LOW ORDER BYTE OF THE REGISTER MUST BE SET TO 0. 0013 19 Bitstring 1 SXOPRAT PAGE RANGE STORAGE TYPE FLAG .... ...1 SXOEXCL X'01' SXOEXCL THIS BIT INDICATES SEGMENTS THAT MAY NOT BE SHARED AMONG SEVERAL USERS. EACH USER GETS A SEPARATE COPY OF THIS SEGMENT. .... ..1. SXOPROT X'02' SXOPROT THIS BIT INDICATES PAGE RANGES THAT ARE PAGE PROTECTED. USERS MAY ACCESS THESE PAGES ONLY IN READ-ONLY MODE. .... .1.. SXONDAT X'04' SXONDAT THIS BIT INDICATES PAGE RANGES WHOSE DATA IS NOT SAVED INTO THE SDF (NO DATA). HOW PAGE DESCRIPTOR CODES CORRESPOND TO SETTINGS OF SXOPRAT: noformat CODE SXOPRAT SXONDAT SXOPROT SXOEXCL SW 000 0=DATA 0=UNPROTECTED (READ/WRITE) 0=SHARED EW 001 0=DATA 0=UNPROTECTED (READ/WRITE) 1=EXCLUSIVE SR 010 0=DATA 1=PROTECTED (READ-ONLY) 0=SHARED ER 011 0=DATA 1=PROTECTED (READ-ONLY) 1=EXCLUSIVE SN 100 1=NODATA 0=UNPROTECTED (READ/WRITE) 0=SHARED EN 101 1=NODATA 0=UNPROTECTED (READ/WRITE) 1=EXCLUSIVE SC 110 1=NODATA 1=PROTECTED (READ-ONLY) 0-SHARED enoformat .... .... SXORNGSW 0 SXORNGSW RANGE FLAG VALUE FOR 'SW' .... ...1 SXORNGEW SXOEXCL SXORNGEW RANGE FLAG VALUE FOR 'EW' .... ..1. SXORNGSR SXOPROT SXORNGSR RANGE FLAG VALUE FOR 'SR' .... ..11 SXORNGER SXOPROT+SXOEXCL SXORNGER RANGE FLAG VALUE FOR 'ER' .... .1.. SXORNGSN SXONDAT SXORNGSN RANGE FLAG VALUE FOR 'SN' .... .1.1 SXORNGEN SXONDAT+SXOEXCL SXORNGEN RANGE FLAG VALUE FOR 'EN' .... .11. SXORNGSC SXONDAT+SXOPROT SXORNGSC RANGE FLAG VALUE FOR 'SC' 0014 20 Signed 4 SXORANE LAST PAGE OF THE RANGE 0014 20 Bitstring 3 SXORGEND THE HIGH ORDER THREE BYTES OF THE END PAGE RANGE ENTRY DEFINITION. TO PRODUCE A VALID END PAGE ADDRESS, THIS VALUE MUST BE PLACED IN THE HIGH ORDER 3 BYTES OF A REGISTER AND THE LOW ORDER BYTE OF THE REGISTER MUST BE SET TO X'F'. 0017 23 Bitstring 1 * RESERVED FOR IBM USE 00000003 SXOSIZE (*-SXODABK+7)/8 SIZE IN DOUBLE WORDS THIS IS THE RE-DEFINITION FOR, DIAGNOSE X'64' SUBCODE X'18' OPERATION CODES X'02' - FINDSKEL X'0C' - FINDSEG OUTPUT AREA. 0000 0 Signed 4 SXOSKBA BEGINNING ADDRESS OF THE SKELETON SEGMENT OR THE ACTIVE SEGMENT. IF THE REQUEST WAS FOR A MEMBER SAVED SEGMENT, THEN THE ADDRESS RETURNED IS THE LOWEST PAGE VALUE DEFINED FOR THE MEMBER. IF THE REQUEST WAS FOR A SAVED SEGMENT, THEN THE LOWEST PAGE VALUE DEFINED FOR THE SAVED SEGMENT IS RETURNED. IF THE REQUEST WAS FOR A SEGMENT SPACE THEN THE BEGINNING ADDRESS OF A SEGMENT SPACE RETURNED IS THE FIRST BYTE OF THE PAGE WITH THE LOWEST SPECIFIED VALUE DEFINED BY ONE OF IT'S MEMBERS. 0004 4 Signed 4 SXOSKEA ENDING ADDRESS OF THE SKELETON SEGMENT OR THE ACTIVE SEGMENT. IF THE REQUEST WAS FOR A MEMBER SAVED SEGMENT, THEN THE ADDRESS RETURNED IS THE HIGHEST PAGE VALUE DEFINED FOR THE MEMBER. IF THE REQUEST WAS FOR A SAVED SEGMENT, THEN THE HIGHEST PAGE VALUE DEFINED FOR THE SAVED SEGMENT IS RETURNED. IF THE REQUEST WAS FOR A SEGMENT SPACE THEN, THE ENDING ADDRESS OF A SEGMENT SPACE RETURNED IS THE LAST BYTE OF THE PAGE WITH THE HIGHEST SPECIFIED VALUE DEFINED BY ONE OF IT'S MEMBERS. 0008 8 Signed 4 SXORGCT A COUNT OF THE VALID PAGE RANGE ENTRY PAIRS (SXORGST AND SXORGEND) 000C 12 Signed 4 SXORGCTA A COUNT OF THE VALID PAGE RANGE ENTRY PAIRS (SXORGST AND SXORGEND) THAT WERE ACTUALLY PLACED IN THE OUTPUT PAGE RANGE TABLE. THIS MAY BE USED WHEN THE OUTPUT BUFFER PROVIDED WAS NOT LARGE ENOUGH TO CONTAIN ALL THE PAGE RANGE ENTRIES THAT WERE AVAILABLE (SXORGCT). 0010 16 Character 8 SXOMSSNM Name of member. 0018 24 Signed 4 SXOMEMST Member's lowest page range. 001C 28 Signed 4 SXOMEMEN Member's highest page range. 00000010 SXONTSZM *-SXOASM2 Size of a member entry. 0020 32 Signed 4 SXOMSNXT (0) Next entry. This is the definition for, Diagnose x'64' subcode x'38' operation code x'01' output area. 0000 0 Dbl-Word 8 SXOLSBAG 64-bit beginning address of the segment space. The address is on a megabyte boundary containing the lowest page definition of the segment space. 0008 8 Dbl-Word 8 SXOLSEAG 64-bit ending address of the segment space. The last address of the megabyte where the page with the highest definition resides. 0010 16 Character 8 SXOLSNMG Name of the segment space that contains the required saved segment This is definition of page range information for, Diagnose x'64' subcode x'38' operation codes x'02' - FINDSKEL x'0C' - FINDSEG output area. 0018 24 Dbl-Word 8 SXOASMG2 (128) Page range information .1.. .... SXOPRMXG 64 SXOPRMXG The maximum number of page range entries This is the start of a 1024 byte page range information table that contains 16-byte entries. Each entry consists 2 8-byte addresses with some bits in byte 7 of each. The attribute of the page range definition is contained in the 8th byte of the entry. The page range entries are ordered from lowest value to highest value. A maximum of 64 page range entries may be placed in this table. *** REDEFINITION 0018 24 Dbl-Word 8 SXORANSG First range of the pair This field will contain a flag rightmost byte 0018 24 Bitstring 7 SXORGSTG The high order seven bytes of the start page range entry definition. To produce a valid start page address, this value must be placed in the high order 7 bytes of a register and the low order byte of the register must be set to 0 001F 31 Bitstring 1 SXOPRATG Page range storage type flag, which has same bit definition as SXOPRAT 0020 32 Dbl-Word 8 SXORANEG Last page of the range 0020 32 Bitstring 7 SXORGENG The high order seven bytes of the end page range entry definition. To produce a valid end address of the range, this value must be placed in the high order 7 bytes of a register and the low order byte of the register must be set to X'FF' 0027 39 Bitstring 1 * Reserved for IBM use 00000005 SXOSIZEG (*-SXODABK+7)/8 Size in double words This is the re-definition for, Diagnose x'64' subcode x'38' operation codes x'02' - FINDSKEL x'0C' - FINDSEG output area. 0000 0 Dbl-Word 8 SXOSKBAG 64-bit beginning address of the skeleton segment or the active segment. If the request was for a member saved segment, then the address returned is the lowest page value defined for the member. If the request was for a segment space then the beginning address of a segment space returned is the first byte of the page with the lowest specified value defined by one of its members 0008 8 Dbl-Word 8 SXOSKEAG 64-bit ending address of the skeleton segment or the active segment. If the request was for a member saved segment, then the address returned is the highest page value defined for the member. If the request was for a saved segment, then the highest page value defined in the saved segment is returned. If the request was for a segment space, then the ending address of a segment space returned is the last byte of the page with the highest specified value defined by one of its members 0010 16 Signed 4 SXORGCTG A count of the valid page range entry pairs (SXORGSTG and SXORGENG) 0014 20 Signed 4 SXORGCGA A count of the valid page range entry pairs (SXORGSTG and SXORGENG) that were actually placed in the output page range table. This may be used when the output buffer provided was not large enough to contain all the page range entries that were available (SXORGCTG) 0018 24 Character 8 SXOMSNMG Name of member. 0020 32 Dbl-Word 8 SXOMEMSG 64-bit Member's lowest page of the range 0028 40 Dbl-Word 8 SXOMEMEG 64-bit Member's highest page of the range 00000018 SXONTSZG *-SXOASMG2 Size of a member entry. 0030 48 Signed 4 SXOMSNTG (0) Next entry.
SXODABK Storage Layout
*** SXODABK - DIAGNOSE X'64' SEGMENT EXTENDED OUTPUT AREA
*
* +---------------------------+---------------------------+
* 0 | SXOLSBA | SXOLSEA |
* +---------------------------+---------------------------+
* 8 | SXOLSNAM |
* +-------------------------------------------------------+
* 10 | |
* = SXOASM2 =
* | |
* +-------------------------------------------------------+
* 410
*
*** SXODABK - DIAGNOSE X'64' SEGMENT EXTENDED OUTPUT AREA
*** Overlay for SXOASM2 in SXODABK
*
* +---------------------------+
* 10 | SXORANS | 14
* +---------------------------+
*
*** Overlay for SXOASM2 in SXODABK
*** Overlay for SXORANS in SXODABK
*
* +--------------------+------+---------------------------+
* 10 | SXORGST |:PRAT | SXORANE |
* +--------------------+------+---------------------------+
* 18
*
*** Overlay for SXORANS in SXODABK
*** Overlay for SXORANE in SXODABK
*
* +--------------------+------+
* 10 ... 14 | SXORGEND |//////|
* +--------------------+------+
* 18
*
*** Overlay for SXORANE in SXODABK
*** Overlay for SXOLSBA in SXODABK
*
* +---------------------------+---------------------------+
* 0 | SXOSKBA | SXOSKEA |
* +---------------------------+---------------------------+
* 8 | SXORGCT | SXORGCTA |
* +---------------------------+---------------------------+
* 10
*
*** Overlay for SXOLSBA in SXODABK
*** Overlay for SXOASM2 in SXODABK
*
* +-------------------------------------------------------+
* 10 | SXOMSSNM |
* +---------------------------+---------------------------+
* 18 | SXOMEMST | SXOMEMEN |
* +---------------------------+---------------------------+
*
*** Overlay for SXOASM2 in SXODABK
*** Overlay for SXOLSBA in SXODABK
*
* +-------------------------------------------------------+
* 0 | SXOLSBAG |
* +-------------------------------------------------------+
* 8 | SXOLSEAG |
* +-------------------------------------------------------+
* 10 | SXOLSNMG |
* +-------------------------------------------------------+
* 18 | |
* = SXOASMG2 =
* | |
* +-------------------------------------------------------+
* 418
*
*** Overlay for SXOLSBA in SXODABK
*** Overlay for SXOASMG2 in SXODABK
*
* +-------------------------------------------------------+
* 18 | SXORANSG |
* +-------------------------------------------------------+
* 20
*
*** Overlay for SXOASMG2 in SXODABK
*** Overlay for SXORANSG in SXODABK
*
* +------------------------------------------------+------+
* 18 | SXORGSTG |:PRATG|
* +------------------------------------------------+------+
* 20 | SXORANEG |
* +-------------------------------------------------------+
* 28
*
*** Overlay for SXORANSG in SXODABK
*** Overlay for SXORANEG in SXODABK
*
* +------------------------------------------------+------+
* 20 | SXORGENG |//////|
* +------------------------------------------------+------+
* 28
*
*** Overlay for SXORANEG in SXODABK
*** Overlay for SXOLSBA in SXODABK
*
* +-------------------------------------------------------+
* 0 | SXOSKBAG |
* +-------------------------------------------------------+
* 8 | SXOSKEAG |
* +---------------------------+---------------------------+
* 10 | SXORGCTG | SXORGCGA |
* +---------------------------+---------------------------+
* 18
*
*** Overlay for SXOLSBA in SXODABK
*** Overlay for SXOASMG2 in SXODABK
*
* +-------------------------------------------------------+
* 18 | SXOMSNMG |
* +-------------------------------------------------------+
* 20 | SXOMEMSG |
* +-------------------------------------------------------+
* 28 | SXOMEMEG |
* +-------------------------------------------------------+
*
*** Overlay for SXOASMG2 in SXODABK
SXODABK Cross Reference
Symbol Dspl Value -------------- ---- ----- SXOASMG2 0018 SXOASM2 0010 SXOEXCL 0013 01 SXOLSBA 0000 SXOLSBAG 0000 SXOLSEA 0004 SXOLSEAG 0008 SXOLSNAM 0008 SXOLSNMG 0010 SXOMEMEG 0028 SXOMEMEN 001C SXOMEMSG 0020 SXOMEMST 0018 SXOMSNMG 0018 SXOMSNTG 0030 SXOMSNXT 0020 SXOMSSNM 0010 SXONDAT 0013 04 SXONTSZG 0028 00000018 SXONTSZM 001C 00000010 SXOPRAT 0013 SXOPRATG 001F SXOPRMAX 0010 80 SXOPRMXG 0018 40 SXOPROT 0013 02 SXORANE 0014 SXORANEG 0020 SXORANS 0010 SXORANSG 0018 SXORGCGA 0014 SXORGCT 0008 SXORGCTA 000C SXORGCTG 0010 SXORGEND 0014 SXORGENG 0020 SXORGST 0010 SXORGSTG 0018 SXORNGEN 0013 05 SXORNGER 0013 03 SXORNGEW 0013 01 SXORNGSC 0013 06 SXORNGSN 0013 04 SXORNGSR 0013 02 SXORNGSW 0013 00 SXOSIZE 0017 00000003 SXOSIZEG 0027 00000005 SXOSKBA 0000 SXOSKBAG 0000 SXOSKEA 0004 SXOSKEAG 0008
Copyright IBM Corporation, 1990, 2011