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

alet as one to eight hexadecimal digits; leading zeros are optional. The ALET is
used in conjunction with the virtual machine’s host access list to determine the
address space in which to store.
SPACEspaceid.
alters the contents of absolute storage in the address space identified by the
specified spaceid. spaceid is a 1- to 33-character string of the form
►►
owner
:
spacename
STORE Guest Storage (ESA/XC)
where owner ID is an optional 1- to 8-character user ID of the virtual machine
that owns the address space, and spacename is the 1- to 24-character
address-space name assigned to the address space. If ownerid is not specified,
your virtual machine is assumed to be the owner of the address space.
The spacename BASE is preassigned by CP to be the name of your virtual
machine’s host-primary address space.
ASITasit.
alters the contents of absolute storage in the address space identified by the
specified address space identification token (ASIT). Specify asit as one to 16
hexadecimal digits; leading zeros are optional.
N stores data (hexadecimal) in successive fullword locations starting at the
address specified by hexloc. The smallest group of hexadecimal values that can
be stored is one fullword. N is the default.
If hexloc is not on a fullword boundary, the store operation begins on the next
lower fullword boundary. If data is less than one fullword (eight hexadecimal
digits) in length, it is right-justified in the word and is filled in with zeros. If two
or more hexadecimal words are specified, they must be separated with one or
more blanks.
S stores data (hexadecimal) without word alignment, starting at the address
specified in hexloc. The shortest string that can be stored is one byte (two
hexadecimal digits). If the string contains an odd number of characters, the last
character is not stored, an error message is issued, and the function terminates.
If you specify the S operand, data must be a string of two or more hexadecimal
digits with no embedded blanks.
K stores data in the storage key for the 4 KB page in which hexloc is located. Two
hexadecimal digits form the key for the page.
U stores the specified data starting at the address specified by hexloc. By default
the data is treated as EBCDIC; if the X option is specified, the data is treated
as ASCII. The data is stored in byte segments with no word alignment.
If you do not specify any of the options N, S, K, or U, data is stored in
hexadecimal word segments.
hexloc
specifies the starting storage location that is to be altered. The value hexloc
may be one to sixteen hexadecimal digits, separated with an optional
underscore for readability; leading zeros are optional. The hexloc parameter has
no default; you must always specify the starting location that you want to alter.
If neither the BASE or INDEX operand is used, hexloc is the address of the first
location to be altered. This address is treated as a 31-bit address, regardless of
the addressing mode of the virtual CPU.
►◄
Chapter 2. CP Commands 1533