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 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: 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 RANGE FLAG VALUE FOR 'SW' .... ...1 SXORNGEW SXOEXCL RANGE FLAG VALUE FOR 'EW' .... ..1. SXORNGSR SXOPROT RANGE FLAG VALUE FOR 'SR' .... ..11 SXORNGER SXOPROT+SXOEXCL RANGE FLAG VALUE FOR 'ER' .... .1.. SXORNGSN SXONDAT RANGE FLAG VALUE FOR 'SN' .... .1.1 SXORNGEN SXONDAT+SXOEXCL RANGE FLAG VALUE FOR 'EN' .... .11. 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 | * +---------------------------+---------------------------+ * *** 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, 2001