QUERY ICLNAME

Read syntax diagramSkip visual syntax diagram Query ICLNAME epname

Authorization

Privilege Class: A, C, E

Purpose

Use QUERY ICLNAME to display usage statistics information about indirect calls to external entry points.

Operands

epname
is the name of the external entry point for which you want to display information. 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 4 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 1 or more characters and percent signs (%) in place of exactly 1 character. For example,
query iclname hcp%rc*
displays all the entry points that start with HCP and have RC as their fifth and sixth characters.

Usage Notes

  1. To display the address of the CP indirect call locator block for a specific exit point, use the LOCATE ICLBK command (see LOCATE ICLBK).
  2. For more information about indirect calls to external entry points, see Available Diagnostic Facilities in z/VM: CP Exit Customization.

Responses

Response 1:

To display the current usage statistics for all external entry points whose names begin with the letters RDF, enter the following:
query iclname rdf*
ICLNAME       Count Seconds
RDFSAMPL         90 0.000123
RDFEXECU          1 0.000041
Ready;
In this example,
ICLNAME
is the name of the external entry point in the indirect call locator block (ICLBK).
Count
shows you the total number of successful indirect calls to this external entry point.
Seconds
shows the total elapsed time CP used to process all of the successful indirect calls to this external entry point. For each successful indirect call, CP records how long it took (the elapsed time, not CPU time) to process the external entry point from the time it was called to the time it finished processing.

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.