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

Usage Notes
Responses
HEX xdata
specifies the hexadecimal data to search for. The data may be specified as any
number of strings of hexadecimal digits. If necessary, each string will be padded
on the left with a single leading zero (0) to generate a string of an even number
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.
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 255 bytes.
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,
locate cpreal 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 start at the hi address and progress
downward ending at the lo address. For example, in the following command:
locate cpreal 0 1000 decr c data 123456
the first comparison address is X'FF0'.
7. CP skips pages that contain CP directory data.
8. If you specify PROMPT, you see the following:
Enter data now. To abort the command,
press ENTER with no data or press PA1.
9. If a large search range is specified, the LOCATE command will take a large
amount of CPU cycles and therefore can impact 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:
LOCATE (Storage)
The following are examples of responses to the LOCATE CPREAL command:
Chapter 2. CP Commands 555