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

#### CPVWK

Prolog

Control Block Contents
CPVWK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### CPVWK Prolog

     Name       : HCPCPVWK
     Description: LOCK/UNLOCK Command work area
     DSECT      : CPVWK
     Function   : This work area contains information used
                  during LOCK and UNLOCK command processing.
     Located by : R9 in HCPCPV
                  - R9 in HCPCPW
     Created by : HCPCPV
     Deleted by : HCPCPV

#### CPVWK Control Block Content

#### CPVWK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      CPVWK          LOCK/UNLOCK Command work area
    0000    0 Signed       4 CPVARG         Ad-len of 1st token
    0008    8 Signed       4 CPVSAVE1 (16)  Save/restore for GETOPTS
    0048   72 Signed       4 CPVSAVE2 (16)  Save/restore for LKPAGES
    0088  136 Signed       4 CPVSAVE3 (16)  Save/restore for ULPAGES
    00C8  200 Signed       4 CPVSAVE4 (16)  Save/restore for GETSPACE
    0108  264 Signed       4 CPVSAVE5 (16)  Save/restore for GETASIT
    0148  328 Signed       4 CPVSAVPG (16)  Work area for HCPCPVPG
    0148  328 Signed       4 CPVPGFPL       First page parameter length
    014C  332 Signed       4 CPVPGFPA       First page parameter address
    0150  336 Signed       4 CPVPGLPL       Last page parameter length
    0154  340 Signed       4 CPVPGLPA       Last page parameter address
    0158  344 Bitstring   16 CPVPGFCH       First page convert from buffer
    0158  344 Bitstring   16 CPVPGFWK (0)   Work area for convert to print
    0158  344 Bitstring    8 CPVPGFWH       High 8 characters
    0160  352 Bitstring    8 CPVPGFWL       Low 8 characters
    0168  360 Bitstring    8 CPVPGFHX       First page as a hex address
    0168  360 Bitstring    4 *              First address high word
    016C  364 Bitstring    4 CPVPGFH1       First address low word
    0170  368 Bitstring   16 CPVPGLCH       Last page convert from buffer
    0180  384 Bitstring    8 CPVPGLHX       Last page as a hex address
    0180  384 Bitstring    4 *              Last address high word
    0184  388 Bitstring    4 CPVPGLH1       Last address low word
    0188  392 Address      4 CPVSYMBA       Location of symbol being locked
    018C  396 Signed       4 CPVSYMBL       Length of symbol from HCPCFDSY
    0190  400 Address      4 CPVIASIT       Address of i-ASIT
         The following is the response area for the LOCK command with the MAP
         option. While there are four formats for this response, only the
         mapping which generates the longest is shown here to ensure enough
         space is allocated.
         Old short addr format: VIRTADDR REALADDR New short addr format:
         useridxx VIRTADDR REALADDR Old long addr format: VIRTADDRvirtaddr
         REALADDR New long addr format: useridxx VIRTADDRvirtaddr REALADDR
              00000194       CPVRESP        * Response area - max size shown
    0194  404 Character    8 *              Id field
    019C  412 Character    1 *              Blank spacer
    019D  413 Character   16 *              Virtual address - worst case
    01AD  429 Character    4 *              Blanks
    01B1  433 Character    8 *              Real address
              00000025       CPVRESPL       *-CPVRESP Length of maximum
                                            response
    01B9  441 Character    4 CPVM2CNT       Count of active Preferred users
    01BD  445 Character    1 CPVM2FNC       Fence
    01BE  446 Character    8 CPVUID         Userid substitution and fence
    01C7  455 Bitstring    1 CPVFLAG1       Flags
              .... ..1.      CPVFLNMP       X'02' 'NOMAP' option
              .... ...1      CPVFLMAP       X'01' 'MAP' option
    01C8  456 Bitstring    1 CPVFLAG2       Flags
              1... ....      CPVFLMOD       X'80' Show locking a module
              .1.. ....      CPVFLSYS       X'40' Show working on SYSTEM
                                            addresses
              ..1. ....      CPVFLSPC       X'20' Show working on Space
                                            addresses
              ...1 ....      CPVFLNEW       X'10' New style command format
              .... 1...      CPVFL1ST       X'08' First-page switch
              .... ..1.      CPVALLLC       X'02' Cyclic List Hold Lock
                                            acquired
    01C9  457 Bitstring    1 CPVFLAGW       Work area for option flags
    01CA  458 Bitstring    1 CPVSYMPG       1 ==> Symbol is pageable 0
                                            ==> Symbol is resident
    01CB  459 Character    8 CPVSYMNM       CP symbol locked previous time
              000001D3       CPVWKL         *-CPVWK
              0000003B       CPVWKSZ        (*-CPVWK+7)/8

