SXODABK - 32-bit CP - V4R4.0

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' SUBCODE X'18'.
     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' SUBCODE X'18' 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.

#### 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 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' 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' THIS BIT INDICATES PAGE
                                            RANGES THAT ARE PAGE PROTECTED.
                                            USERS MAY ACCESS THESE PAGES ONLY
                                            IN READ-ONLY MODE.
              .... .1..      SXONDAT        X'04' 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 RANGE FLAG VALUE FOR 'SW'
              .... ...1      SXORNGEW       SXOEXCL RANGE FLAG VALUE FOR 'EW'
              .... ..1.      SXORNGSR       SXOPROT RANGE FLAG VALUE FOR 'SR'
              .... ..11      SXORNGER       SXOPROT+SXOEXCL RANGE FLAG VALUE
                                            FOR 'ER'
              .... .1..      SXORNGSN       SXONDAT RANGE FLAG VALUE FOR 'SN'
              .... .1.1      SXORNGEN       SXONDAT+SXOEXCL RANGE FLAG VALUE
                                            FOR 'EN'
              .... .11.      SXORNGSC       SXONDAT+SXOPROT 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.

#### 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

#### SXODABK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SXOASM2        0010
    SXOEXCL        0013 01
    SXOLSBA        0000
    SXOLSEA        0004
    SXOLSNAM       0008
    SXOMEMEN       001C
    SXOMEMST       0018
    SXOMSNXT       0020
    SXOMSSNM       0010
    SXONDAT        0013 04
    SXONTSZM       001C 00000010
    SXOPRAT        0013
    SXOPRMAX       0010 80
    SXOPROT        0013 02
    SXORANE        0014
    SXORANS        0010
    SXORGCT        0008
    SXORGCTA       000C
    SXORGEND       0014
    SXORGST        0010
    SXORNGEN       0013 05
    SXORNGER       0013 03
    SXORNGEW       0013 01
    SXORNGSC       0013 06
    SXORNGSN       0013 04
    SXORNGSR       0013 02
    SXORNGSW       0013 00
    SXOSIZE        0017 00000003
    SXOSKBA        0000
    SXOSKEA        0004

This information is based on z/VM V4R4.0. Last updated on 29 Jul 2003 at 16:26:29 EDT.
Copyright IBM Corporation, 1990, 2003