SXODABK Back to Index page
 
Prolog 
Control Block Contents 
   SXODABK 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.


  SXODABK Prolog Top of page
 
 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 Top of page
 

 SXODABK DSECT Top of page
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 Top of page
 
          
*** 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 Top of page
 
 
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
 
This information is based on z/VM 7.1.0 Last updated on 22 Jun 2018 at 11:53:04 EDT.
Copyright IBM Corporation, 1990, 2018