#### CPVWK Storage Layout

    *** CPVWK - LOCK/UNLOCK Command work area
    *
    *     +---------------------------+---------------------------+
    *   0 |          CPVARG           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *   8 |                                                       |
    *     =                       CPVSAVE1                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  48 |                                                       |
    *     =                       CPVSAVE2                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  88 |                                                       |
    *     =                       CPVSAVE3                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  C8 |                                                       |
    *     =                       CPVSAVE4                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 108 |                                                       |
    *     =                       CPVSAVE5                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 148 |                                                       |
    *     =                       CPVSAVPG                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 188
    *
    *** CPVWK - LOCK/UNLOCK Command work area

    *** Overlay for CPVSAVPG in CPVWK
    *
    *     +---------------------------+---------------------------+
    * 148 |         CPVPGFPL          |         CPVPGFPA          |
    *     +---------------------------+---------------------------+
    * 150 |         CPVPGLPL          |         CPVPGLPA          |
    *     +---------------------------+---------------------------+
    * 158 |                       CPVPGFCH                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 168
    *
    *** Overlay for CPVSAVPG in CPVWK

    *** Overlay for CPVPGFCH in CPVWK
    *
    *     +-------------------------------------------------------+
    * 158 |                       CPVPGFWH                        |
    *     +-------------------------------------------------------+
    * 160 |                       CPVPGFWL                        |
    *     +-------------------------------------------------------+
    * 168 |                       CPVPGFHX                        |
    *     +-------------------------------------------------------+
    * 170
    *
    *** Overlay for CPVPGFCH in CPVWK

    *** Overlay for CPVPGFHX in CPVWK
    *
    *     +---------------------------+---------------------------+
    * 168 |///////////////////////////|         CPVPGFH1          |
    *     +---------------------------+---------------------------+
    * 170 |                       CPVPGLCH                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 180 |                       CPVPGLHX                        |
    *     +-------------------------------------------------------+
    * 188
    *
    *** Overlay for CPVPGFHX in CPVWK

    *** Overlay for CPVPGLHX in CPVWK
    *
    *     +---------------------------+---------------------------+
    * 180 |///////////////////////////|         CPVPGLH1          |
    *     +---------------------------+---------------------------+
    * 188 |         CPVSYMBA          |         CPVSYMBL          |
    *     +---------------------------+---------------------------+
    * 190 |         CPVIASIT          |///////////////////////////|
    *     +---------------------------+------+--------------------+
    * 198 |///////////////////////////|//////|////////////////////|
    *     +---------------------------+------+////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     |//////////////////////////////////+--------------------+
    *     |//////////////////////////////////|////////////////////|
    *     +------+---------------------------+--------------------+
    * 1B0 |//////|////////////////////////////////////////////////|
    *     +------+---------------------------+------+-------------+
    * 1B8 |//////|         CPVM2CNT          |:M2FNC|   (1BE)-    |
    *     +------+---------------------------+------+------+------+
    * 1C0 |                -CPVUID                  |//////|:FLAG1|
    *     +------+------+------+--------------------+------+------+
    * 1C8 |:FLAG2|:FLAGW|:SYMPG|            CPVSYMNM-             |
    *     +------+------+------+----------------------------------+
    * 1D0 |      -(1CB)        | 1D3
    *     +--------------------+
    *
    *** Overlay for CPVPGLHX in CPVWK

#### CPVWK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    CPVALLLC       01C8 02
    CPVARG         0000
    CPVFLAGW       01C9
    CPVFLAG1       01C7
    CPVFLAG2       01C8
    CPVFLMAP       01C7 01
    CPVFLMOD       01C8 80
    CPVFLNEW       01C8 10
    CPVFLNMP       01C7 02
    CPVFLSPC       01C8 20
    CPVFLSYS       01C8 40
    CPVFL1ST       01C8 08
    CPVIASIT       0190
    CPVM2CNT       01B9
    CPVM2FNC       01BD
    CPVPGFCH       0158
    CPVPGFHX       0168
    CPVPGFH1       016C
    CPVPGFPA       014C
    CPVPGFPL       0148
    CPVPGFWH       0158
    CPVPGFWK       0158
    CPVPGFWL       0160
    CPVPGLCH       0170
    CPVPGLHX       0180
    CPVPGLH1       0184
    CPVPGLPA       0154
    CPVPGLPL       0150
    CPVRESP        0190 00000194
    CPVRESPL       01B1 00000025
    CPVSAVE1       0008
    CPVSAVE2       0048
    CPVSAVE3       0088
    CPVSAVE4       00C8
    CPVSAVE5       0108
    CPVSAVPG       0148
    CPVSYMBA       0188
    CPVSYMBL       018C
    CPVSYMNM       01CB
    CPVSYMPG       01CA
    CPVUID         01BE
    CPVWKL         01CB 000001D3
    CPVWKSZ        01CB 0000003B

This information is based on z/VM V4R3.0. Last updated on 1 May 2002 at 08:20:22 EDT.
Copyright IBM Corporation, 1990, 2002