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

LOCATE SYMBOL
Messages
HCP002E Invalid operand - operand
v For normal assembler routines, the CSECT is longer than 0 bytes. Therefore,
when you enter a LOCATE command for an assembler module, CP shows you
the length of the entire module. If you enter a LOCATE command for an entry
point within an assembler module, CP does not display any information about the
module’s length, because entry points are not defined to have length.
v For PLX routines, the first CSECT is 0 bytes long. If you enter a LOCATE
command for a PLX module, CP does not display any information about the
length of the entire module. Entry points within a PLX module are actually
independent CSECTs and are longer than 0 bytes. When you enter a LOCATE
command for an entry point within a PLX module, CP shows you the length of
the CSECT indicated by that entry point.
This distinction is apparent in the following examples.
If you use pattern matching to find the addresses of all the external symbols that
start with the letters HCPZSP, you may see the following:
locate symbol hcpzsp*
10:45:00 HCPZSP = 003D1CB0 Resident 0000A8 Bytes
10:45:00 HCPZSPPP = 003D1D30 Resident
10:45:00 HCPZSPRD = 003D1D10 Resident
Ready;
HCPZSP is an Assembler module; the other two items listed are entry points within
it.
If you use pattern matching to find the addresses of all the external symbols that
start with the letters HCPCFC, you may see the following:
locate symbol hcpcfc*
10:45:09 HCPCFC = 0087BAD0 Resident
10:45:09 HCPCFCMD = 0087BAD0 Resident 000900 Bytes
10:45:09 HCPCFCSD = 0087C3D0 Resident 0003A8 Bytes
Ready;
HCPCFC is a PLX module; the other two items are entry points within it.
HCP003E Invalid option - command contains
extra option(s) starting with option
HCP026E Operand missing or invalid
HCP1003E External symbol name {is|was} not
found.
HCP6720I No items found to satisfy selection
criteria
558 z/VM: CP Commands and Utilities Reference