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

LOCK
►►
LOCK
Authorization
Purpose
Operands
ASIT asit
SPACE owner:space_name
space_name
userid
Userid *
MAP
symbol
SYMBOL
Privilege Class: A
firstpage
lastpage
Use LOCK to keep selected pages of user virtual storage in real storage.
ASIT asit
locks pages in the address space identified by the ASIT, asit. Specify asit as 1
to 16 hexadecimal digits. Leading zeros are required.
SPACE owner:space_name
locks pages in the address space identified by owner:space_name, where
space_name is the name of the address space containing the pages, and
owner is user ID of the owner of the address space.
If owner is not specified, your virtual machine is assumed to be the owner of
the address space.
The space name is a string of alphanumeric and national characters, 1 to 24
characters long. The space name “BASE” is preassigned by CP to be the name
of the issuer’s host-primary address space.
Userid userid
userid
locks pages in the primary address space of the virtual machine identified by
the specified user ID. userid is the 1- to 8-character user ID of a logged on
virtual machine. If you are locking pages of your own virtual machine’s storage,
you can specify userid as an asterisk (*).
firstpage
is the hexadecimal number of the first user, system, or address space page to
be brought into storage and locked. Page numbers are assigned beginning with
zero; each page is X'1000':
Table 14. Page Number Derivation
MAP
Storage Location Page Number
0000-FFFF 0
1000-1FFF 1
LOCK
►◄
Chapter 2. CP Commands 571