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

Usage Notes
Responses
of hexadecimal digits. CP ignores blanks between the hexadecimal strings as it
converts the strings for comparison. The length of the data to search for must
be less than 254 hexadecimal digits.
If you specify the HEX operand, the CASE operand is ignored.
PROMPT
tells CP to prompt you to enter the data to be searched for. The length of the
data to search for must be less than 254bytes.
1. CP only searches addresses for pages assigned. CP skips a page for an
address not assigned (for example, an unreferenced page). If CP skips a page
for any reason, the next comparison is in the next acceptable page at the
address that would have been reached had the page or pages not been skipped
and had all comparisons failed.
2. If you specify the search area as lo hi or lo-hi, CP searches and compares the
byte at address hi. For example,
locatevm 0 1 hex 00
causes CP to compare the two bytes (address 0 and address 1) to the specified
data (00).
3. Specifying the search area as lo hi or lo-hi is the same as specifying lo.len if len
= hi – lo + 1.
4. If CP finds a match, the address of the next comparison attempt is the address
of the match plus the increment amount (or minus the decrement amount).
5. If you specify DECREMENT, CP displays the addresses of matches with the
highest address first.
6. Whether you specify INCREMENT or DECREMENT, the set of addresses
eligible for the search are the same. The difference is that INCREMENT causes
the search to start from the lo address and progress upward, while
DECREMENT causes the search to begin at the hi address and progress
downward ending at the lo address. For example, in the following command,
locatevm 0 1000 decr c data 123456
the first comparison address is X'FF0'.
7. If you specify PROMPT, you see the following:
Enter data now. To abort the command,
press ENTER with no data or press PA1.
8. If a large search range is specified, the LOCATEVM command will take a large
amount of CPU cycles and therefore can impact the overall system
performance.
Addresses in responses can be up to sixteen hexadecimal digits, separated by an
underscore if SET UNDERSCORE ON has been specified.
Response 1:
If you enter a LOCATEVM command, you might see something like this:
locatevm 1000-2000 hex 0
The data is located at 00001000.
Ready;
LOCATEVM
Chapter 2. CP Commands 569