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.
     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 V6R1.0. Last updated on 18 Feb 2010 at 09:14:16 EDT.
Copyright IBM Corporation, 1990, 2008