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