HP 3000 Manuals HP 3000 Manuals
HPGETPROCPLABEL
NM callable only.
Dynamically loads a native mode (NM) executable library procedure.
Syntax
________________________________________________________
| |
| CA U32 I32 CA |
| HPGETPROCPLABEL(procname,plabel,status,firstfile,|
| B |
| casesensitive); |
________________________________________________________
Parameters
procname character array (required)
Passes the name of the procedure being searched
for. The first character of procname designates
the terminating character that HPGETPROCPLABEL uses
to search for the end of the name. That delimiter
can appear again only following the last valid
character of the procedure name.
plabel 32-bit unsigned integer by reference (required)
Returns a procedure label (NM plabel) for the
procedure that was found.
status 32-bit signed integer by reference (optional)
Returns the status of the HPGETPROCPLABEL intrinsic
call. If no errors or warnings are encountered,
status returns 32 bits of zero. If errors or
warnings are encountered, status is interpreted as
two 16-bit fields.
Bits (0:16) comprise status.info. A negative value
indicates an error condition, a positive value
indicates a warning condition. Refer to the MPE/iX
Error Message Manual Volumes 1, 2 and 3
(32650-90066, 32650-90152, and 32650-90368) for a
description of its value.
Bits (16:16) comprise status.subsys. The value
represented by these bits defines the subsystem
that set the status information. The subsystem
identifier for HPGETPROCPLABEL is 104.
firstfile character array (optional)
Passes the name of the program file or XL at which
to begin searching. The firstfile parameter can be
either in MPE syntax or HFS syntax. If the name of
the program file or XL is in HFS syntax, you must
use an absolute pathname. The first character that
HPGETPROCPLABEL uses to search for the end of the
file name. That delimiter can appear again only
following the last valid character of the name.
If firstfile is located in the binding sequence of
the calling process, then, beginning with
firstfile, HPGETPROCPLABEL directs the NM loader to
search through each file in the binding sequence
for the first instance of 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
Intrinsics None
Commands None
Manuals Resource Management Programmer's Guide
(32650-90024).