LOCATE ICLBK
Authorization
Privilege Class: C, E
Purpose
Use LOCATE ICLBK to display the address of the CP indirect call locator block (ICLBK) for a specific entry point.
Operands
- epname
- is the name of the entry point whose CP indirect call locator block address you want to display.
The variable epname must be a 1-character to 8-character string. The first
character must be alphabetic or one of the following special characters: dollar sign ($), number
sign (#), underscore (_), or at sign (@). The rest of the string can be alphanumeric characters, the
four special characters ($, #, _, and @), or any combination thereof. You can use generic entry point names to request information about a specific subset of entry point names. A generic entry point name is a 1-character to 8-character string with asterisks (*) in place of one or more characters and percent signs (%) in place of exactly one character. For example,
lists all the entry points that start with HCP and have RC as their fifth and sixth characters.locate iclbk hcp%rc*
Usage Notes
- To load customer-written CP routines into the system execution space, use the CPXLOAD command (see CPXLOAD).
- To add to, change, or replace the list of entry points and external symbols associated with an exit point and to enable or disable that exit point, use the ASSOCIATE EXIT command (see ASSOCIATE EXIT).
- To display usage statistics information about indirect calls to external entry points, use the QUERY ICLNAME command (see QUERY ICLNAME).
- For more information about the indirect call locator block, see Available Diagnostic Facilities in z/VM®: CP Exit Customization.
Responses
Response 1:
Symbol ICLBK
symbol nnnnnnnn
⋮
- Symbol
- shows the entry point name you specified, or an entry point name that matches the pattern you specified.
- ICLBK
- shows the host logical storage address of the CP indirect call locator block for that entry point.
Examples
Example 1:
To display the address of the indirect call locator block for entry point HCPSRC00, enter the
following:
locate iclbk hcpsrc00
Symbol ICLBK
HCPSRC00 06FE09C8
Ready;
Example 2:
To display the address of all the indirect call locator blocks for entry points that have
HCPSRCas the first six characters of their name, enter the following:
locate iclbk hcpsrc*
Symbol ICLBK
HCPSRC00 061E09C8
HCPSRC04 06F109C8
HCPSRC08 06FE01C8
HCPSRC10 06FE19C8
Ready;
Messages
- HCP003E Invalid option - command contains extra option(s) starting with option
- HCP026E Operand missing or invalid
- HCP6706E Invalid entry point name - epname
- HCP6720I No items found to satisfy selection criteria.