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..      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 Bitstring    1 UWKTYPE        VMDBK type
000D   13 Bitstring    1 UWKADJFL       ADJUNCT TYPE
000E   14 Bitstring    1 UWKCMODE       Vconfig mode
000F   15 Bitstring    1 *              Reserved
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 fields represent totals for all
         address spaces.
0058   88 Dbl-Word     8 UWKGTOTSZ      Total size, in pages, of all
                                        spaces owned by this user
0060   96 Dbl-Word     8 UWKLOK         Number of locked pages in real
                                        storage
0068  104 Signed       4 UWKTOTSP       Number of spaces owned by user
         The following counts are the totals of the values for
         all private address spaces.
006C  108 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 UWKRESL        Number of resident pages in host
                                        logical for private address space
0088  136 Signed       4 UWKWSS         Working Set Size
008C  140 Signed       4 UWKRESV        Number of reserved pages in
                                        private address spaces
0090  144 Signed       4 UWKLOKL        Number of locked pages in host
                                        logical for private address space
         End of totals for private spaces
         The following counts are the totals of the values for
         all shared address spaces.
0094  148 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 UWKSRESL       Number of resident pages in host
                                        logical for private address space
00B0  176 Signed       4 UWKSLOKL       Number of locked pages in host
                                        logical for private address space
         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:
00B4  180 Signed       4 UWKXRD         Number reads from xstore to
                                        private address spaces
00B8  184 Signed       4 UWKXWT         Number writes to xstore from
                                        private address spaces
00BC  188 Signed       4 UWKMIG         Number of migrates for private
                                        address spaces
00C0  192 Signed       4 UWKREAD        Number of reads from DASD to
                                        private address spaces
00C4  196 Signed       4 UWKWRIT        Number of writes to DASD from
                                        private address spaces
          Shared paging information:
00C8  200 Signed       4 UWKSXRD        Number of reads from xstore to
                                        shared address spaces
00CC  204 Signed       4 UWKSXWT        Number of writes to xstore from
                                        shared address spaces
00D0  208 Signed       4 UWKSMIG        Number of migrates for shared
                                        address spaces
00D4  212 Signed       4 UWKSREAD       Number of reads from DASD to
                                        shared address spaces
00D8  216 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.
00DC  220 Signed       4 UWKCPUAD       Virtual CPU address
00E0  224 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.
00E8  232 Dbl-Word     8 UWKVTIM        Total virtual time
00F0  240 Dbl-Word     8 UWKTTIM        Total virtual and simulation time
00F8  248 Dbl-Word     8 UWKVTP         Total virtual time consumed while
                                        running on a primary processor
0100  256 Dbl-Word     8 UWKTTP         Total virtual and simulation time
                                        consumed while running on a
                                        primary processor
0108  264 Dbl-Word     8 UWKVTS         Total virtual time consumed while
                                        running on a secondary processor
0110  272 Dbl-Word     8 UWKTTS         Total virtual and simulation time
                                        consumed while running on a
                                        secondary processor
0118  280 Signed       4 UWKRDR         Number of virtual cards read
011C  284 Signed       4 UWKPRT         Number of virtual lines printed
0120  288 Signed       4 UWKPCH         Number of virutal cards punched
0124  292 Signed       4 UWKIOS         Number of IO requests
0128  296 Bitstring    1 UWKPUTY        CPU Type Code - the possible code
                                        values are in HCPEQUAT
0129  297 Bitstring    1 UWKAFFLG       CPU Affinity Flag
          1... ....      UWKAFFIN       X'80' UWKAFFIN CPU Affinity
                                        requested
          .1.. ....      UWKAFSUP       X'40' UWKAFSUP CPU Affinity
                                        suppressed
012A  298 Bitstring    1 * (2)          Reserved
         End of fields significant for each virtual processor
         End of control block
          0000012C       UWKSIZE        *-UWKPG Single entry size (bytes)
          00000026       UWKDWSZ        ((*-UWKPG)+7)/8 Single entry size
                                        (dbl words)

 

