Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

UWKPG

Prolog  

Control Block Contents  
   UWKPG DSECT

Storage Layout  

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 Signed       4 UWKSTOR        Defined storage size of user's
                                        primary address space
0014   20 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.'
0018   24 Character    8 UWKIPLN (0)    Name of IPL device or name, or
                                        'DEV NONE' if none.
0018   24 Character    4 UWKIPDEV       'DEV '
001C   28 Character    4 UWKIPNUM       IPL device number
0020   32 Signed       4 UWKDEVN        Number of attached devices
0024   36 Signed       4 UWKSPLRD       Number of spooling pages read
                                        from DASD
0028   40 Signed       4 UWKSPLWT       Number of spooling pages written
                                        to DASD
002C   44 Character    8 UWKPRMUS       Userid of primary space owner
0034   52 Character   24 UWKPRMNM       Space name of primary space
004C   76 Signed       4 UWKPRMAD       Addressable size of primary
                                        address space
     The following two fields represent totals for all address spaces.
0050   80 Signed       4 UWKTOTSP       Number of spaces owned by user
0054   84 Signed       4 UWKTOTSZ       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.
0058   88 Signed       4 UWKPVTSP       Number of private spaces owned by
                                        this user
005C   92 Signed       4 UWKPVTSZ       Size in pages of all private
                                        spaces owned by this user
     Private spaces, pages information These are counts for spaces which are
     currently private.
0060   96 Signed       4 UWKRES         Number of resident pages in
                                        private address spaces
0064  100 Signed       4 UWKXBK         Number of pages in xstore for
                                        private address spaces
0068  104 Signed       4 UWKPDAS        Number of pages on DASD for
                                        private address spaces
006C  108 Signed       4 UWKLOK         Number of locked pages in private
                                        address spaces
0070  112 Signed       4 UWKWSS         Working Set Size
0074  116 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.
0078  120 Signed       4 UWKSHRSP       Number of shared spaces owned by
                                        this user
007C  124 Signed       4 UWKSHRSZ       Size in pages of all shared
                                        spaces owned by this user
     Shared spaces, pages information These are counts for spaces which are
     currently shared.
0080  128 Signed       4 UWKSRES        Number of resident pages in
                                        shared address spaces
0084  132 Signed       4 UWKSXBK        Number of pages in xstore for
                                        shared address spaces
0088  136 Signed       4 UWKSDAS        Number of pages on DASD for
                                        shared address spaces
008C  140 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:
0090  144 Signed       4 UWKXRD         Number reads from xstore to
                                        private address spaces
0094  148 Signed       4 UWKXWT         Number writes to xstore from
                                        private address spaces
0098  152 Signed       4 UWKMIG         Number of migrates for private
                                        address spaces
009C  156 Signed       4 UWKREAD        Number of reads from DASD to
                                        private address spaces
00A0  160 Signed       4 UWKWRIT        Number of writes to DASD from
                                        private address spaces
     Shared paging information:
00A4  164 Signed       4 UWKSXRD        Number of reads from xstore to
                                        shared address spaces
00A8  168 Signed       4 UWKSXWT        Number of writes to xstore from
                                        shared address spaces
00AC  172 Signed       4 UWKSMIG        Number of migrates for shared
                                        address spaces
00B0  176 Signed       4 UWKSREAD       Number of reads from DASD to
                                        shared address spaces
00B4  180 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.
00B8  184 Signed       4 UWKCPUAD       Virtual CPU address
00BC  188 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.
00C0  192 Dbl-Word     8 UWKVTIM        Total virtual time
00C8  200 Dbl-Word     8 UWKTTIM        Total virtual and simulation time
00D0  208 Dbl-Word     8 UWKVVECT       VVECTIME
00D8  216 Dbl-Word     8 UWKTVECT       TVECTIME
00E0  224 Signed       4 UWKRDR         Number of virtual cards read
00E4  228 Signed       4 UWKPRT         Number of virtual lines printed
00E8  232 Signed       4 UWKPCH         Number of virutal cards punched
00EC  236 Signed       4 UWKIOS         Number of IO requests
     End of fields significant for each virtual processor
     End of control block
          000000F0       UWKSIZE        *-UWKPG Single entry size (bytes)
          0000001E       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 |         UWKSTOR           |         UWKXSTR           |
