Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

SXODABK

Prolog  

Control Block Contents  
   SXODABK DSECT

Storage Layout  

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

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:25:40 EDT.
Copyright IBM Corporation, 1990, 2011