UWKPG Storage Layout

          
*** UWKPG - INDICATE USER data block
*
*     +-------------------------------------------------------+
*   0 |                       UWKUSER                         |
*     +------+------+------+------+------+------+------+------+
*   8 |:FLAG |:PVTSH|:IOPT |:VIRT |:TYPE |:ADJFL|:CMODE|//////|
*     +------+------+------+------+------+------+------+------+
*  10 |                       UWKGSTOR                        |
*     +---------------------------+---------------------------+
*  18 |         UWKXSTR           |         UWKIPDEV          |
*     +---------------------------+---------------------------+
*  20 |         UWKIPNUM          |         UWKDEVN           |
*     +---------------------------+---------------------------+
*  28 |         UWKSPLRD          |         UWKSPLWT          |
*     +---------------------------+---------------------------+
*  30 |                       UWKPRMUS                        |
*     +-------------------------------------------------------+
*  38 |                                                       |
*     =                       UWKPRMNM                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  50 |                      UWKGPRMAD                        |
*     +-------------------------------------------------------+
*  58 |                      UWKGTOTSZ                        |
*     +-------------------------------------------------------+
*  60 |                        UWKLOK                         |
*     +---------------------------+---------------------------+
*  68 |         UWKTOTSP          |         UWKPVTSP          |
*     +---------------------------+---------------------------+
*  70 |                      UWKGPVTSZ                        |
*     +---------------------------+---------------------------+
*  78 |          UWKRES           |          UWKXBK           |
*     +---------------------------+---------------------------+
*  80 |         UWKPDAS           |         UWKRESL           |
*     +---------------------------+---------------------------+
*  88 |          UWKWSS           |         UWKRESV           |
*     +---------------------------+---------------------------+
*  90 |         UWKLOKL           |         UWKSHRSP          |
*     +---------------------------+---------------------------+
*  98 |                      UWKGSHRSZ                        |
*     +---------------------------+---------------------------+
*  A0 |         UWKSRES           |         UWKSXBK           |
*     +---------------------------+---------------------------+
*  A8 |         UWKSDAS           |         UWKSRESL          |
*     +---------------------------+---------------------------+
*  B0 |         UWKSLOKL          |          UWKXRD           |
*     +---------------------------+---------------------------+
*  B8 |          UWKXWT           |          UWKMIG           |
*     +---------------------------+---------------------------+
*  C0 |         UWKREAD           |         UWKWRIT           |
*     +---------------------------+---------------------------+
*  C8 |         UWKSXRD           |         UWKSXWT           |
*     +---------------------------+---------------------------+
*  D0 |         UWKSMIG           |         UWKSREAD          |
*     +---------------------------+---------------------------+
*  D8 |         UWKSWRIT          |         UWKCPUAD          |
*     +---------------------------+---------------------------+
*  E0 |         UWKTODON          |///////////////////////////|
*     +---------------------------+---------------------------+
*  E8 |                       UWKVTIM                         |
*     +-------------------------------------------------------+
*  F0 |                       UWKTTIM                         |
*     +-------------------------------------------------------+
*  F8 |                        UWKVTP                         |
*     +-------------------------------------------------------+
* 100 |                        UWKTTP                         |
*     +-------------------------------------------------------+
* 108 |                        UWKVTS                         |
*     +-------------------------------------------------------+
* 110 |                        UWKTTS                         |
*     +---------------------------+---------------------------+
* 118 |          UWKRDR           |          UWKPRT           |
*     +---------------------------+---------------------------+
* 120 |          UWKPCH           |          UWKIOS           |
*     +------+------+-------------+---------------------------+
* 128 |:PUTY |:AFFLG|/////////////| 12C
*     +------+------+-------------+
*
*** UWKPG - INDICATE USER data block

 

UWKPG Cross Reference

Symbol         Dspl Value
-------------- ---- -----
UWKADJFL       000D
UWKAFFIN       0129 80
UWKAFFLG       0129
UWKAFSUP       0129 40
UWKBASE        0008 04
UWKCMODE       000E
UWKCPUAD       00DC
UWKDEVN        0024
UWKDWSZ        012A 00000026
UWKESA         0008 20
UWKFLAG        0008
UWKGPRMAD      0050
UWKGPVTSZ      0070
UWKGSHRSZ      0098
UWKGSTOR       0010
UWKGTOTSZ      0058
UWKIOPT        000A
UWKIOS         0124
UWKIPDEV       001C
UWKIPLN        001C
UWKIPNUM       0020
UWKLOK         0060
UWKLOKL        0090
UWKMIG         00BC
UWKPCH         0120
UWKPDAS        0080
UWKPRIVT       0009 80
UWKPRMNM       0038
UWKPRMUS       0030
UWKPRT         011C
UWKPUTY        0128
UWKPVTSH       0009
UWKPVTSP       006C
UWKRDR         0118
UWKREAD        00C0
UWKRES         0078
UWKRESL        0084
UWKRESV        008C
UWKSDAS        00A8
UWKSHARD       0009 40
UWKSHRSP       0094
UWKSIZE        012A 0000012C
UWKSLOKL       00B0
UWKSMIG        00D0
UWKSPLRD       0028
UWKSPLWT       002C
UWKSREAD       00D4
UWKSRES        00A0
UWKSRESL       00AC
UWKSWRIT       00D8
UWKSXBK        00A4
UWKSXRD        00C8
UWKSXWT        00CC
UWKTODON       00E0
UWKTOTSP       0068
UWKTTIM        00F0
UWKTTP         0100
UWKTTS         0110
UWKTYPE        000C
UWKUSER        0000
UWKVIRT        000B
UWKVTIM        00E8
UWKVTP         00F8
UWKVTS         0108
UWKWRIT        00C4
UWKWSS         0088
UWKXA          0008 40
UWKXBK         007C
UWKXC          0008 10
UWKXRD         00B4
UWKXSTR        0018
UWKXWT         00B8
UWK370         0008 80

This information is based on z/VM V5R4.0. Last updated on 18 Feb 2010 at 04:21:51 EDT.
Copyright IBM Corporation, 1990, 2009