Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
UWKPG
Control Block Contents
UWKPG DSECT
Cross Reference (Contains links to field and bit definitions)
UWKPG Prolog
Name : HCPUWKPG Description: INDICATE USER data block DSECT : UWKPG Function : Contain information gathered to process the INDICATE USER command. Located by : Registers in INDICATE USER modules Created by : HCPTHLU Deleted by : HCPTHLU Serialized : Task execution: each time the task is run a new set of pages is obtained to hold the UWKPG maps; the data is first collected, then used, and finally the pages are deleted Comments : This control block is used to map entries in storage that is fetched and released by the page. This control block is used to map the data gathered for both the old response and the expanded response to the Indicate user command. Some fields are not used when processing the old response format.
UWKPG Control Block Content
UWKPG DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure UWKPG INDICATE USER data block 0000 0 Character 8 UWKUSER Userid 0008 8 Bitstring 1 UWKFLAG Flags for various states; contains BITS, so TM must be used. 1... .... UWK370 X'80' Machine Mode = 370 .1.. .... UWKXA X'40' Machine Mode = XA ..1. .... UWKESA X'20' Machine Mode = ESA ...1 .... UWKXC X'10' Machine Mode = XC .... 1... UWKHADVF X'08' User had virtual vector facility .... .1.. UWKBASE X'04' Entry is for virtual MP configuration 0009 9 Bitstring 1 UWKPVTSH Flags indicating type of primary address space. 1... .... UWKPRIVT X'80' Primary space is private .1.. .... UWKSHARD X'40' Primary space is shared 000A 10 Bitstring 1 UWKIOPT IO passthrough indication 000B 11 Bitstring 1 UWKVIRT Storage type 000C 12 Signed 4 * Not used 0010 16 Dbl-Word 8 UWKGSTOR Total configured size of user's primary address space in bytes-1 0018 24 Signed 4 UWKXSTR Xstore size (if attached), or 'NONE' For the EXPanded response, UWKIPLN is filled in only for base VMDBK UWKPG entries, and is filled in with the IPL system name or device that is in effect for the virtual configuration, or 'DEV NONE' if none. For the non-EXPanded response, UWKIPLN is filled in for each UWKPG entry with the IPL system name or device that is in effect for the virtual configuration if it was IPL'd on that virtual CPU, or 'DEV NONE.' 001C 28 Character 8 UWKIPLN (0) Name of IPL device or name, or 'DEV NONE' if none. 001C 28 Character 4 UWKIPDEV 'DEV ' 0020 32 Character 4 UWKIPNUM IPL device number 0024 36 Signed 4 UWKDEVN Number of attached devices 0028 40 Signed 4 UWKSPLRD Number of spooling pages read from DASD 002C 44 Signed 4 UWKSPLWT Number of spooling pages written to DASD 0030 48 Character 8 UWKPRMUS Userid of primary space owner 0038 56 Character 24 UWKPRMNM Space name of primary space 0050 80 Dbl-Word 8 UWKGPRMAD Addressable size of primary address space - 1 The following two fields represent totals for all address spaces. 0058 88 Signed 4 UWKTOTSP Number of spaces owned by user 0060 96 Dbl-Word 8 UWKGTOTSZ Total size, in pages, of all spaces owned by this user The following counts are the totals of the values for all private address spaces. 0068 104 Signed 4 UWKPVTSP Number of private spaces owned by this user 0070 112 Dbl-Word 8 UWKGPVTSZ Size in pages of all private spaces owned by this user Private spaces, pages information These are counts for spaces which are currently private. 0078 120 Signed 4 UWKRES Number of resident pages in private address spaces 007C 124 Signed 4 UWKXBK Number of pages in xstore for private address spaces 0080 128 Signed 4 UWKPDAS Number of pages on DASD for private address spaces 0084 132 Signed 4 UWKLOK Number of locked pages in private address spaces 0088 136 Signed 4 UWKWSS Working Set Size 008C 140 Signed 4 UWKRESV Number of reserved pages in private address spaces End of totals for private spaces The following counts are the totals of the values for all shared address spaces. 0090 144 Signed 4 UWKSHRSP Number of shared spaces owned by this user 0098 152 Dbl-Word 8 UWKGSHRSZ Size in pages of all shared spaces owned by this user Shared spaces, pages information These are counts for spaces which are currently shared. 00A0 160 Signed 4 UWKSRES Number of resident pages in shared address spaces 00A4 164 Signed 4 UWKSXBK Number of pages in xstore for shared address spaces 00A8 168 Signed 4 UWKSDAS Number of pages on DASD for shared address spaces 00AC 172 Signed 4 UWKSLOK Number of locked pages in shared address spaces End of totals for shared spaces. The following counts are the totals of the values for all address spaces: These are the cummulative counts of private and shared paging for all address spaces regardless of whether they are currently private or shared. Private paging information: 00B0 176 Signed 4 UWKXRD Number reads from xstore to private address spaces 00B4 180 Signed 4 UWKXWT Number writes to xstore from private address spaces 00B8 184 Signed 4 UWKMIG Number of migrates for private address spaces 00BC 188 Signed 4 UWKREAD Number of reads from DASD to private address spaces 00C0 192 Signed 4 UWKWRIT Number of writes to DASD from private address spaces Shared paging information: 00C4 196 Signed 4 UWKSXRD Number of reads from xstore to shared address spaces 00C8 200 Signed 4 UWKSXWT Number of writes to xstore from shared address spaces 00CC 204 Signed 4 UWKSMIG Number of migrates for shared address spaces 00D0 208 Signed 4 UWKSREAD Number of reads from DASD to shared address spaces 00D4 212 Signed 4 UWKSWRIT Number of writes to DASD from shared address spaces. End of totals for all address spaces The following fields are significant for each virtual processor in a virtual configuration. 00D8 216 Signed 4 UWKCPUAD Virtual CPU address 00DC 220 Signed 4 UWKTODON Connect time. The current TOD minus the time of logon (or creation for a non origin VMDBK). Only the high order word of the TOD clock value is used. 00E0 224 Dbl-Word 8 UWKVTIM Total virtual time 00E8 232 Dbl-Word 8 UWKTTIM Total virtual and simulation time 00F0 240 Dbl-Word 8 UWKVVECT VVECTIME 00F8 248 Dbl-Word 8 UWKTVECT TVECTIME 0100 256 Signed 4 UWKRDR Number of virtual cards read 0104 260 Signed 4 UWKPRT Number of virtual lines printed 0108 264 Signed 4 UWKPCH Number of virutal cards punched 010C 268 Signed 4 UWKIOS Number of IO requests End of fields significant for each virtual processor End of control block 00000110 UWKSIZE *-UWKPG Single entry size (bytes) 00000022 UWKDWSZ ((*-UWKPG)+7)/8 Single entry size (dbl words)
UWKPG Storage Layout
*** UWKPG - INDICATE USER data block * * +-------------------------------------------------------+ * 0 | UWKUSER | * +------+------+------+------+---------------------------+ * 8 |:FLAG |:PVTSH|:IOPT |:VIRT |///////////////////////////| * +------+------+------+------+---------------------------+ * 10 | UWKGSTOR | * +---------------------------+---------------------------+ * 18 | UWKXSTR | UWKIPDEV | * +---------------------------+---------------------------+ * 20 | UWKIPNUM | UWKDEVN | * +---------------------------+---------------------------+ * 28 | UWKSPLRD | UWKSPLWT | * +---------------------------+---------------------------+ * 30 | UWKPRMUS | * +-------------------------------------------------------+ * 38 | | * = UWKPRMNM = * | | * +-------------------------------------------------------+ * 50 | UWKGPRMAD | * +---------------------------+---------------------------+ * 58 | UWKTOTSP |///////////////////////////| * +---------------------------+---------------------------+ * 60 | UWKGTOTSZ | * +---------------------------+---------------------------+ * 68 | UWKPVTSP |///////////////////////////| * +---------------------------+---------------------------+ * 70 | UWKGPVTSZ | * +---------------------------+---------------------------+ * 78 | UWKRES | UWKXBK | * +---------------------------+---------------------------+ * 80 | UWKPDAS | UWKLOK | * +---------------------------+---------------------------+ * 88 | UWKWSS | UWKRESV | * +---------------------------+---------------------------+ * 90 | UWKSHRSP |///////////////////////////| * +---------------------------+---------------------------+ * 98 | UWKGSHRSZ | * +---------------------------+---------------------------+ * A0 | UWKSRES | UWKSXBK | * +---------------------------+---------------------------+ * A8 | UWKSDAS | UWKSLOK | * +---------------------------+---------------------------+ * B0 | UWKXRD | UWKXWT | * +---------------------------+---------------------------+ * B8 | UWKMIG | UWKREAD | * +---------------------------+---------------------------+ * C0 | UWKWRIT | UWKSXRD | * +---------------------------+---------------------------+ * C8 | UWKSXWT | UWKSMIG | * +---------------------------+---------------------------+ * D0 | UWKSREAD | UWKSWRIT | * +---------------------------+---------------------------+ * D8 | UWKCPUAD | UWKTODON | * +---------------------------+---------------------------+ * E0 | UWKVTIM | * +-------------------------------------------------------+ * E8 | UWKTTIM | * +-------------------------------------------------------+ * F0 | UWKVVECT | * +-------------------------------------------------------+ * F8 | UWKTVECT | * +---------------------------+---------------------------+ * 100 | UWKRDR | UWKPRT | * +---------------------------+---------------------------+ * 108 | UWKPCH | UWKIOS | * +---------------------------+---------------------------+ * 110 * *** UWKPG - INDICATE USER data block
UWKPG Cross Reference
Symbol Dspl Value -------------- ---- ----- UWKBASE 0008 04 UWKCPUAD 00D8 UWKDEVN 0024 UWKDWSZ 010C 00000022 UWKESA 0008 20 UWKFLAG 0008 UWKGPRMAD 0050 UWKGPVTSZ 0070 UWKGSHRSZ 0098 UWKGSTOR 0010 UWKGTOTSZ 0060 UWKHADVF 0008 08 UWKIOPT 000A UWKIOS 010C UWKIPDEV 001C UWKIPLN 001C UWKIPNUM 0020 UWKLOK 0084 UWKMIG 00B8 UWKPCH 0108 UWKPDAS 0080 UWKPRIVT 0009 80 UWKPRMNM 0038 UWKPRMUS 0030 UWKPRT 0104 UWKPVTSH 0009 UWKPVTSP 0068 UWKRDR 0100 UWKREAD 00BC UWKRES 0078 UWKRESV 008C UWKSDAS 00A8 UWKSHARD 0009 40 UWKSHRSP 0090 UWKSIZE 010C 00000110 UWKSLOK 00AC UWKSMIG 00CC UWKSPLRD 0028 UWKSPLWT 002C UWKSREAD 00D0 UWKSRES 00A0 UWKSWRIT 00D4 UWKSXBK 00A4 UWKSXRD 00C4 UWKSXWT 00C8 UWKTODON 00DC UWKTOTSP 0058 UWKTTIM 00E8 UWKTVECT 00F8 UWKUSER 0000 UWKVIRT 000B UWKVTIM 00E0 UWKVVECT 00F0 UWKWRIT 00C0 UWKWSS 0088 UWKXA 0008 40 UWKXBK 007C UWKXC 0008 10 UWKXRD 00B0 UWKXSTR 0018 UWKXWT 00B4 UWK370 0008 80
Copyright IBM Corporation, 1990, 2001