The HPGETPROCPLABEL intrinsic dynamically loads an XL
procedure and returns the procedure's label (plabel) to
your program.
You can use the plabel to make a dynamic call to the
procedure if the programming language contains features for
making dynamic procedure calls, for example, the CALL
procedure in HP Pascal/XL. Refer to the HP Pascal Reference
Manual (31502-90001) for details on the CALL
procedure.
The syntax of HPGETPROCPLABEL is as follows:
HPGETPROCPLABEL(procname,plabel,status,firstfile,casesensitive)
|
HPGETPROCPLABEL searches through a list of XLs
(referred to as the binding sequence, described below)
to locate the procedure you specify in the procname
parameter. When the procedure is found, it is dynamically loaded
and its plabel is returned to your program in the plabel
parameter.
Appendix B contains a program example illustrating the use of
the HPGETPROCPLABEL intrinsic.
The status parameter returns status information about the
intrinsic call, in the following manner:
Bits (0:16) | When the signed integer value represented by these bits is zero,
a normal status is indicated. A negative value indicates an error
condition, and a positive value indicates a warning condition. |
Bits (16:16) | The signed integer value represented by these bits defines the subsystem that set the status information in Bits (0:16). The NM loader identification number is 104. When the value represented by these
bits is zero, a normal status is indicated. |