27.12.2012 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

LOCATE<strong>VM</strong><br />

568 z/<strong>VM</strong>: <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> <strong>and</strong> <strong>Utilities</strong> <strong>Reference</strong><br />

upper case before it processes them. If you specify the HEX oper<strong>and</strong>,<br />

CASE is ignored. The default is CASE RESPECT.<br />

Respect<br />

tells <strong>CP</strong> not to convert the data from the comm<strong>and</strong> <strong>and</strong> the data from<br />

storage before comparing them. RESPECT is the default.<br />

Ignore<br />

tells <strong>CP</strong> to convert the data from the comm<strong>and</strong> <strong>and</strong> the data from storage<br />

before comparing them so that the upper <strong>and</strong> lower case characters are<br />

considered equal.<br />

ASCII<br />

tells <strong>CP</strong> to convert the data you enter to ASCII before it is compared to the data<br />

in storage.<br />

COUNT n<br />

COUNT ALL<br />

specifies how many matches to report. ALL reports all matches. The default is<br />

COUNT 1.<br />

DECRement i<br />

tells <strong>CP</strong> to go i number of bytes backward through storage to search for the<br />

data. i must be a hexadecimal number. <strong>CP</strong> begins at the address you have<br />

specified as the end of the search area <strong>and</strong> compares the data you enter with<br />

what is at that address. If it does not find a match, it goes back i bytes <strong>and</strong> tries<br />

again. When it reaches the beginning of the search area or finds as many<br />

matches as you have specified with the COUNT keyword, <strong>CP</strong> displays the<br />

addresses of the fields within the search area that contain the data that you are<br />

looking for.<br />

i can be a one to sixteen hexadecimal digit 64-bit address, separated with an<br />

optional underscore for readability. If the underscore is used there must be eight<br />

hexadecimal digits to the right of it.<br />

INCRement i<br />

tells <strong>CP</strong> to go i number of bytes forward through storage to search for the data.<br />

i must be a hexadecimal number. <strong>CP</strong> begins at the address you have specified<br />

as the start of the search area <strong>and</strong> compares the data you enter with what is at<br />

that address. If it does not find a match, it advances i bytes <strong>and</strong> tries again.<br />

When it reaches the end of the search area or finds as many matches as you<br />

have specified with the COUNT keyword, <strong>CP</strong> displays the addresses of the<br />

fields within the search area that contain the data you are looking for.<br />

i can be a one to sixteen hexadecimal digit 64-bit address, separated with an<br />

optional underscore for readability. If the underscore is used there must be eight<br />

hexadecimal digits to the right of it.<br />

If you do not specify INCREMENT or DECREMENT, INCREMENT 1 is<br />

assumed.<br />

DATA data<br />

specifies the data to search for. The data to be compared starts after the first<br />

blank following the keyword DATA. Leading, imbedded, <strong>and</strong> trailing blanks are<br />

included in the comparison. The length of the data to search for must be less<br />

than 254 bytes.<br />

HEX xdata<br />

specifies the hexadecimal data to search for. You can specify the data as any<br />

number of strings of hexadecimal digits. If necessary, each string will be padded<br />

on the left with a single leading zero (0) to generate a string of an even number

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!