QUERY ICLNAME
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,
displays all the entry points that start with HCP and have RC as their fifth and sixth characters.query iclname hcp%rc*
Usage Notes
- To display the address of the CP indirect call locator block for a specific exit point, use the LOCATE ICLBK command (see LOCATE ICLBK).
- 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.