MPE/iX Intrinsics Reference Manual (32650-90875)

402 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPGETPROCPLABEL
a procedure named procname .
If either
procname is not located in the XL or procname contains
unresolved external references that must be satisfied in subsequent XLs,
then each XL in the binding sequence after
firstfile is searched.
If
firstfile is not located in the binding sequence, then firstfile has a
binding sequence independent of the program and is bound directly to the
system libraries. Any unresolved external references found within
firstfile must be resolved in the system libraries.
Default: System libraries
casesensitive Boolean (optional)
Indicates in the following manner whether the
procname parameter is
case sensitive:
FALSE HPGETPROCPLABEL first tries finding
procname as it was
specified. If
procname cannot be found, HPGETPROCPLABEL
tries to find the procedure with the case of
procname the
opposite case of the first character of
procname for
example, if you specify
procname as scanforkey and the
procedure scanforkey is not found, the intrinsic searches
for the procedure SCANFORKEY.
Default: FALSE
TRUE The
procname parameter is case-sensitive.
HPGETPROCPLABEL does not alter the name in any way.
Operation Notes
The HPGETPROCPLABEL intrinsic locates a procedure found in an NM executable library file
(XL) and returns its procedure label (NM plabel). In addition, if the procedure is not yet
loaded for the process, HPGETPROCPLABEL dynamically loads the procedure.
You can then use the NM plabel to call the specified procedure dynamically, provided the
programming language contains features for making dynamic procedure calls.
NOTE If you are going to use HPGETPROCPLABEL to call system intrinsics, you must
first refer to the SYSINTR file to determine the correct parameter descriptions
(for the parameters to be passed with the returned PLABEL).
A plabel returned by HPGETPROCPLABEL is valid only for the duration of the calling process.
Related Information
Manual Resource Management Programmer's Guide.