|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SXODABK
Control Block Contents
SXODABK DSECT
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
Copyright IBM Corporation, 1990, 2007