|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
SXODABK
Cross Reference (Contains links to field and bit definitions)
SXODABK Prolog
NAME : HCPSXOBK
DESCRIPTION: DIAGNOSE X'64' SEGMENT EXTENDED OUTPUT AREA
STATUS : VM/ESA Version 2, Release 4.0
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 00000080 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: 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 00000000 SXORNGSW 0 RANGE FLAG VALUE FOR 'SW' 00000001 SXORNGEW SXOEXCL RANGE FLAG VALUE FOR 'EW' 00000002 SXORNGSR SXOPROT RANGE FLAG VALUE FOR 'SR' 00000003 SXORNGER SXOPROT+SXOEXCL RANGE FLAG VALUE FOR 'ER' 00000004 SXORNGSN SXONDAT RANGE FLAG VALUE FOR 'SN' 00000005 SXORNGEN SXONDAT+SXOEXCL RANGE FLAG VALUE FOR 'EN' 00000006 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 | * +---------------------------+---------------------------+ * 20 | | * = SXOMSNXT = * | | * +-------------------------------------------------------+ * *** Overlay for SXOASM2 in SXODABK
SXODABK Cross Reference
(contains links to field and bit definitions)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 00000080
SXOPROT 0013 02
SXORANE 0014
SXORANS 0010
SXORGCT 0008
SXORGCTA 000C
SXORGEND 0014
SXORGST 0010
SXORNGEN 0013 00000005
SXORNGER 0013 00000003
SXORNGEW 0013 00000001
SXORNGSC 0013 00000006
SXORNGSN 0013 00000004
SXORNGSR 0013 00000002
SXORNGSW 0013 00000000
SXOSIZE 0017 00000003
SXOSKBA 0000
SXOSKEA 0004
Last updated on 3 Aug 1999 at 12:37:14 EDT.
Copyright IBM Corporation, 1990, 1999