UWKPG | Back to Index page

| Prolog Control Block Contents UWKPG DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

UWKPG Prolog | Top of page

     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
     RELOCATION CONSIDERATIONS : None
     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 | Top of page

     UWKPG DSECT
    Top of page

    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...      UWKZ           X'08' Machine Mode = Z (CZAM)
              .... .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
    0094  148 Signed       4 UWKINST        Number of instantiated pages for
                                            private address space
             End of totals for private spaces
             The following counts are the totals of the values for
             all shared address spaces.
    0098  152 Signed       4 UWKSHRSP       Number of shared spaces owned by
                                            this user
    00A0  160 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.
    00A8  168 Signed       4 UWKSRES        Number of resident pages in
                                            shared address spaces
    00AC  172 Signed       4 UWKSXBK        Number of pages in xstore for
                                            shared address spaces
    00B0  176 Signed       4 UWKSDAS        Number of pages on DASD for
                                            shared address spaces
    00B4  180 Signed       4 UWKSRESL       Number of resident pages in host
                                            logical for private address space
    00B8  184 Signed       4 UWKSLOKL       Number of locked pages in host
                                            logical for private address space
    00BC  188 Signed       4 UWKSINST       Number of instantiated pages for
                                            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:
    00C0  192 Signed       4 UWKXRD         Number reads from xstore to
                                            private address spaces
    00C4  196 Signed       4 UWKXWT         Number writes to xstore from
                                            private address spaces
    00C8  200 Signed       4 UWKMIG         Number of migrates for private
                                            address spaces
    00CC  204 Signed       4 UWKREAD        Number of reads from DASD to
                                            private address spaces
    00D0  208 Signed       4 UWKWRIT        Number of writes to DASD from
                                            private address spaces
              Shared paging information:
    00D4  212 Signed       4 UWKSXRD        Number of reads from xstore to
                                            shared address spaces
    00D8  216 Signed       4 UWKSXWT        Number of writes to xstore from
                                            shared address spaces
    00DC  220 Signed       4 UWKSMIG        Number of migrates for shared
                                            address spaces
    00E0  224 Signed       4 UWKSREAD       Number of reads from DASD to
                                            shared address spaces
    00E4  228 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.
    00E8  232 Signed       4 UWKCPUAD       Virtual CPU address
    00EC  236 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.
    00F0  240 Dbl-Word     8 UWKVTIM        Total virtual time
    00F8  248 Dbl-Word     8 UWKTTIM        Total virtual and simulation time
    0100  256 Dbl-Word     8 UWKVTP         Total virtual time consumed while
                                            running on a primary processor
    0108  264 Dbl-Word     8 UWKTTP         Total virtual and simulation time
                                            consumed while running on a
                                            primary processor
    0110  272 Dbl-Word     8 UWKVTS         Total virtual time consumed while
                                            running on a secondary processor
    0118  280 Dbl-Word     8 UWKTTS         Total virtual and simulation time
                                            consumed while running on a
                                            secondary processor
    0120  288 Signed       4 UWKRDR         Number of virtual cards read
    0124  292 Signed       4 UWKPRT         Number of virtual lines printed
    0128  296 Signed       4 UWKPCH         Number of virutal cards punched
    012C  300 Signed       4 UWKIOS         Number of IO requests
    0130  304 Bitstring    1 UWKPUTY        CPU Type Code - the possible code
                                            values are in HCPEQUAT
    0131  305 Bitstring    1 UWKAFFLG       CPU Affinity Flag
              1... ....      UWKAFFIN       X'80' UWKAFFIN CPU Affinity
                                            requested
              .1.. ....      UWKAFSUP       X'40' UWKAFSUP CPU Affinity
                                            suppressed
    0132  306 Bitstring    1 * (2)          Reserved
             End of fields significant for each virtual processor
             End of control block
              00000134       UWKSIZE        *-UWKPG Single entry size (bytes)
              00000027       UWKDWSZ        ((*-UWKPG)+7)/8 Single entry size
                                            (dbl words)

UWKPG Storage Layout | Top of page

    *** 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           |         UWKINST           |
    *     +---------------------------+---------------------------+
    *  98 |         UWKSHRSP          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  A0 |                      UWKGSHRSZ                        |
    *     +---------------------------+---------------------------+
    *  A8 |         UWKSRES           |         UWKSXBK           |
    *     +---------------------------+---------------------------+
    *  B0 |         UWKSDAS           |         UWKSRESL          |
    *     +---------------------------+---------------------------+
    *  B8 |         UWKSLOKL          |         UWKSINST          |
    *     +---------------------------+---------------------------+
    *  C0 |          UWKXRD           |          UWKXWT           |
    *     +---------------------------+---------------------------+
    *  C8 |          UWKMIG           |         UWKREAD           |
    *     +---------------------------+---------------------------+
    *  D0 |         UWKWRIT           |         UWKSXRD           |
    *     +---------------------------+---------------------------+
    *  D8 |         UWKSXWT           |         UWKSMIG           |
    *     +---------------------------+---------------------------+
    *  E0 |         UWKSREAD          |         UWKSWRIT          |
    *     +---------------------------+---------------------------+
    *  E8 |         UWKCPUAD          |         UWKTODON          |
    *     +---------------------------+---------------------------+
    *  F0 |                       UWKVTIM                         |
    *     +-------------------------------------------------------+
    *  F8 |                       UWKTTIM                         |
    *     +-------------------------------------------------------+
    * 100 |                        UWKVTP                         |
    *     +-------------------------------------------------------+
    * 108 |                        UWKTTP                         |
    *     +-------------------------------------------------------+
    * 110 |                        UWKVTS                         |
    *     +-------------------------------------------------------+
    * 118 |                        UWKTTS                         |
    *     +---------------------------+---------------------------+
    * 120 |          UWKRDR           |          UWKPRT           |
    *     +---------------------------+---------------------------+
    * 128 |          UWKPCH           |          UWKIOS           |
    *     +------+------+-------------+---------------------------+
    * 130 |:PUTY |:AFFLG|/////////////| 134
    *     +------+------+-------------+
    *
    *** UWKPG - INDICATE USER data block

UWKPG Cross Reference | Top of page

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

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:31:31 EDT.
Copyright IBM Corporation, 1990, 2020