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

 

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 V5R3.0. Last updated on 25 Jun 2007 at 17:40:32 EDT.
Copyright IBM Corporation, 1990, 2007