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).
          0SXOPRAT       *              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*null
          .... ....      *
          0SXOPRAT       *              FLAG VALUE FOR 'SW' EQU
          0SXOPRAT       *              FLAG VALUE FOR 'EW' EQU
          0SXOPRAT       *              FLAG VALUE FOR 'SR' EQU
          0SXOPRAT       *              FLAG VALUE FOR 'ER' EQU
          0SXOPRAT       *              FLAG VALUE FOR 'SN' EQU
          0SXOPRAT       *              FLAG VALUE FOR 'EN' EQU
          0SXOPRAT       *              FLAG VALUE FOR 'SC' *null
          .... ....      *
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
-------------- ---- -----
*              0013 0SXOPRAT
*              0013 00
*              0013 0SXOPRAT
*              0013 0SXOPRAT
*              0013 0SXOPRAT
*              0013 0SXOPRAT
*              0013 0SXOPRAT
*              0013 0SXOPRAT
*              0013 0SXOPRAT
*              0013 00
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
SXOSIZE        0017 00000003
SXOSKBA        0000
SXOSKEA        0004

This information is based on z/VM V4R1.0.
Last updated on 5 Jun 2001 at 16:53:46 EDT.
Copyright IBM Corporation, 1990, 2001