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

LOCATE SYMBOL
►►
LOCate
Authorization
Purpose
Operands
Usage Notes
Responses
SYMBOL
symbol
symbol
*
Privilege Class: C, E
Use LOCATE SYMBOL to display the address of an external symbol.
symbol
is the name of an external symbol. LOCATE symbol tells CP to locate the
address of the external symbol. If you specify the SYMBOL keyword, CP
supports pattern matching as described below in Usage Note 1. An asterisk (*)
with the SYMBOL keyword tells CP to list every CP external symbol and its
location.
1. Pattern matching generally follows the rules used by the CMS LISTFILE
command. Use an asterisk (*) to match any number of characters; use a
percent symbol (%) to match any single character.
2. There are several LOCATE commands (LOCATE RDEV, LOCATE SYMBOL,
LOCATE VMDBK) that treat the qualifying keyword on locate as optional. The
use of a keyword on this LOCATE command is recommended to avoid
undesired results.
Response 1:
If you use LOCATE SYMBOL and you do not specify the SYMBOL keyword, you
may see the following:
locate hcpabc
10:40:52 HCPABC = 00868000 Resident
Ready;
This response indicates HCPABC is at the hexadecimal address 00868000.
Response 2:
If you use LOCATE SYMBOL with the SYMBOL keyword to find the address of the
same external symbol, you may get the following response:
locate symbol hcpabc
16:38:48 HCPABC = 00868000 Resident 000858 Bytes
Ready;
LOCATE SYMBOL
The second number in the response is the length of the CSECT, and is shown if the
entry in the map contains a nonzero length for the external label:
►◄
Chapter 2. CP Commands 557