Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CPVWK
Control Block Contents
CPVWK DSECT
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
Copyright IBM Corporation, 1990, 2001