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 V4R3.0. Last updated on 30 Apr 2002 at 18:17:35 EDT.
Copyright IBM Corporation, 1990, 2002