*     +---------------------------+---------------------------+
*  18 |         UWKIPDEV          |         UWKIPNUM          |
*     +---------------------------+---------------------------+
*  20 |         UWKDEVN           |         UWKSPLRD          |
*     +---------------------------+---------------------------+
*  28 |         UWKSPLWT          |        UWKPRMUS-          |
*     +---------------------------+---------------------------+
*  30 |          -(02C)           |                           |
*     +---------------------------+                           |
*  38 |                                                       |
*     =                       UWKPRMNM                        =
*     |                           +---------------------------+
*  48 |                           |         UWKPRMAD          |
*     +---------------------------+---------------------------+
*  50 |         UWKTOTSP          |         UWKTOTSZ          |
*     +---------------------------+---------------------------+
*  58 |         UWKPVTSP          |         UWKPVTSZ          |
*     +---------------------------+---------------------------+
*  60 |          UWKRES           |          UWKXBK           |
*     +---------------------------+---------------------------+
*  68 |         UWKPDAS           |          UWKLOK           |
*     +---------------------------+---------------------------+
*  70 |          UWKWSS           |         UWKRESV           |
*     +---------------------------+---------------------------+
*  78 |         UWKSHRSP          |         UWKSHRSZ          |
*     +---------------------------+---------------------------+
*  80 |         UWKSRES           |         UWKSXBK           |
*     +---------------------------+---------------------------+
*  88 |         UWKSDAS           |         UWKSLOK           |
*     +---------------------------+---------------------------+
*  90 |          UWKXRD           |          UWKXWT           |
*     +---------------------------+---------------------------+
*  98 |          UWKMIG           |         UWKREAD           |
*     +---------------------------+---------------------------+
*  A0 |         UWKWRIT           |         UWKSXRD           |
*     +---------------------------+---------------------------+
*  A8 |         UWKSXWT           |         UWKSMIG           |
*     +---------------------------+---------------------------+
*  B0 |         UWKSREAD          |         UWKSWRIT          |
*     +---------------------------+---------------------------+
*  B8 |         UWKCPUAD          |         UWKTODON          |
*     +---------------------------+---------------------------+
*  C0 |                       UWKVTIM                         |
*     +-------------------------------------------------------+
*  C8 |                       UWKTTIM                         |
*     +-------------------------------------------------------+
*  D0 |                       UWKVVECT                        |
*     +-------------------------------------------------------+
*  D8 |                       UWKTVECT                        |
*     +---------------------------+---------------------------+
*  E0 |          UWKRDR           |          UWKPRT           |
*     +---------------------------+---------------------------+
*  E8 |          UWKPCH           |          UWKIOS           |
*     +---------------------------+---------------------------+
*  F0
*
*** UWKPG - INDICATE USER data block

 

UWKPG Cross Reference

Symbol         Dspl Value
-------------- ---- -----
UWKBASE        0008 04
UWKCPUAD       00B8
UWKDEVN        0020
UWKDWSZ        00EC 0000001E
UWKESA         0008 20
UWKFLAG        0008
UWKHADVF       0008 08
UWKIOPT        000A
UWKIOS         00EC
UWKIPDEV       0018
UWKIPLN        0018
UWKIPNUM       001C
UWKLOK         006C
UWKMIG         0098
UWKPCH         00E8
UWKPDAS        0068
UWKPRIVT       0009 80
UWKPRMAD       004C
UWKPRMNM       0034
UWKPRMUS       002C
UWKPRT         00E4
UWKPVTSH       0009
UWKPVTSP       0058
UWKPVTSZ       005C
UWKRDR         00E0
UWKREAD        009C
UWKRES         0060
UWKRESV        0074
UWKSDAS        0088
UWKSHARD       0009 40
UWKSHRSP       0078
UWKSHRSZ       007C
UWKSIZE        00EC 000000F0
UWKSLOK        008C
UWKSMIG        00AC
UWKSPLRD       0024
UWKSPLWT       0028
UWKSREAD       00B0
UWKSRES        0080
UWKSTOR        0010
UWKSWRIT       00B4
UWKSXBK        0084
UWKSXRD        00A4
UWKSXWT        00A8
UWKTODON       00BC
UWKTOTSP       0050
UWKTOTSZ       0054
UWKTTIM        00C8
UWKTVECT       00D8
UWKUSER        0000
UWKVIRT        000B
UWKVTIM        00C0
UWKVVECT       00D0
UWKWRIT        00A0
UWKWSS         0070
UWKXA          0008 40
UWKXBK         0064
UWKXC          0008 10
UWKXRD         0090
UWKXSTR        0014
UWKXWT         0094
UWK370         0008 80

This information is based on z/VM V4R2.0. Last updated on 18 Oct 2001 at 09:18:59 EDT.
Copyright IBM Corporation, 1990, 2001