z/VM: CP Commands and Utilities Reference - z/VM - IBM

Examples
A locked page from an address space created by the ADRSPACE macro is
unlocked when the address space is destroyed by the ADRSPACE macro.
5. Pages that are locked by this command are not unlocked by the operation of
the ADRSPACE ISOLATE and ADRSPACE PERMIT macros. The ADRSPACE
macros are described in z/VM: CP Programming Services.
6. The CP SYSTEM CLEAR command unlocks any locked pages and sets them to
binary zeros.
7. The virtual pages locked in processor storage are 4 KB (4096-byte) blocks. This
block of storage need not represent all of the user’s virtual storage. The LOCK
command may be issued as many times as required for one virtual machine to
lock noncontiguous pages of storage. The remaining virtual machine storage
blocks remain pageable.
8. If you omit the MAP option from a LOCK command and you later want to find
the real page, reissue the LOCK with the MAP option. No intervening UNLOCK
is required. The MAP option is the default if the symbol form is used.
1. For the first and last page, only the page numbers are specified. For example,
to lock storage locations X'12000' through X'14FFF' of USERA’s primary
address space in real storage and display the real storage location for each
page, you could enter:
lock userid usera 12 14 map
VIRTPAGE REALPAGE
USERA 00012000 078F8000
USERA 00013000 06B7C000
USERA 00014000 02A77000
Command complete
Ready;
You can enter the LOCK command without the userid parameter:
lock usera 12 14 map
VIRTPAGE REALPAGE
00012000 078F8000
00013000 06B7C000
00014000 02A77000
Command complete
Ready;
To lock the first three pages of USERA’s primary address space, enter:
lock userid usera 0 2
Command complete
Ready;
To lock the first three pages of USERA’s address space named MYSPACE,
enter:
lock space usera:myspace 0 2
Command complete
Ready;
2. To lock pages above the 2 GB storage line for USERA enter:
lock userid usera 123456 123457 map
VIRTPAGE REALPAGE
USERA 00000001_23456000 71A7F000
USERA 00000001_23457000 46B41000
Command complete
Ready;
The underscore is used for readability if SET UNDERSCORE ON is in effect.
LOCK
Chapter 2. CP Commands 573