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

STORE Guest Storage (z/Architecture)
The spacename BASE is preassigned by CP to be the name of your virtual
machine’s host-primary address space.
ASITasit.
stores data in absolute storage in the CP-created address space identified by
the specified address space identification token (ASIT). Specify asit as one to
sixteen hexadecimal digits; leading zeros are optional.
N stores data (in 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. This is the default.
If hexloc is not on a fullword boundary, the store operation begins on the next
lower fullword boundary. If the value being stored is less than one fullword
(eight hexadecimal digits) in length, it is right-adjusted 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 (in 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, the data you enter 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 are used to form the key for the page. If one digit is
provided, it becomes the lower digit, and the upper digit is zero.
U stores data starting at the address specified by hexloc. The data is treated as
an EBCDIC string by default; it is treated as an ASCII string if the X option is
specified. The data is stored in byte segments with no word alignment.
hexloc
is the starting storage location that is to be altered. The address hexloc may be
one to sixteen hexadecimal digits, separated with an optional underscore for
readability; leading zeros are optional. The hexloc parameter has no defaults;
you must always specify the starting address you want to alter.
% indicates 31-bit address indirection. Indirection means that the contents of the
specified address are used instead of the address itself. In this case, the 31 bits
at the specified address (the high-order bit is set to 0) are used as the address
for the STORE command.
& indicates 64-bit address indirection. Indirection means that the contents of the
specified address are used instead of the address itself. In this case, the 64 bits
at the specified address are used as the address for the STORE command.
BASEnn
stores data in guest storage using the specified address (hexloc) as a
displacement from the address in the specified general register. The general
register may be specified as a decimal number from 0 to 15 or as a
hexadecimal number from 0 to F. If the L operand has been specified, the
virtual CPU is an ESA virtual machine, and the virtual CPU is in access register
mode, the specified nn indicates an AR/GR pair. The specified access register
is used, in the same manner as if the AREGareg. operand had been specified,
in conjunction with the guest access-register-translation tables to locate the
guest address space to store data in.
Chapter 2. CP Commands 1545