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

UNLOCK
UNLOCK
►►
UNLOCK
Authorization
Purpose
Operands
ASIT asit
SPACE owner:space_name
space_name
userid
Userid *
symbol
SYMBOL
Privilege Class: A
1698 z/VM: CP Commands and Utilities Reference
firstpage
lastpage
Use UNLOCK to release page frames locked by the LOCK command.
ASIT asit
unlocks pages in the address space identified by the address-spaceidentification
token, asit. The ASIT must be padded to 16 hexadecimal digits
with leading zeros.
SPACE owner:space_name
unlocks pages in the address space identified by the space ID,
owner:space_name, where owner is the user ID of the virtual machine that
owns the address space, and space_name is the space name assigned to the
address space. The space name consists of alphanumeric and national
characters and is 1 to 24 characters long. If owner: is not specified, your virtual
machine is assumed to be the owner of the address space.
The space name “BASE” is assigned by CP as the name of a virtual machine’s
host-primary address space.
USERID userid
userid
unlocks pages in the primary address space of the virtual machine identified by
userid. The virtual machine must be logged on. If you are unlocking 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 unlocked. Usage note 2 on page 1699 explains how to derive page numbers
from storage addresses.
lastpage
is the hexadecimal number of the last user, system or address space page to
be unlocked. If only one page is to be unlocked, lastpage must be the same as
firstpage.
SYMBOL symbol
has no effect and is retained only for compatibility with previous releases. All
symbols are considered resident, which means they cannot be locked or
unlocked. You can specify symbol as a pattern by using asterisks (*) in place of
one or more characters and percent signs (%) in place of exactly one character.
►◄