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 V4R1.0.
Last updated on 5 Jun 2001 at 13:11:51 EDT.
Copyright IBM Corporation, 1990, 2001