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

LOCATE (Storage)
554 z/VM: CP Commands and Utilities Reference
ASCII
tells CP to convert the data you enter to ASCII before it is compared to the data
in storage.
CASE
tells CP to convert the data you enter to upper case before it compares it to the
data in storage.
Note: Unless you are using DIAGNOSE code X'08' to send commands to CP
in mixed case, CP converts commands entered from the terminal to
upper case before it processes them. If you specify the HEX operand,
CASE is ignored. The default is CASE RESPECT.
Respect
tells CP not to convert the data from the command and the data from
storage before comparing them.
Ignore
tells CP to convert the data from the command and the data from storage
before comparing them so the upper and lower case characters are
considered equal.
COUNT n
COUNT ALL
specifies how many matches to report. ALL reports all matches. If COUNT is
not specified, the default is COUNT 1.
DECRement i
tells CP to go i number of bytes backward through storage to search for the
data. i must be a hexadecimal number. CP begins at the address you have
specified as the end of the search area and compares the data you enter with
what is at that address. If it does not find a match, it goes back i bytes and tries
again. When it reaches the beginning of the search area or finds as many
matches as you have specified with the COUNT keyword, CP displays the
addresses of the fields within the search area that contain the data you are
looking for.
i can be a one to sixteen hexadecimal digit 64-bit address, separated with an
optional underscore for readability. If the underscore is used there must be eight
hexadecimal digits to the right of it.
INCRement i
tells CP to go i number of bytes forward through storage to search for the data.
i must be a hexadecimal number. CP begins at the address you have specified
as the start of the search area and compares the data you enter with what is at
that address. If it does not find a match, it advances i bytes and tries again.
When it reaches the end of the search area or finds as many matches as you
have specified with the COUNT keyword, CP displays the addresses of the
fields within the search area that contain the data you are looking for.
If you do not specify INCREMENT or DECREMENT, INCREMENT 1 is
assumed.
i can be a one to sixteen hexadecimal digit 64-bit address, separated with an
optional underscore for readability. If the underscore is used there must be eight
hexadecimal digits to the right of it.
DATA data
specifies the data to search for. The data to be compared starts after the first
blank following the keyword DATA. Leading, imbedded, and trailing blanks are
included in the comparison.