LOCATE ICLBK

Read syntax diagramSkip visual syntax diagram LOCate ICLBK epname

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,
locate iclbk hcp%rc*
lists all the entry points that start with HCP and have RC as their fifth and sixth characters.

Usage Notes

  1. To load customer-written CP routines into the system execution space, use the CPXLOAD command (see CPXLOAD).
  2. 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).
  3. To display usage statistics information about indirect calls to external entry points, use the QUERY ICLNAME command (see QUERY ICLNAME).
  4. 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 HCPSRC as 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.